Server event

Blood Moon

Some nights change everything.

Run configurable night events with seven specialised encounters, live difficulty profiles, and themed abilities.

  • Paper
  • Minecraft 26.2
  • Java 25+
  • MIT
Upgrading to 2.0? Install Blockfolk 1.4.0 or newer first. This release needs Paper 26.2 and Java 25. Earlier releases remain available for older servers.

What it does

The current release uses Blockfolk for encounters and requires Paper 26.2 and Java 25. Install Blockfolk 1.4.0 or newer first. Citizens and Sentinel are no longer required. Older releases remain available for older servers.

  • Seven special NPCs
  • Per-player spawning with separate health, radius, and population limits for each NPC type
  • Multi-phase encounters with telegraphed abilities, visual effects, and themed rewards
  • Four live difficulty profiles that alter health, rewards, experience, and ability cadence

Features

  • Seven special NPCs: Vampire, Clown, Zombie, Witch, Scarecrow, Ghost, and Werewolf
  • Per-player spawning with separate health, radius, and population limits for each NPC type
  • Multi-phase encounters with telegraphed abilities, visual effects, and themed rewards
  • Four live difficulty profiles that alter health, rewards, experience, and ability cadence
  • Configurable world list, event chance, bleed behavior, NPC skins, and messages
  • Admin controls for starting, stopping, testing, clearing, and reloading events
  • Segmented overhead health bars and automatic cleanup of supporting entities

Installation

  1. 1

    Check your server

    Run Paper with Java 25 or newer, built for Minecraft 26.2. Install Blockfolk 1.4.0+ first.

  2. 2

    Add the JAR

    Stop the server, download Blood-Moon-2.0.1.jar, and place it in plugins/. When upgrading, replace the previous JAR.

  3. 3

    Start and configure

    Start the server and check the console. Review the generated configuration with the release documentation.

First command
/bloodmoon status

Inspect event settings, then use /bloodmoon start in a test world to experience the encounters.

Commands12

CommandDescription
/bloodmoon start [world]Set the world to night and force-start an event. A player may omit the world.
/bloodmoon stop [world]Stop one world's event, or all active events when no world is supplied.
/bloodmoon statusShow active worlds, chance, difficulty, NPC counts, and the next roll window.
/bloodmoon spawn <type> [player]Spawn an NPC at the block a player is looking at, or near the named player. Console must supply a player.
/bloodmoon clear [world]Remove BloodMoon NPCs in one world or across all worlds.
/bloodmoon reloadReload the configuration and refresh active Vampire combat settings.
/bloodmoon enable <world>Add a loaded world to the natural-event list and save the change.
/bloodmoon disable <world>Remove a world from the list, save the change, and stop its active event.
/bloodmoon chance <1-100>Set a temporary one-in-N chance override for the current session.
/bloodmoon difficulty <profile>Select easy, medium, hard, or nightmare for the current session.
/bloodmoon messagesToggle boss phase messages for the player running the command.
/bloodmoon healthbarShow health-bar information to the player running the command.

Permissions3

PermissionDefaultDescription
bloodmoon.adminOperatorsAccess to event administration and manual NPC spawning.
bloodmoon.healthbarEveryoneAccess to /bloodmoon healthbar.
bloodmoon.notifyEveryoneReceive Blood Moon notifications.

Configuration16

KeyDefaultPurpose
bloodmoon.chance24One-in-N chance evaluated when a configured world reaches night.
bloodmoon.worlds[world]Worlds eligible for natural Blood Moons.
bloodmoon.special-mob-replace-chance0.08Chance used by special-mob replacement behavior. Values are clamped from 0 to 1.
messages.event-start§4- THE BLOOD MOON RISES -Event start announcement.
messages.event-end§6The Blood Moon fades... for now.Event end announcement.
SectionExtra Controls
vampireMinimum and maximum stalking duration
clownManic threshold and cadence, balloon cap, teleport hops, and snap radius
zombieInfection timing and damage, infection jump radius, horde radius, phase threshold, and plague radius
KeyDefaultPurpose
bleed.chance0.4Chance for a qualifying hit to apply bleed.
bleed.damage-per-tick1.0Damage dealt by each bleed tick.
bleed.interval-ticks40Time between bleed ticks.
bleed.max-stacks2Maximum simultaneous stacks on one target.
ProfileNon-Vampire HealthRewardsExperienceAbility Interval
easy0.85x0.90x0.90x1.12x
medium1.00x1.00x1.00x1.00x
hard1.20x1.25x1.25x0.85x
nightmare1.38x1.55x1.60x0.72x

Release notes

Blood Moon v2.0.1

Blood Moon 2.0.1 fixes floating encounter NPCs, excessive navigation work, and Clown flight behavior.

Questions or an issue?

Bug reports, questions, and contributions go to this plugin’s GitHub repository.

Open an issue