Changelog
Last updated August 16, 2026
Patch notes for the Minecraft server plugin.
WerePires 1.15.12 test build · complete fork history from VampireSMP 1.0.6
The short version. Everything that matters, nothing that doesn't.
The big three
- Werewolves are in. A third faction alongside vampires and humans, with their own stages, their own hunger, and their own weakness to silver.
- Death isn't the end. Die permanently and you can stay on as a ghost, haunting the living. There is also a ritual to bring ghosts back.
- Vampires can take thralls. Humans who drink vampire blood become bound to that vampire, with everything that implies.
Also new
- 18 new abilities: 7 for vampires and 11 registered human tomes.
- Humans get roles: Vampire Hunter, Tracker and Medic, handed out at the start to people who opted in.
- Beacons are a three way war now. Werewolves can claim them too.
- Your skin changes automatically as you turn and rank up. You can now
keep your current look when your vampire tier drops with
/skin tierdown off. - Cellphones are native now. Contacts, offline messages, calls, social feeds, groups, GPS, notes and seven games all live in one in-game phone.
- A setup wizard when you first join, which is also where you set what roleplay you are and aren't up for.
- The command guide is complete. Every player command is explained in the Player tab, and every staff command is explained in the Admin tab.
The server now needs a client mod to join. Without it you get disconnected a few seconds after connecting. See Getting started.
Want the detail? The Player tab covers gameplay and every command available to players. The Admin tab covers every staff command, configuration and the bug fixes.
How the new systems actually work, and what changed about the old ones.
Werewolves
A third faction with three stages of its own.
Two ways to be turned
By biting. A werewolf sneaks and holds onto you for 15 seconds. You are warned at 10 seconds and it completes at 15. If either of you moves more than 3.5 blocks apart, or the werewolf stops sneaking, it fails. Only one wolf can bite you at a time.
When a werewolf lands what would be a killing blow with bare hands, you do not die. You are left at half a heart, turned into a Stage 1 werewolf, and given regeneration. A werewolf punching you to death does not kill you. It recruits you.
Hunger
Your hunger is shown on your experience bar. It drains from full to empty in about 20 minutes, and eating meat fills it, roughly ten pieces from empty. Fill it to be promoted a stage; let it empty and you drop one. After any stage change you get 15 minutes before it starts draining again.
Only meat counts: beef, pork, chicken, mutton, rabbit, salmon, cod, tropical fish and rotten flesh, raw or cooked.
Claws, packs and silver
- Bare fists hit harder as you rank up. No bonus at Stage 1, then ×1.5 at Stage 2 and ×2.5 at Stage 3, with a sweeping strike and a growl from Stage 2.
- Pack bonus. Werewolves within 20 blocks of each other are buffed automatically. Hunt together and you are stronger.
- Silver weakness. Iron weapons deal ×1.75 damage to a werewolf.
- Feral Charge (Stage 2+) launches you forward, 12 second cooldown.
Use
/pow wability.
Beacons: a three way war
Werewolves have their own beacon state, Primal, and claim beacons just as humans claim Holy and vampires claim Desecrated. The majority bonus now compares all three factions, and whichever side leads is rewarded based on how far ahead of second place it is.
Standing within 3 blocks of a beacon as an enemy of whoever is claiming it stops the claim outright, and every faction counts the other two as enemies. A vanished vampire does not block anyone, since breaking cover is the cost of interfering.
The barrier
The wall around the playable area was rebuilt.
- Spectators and ghosts pass straight through instead of being shoved around by it.
- Riding a horse or boat into it dismounts you rather than rubber-banding you and your mount.
- You cannot mount up within 2 blocks of the barrier.
- Staff can raise and lower it, and can let specific people out or keep specific people in.
The escape conditions are unchanged: cured vampires can always leave, vampires can leave once every beacon is desecrated and no survival humans remain, and humans can leave once every beacon is holy and no survival vampires remain.
New vampire powers
Seven added, on top of Bat, Lunge, Vanish, Storm Call, Shadow Travel and Vampire Vision.
| Power | Stage | What it does | Cooldown |
|---|---|---|---|
| Bloodscent | 1 | Wounded humans within 40 blocks are marked with red motes only you can see. | 30s |
| Mist Form | 2 | Surge up to 8 blocks forward through walls, briefly untouchable on landing. | 30s |
| Sanguine Bite | 2 | Bite the human in front of you. Deals 2 hearts, heals you 3, slakes your thirst. | 20s |
| Call the Swarm | 2 | A swarm of bats blinds and harries every human within 10 blocks. | 60s |
| Hypnotic Gaze | 3 | Cloud a human's mind with slowness and blindness. Garlic breaks your hold. | 45s |
| Crimson Veil | 3 | A blood mist that mends vampires and weakens humans. | 120s |
| Sire's Command | 3 | Your bonded thralls gain strength and swiftness. | 90s |
The older powers changed too:
- Vanish now tells you how many attacks you have left before it breaks, and cannot be used in bat form.
- Storm Call warns you 60 seconds before the storm runs out, so you are not caught in daylight.
- Bat form lasts 3 minutes at Stage 3, up from 2.
- Shadow Travel can be set to require full health.
New tome abilities
Eleven registered for humans, several of them direct answers to the new vampire powers.
| Tome | What it does | Cooldown |
|---|---|---|
| Consecrate Ground | Humans nearby are mended, vampires seared and weakened. | 2 min |
| Blessed Blade | Your strikes against vampires hit 50% harder and leave them weakened. | 90s |
| Daybreak | A shaft of daylight. Vampires caught in it burn as if in the sun. | 2 min |
| Sanctuary | A warding light that shields you and nearby humans. | 2 min |
| Cleansing Smoke | Garlic smoke. Vampires are flung back and weakened, humans shielded. | 90s |
| Hunter's Mark | Brand a vampire up to 24 blocks away. They glow for everyone to see. | 90s |
| Last Vigil | A desperate stand: resistance, regeneration and absorption. | 2 min |
| Fire Breath | A cone of flame 8 blocks long that ignites everything in front of you. | 10 min |
| Magic Fire Breath | The longer, tighter, stronger fire variant. Old BlueFireBreath data still works. | 15 min |
| Scrying | Points your vampire-indicator arrow at a named target for a limited time. | 3 min |
| Fading | Eases your compatibility-mod opacity to a chosen level or toggles fully faded. | None |
Holy Word also changed: a paralysed vampire can no longer climb onto a horse or into a boat to escape it.
Fae bargains
Staff can mark a player as Fae, unlocking bargains that pin a human to a chosen vampire stage. A bargain can optionally be tied to the Fae's permanent life; when that Fae dies, the deal breaks according to server settings. Bargains can also govern death counts, turning permission and whether the target may be turned.
- Fae-created vampires cannot promote or demote outside their bargained stage.
- They keep a safe minimum blood value instead of repeatedly crossing a stage boundary.
- Staff can choose whether a broken bargain restores humanity, marks the player cured, or merely removes the stage lock.
Cellphones
The old CellPhone Skript has been ported into the plugin. Hold the phone and right-click to open it; shift-right-click another player to add their active character as a contact. See the complete cellphone guide for controls and limits.
- Communication: favorites, nicknames, blocking, offline direct messages, unread totals, paging, transcript exports, group chats and character-based social handles.
- Calls: private/group Simple Voice Chat calls, DND, mute, deafen, missed calls and two-way speakerphone without replacing proximity chat.
- Utilities: 50 GPS pins with sharing and direction tracking, 100 private notes, nine phone colors and per-player notification/refresh settings.
- Games: Blackjack, Higher or Lower, Memory, 112-word Wordle, Connect Four, Tic-Tac-Toe and Rock Paper Scissors, with chips, wagers, records and leaderboards.
- Migration: all eight legacy Skript YAML files import once into atomic
phone-data.json; the originals are kept as a recovery source.
Thralls and blood bonds
A vampire can bottle their own blood, and a human who drinks it becomes that vampire's thrall. The bond deepens with each dose: 1 bottle reaches Stage 1, 3 reaches Stage 2, 6 reaches Stage 3. A vampire can hold up to 3 thralls, and a thrall can be bound to two masters at once.
Orders do not always work. The chance depends on the bond: 50% at Stage 1, 80% at Stage 2, guaranteed at Stage 3. Masters can command, root, punish and track their thralls.
Being a thrall costs you:
- Withdrawal. An hour after your last dose a countdown starts, then recurring poison until you are fed again.
- Separation anxiety (Stage 2+) if you stray more than 150 blocks from your master.
- Holy water weakens the bond, two bottles' worth per splash.
- At Stage 3 you get a choice: swear yourself to vampirism, or don't.
You choose what you are open to during setup: open to being a thrall, open to owning one,
open to both, please don't, or you can try but may not succeed. Anyone can check with
/thrall preferences list before dragging you into a plot you did not want.
Blood bottles
Three kinds of blood now, and who you are decides what happens when you drink one. All of them are drunk rather than thrown.
| Blood | Vampire | Thrall | Anyone else |
|---|---|---|---|
| Vampire blood | Drinkable, with the bonding effects | Deepens the bond | Recoils |
| Thrall blood | Quenches thirst, thinly | Regeneration and saturation | Refuses |
| Plain blood | Quenches thirst properly | — | Refuses |
Human roles
Humans are no longer identical. Three roles are handed out at random to players who opted in. Hunter and Tracker are mutually exclusive, and any role is lost the moment you become a vampire.
| Role | What you get | Timings |
|---|---|---|
| Vampire Hunter | /findvampires makes nearby vampires glow. The glow is visible to everyone, not just you, so the hunt is loud. | 10s scan, 5 min cooldown |
| Tracker | Right-click to lock your compass onto a target and follow them. | 4 min window, 5 min cooldown |
| Medic | The support role. | — |
Ghosts and haunting
Dying permanently no longer means logging off. You choose between being a normal spectator or haunting the lands: flying, invisible, passing through walls, still part of the story.
- You cannot break or place blocks, use items, or pick things up.
- You can open doors, levers, buttons and chests, enough to rattle a room, but not move anything in or out.
/ghost show <player>reveals you to one person only./ghost haunt <player>routes your voice chat to that person alone.
The Rite of Return
A ritual that drags a ghost back into the living world. Four books teach it, and reading them is how you learn the conditions: it needs vampire blood, it must happen at night, it requires a desecrated beacon, and the fourth book reveals the price.
The reviver holds a vial of vampire blood, stands at a desecrated beacon with the ghost within 25 blocks, and performs it after dark. What comes back is up to staff: a vampire, a human, a thrall, or a ghoul.
A soul that came back wrong. Permanently 7 hearts instead of 10, unable to use tome abilities at all, and bound to the vampire whose blood paid for the ritual.
Other things you will notice
- The cure traces your bloodline. It no longer stops at your direct sire; it walks up the chain as far as staff have configured. A sire in spectator mode breaks the chain.
- Vampires can no longer gain Strength from any source.
- You cannot feed on a player who is not in survival mode, and a feed in progress is cancelled if they leave it.
- Turning switches off automatically after a new vampire is made, so turns cannot chain instantly through a group.
- Permanent death is announced anonymously, with no name attached.
- Selected tome abilities can survive turning. Staff can allow named abilities (or all of them), and separately decide whether physical tome items remain usable.
- You can permakill yourself with
/pow permakill, behind a confirmation. - Vampires respawn at the crypt. Humans keep their bed only if it is in the world currently running.
- Silver arrows. A silver (iron) ingot on top, a stick in the middle, an arrow at the bottom, vertically, gives 2. They are spectral arrows without the glow, so you can shoot without lighting your target up for the whole server.
- Real vault blocks around the map hold tome and cure books, opened with Trial Keys, once per player.
- Your skin changes as you rise and fall through the vampire stages, and
is restored when you are cured. Register your own with
/skin register. Use/skin tierdown offif promotions should change your skin but demotions should keep the look you already have; the choice survives reconnects.
Every player command
These are all commands players can use. Some only work while you are a vampire, werewolf, Fae, thrall, master, ghost, role holder, or after learning the matching ritual.
Core, abilities and personal settings
/pow [help] | Show the in-game WerePires command help. Root aliases: /vampiresmp and /vsmp. |
/pow vability [list|all|<ability>] | List or use vampire powers available at your current stage. |
/pow wability [list|all|feralcharge] | List or use werewolf powers; Feral Charge requires the configured stage. |
/pow tome [list|<ability>] | List or use human tome abilities you have learned. |
/pow beaconstatus | Show current Holy, Desecrated and Primal beacon influence. Aliases: holysites, holy. |
/pow texture [vampire|human] | Apply or refresh your appropriate resource pack. Aliases: texturepack, resourcepack. |
/pow permadeath <on|off|absolute> | Set your permanent-death preference. Aliases include toggle-permadeath, toggle_permadeath and togglepermadeath. |
/pow permakill | Permanently kill your own character after confirmation, when enabled. |
/pow toggle-turning | Enable or disable your ability to turn humans. Alias: turning. |
/pow sendmessage | Send the pending roleplay chat message. Alias: sendpendingmessage. |
/pow reopen | Reopen a pending forced-cure choice. Alias: forcedcure-reopen. |
/pow ability [list|status] | Show which tome abilities and items survive being turned. |
/pow ability check [player] | Show which learned abilities the selected player can currently use. |
Fae bargains
/pow faedeal vampire <player> <stage> [true|false] | Bind a human to a fixed vampire stage; the optional value makes the deal end with the Fae's permanent death. |
/pow faedeal bargains | List bargains you currently hold. Alias: list. |
/pow faedeal release <player> | Break one of your bargains. Alias: free. |
/pow faedeal deaths <player> <get|set|add|remove> [n] | Inspect or change the death count of an allowed bargain target. |
/pow faedeal hearts <player> <get|give|take> [n] | Inspect or change that same counter as remaining hearts. |
/pow faedeal canturn <player> <vampire|werewolf> <allow|deny|status> | Control whether the target may turn others. |
/pow faedeal canbeturned <player> <vampire|werewolf> <allow|deny|status> | Control whether the target may be turned. |
/pow faedeal turnlocks <player> | Show all four vampire/werewolf turn locks. |
/pow faedeal help | Show Fae bargain help. The whole command also accepts the alias /pow fae. |
Thralls and blood bonds
/thrall | Show the commands available for your current thrall/master state. |
/thrall bondinfo thrall <player> | Show your bond with one of your thralls. |
/thrall bondinfo master | Show your own masters and bond stages. |
/thrall findmaster | Locate your master when the bond permits it. |
/thrall findthrall <player> | Locate one of your thralls. |
/thrall list | List your current blood-bond relationships. |
/thrall command <player|all> <message...> | Issue an order to one or all of your thralls. |
/thrall punish <effect> <player> | Apply an available bond punishment to your thrall. |
/thrall bar <Dose|Withdraw|Unthrallment|on|off> | Choose or toggle your thrall progress boss bar. |
/thrall stay <seconds> <player> | Order a thrall to remain in place for a limited time. |
/thrall check <player> | Inspect the visible bond status for a player. |
/thrall thrallcount | Show how many thralls you own and your limit. |
/thrall force <player> | Send a forced blood-bond offer when your role permits it. |
/thrall profile create <name> <taste> | Create a character blood profile. |
/thrall profile select | Select the active character profile. |
/thrall profile list | List your character profiles. |
/thrall profile delete <number> | Delete one of your character profiles. |
/thrall preferences list | List players by their thrall-roleplay preference. |
/thrall preferences <player> | View one player's thrall-roleplay preference. |
Roles, setup, skins and ghosts
/role <vampire_hunter|tracker|medic> <optin|optout> | Join or leave the eligible pool for a human role. |
/vampire <optin|optout> | Join or leave the pool for starting-vampire selection. |
/findvampires | As a Vampire Hunter, scan for and reveal nearby vampires. |
/playersetup | Open your character and roleplay-preference setup wizard. |
/starterkit [edit] | Claim your starter kit; use edit to open your personal kit settings. |
/skin register <stage> | Save your current skin for human, stage1, stage2, stage3, cured or ghost. |
/skin apply <stage> | Manually apply one of your registered stage skins. |
/skin clear <stage> | Remove your saved skin for a stage. |
/skin list | Show which stage skins you have registered. |
/skin tierdown <on|off> | Choose whether an automatic vampire-tier decrease changes your skin. With it off, tier-ups still switch automatically and the preference is remembered. |
/ghost show <player> / hide <player> | Reveal your ghost to, or conceal it from, one player. |
/ghost showall / hideall | Reveal yourself to, or hide from, everyone. |
/ghost list | List living players who can currently see you. |
/ghost haunt <player> | Send your Simple Voice Chat audio only to one haunted player. |
/ghost unhaunt | Stop voice-haunting your target. Alias: stop. |
/ghost setfree | End your haunting and continue as a normal spectator. |
Rituals and cellphone calls
/voluntate-mea-hoc-nefandum-vinculum-abicio | Perform the learned self-cure ritual when all conditions are met. |
/hoc-vinculum-tibi-dirumpo-mala-creatura <player> | Perform the learned forced-cure ritual on a vampire. |
/sanguine-et-nocte-te-ex-umbra-revoco <player> | Perform the learned Rite of Return on a nearby ghost. |
/cellphone | Open your native cellphone interface. |
/checkphonestatus | Check whether your inventory contains a native phone. |
/answer | Answer an incoming call. Alias: pickup; internal alias: cpacceptcall. |
/decline | Decline an incoming call. Alias: reject; internal alias: cpdeclinecall. |
/hangup | Leave or cancel a call. Aliases: cphangup and legacy cphanghup. |
/callmute | Mute or unmute your microphone for the phone call only. |
/calldeafen | Mute or restore incoming call audio. |
/speaker | Toggle two-way speakerphone for your active call. |
Everything, including the things players never see. Assumes you have read the Player tab.
Before you update
With require-compatibility-mod: true (the default), anyone who joins without
it is kicked about five seconds after joining. It is what makes ghost
noclip and the skin system work. Staff with vampiresmp.modgate.bypass
(ops by default) are never checked. Turn it off if your players aren't ready.
1.0.6 stored live game state inside config.yml and re-saved it constantly
during a session, which strips every comment out of the file. State now
lives in a separate state.yml and migrates itself on first startup. Your
config.yml is only written when you deliberately change a setting.
Server version. Built against Paper 1.21.10, declaring 1.21.5 as the minimum. Several menus use Paper's native dialog windows, so an older Paper will not run it.
The plugin is renamed to WerePires. Bukkit now uses
plugins/WerePires/. On first startup, files missing there are copied from
plugins/VampireSMP/; current files are never overwritten and the old folder is
preserved as a backup. Permission plugins, soft-depends and scripts that use the old plugin
name still need checking.
Config compatibility. Every 1.0.6 setting still exists, spelled the same. Hundreds of new settings use defaults matching the old hardcoded behavior, so an old config keeps working while gaining the new sections.
Starting a game: /pow admin init
Rebuilt from a single chest menu into a full wizard. It opens with a warning listing what init destroys (player tags and inventories, all beacons neutralised, session reset, everyone teleported, new vampires assigned), then walks through vampire assignment mode, vampire count or min/max, a paged player picker, role counts, session mode, half length, series break, build phase, break schedule, break duration, break looping, what happens after the break, starter kits, and a final confirm. Nothing applies until you confirm.
Every admin command
This is the complete staff command reference, including administrative subcommands that do
not live under /pow admin. Normal player commands remain in the Player tab.
Sessions, factions and player state
/pow admin | Show the complete in-game staff command help. |
/pow admin init | Open the full new-game initialization wizard and reset workflow. |
/pow admin session <start|pause|end|prime|resume|building> | Move the server between session phases. |
/pow admin vampire <player> <human|1|2|3|turn> | Set human/vampire state, stage, or force a turn. |
/pow admin vampire <player> <clearcap|clear_stage_cap> | Remove a vampire stage cap. |
/pow admin vampire <player> <clearban|clear_promotion_ban> | Remove a vampire promotion ban. |
/pow admin werewolf <player> <human|1|2|3> | Set human/werewolf state or stage. |
/pow admin werewolf <player> <clearcap|clear_stage_cap> | Remove a werewolf stage cap. |
/pow admin werewolf <player> <clearban|clear_promotion_ban> | Remove a werewolf promotion ban. |
/pow admin onehumanleft | Toggle One Human Left mode and its beacon-cooldown behavior. |
/pow admin setupplayer <player> | Give one player the standard starter items. |
/pow admin resetplayer <player> [true|false] | Return a player to fresh state, optionally clearing their inventory. |
/pow admin permakill <player> | Force a player's permanent death. |
/pow admin sire <player> | Inspect a player's sire. |
/pow admin sire <player> clear | Remove their sire relationship. |
/pow admin sire <player> <sire> | Assign a sire relationship. |
/pow admin deaths <player> <get|set|add|remove> [n] | Inspect or change a death counter. |
/pow admin hearts <player> <get|give|take> [n] | Inspect or change the same counter as remaining hearts. |
Abilities, turning, Fae and combat
/pow admin vampirecooldowns <reset|clear> [player] | Reset vampire ability cooldowns for one player or everyone online. |
/pow admin resettomecooldowns | Reset tome cooldowns for all humans. |
/pow admin vampirehealthcheck <get|set> [ticks] | Inspect or change the vampire health-check interval. |
/pow admin damagesuppression <get|set> [percentage] | Inspect or change global damage suppression. |
/pow admin fixattributes [all|player] | Repair stuck health, speed and other attribute modifiers. |
/pow admin clearbloodmoonbuffs <all|player> | Remove stuck Blood Moon attribute buffs. |
/pow admin fae list | List every Fae and their bargain count. |
/pow admin fae <player> [add|grant|on] | Grant Fae status. |
/pow admin fae <player> <remove|revoke|off> | Revoke Fae status. |
/pow admin fae <player> status | Inspect Fae status. |
/pow admin canturn <player> <vampire|werewolf> <allow|deny|status> | Control whether a player may turn others. |
/pow admin canbeturned <player> <vampire|werewolf> <allow|deny|status> | Control whether a player may be turned. |
/pow admin turnlocks <player> | Show all four turning locks for a player. |
/pow ability allow <ability|*> | Allow one or every tome ability to survive turning. |
/pow ability deny <ability|*> | Remove an ability from the survive-turning allow-list. |
/pow ability <enable|disable> | Toggle the survive-turning system globally. |
/pow texture all | Apply the vampire resource pack to every online vampire. |
/pow texture force | Force-apply the vampire resource pack to yourself. |
Beacons, worlds, barrier and server events
/pow admin beacon add <name> [radius] | Add a beacon at your location. |
/pow admin beacon <remove|delete> <name> | Remove a named beacon. |
/pow admin beacon list | List every beacon. |
/pow admin beacon info <name> | Show detailed state for one beacon. |
/pow admin beacon stats | Show faction-wide spiritual influence totals. |
/pow admin beacon reload | Reload beacon data from disk. |
/pow admin beacon validate | Check for invalid beacon records. |
/pow admin beacon <holy|desecrated|desecrate|neutral> <name> | Force the named beacon to a faction or neutral state. |
/pow admin beacon <fix|repair> | Repair missing beacon item displays. |
/pow admin beacon refresh | Force-refresh all beacon displays. |
/pow admin beacon cleanup | Aggressively remove stray beacon display entities. |
/pow admin beacon clearcooldowns | Clear beacon conversion cooldowns. |
/pow admin beacon debug [name] | Print display diagnostics for all beacons or one named beacon. |
/pow admin barrier <lower|raise|status> | Lower, raise or inspect the playable-area barrier. |
/pow admin barrier exempt <player> | Let a player leave even while the barrier is raised. |
/pow admin barrier unexempt <player> | Keep a player inside even while the barrier is lowered. |
/pow admin barrier normal <player> | Return a player to the standard barrier rules. |
/pow admin loadworld <name> | Hot-swap to a named world template. |
/pow admin listworlds | List available world templates. |
/pow admin set_vampire_spawn [x y z] | Set the vampire respawn location at your position or coordinates. |
/pow admin bloodmoon <start|stop|status> | Start, stop or inspect the Blood Moon event. |
/pow admin break_warning | Play the configured session-break warning sounds. |
/pow admin spawnanimals | Trigger passive animal spawning immediately. |
/pow admin removeendermen <all|toggle|status> | Remove loaded Endermen or control spawn prevention. |
/pow admin fadestatus | Show live Fading/opacity synchronization status. |
Tomes, cure books, revival books and vaults
/pow admin givetome <player> <ability> [amount] | Give physical tome books for an ability. |
/pow admin select_tomes <player> | Open the tome-ability grant menu for a player. |
/pow admin give_cure_book <player> <1|2|3|4> | Give one of the four cure books. |
/pow admin give_revival_book <player> <1|2|3|4> | Give one of the four Rite of Return books. |
/pow admin distributetomes | Run the configured tome distribution immediately. |
/pow admin addtomechest | Add your current location as a tome-chest spawn. |
/pow admin removetomechest | Remove the nearest tome-chest location. |
/pow admin listtomechests | List and teleport to configured tome-chest locations. |
/pow admin addtomevault | Add the block you are looking at as a tome vault. |
/pow admin removetomevault | Remove the targeted tome vault. |
/pow admin listtomevault | List tome vaults. Alias: listtomevaults. |
/pow admin addominouscurevault | Add the targeted block as an ominous cure-book vault. |
/pow admin removeominouscurevault | Remove the targeted ominous cure-book vault. |
/pow admin listominouscurevaults | List ominous cure vaults. Alias: listominouscurevault. |
/stash_third_book | Place Cure Book 3 in its legacy map chest. |
/stash_fourth_book <x> <y> <z> | Place Cure Book 4 into the chest at the supplied coordinates. |
Configuration, roles, kits and scheduled sessions
/pow admin config [gui] | Open the in-game configuration editor. |
/pow admin config get <path> | Read a configuration value. |
/pow admin config set <path> <value> | Change and save a configuration value. |
/pow admin config list [prefix] | List configuration paths, optionally below a prefix. |
/pow admin config reload | Reload configuration through the editor. |
/pow admin reloadconfig | Reload the plugin's config.yml directly. |
/rolecfg | Open the human-role configuration menu. |
/rolecfg <enable|disable> <role> | Enable or disable a human role. |
/rolecfg cooldown <minutes> | Set the role-assignment cooldown. |
/rolestart <role|all> | Assign one role or fill every enabled role. |
/role cooldownreset <role> [player|@a] | Reset role cooldowns. |
/role clearlist <role> | Clear a role's opt-in pool. |
/role removeplayer <role> <player> | Remove one player from a role pool. |
/role sessionreset | Clear all human-role tags from online players for a new session. |
/vampire select <amount> | Select starting vampires from the opt-in pool. |
/vampire list | List the starting-vampire pool. |
/vampire clearlist | Clear that pool. |
/vampire removeplayer <player> | Remove one player from that pool. |
/gameadmin <add|remove> <player> | Add or remove a session game admin. |
/gameadmin <list|clear> | List or clear session game admins. |
/gamestart | Open the full session setup wizard. |
/gamestart timer | Show current series, break or phase timing. |
/gamestart cancel | Cancel/close the self-contained wizard flow. |
/gamestart sessionend | End the scheduled session. |
/gamestart resumesession | Resume the recorded series session. |
/gamestart breaktimer <start|stop> | Enable or disable the break timer. |
/kitstart / /kitstop | Enable or disable automatic starter kits. |
/kitall | Give the starter kit to everyone online. |
/starterkitgive <player> | Give one player a starter kit. |
/foodkitadd <player> / /foodkitremove <player> | Mark or unmark a player's food-kit record. |
/foodkitgive <player> | Give one player the food kit. |
Thralls, ghosts, skins and phones
/thrall checkconfig | Print the live thrall configuration summary. |
/thrall admin cooldownreset <player|@a> | Clear thrall cooldowns for one player or everyone online. |
/thrall admin reset <player|@a> | Sever and wipe thrall bonds. |
/thrall admin setowner <thrall> <master> [stage] | Create or replace a primary master bond. |
/thrall admin bondset <thrall> <stage> | Set the stage of an existing primary bond. |
/thrall admin forcesave | Save all thrall bonds and profiles immediately. |
/ghost setfree <player> | Release another player from haunting into normal spectator mode. |
/skin reload | Reload registered skin data for all online players. |
/cellphone give <player> | Issue a native phone. |
/cellphone open <player> | Open the phone interface for an online player. |
/cellphone reload | Reload phone data from disk. |
/givephone [player] | Issue a phone to yourself or another player. |
/phonegive <player|all> | Issue phones to one player or everyone online. |
/phonereset confirm | Clear session phone data while preserving settings and social handles. Alias: cpreset. |
World templates
Named map templates live in plugins/WerePires/worlds/, each carrying its own
config overrides, beacon layout and session defaults. /pow admin loadworld
swaps the live map without a restart: players are moved to a holding area, the world is
replaced, everyone is returned to the new spawn, and that world's settings are applied. An
_EXAMPLE folder is generated on first run.
New config sections
The original keys remain compatible, while hundreds of new controls replace hardcoded values.
The full list of new sections
| Section | Controls |
|---|---|
require-compatibility-mod | Whether players without the client mod are kicked. |
werepires-network | Network server identity and world-repository integration. |
ghost | Per-ghost view and simulation distance (lag control). |
messages | The anonymous permadeath broadcast, worded per side. |
allow.use.after.turned | Which tome powers and items may survive a vampire turn. |
fae | Bargain stages, life binding, reversion, staking and turn restrictions. |
vampire-indicator | New-vampire alert: duration, radius, tracker, minimum stage. |
vampire-skins | Automatic per-stage skin swapping. |
abilities.vampire.* | 7 new powers plus per-stage tuning for the old ones. |
abilities.tome.* | 11 registered new tomes plus full tuning for the original 15. |
cure | Distance, sire-line depth, cured-sire rule, daytime requirement. |
revival | Rite of Return: outcome, range, night requirement, book spawns, ghoul health. |
tome-chest-items | Which tomes, which enchantments, how many, plus extra items. |
vaults | Tome and ominous cure vault locations. |
iron-weakness | Repel distance and strength, weakness radius, level, duration. |
werewolf | The whole faction: combat, biting, pack bonus, hunger, abilities. |
thrall | Bonds, stages, obedience odds, withdrawal, anxiety, holy water, profiles. |
blood-draw | Who may collect animal blood. |
starterkit | Every kit component, per-character items, timing, broadcasts. |
server-resource-pack | Stacked pack URL, hash, prompt, required state and delivery delay. |
phone.calls.speaker | Two-way speakerphone enablement and listening/transmission radii. |
beacons.capture-radius | How close you must stand to capture a beacon. |
combat.* | Final Stand health cap, death score cap, per-death penalty. |
oakhurst.name | What the map is called in all player-facing text. |
passive-mob-spawning.mob-weights | Weighted animal spawn table. |
allow-self-permakill | Whether players may end themselves. |
Tuning that used to be hardcoded
- Every tome has two switches: enabled or not, and in the loot pool or
not. Stop the Bleeding ships working but unfindable, handed out with
/pow admin givetome. - Tomes can hook events, which is what makes on-hit abilities like Blessed Blade possible at all.
- All 15 original tomes now expose radius, durations, effect levels, damage and channel times.
- Vampire abilities take per-stage values for cooldown, duration, power and attack limits.
- An unknown tome name in the loot list now warns you by name at startup instead of silently producing empty chests.
Complete fork inventory
Audited against the supplied VampireSMP 1.0.6 JAR. This is the complete fork inventory, not a cellphone-only release: all 185 Java files and every changed build/resource file were checked, and the detailed ledger names every branch-changed source file.
Platform, data and compatibility
- Renamed the plugin to WerePires and added copy-only migration from
plugins/VampireSMP/toplugins/WerePires/, preserving the old folder and never overwriting current files. - Moved to Paper 1.21.10 APIs (1.21.5 minimum), Java 17 bytecode, a reproducible Maven shade build and an optional Simple Voice Chat dependency.
- Replaced decompiled embedded Gson sources with a declared shaded dependency.
- Added the compatibility-mod handshake, bypass permission, skin/ghost/Fading payloads, and the WerePires network/world-repository configuration.
- Moved mutable session state to
state.ymlwith migration, preservingconfig.ymlcomments. - Added in-game config editing/reloading, nonessential-log suppression, TESTBUILD naming, test-server scripts, compatibility patches and development/reference assets.
Vampires, humans, Fae and combat
- Added seven vampire powers and eleven registered human tome powers; exposed full tuning for them and all inherited abilities.
- Added per-stage Bat/Lunge/Vanish/Shadow Travel tuning, Storm Call expiry warning, new-vampire tracking, Strength immunity and survival-only feeding.
- Added persistent turn locks, optional tome abilities surviving a turn, Scrying, compatibility-mod Fading, and hidden tome identities.
- Added Fae bargains, stage pinning, life-bound deals, sire controls and configurable bloodline-aware cure rules.
- Added death/hearts administration, anonymous permadeath, player self-permadeath, vampire-kill thresholds, staking rules and Silver Arrows.
Factions, story systems and maps
- Added the complete Werewolf faction: biting, claw conversion, hunger, stages, pack bonuses, silver weakness, Feral Charge and Primal beacons.
- Added Thralls: primary/secondary bonds, blood progression, consent preferences, commands, withdrawal, separation anxiety, profiles, holy water and configurable blood draw.
- Added ghosts, selective reveal, voice haunting, performance limits, four-book revival, configurable outcomes and Ghouls.
- Added human roles, opt-in pools, setup/skin dialogs, starter kits and the full session initialization/build/break wizard.
- Added three-faction contested beacons, vaults, hot-swappable world templates, barrier exemptions/mount handling and blood-moon map-swap support.
Cellphone, voice and resource packs
- Added the native phone, eight-file Skript migration, contacts, DMs, social, groups, GPS, notes, settings, calls, speakerphone and seven games.
- Added 112 Wordle answers, correct duplicate-letter scoring, live multiplayer screen refreshes, persistent wagers/records and safe session reset.
- Fixed call audio capture/echo and kept normal proximity voice active alongside private call channels.
- Added plugin-managed resource-pack delivery, then unified it with vampire packs and changed it to a stable stacked pack so the server pack remains loaded.
- 1.15.9 scopes unread totals correctly, adds group unread totals, enforces call blocking, and fixes direct/missed-call character labels.
Release checkpoints
- 1.14.1–1.14.2: Vampire Blood drinking, Fae bargain fixes, Fire Breath compatibility, permadeath messages and command completion.
- 1.15–1.15.2: native cellphone parity, games, migration, private voice channels, mute/deafen/speakerphone and recursion protection.
- 1.15.3–1.15.5: pack delivery, character contact shortcut, microphone routing and removal of competing pack requests.
- 1.15.6–1.15.8: phone/game UI fixes, expanded Wordle and stacked packs.
- 1.15.9: phone privacy/counting fixes and this full-fork documentation audit.
- 1.15.10: source-level completeness audit, restored Blood Moon and legacy command paths, cure-book identity repair, and complete manager shutdown coverage.
- 1.15.11: whole-fork command, permission, listener, lifecycle, persistence and data-folder audit; additional routes restored, duplicate listeners removed, mutable state migrated and a repeatable source-audit script added.
- 1.15.12: persistent per-player
/skin tierdown on|off; players can keep automatic promotion skins without changing appearance on demotion.
Complete command and code audit
The branch name says cellphone, but the audit covers all 185 Java files. It checks every command route, permission, manager, listener, service, registration and shutdown hook.
Every command family
- Main:
/pow(aliases/vampiresmpand/vsmp) with help, vampire/werewolf/tome abilities, holy-site status, texture packs, permadeath, turning, pending messages, ability preservation, Fae deals, and the complete admin tree. - Admin tree: init/session, vampire/werewolf stages, beacons, cooldowns, Blood Moon, health checks, damage suppression, tomes, cure/revival books, vaults, starter setup, passive animals, player reset, vampire spawn, barrier, config, worlds, Fae, sire, turn locks, deaths/hearts and permakill.
- Thralls: bond info, master/thrall finding, lists, commands, punishments, boss bars, stay, checks, counts, forced offers, profiles, preferences and administration.
- Roles and sessions:
/role,/rolecfg,/rolestart,/vampire,/gameadmin,/findvampires,/playersetupand/gamestart. - Kits: kit start/stop/all, starter-kit settings/give, and food-kit add/remove/give.
- Identity and story: skin register/apply/clear/list/tierdown/reload; ghost show/hide/haunt/release; the two cure-book stash commands; and three Latin cure/revival ritual commands.
- Phone: give/open/status/reload/reset; answer, decline, hang up, mute, deafen and speakerphone, including published and legacy aliases.
1.15.10–1.15.12 omissions found and repaired
/pow admin bloodmoon <start|stop|status>had a handler, help text and tab completion but no Brigadier route. The route is restored.- Handler-supported aliases restored:
abilities,fae,toggle_permadeath,togglepermadeath, plural/singular vault forms, and beacondelete,desecrateandrepair. - The orphaned
/stash_third_bookand/stash_fourth_bookclasses are registered as admin commands. The third book now carries its hidden Cure Book 3 identity so it actually advances the reading sequence. StarterKitManager.shutdown()is now called on plugin disable, matching every other manager-owned final save/cleanup hook.- Restored explicit routes for
ability status,ability help, Faelist/help/free, and long-form vampire/werewolf stage-cap and promotion-ban aliases. - Corrected admin usage paths, command manifests, starter-kit access and role/session staff checks so declared permissions match runtime behavior.
- Centralized registration for Holy Word, the three Way tomes and Blood Moon attributes, preventing the same listener from firing twice.
- Moved active world/template and revival-unlock values into
state.yml, even when an older state file already exists, and added missing animal blood-draw defaults. - Added safe legacy-folder migration, corrected WerePires paths/branding and removed unused config accessors that implied settings with no runtime effect.
All branch-changed code areas
- Entry/build/resources: Maven build, plugin entry point,
config.ymlandplugin.yml. - Commands: ability preservation, Brigadier registration, admin dispatch, death/hearts, Fae, bargains, main routing, third-book stash, tome abilities and turn locks.
- Managers: config, Fading, Fae, session, thirst, tomes, turn locks, feeding, vampire stages and texture packs.
- Listeners: combat, death, experience bottles, joins, tome restrictions, werewolf bites and blood drinking.
- Tome code: common tome base, Fire Breath, Magic Fire Breath, Scrying and Fading.
- Phone code: legacy import, commands, calls, persistent data, seven games, item/event manager, dialogs and voice-chat transport.
- Network: client compatibility messages for skins, ghosts, Fading and related features; the custom TESTBUILD protocol remains intentionally disabled.
Bugs fixed from 1.0.6
Player-facing fixes
- Any renamed book counted as a tome. Books were identified by title, so an anvil could hand you any ability in the game. They now carry a hidden identity tag, and the fourth cure book is stamped properly too.
- Tome books could be destroyed in crafting. A recipe containing one now produces no result.
- Feeding used the wrong hand. The plugin checked both hands and preferred the main one, so off-hand clicks consumed the wrong item and holding items in both hands fired it twice.
- The turning toggle was forgotten on restart, so a vampire who had deliberately switched it off could return and turn the next human they killed.
- Stored armour could come back wrong. It was serialised with a generic object serialiser that does not round-trip Minecraft items; it now uses Paper's own.
- The immersion chat warning fired outside sessions, during downtime and build phases.
- Dead players were shoved by the world barrier, which exempted creative but not spectator.
- Holy Word showed the wrong message, telling a paralysed vampire they were being cured.
Admin-facing fixes
- config.yml comments were being wiped repeatedly during play. See the warning at the top.
- A command was hardcoded to a world named
worldand failed on any server whose main world is named otherwise. - Permadeath data errors failed silently. A missing, locked or corrupt file now logs a clear warning naming the file.
- Ghosts stayed stuck after a reset, rather than returning to survival.
- Blood moons now survive a map swap instead of assuming the starting world is still loaded.
Re-audited against the supplied VampireSMP 1.0.6 JAR and the current 1.15.12 source, class by class and system by system: 185 Java files, 35 Bukkit command roots, 58 listener-capable classes, 40 concrete abilities, 50 managers and 42 explicit lifecycle owners. Original configuration keys remain compatible while hundreds of new controls have been added.