Installing
The mod needs Fabric Loader and Fabric API for Minecraft 26.3, and Java 25.
Install Fabric Loader on the server
Download the Fabric installer from fabricmc.net and run it in your server folder, or use the server launcher it offers there.
java -jar fabric-installer.jar server -mcversion 26.3 -downloadMinecraft
Add the mods
Put Fabric API and Bloodline Chronicles in the
modsfolder.server/ ├── mods/ │ ├── fabric-api-[version].jar │ └── bloodline-chronicles-[version].jar ├── config/ └── fabric-server-launch.jar
Start the server
The first start creates the settings file,
config/bloodline.json. Players who join get a house, a character and the Chronicle straight away.java -Xmx4G -jar fabric-server-launch.jar nogui
Singleplayer
Put the same two files in the mods folder of a Fabric profile in your launcher, or install from Modrinth or CurseForge with their apps. Every new world starts with your first house.
Inns and crypts
Roadside inns, barrow crypts, wayside shrines and fallen manors generate in newly explored land, so on an existing world players have to travel to new chunks to find them. Village inns work everywhere: an innkeeper appears at any village bell.
The settings file
All settings live in config/bloodline.json. It is rewritten on every start, so settings added in later versions appear with their default values; invalid values fall back to the defaults. Changes apply the next time the world starts.
Families
| Setting | Default | What it does |
|---|---|---|
| maxTraits | 4 | Most traits a family member can have. |
| boonPassChance | 0.5 | Chance that each of a parent's boons and quirks passes to a child. |
| flawPassChance | 0.35 | Chance that each of a parent's flaws passes to a child. |
| newTraitQuirkChance newTraitFlawChance | 0.15 0.25 | Chances that a child's new trait is a quirk or a flaw (otherwise a boon). |
| heirChoices | 3 | How many children a dead family member leaves to choose from. |
| heirAutoChooseSeconds | 120 | Seconds of play before the family chooses an heir for a player who hasn't. |
| briefLifeMinutes | 20 | A life shorter than this is "the Brief" and passes no traits on. |
Renown
| Setting | Default | What it does |
|---|---|---|
| actThresholds | 0, 10, 25, 45 | Renown the house needs to begin each act of the oath. |
| perFulfilledOath | 50 | Extra renown every act needs for each oath the house already fulfilled. |
| bloodDebt, actCompleted, cryptCleared, familyEvent, reclaimedHeirloom, unfinishedBusiness, innJob, restingPlace, foundingGoal, preparation, shrineVisited, manorClaimed | 5, 5, 6, 4, 4, 3, 3, 2, 2, 2, 1, 10 | Renown for each kind of deed. |
| debtInherited debtForgotten | -2 -3 | Renown lost per unpaid blood debt at death, and when an old debt is pushed out. |
| maxBloodDebts | 3 | Most unpaid blood debts a house can carry. |
Everything else
| Setting | Default | What it does |
|---|---|---|
| events.enabled | true | Whether family events (sickness, rivals, weddings, cousins, restless spirits) happen at all. |
| events.intervalDays | 3 | Minecraft days between family events, plus up to two days of chance. |
| events.graceDays | 7 | Days after founding before a house can face a feud or a restless spirit. |
| champions.tierRenown | 15, 45, 100 | Renown at which surprise champions get stronger (Established, Renowned, Legendary). |
| champions.tierHealth champions.tierGuards | 0.4 … 1.5 -3 … +1 | Champion health and bodyguards per tier. Oath champions are never scaled. |
| sacrifice.renown | 10 | Renown for a Sacrifice. |
| sacrifice.sacrificesForBloodSworn | 3 | Sacrifices after which the house becomes Blood-Sworn. |
| steward.hireCost steward.moveCost | 10 2 | Emeralds to hire the steward, and to move them to a new bed. |
| steward.vaultSlots steward.vaultRenown | 3, 6, 9 0, 25, 50 | Vault slots unlocked at each amount of renown. |
| inns.maxJobsPerPlayer | 2 | Inn jobs a player can hold at once. |
| inns.innkeepersAtPlayerBells | true | Whether a bell placed by a player also attracts an innkeeper, or only bells in villages. |
| houses.maxMembers | 12 | Most players in one house. |
| heirlooms.maxRank | 3 | Highest rank an heirloom's bonus can reach. |
| structures.searchRadiusChunks | 100 | How far to look for structures for quests and maps. Keep it modest on busy servers: finding rare structures far away can briefly pause the server. |
| structures.rumourSearchRadiusChunks | 64 | Search radius for inn rumours. |
Commands
Players don't need commands: the Chronicle, the scrolls and the buttons in chat do nearly everything. Only inviting players, removing members and passing on leadership need a command for now. The rest are for players who prefer typing, and for operators.
For every player
| Command | What it does |
|---|---|
| /bloodline | Your house, character, traits, members and renown. |
| /bloodline quests | Your duties and quests with progress. |
| /bloodline tree [player] | The family tree. |
| /bloodline info <player> | Another player's house. |
| /bloodline chronicle | A new copy of the Chronicle. |
| /bloodline heir <1-3> | Choose your heir after a death. |
| /bloodline event [accept|decline] | See or answer a family event waiting for a choice. |
| /bloodline sacrifice | Start the Sacrifice. |
| /bloodline accept keep|fresh /bloodline decline | Answer an invitation to another house. |
| /bloodline leave | Leave your house and found a new one. |
For the head of a house
| Command | What it does |
|---|---|
| /bloodline oath [sword|deep|hearth] | See or swear the house's oath. |
| /bloodline house <name> | Rename the house. |
| /bloodline invite <player> | Invite a player into the house. |
| /bloodline remove <player> | Send a member away. |
| /bloodline head <player> | Pass leadership on. |
For operators
These need operator permission (level 2).
# Wipe a player's family, so they start over with a new house /bloodline admin reset <player> # Find the nearest roadside inn or barrow crypt /locate structure bloodline:roadside_inn /locate structure bloodline:crypt /locate structure bloodline:shrine_temperate # or shrine_cold, shrine_warm /locate structure bloodline:fallen_manor
For testing, there are also debug commands:
| Command | What it does |
|---|---|
| /bloodline debug complete | Finish your newest quest. |
| /bloodline debug renown <amount> | Add (or take) renown. |
| /bloodline debug event <type> | Start a family event: sickness, restless, feud, wedding or cousin. |
| /bloodline debug age | Count your character as having lived a full life. |
| /bloodline debug champion | Spawn a test champion. |
| /bloodline debug manor [clear|reset] | Inside a manor: see its progress, drive the occupants out at once, or start it over (the claim stays). |
| /bloodline debug crypt [reset] | Inside a crypt: see its answer and progress, or start it over. |
Saves and accounts
Every family is stored in the world's save, linked to the player's Minecraft account, so it survives name changes. Families belong to that world: another world or server has its own. On offline-mode servers, families follow the player's name instead.