[XxFran10xX]

What

Adds the hidden Blood Magic path to Magic (package net.tfminecraft.magic.blood, config bloodmagic.yml). Hidden content: keep it off the wiki.

• Voices. A hidden whisper meter fills from dark deeds: blade kills of animals, permakills, deep corruption, and faster with an evil trait. Then Lorvear, the first vampire and Blood Father, teaches the path and gives a bound ritual knife and altar. Staff can wake the voices with /magic blood whisper.
• Altar.
  • Placing it: underground only, outside WorldGuard regions, and claim plugins are asked first through a BlockPlaceEvent.
  • Defenses: it can't be broken, pushed or blown up.
  • Corruption: it grows bloodier over 6 stages and corrupts the room around it (journalled, never inside protected regions).
  • Purifying: it purifies itself when the owner character dies.
• Animal stage. Bind another player's animal on the altar with the ritual knife and kill it with that knife. 7 species, one per rolling 24 hours. A stolen animal leaves a trace and a delayed note for its owner.
• The Blood Father's question. A menu with two answers:
  • Kneel to Lorvear (devotee): 2 permanent injuries, the hidden Bloodsworn class (unlocked through RPCharacters ClassUnlocks), bound armour, then straight to the finals.
  • Kneel to no one (true path): the hunt.
• Hunt and finals.
  • Hunt: sacrifice knocked-out characters on the altar (always a permakill) for 7 points, scored by a hidden closeness ranking built from RP conversations, time spent near each other and the will heir. That unlocks the Sanguinar class and armour. The armour is made from the hunt's victims: each piece is named after one (<name> Skull, Ribcage, Hide, Bones), the most important victim (most points, then closest rank) on the skull and so on down; with fewer victims than pieces the names start over from the top. Sacrifices now keep the victim's closeness rank for this order.
  • Finals: the 5 closest characters, named one at a time from least close to closest. A target dying any other way is a failed sacrifice: backlash and a 72-hour wait. Each final adds MythicLib stat boons.
  • Anti-abuse: same account never counts, minimum playtime and character age, and the same player never twice in a row during the hunt.
• Carry. Sneak and right-click a knocked-out character with the blood knife to drag the body along. It is moved through RPCharacters moveDowned and is never laid in liquid, fire or walls.
• The other voice. The mage's "own dark self" is the Void Reaper working on them unseen. It argues against kneeling at the question and is all a true-path mage hears.
• Effects. BloodFx gives every moment layered, configurable sounds and particles (fx: in bloodmagic.yml).
• Path permissions. permissions: in bloodmagic.yml gives the played character of each path a permission (magic.blood.bloodsworn, magic.blood.sanguinar) through a permission attachment: set on session start, the choice and staff path/reset, removed on session end and quit, so it follows the character. ArmourShop uses it to show the Bloodsworn skin category only to Bloodsworn.
• Skinned blood armour stays protected. An ArmourShop skin replaces the piece's ItemsAdder compound and drops override_auto_update; Magic marks every blood piece again when an inventory closes, armour changes or a session starts.
• Looks. The items, altar stages, trace and armour use the tfmc_blood ItemsAdder pack (ServerAssets). Bound items opt out of ItemsAdder auto_update.
• Staff tools. /magic blood list | info | stage | path | give | whisper | voice | target | bonds | altar | reset, documented in ADMIN-COMMANDS.md.

Depends on

• RPCharacters feat/knockout-move (ClassUnlocks and PvpKnockoutManager.moveDowned). Both are reached by reflection, so Magic still runs on older RPCharacters. Without them, staff unlock classes by hand and a dragged body snaps back.
• ServerAssets feat/blood-path-art: the tfmc_blood pack, MMOItems BLOODSWORN_*/SANGUINAR_* and the MMOCore bloodsworn/sanguinar classes. Load the pack before this config; a missing IA id builds dirt.
• Compiles against RPCharacters 2.31.0. NBTAPI is a provided dependency, and authlib is a test-only dependency.

Review and tests

• Self-review: 3 rounds. Round 1 (4 reviewers) found 12 issues in this repo, rounds 2 and 3 found follow-ups. All were fixed with tests.
• Coverage: the new blood package and the integration bridge are at 100%, with no skipped tests.
• Full suite on Windows: the only failures are the existing 15 failures and 140 errors in the Gear*/ProfileEdge storage tests (directory fsync on Windows), the same as main.
• On TFMCDev01 (bots): 3 end-to-end tests all pass:
  • altar placement, the stolen-animal rite, a voice line and purify;
  • knockout, carry across the room, laying the body on the altar, the body held on the altar through the rite, and the sacrifice counted;
  • a wall refuses the rite, logging out on the altar still sacrifices, both voices speak at the question, and enabled: false stops the rite.
• Dev log: no Magic, RPCharacters or pack errors.

Notes

• Names: the blade (Vein-Reaver) and the classes (Bloodsworn, Sanguinar) are placeholders.
• Main rollout: Act System caps for the two classes are recorded in ACT-SYSTEM.md (11 in Act 1).
• Not in scope: class spells.

🤖 Generated with Claude Code

[coderabbitai]

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

• Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true

• Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}