Supernatural

Supernatural turns survival Minecraft into a class-based RPG. Players choose one of nine supernatural races; each race comes with its own active abilities, passive effects, racial weaknesses, and a separate skill-point progression. Combat, mob behaviour, follower AI, chat, food, light exposure, and water all bend around the player's race.

Built on Spigot 1.16.5 with a soft requirement on Vault (economy/permissions) and packet-level work via ProtocolLib. At its peak the codebase sat at roughly 13,400 lines across 145 source files, last built in August 2021.

Each race occupies its own package of actions and is intended to play meaningfully differently, the ability kits and weakness profiles cover the whole spectrum from melee bruiser to support caster to nocturnal hunter. Click any race for the full breakdown.

• Action framework. Race-specific actives (HolySmite, VampireBite, BatTeleport, Hellish, Snare, Ghoulish, etc.) sat on top of a generic Action / Target / Damage / Input layer, so adding a new ability was a matter of dropping a class into the right race package and wiring the inputs.
• Skill-point progression. Each race had its own level/skillpoint pool, spent through a chest-GUI menu (SkillPointMenu) with /sn level, /sn skillpoints, and a respec command for refunding allocations.
• Spell hotbar. A custom spellbar with rendered spell icons let players swap and fire abilities from a dedicated bar rather than fighting for the vanilla hotbar.
• Bounty system. Players could place and check bounties on each other through /bounty, with kill rewards routed through Vault.
• Custom-followers system. A full pet/minion architecture covering eleven mob types, with custom pathfinder goals layered on NMS.
• Vampire infection. A VampireBite action spread the race virally, bitten players progressed through an infection state and eventually turned, courtesy of a SupernaturalInfectivity system.
• Race-aware combat. Damage modifiers, attacking restrictions, and entity-hostility tables let races be naturally hostile or peaceful to specific mobs and to each other, independent of the vanilla rules.
• Passive race effects. Vampires took sun damage with LightSensitivity; ghouls took rain damage; underwater races got UnderwaterMining and breathing perks via custom pathfinder goals; max-hearts pools differed per race (MaxHearts).
• Custom arrows & infinite quivers. The Witch Hunter line used CustomArrows and InfiniteArrows for race-flavoured ranged combat.
• Resurrection & recruitment. Race-flavoured respawn handling (RessurectionSpawn), RecruitingItems for converting NPCs/players, and RandomSpawnEntities for biome-tied race-themed mob spawns.
• Race chat prefixes. Players' race showed up next to their name in chat (RacePrefixes), and a PlayerSetRaceEvent let other plugins react when someone changed race.
• Packet-level intercepts. ProtocolLib was used for things vanilla events couldn't reach cleanly, most notably UnderwaterMining mining-speed adjustments.
• Telemetry. bStats integration via the bundled Metrics class.

Supernatural was the project where I learned, the hard way, how a codebase that grows organically can become its own ceiling. By mid-2021 the plugin worked, every race shipped, the followers system was running, vampires could infect, but the code underneath had calcified into a shape I couldn't add new systems to without grinding. So I started refactoring. Three times, across three years. None stuck, and the project's been quietly archived since.