Werewolf

Beware of the full moon! Werewolf adds a werewolf infection, three rival werewolf clans and the hunters who track them down.

How it works

Get bitten by a wolf or a werewolf at night and you may catch the werewolf infection. From the next night on, you turn into a werewolf whenever you're under the open sky. Stay inside at night to stay human. At dawn you turn back.

In wolf form:

• Your skin changes to your clan's werewolf skin, and you show up under a werewolf name in chat and the player list
• Other werewolves understand you; to everyone else your chat sounds like growling
• You hit hard with bare fists, move faster, jump higher and see in the dark
• You can't wear armor, but your thick hide takes much less damage
• You only eat meat, and you regain health from your kills
• You can /growl, /howl, and right-click a player to sniff their scent and follow it with /ww track
• Silver weapons and gold hurt you badly, and wolfbane can force you back into human form

Die in wolf form and you respawn as a human. The cure potion gets rid of the infection for good.

The clans

Every werewolf belongs to one of three clans. Bites pass on the biter's clan.

Clan · Infected by · Strength
Silvermane · A wild wolf's bite · Regeneration
Bloodmoon · A werewolf's bite · Strength
Witherfang · The infection potion · Extra speed and higher jumps

Clans earn points by hunting while in wolf form, more for slaying werewolves of rival clans. Clan members can see their clan with /ww clan, set and teleport to a clan home, and call their pack together.

Each clan is led by an alpha: the most senior werewolf of the clan. Alphas wear their own skin, hit twice as hard, take half the damage, and their howl stuns everything nearby. Kill the alpha as a clanmate and you take their place.

Maturity

Werewolves grow stronger with every full moon they transform under:

Level · Unlocks
2 · /ww intent: choose whether your bite infects
3 · You keep your items when you transform
5 · Sniff and track a player's scent
7 · Transform at will with /ww transform
10 · Gold no longer hurts you

All levels are configurable.

Werewolf hunters

• With Vault there is always a bounty on werewolves. Hunters can add to it, and /ww top shows the best hunters
• /ww hunt makes your compass point at the nearest werewolf
• Silver swords cut through a werewolf's defense
• Silver armor protects against werewolf attacks, and each piece makes it less likely a bite infects you
• Tracker compasses lock on to werewolves (and vampires) at night
• Wolfbane splash potions can force werewolves back into human form

The items can be crafted (each recipe can be turned off), bought from shop signs, or given by admins.

Installation

1. Run a Paper server on Minecraft 26.1 or newer, with Java 25.
2. Drop Werewolf-.jar into your plugins folder. Werewolf skins work without any other plugin.
3. Start the server and adjust plugins/Werewolf/config.yml. Every option is explained in the file, and /ww reload applies changes without a restart.

Upgrading from an older version? Your config is migrated automatically (a backup is kept) and your werewolves and clans carry over.

Optional plugins

• Vault: werewolf bounties and shop signs
• PlaceholderAPI: %werewolf_clan%, %werewolf_form%, %werewolf_level%, %werewolf_alpha%, %werewolf_moonphase% and more
• VampireRevamp: werewolves and vampires exclude each other
• WorldGuard, PvPManager, GriefPrevention: trackers and sniffing respect protected players; optionally PvP is forced on for werewolves trespassing in claims
• LibsDisguises or SkinsRestorer: not needed, but you can use one for the werewolf skins instead of the built-in skins (Disguises.Backend in config.yml)

Commands

Command · What it does
/ww · Werewolf info and your status
/ww help · Lists the commands you can use
/ww clan, /ww home, /ww sethome, /ww call · Clan info, clan home and calling your pack
/ww transform · Transform at will (mature werewolves)
/ww intent · Choose whether your bite infects
/ww track · Follow the scent you sniffed
/ww hunt, /ww bounty, /ww addbounty, /ww top · Hunting werewolves
/growl, /howl · Werewolf sounds
/ww infect, /ww cure, /ww setlevel, /ww setalpha, /ww setphase, ... · Admin tools

Permissions are listed in the plugin.yml.

For developers

Werewolf has a public API with cancellable events for infection, cure, transformation, level changes and new alphas. Get it from JitPack; see the README for examples.

Links

• Source code and issues (GitHub)
• Changelog and releases
• SpigotMC and Bukkit pages
• Statistics (bStats)

This plugin collects anonymous usage statistics through bStats. Server owners can opt out in plugins/bStats/config.yml.