Skip to content

Lycanthropy

dnocturne edited this page Jun 29, 2026 · 1 revision

Lycanthropy

Lycanthropy is a supernatural affliction that turns players into werewolves. Werewolves can take on a wolf-like skin, band together in clans led by an Alpha, and form alliances or rivalries with other clans and with vampires.

Features

  • Roles - Alpha, Beta, and Omega define your standing in werewolf society
  • Clans - Admin-defined packs that an Alpha grows and runs in-game
  • Transformation - Swap in your role's werewolf skin on demand
  • Alliances & Rivalries - Clans hold relations with other clans and with vampires

Becoming a Werewolf

Lycanthropy is granted by an admin, the same way as any other affliction. There is no bite or infection mechanic in this release.

/aff give <player> lycanthropy

A new werewolf starts as an Omega (clanless) until an Alpha invites them into a clan, or an admin assigns them as an Alpha of their own clan.

Roles

Role Description
Alpha The clan leader. One per clan. Manages members and relations.
Beta A clan member. Can challenge the Alpha for leadership.
Omega A werewolf with no clan. Holds no relations and cannot manage them.

Clans

A clan is a werewolf pack. Clans are defined by admins in clans.yml (their name and skins), but everything else happens in-game with no UUIDs to type:

  1. An admin adds a clan to clans.yml and reloads it.
  2. An admin assigns the first Alpha by name with /werewolf clan setalpha <clan> <player>.
  3. The Alpha grows and runs the clan: invite members, kick, and promote.

A clan's membership and current Alpha are tracked by the plugin in its database, not in clans.yml. The config file is read-only to the plugin and is never rewritten.

Joining a clan:

  • An Alpha runs /werewolf clan invite <player> on an online werewolf.
  • The invited werewolf accepts with /werewolf clan accept.

Leaving a clan:

  • A Beta runs /werewolf clan leave.
  • An Alpha must first transfer leadership with /werewolf clan promote <player> (which makes them a Beta) before they can leave.

Transformation

/werewolf transform

Toggles your werewolf skin on and off. Transforming swaps in the skin for your role (the Alpha skin, the Beta skin, or the global Omega skin) and toggles back to your normal skin. The change is session-only and is applied through SkinsRestorer.

Permission: afflictions.werewolf.transform

Skins

Each clan defines an Alpha skin and a Beta skin, and there is one global Omega skin for all clanless werewolves. Skins come from either a texture URL (for example a MineSkin link) or a raw value plus signature pair.

Skins require SkinsRestorer. Without it, /werewolf transform still toggles your transformed state, but your skin will not visibly change.

See Configuration for the skin formats and the clans.yml reference.

Losing Lycanthropy

Curing or removing lycanthropy makes you leave your clan and reverts your skin. If a cured player was an Alpha, the longest-standing remaining member is automatically promoted to the new Alpha.

In the Menu

Clicking Lycanthropy in the /afflictions menu opens a panel showing your clan, your role, the full pack roster, and a Relations card (allied vampires, allied clans, rival clans, and enemy vampires).

Commands

See Commands for the full /werewolf command reference, and Alliances for relations and the Alpha Challenge.

Configuration

See Configuration for the full lycanthropy.yml and clans.yml reference.

Clone this wiki locally