Vampire Plugin

A Minecraft Paper plugin (1.21.4+) that transforms your server into a gothic hierarchy of blood, shadows, and dominion. From fragile Humans to the singular Vampire Progenitor, every drop of blood tells a story.

[HR][/HR]

Features

• Five-Tier Bloodline — Human → Vampire → Vampire Lord → Vampire Prince → Vampire Progenitor (single, *******)
• Prince-Created Lords — Vampire Lords are made only when a Vampire Prince shares their blood (no altar)
• Blood Feeding — Hunt living mobs with bare hands; hunger = blood, undead give nothing
• Blood Bottles & Bloodline — Share blood via /vampire blood to spread vampirism, ascend ranks, or grant sun immunity; bottles track sire for true lineage
• 24 Toggleable Abilities + Royal Call — Night Vision to Eternal Night, plus Prince's active Royal Blood Call that summons their entire lineage
• Maker & Order Hierarchy — Turn, command, and be bound; Progenitor commands all, Prince commands Lords & Vampires, with escalating cooldowns
• Infection System — 25% (Vampire) → 90% (Progenitor) chance to spread via bite; Progenitor bites make Princes, Prince bites make Lords
• Sun & Iron — Vampires burn; Lords/Princes/God are sun-immune but walled by iron barriers; Princes/God inflict 3.0×/5.0× weakness damage to lesser vampires
• Villager Shunning, No Fall Damage, Mob Ignore, Regeneration
• Vampire Codex — 58-page in-game written book (/vampire guide) with lore, strengths/weaknesses, ascension paths, bottle matrices, and ability lists — built to Minecraft's 114px/14 lines/1023 chars/100 pages limits
• Holy Ground — Humans wield Holy Ward Potions (/vampire holyward) to consecrate land: fatal to Vampires, barrier to Lords/Princes/Gods, deadly to undead; lasts 20 Minecraft days
• Placeholders & Permissions — LuckPerms-ready vampire.* ranks + 17 PlaceHolderAPI %vampireplugin_*% placeholders

[HR][/HR]

Roles

Role	Power	Sun	Hunger	Blood/Hit	Notes
Human	None	Safe	—	—	Default; can trade, eat normally
Vampire	1.8×, Speed, Jump I, Haste	Burns (1 dmg + fire)	3600t	0.25	Wooden tools kill; can be infected; needs sire
Vampire Lord	2.5×, +Strength I, Fire Resist, Resistance, Invisibility, Regen 60/1, Water Breathing	Immune	7200t	0.40	Created by Prince blood; iron-blocked
Vampire Prince	3.5×, +Absorption I, Glowing, Levitation, Slow Falling, Dolphins Grace, Conduit Power, Night Flight, Royal Blood Call	Immune	9000t	0.60	Direct child of Progenitor only; unlimited Princes; 3.0× vs Vampire/Lord; can create Lords
Vampire Progenitor	5.0×, +Health Boost II, God Strength II, God Speed II, God Regen II, Saturation, Divine Luck, Eternal Night	Immune	12000t	0.80	Only ONE may exist (admin-only); 5.0× vs ALL vampires; commands entire bloodline; no order cooldown

Prince and Progenitor also gain all lower-tier abilities via ordinal inheritance.

[HR][/HR]

Commands

Command	Description
/vampire help	Show help
/vampire guide (/vampire codex, /vampire book)	Receive the 58-page Vampire Codex
/vampire holyward [amount]	Get Holy Ward Potion (Humans only)
/vampire stats	View role, blood, turned, sun immunity
/vampire ability list	List available abilities with ON/OFF/Active state
/vampire ability <name>	Toggle a potion ability or trigger active royal_blood_call
/vampire blood <amount>	Create blood bottle for yourself (costs blood)
/vampire blood <amount> <player>	Send bottle to player within 5 blocks
/vampire infection <on/off>	Toggle bite infection
/vampire maker	View your maker / active order
/vampire maker <player> <come|sheep|cow|sun|blood> [seconds]	Order your progeny (10–600s, default 120s)
/vampire admin infect <player>	Infect a Human → Vampire
/vampire admin turnVampire <player>	Turn (or demote Lord) → Vampire
/vampire admin turnVampireLord <player>	Turn → Vampire Lord
/vampire admin turnPrince <player>	Turn → Vampire Prince
/vampire admin turnProgenitor <player>	Turn → Progenitor (fails if one exists; remove old first)
/vampire admin giveblood <player> <type> <amount>	Give any vampire blood bottle (vampire/lord/prince/progenitor)
/vampire admin holyward <player> [amount]	Give Holy Ward Potion
/vampire admin remove <player>	Strip to Human

Blood Bottle Matrix

Drinker \ Creator	Vampire	Lord	Prince	Progenitor
Human	Vampire 10%+2%/blood	Vampire 25%+3%	Lord 40%+4%	Prince 60%+5%
Vampire	+blood	Sun immunity 3 days (BossBar)	→ Lord 80%	→ Prince 90%
Vampire Lord	+blood	+blood	+blood	→ Prince 90%
Prince/Progenitor	+blood	+blood	+blood	+blood

Bottles store blood_creator_role + blood_creator_uuid + blood_amount in PDC; successful transforms set makerUuid to sire for true lineage.

Maker Orders & Hierarchy

Order	Description
come	Progeny comes to maker (≤3 blocks)
sheep / cow	Bring animal to maker (32 block search, 8 block maker radius)
sun	Step into sunlight (checks isInSunlight)
blood	Drink maker’s blood → Vampire→Lord (Lord sire) / Vampire/Lord→Prince (God sire)

Who can command whom:

• Progenitor → any Vampire, Lord, or Prince (ignores maker, 0 cooldown, broadcasts ascension)
• Prince → Vampire & Lord (any, ½ cooldown = 36000t)
• Lord/Vampire → only own Vampire progeny (≤ 3 day cooldown = 72000t)
• Lords are exempt from being ordered by lower ranks; Progenitor cannot be ordered.

Royal Blood Call ( royal_blood_call, Prince+, active): /vampire ability royal_blood_call → sends every online vampire in your bloodline (recursive makerUuid chain) a message: "<Target>, your Vampire Prince <Prince> needs you at <x, y, z in world>!" + particles/sound; 5 min cooldown ( lastRoyalBloodCallTick persisted).

[HR][/HR]

Becoming a Vampire Lord (Prince Blood)

1. Find a Vampire Prince willing to share blood — there is no altar
2. Human + Prince blood → Lord (40%+4%/blood); Vampire + Prince blood → Lord (80%)
3. Or Prince bite infection, a maker blood order from a Prince, or admin: /vampire admin turnVampireLord / /vampire admin giveblood
4. Lords serve their Prince — Princes deal 3.0× weakness damage to Lords

[HR][/HR]

Permissions

Permission	Description	Default
vampire.admin.*	All admin	op
vampire.admin	Admin base	op
vampire.admin.infect	infect	op
vampire.admin.turnvampire	turnVampire	op
vampire.admin.turnvampirelord	turnVampireLord	op
vampire.admin.turnprince	turnPrince	op
vampire.admin.turnprogenitor	turnProgenitor	op
vampire.admin.giveblood	giveblood	op
vampire.admin.holyward	holyward	op
vampire.admin.remove	remove	op
vampire.human	Auto-set Human	false
vampire.vampire	Auto-set Vampire	false
vampire.vampirelord	Auto-set Lord	false
vampire.prince	Auto-set Prince	false
vampire.progenitor	Auto-set Progenitor	false

Auto-set via PermissionAttachment on applyRoleEffects, join, and enable — Works with LuckPerms (check has_permission:vampire.prince).

[HR][/HR]

Placeholders (PlaceHolderAPI, softdepend)

For ConditionalEvents LuckPerms groups, use %vampireplugin_role% == Vampire Prince etc — not is_vampire (true for Lord/Prince/God). Example config in ConditionalEvents-Config.yml handles 5 roles without flicker.

[HR][/HR]

Installation

1. Download VampirePlugin-1.1.2.jar (or build)
2. Drop into plugins/; also drop OptionalPlugins/PlaceholderAPI-2.12.3.jar into plugins/ if you want placeholders
3. Restart; edit plugins/VampirePlugin/config.yml

Requirements

• Paper 1.21.4+
• Java 21+
• Optional: PlaceHolderAPI, LuckPerms, ConditionalEvents

[HR][/HR]

Building from Source
JAR → target/VampirePlugin-1.1.2.jar (PlaceholderAPI system scope from OptionalPlugins/)

[HR][/HR]

Configuration (config.yml)

• vampire / vampire-lord / vampire-prince / vampire-progenitor — sun-immune, strength-multiplier (1.8/2.5/3.5/5.0), infection-chance (25/35/45/90), hunger-ticks (3600/7200/9000/12000), blood-per-hit (0.25/0.4/0.6/0.8), max-blood (20/30/40/50), weakness-multiplier (Prince 3.0 vs V/L, God 5.0 vs all), only-one (God)
• blood-bottle — max-amount 20, give-range 5.0, transform (vampire 10/2, lord 25/3, prince 40/4, progenitor 60/5), upgrade (prince-to-lord 80, progenitor-to-prince 90)
• blood-values — per EntityType (e.g., Warden 10, Iron Golem 8)
• iron-barrier — enabled, require-complete-enclosure (blocks Lord+ via flood-fill)
• orders — default/min/max-duration, come-distance, animal-distance/radius
• messages — all prefixes, infection, blood, hunger, iron, sun

[HR][/HR]

How It Works

Blood System
hunger bar 0–20 = blood. Hit living mobs bare-hands to feed ( mob value × blood-per-hit). Undead = 0, no eating. Vampires at 0 food take 1 dmg if Vampire. Hunger drains via BloodManager:checkHunger on scheduler.

Sun Damage
Only isSunVulnerable takes 1 dmg + 20t fire in NORMAL world, daytime ( 0–12300/ 23000–24000), sky light ≥8, no overhang. Vampire burns (but can have 3-day immunity BossBar purple SUN_IMMUNITY_DURATION 72000t); Lord/Prince/God immune ( config sun-immune true).

Ability System
AbilityManager:24 abilities (4 Vampire +6 Lord +7 Prince +7 God). Inherited by ordinal. /vampire ability list shows ON/OFF (or Active for royal_blood_call). VampireManager:syncEffects ( Integer.MAX_VALUE duration) only for isAbilityToggled. Checked on join/respawn/enable. clearPotionEffects removes all 21 types.

Maker & Bloodline
makerUuid set on infection or successful bottle transform (now via blood_creator_uuid PDC). OrderManager:createOrder respects hierarchy + cooldown + isInBloodline recursion for Prince/God. DRINK_BLOOD order elevates via VampireManager:elevate... or direct applyRoleEffects for Prince/God.

Codex
/vampire guide gives GuideBookManager:12 WRITTEN_BOOK ORIGINAL titled Vampire Codex by The Progenitor, 58 pages — each ≤14 lines, ≤20 chars/line (~114px), <1023 chars — covering hierarchy lore, creation matrices, weakness/strength charts, ascension, orders, and full ability lists.

[HR][/HR]