Compatibility
Minecraft: Java Edition
Platforms
Links
Tags
Creators
Details
๐ฉธ BloodMoonPlus โ Blood Moon ยท 1.0.2-beta
A Blood Moon event plugin for Paper servers: 7 complete languages, 10 bosses, 45 items spread across rarities, protected Moon gear, enchantments up to level 7, progressive waves, placeholders, full immersion (red fog, lightning, ambient sounds and announcements) and rare-loot inventory delivery.
Built to run smoothly on 40+ player servers without changing the gameplay.
Requires Paper 26.2 or 26.3 ยท Java 25. Updating from 1.0.1? Only the
.jarneeds to be replaced. See Updating from 1.0.1.
โจ Highlights
- ๐ 7 languages โ Spanish, English, Portuguese, French, German, Italian and Russian, complete and switchable in
locales/locales.ymlwith/luna reload(no restart). An unknown code warns and falls back to English, and the build fails if a translation loses a key or a{placeholder}. - ๐ฉ New boss โ Fauces del Cataclismo (
creeper_cargado): a charged creeper twice as tall, 320 HP, immune to every explosion. It absorbs players withVORTEX, summons Crรญas del Cataclismo withSWARMand detonates itself every 50 s without dying โ only in its enraged phase does the blast open a crater. - ๐ก๏ธ Moon gear cannot be stripped โ the grindstone is blocked for Blood Moon items, the anvil and smithing table can never return a result with fewer enchantments or abilities, and the gear players already own is upgraded automatically when they join (renamed items included).
/luna refresh <player|all>forces it instantly. - ๐๏ธ Fixed schedules โ
weeklymode (per weekday at a real time, configurable timezone, defaults toAmerica/Mexico_City) orintervalmode (every N hours). You can set multiple runs on the same day. - ๐ Server-wide event โ one Blood Moon for every loaded world at the same time (
event.global: true): night, hordes, bosses, the boss bar and survivor rewards all run everywhere together. Set it tofalseto go back to aworldslist. - ๐น 10 bosses with custom health bars, enrage phases, minimum difficulty, abilities and their own loot.
- ๐ 45 items sorted by rarity: common (always drop), rare, epic, legendary and mythic (extremely rare, ~0.1%, max 3 per server with a serial number).
- ๐ Curse of Vanishing on every Rare-to-Mythic weapon, tool and armour piece, so high-rarity gear is lost on death as its rarity implies (toggle with
settings.vanishing-curse-min-rarity). - ๐ฆ Rare loot delivery: rare, epic, legendary and mythic drops go straight to the killer's inventory when there is one.
- โ๏ธ Custom enchantments up to level 7, each with unique abilities (crit, thunder guard, blast wave, levitate, bleedingโฆ).
- ๐ Progressive waves โ wave 1: 5 mobs, wave 2: 10, wave 3: 15โฆ up to a configurable cap.
- ๐ซ๏ธ Immersion โ red fog, lightning when hordes/bosses appear, ambient sounds and periodic announcements. No rain, but thunder.
- ๐ Stats & survivors โ who survived, who dealt the most damage, rankings and MVP rewards, all counted from real participation time instead of estimates.
- ๐ Optional integrations with PlaceholderAPI, Multiverse-Core and WorldGuard (MythicMobs as an alternative boss mode).
- ๐ซ Wither control โ the normal Wither is blocked; only the Crimson Scourge boss can spawn.
- โก No TPS drops โ the placeholder/statistics path no longer takes a lock while the file is being written, which is what used to stall the main thread and trigger the Paper watchdog.
๐ Languages
| Language | Code | Language | Code |
|---|---|---|---|
| Spanish | es |
Italian | it |
| English | en |
Russian | ru |
| Portuguese | pt |
French | fr |
| German | de |
Change Language: in plugins/BloodMoonPlus/locales/locales.yml and run /luna reload. Every file is copied on first start; the plugin never overwrites your edited files, and any key missing there falls back to the copy inside the jar, so you never see [i18n missing].
๐ฅ Installation
- Download the
.jarfrom the Versions tab. - Drop it into the
plugins/folder of your Paper server. - Restart the server.
- (Optional) Install PlaceholderAPI for placeholders.
- Configure
plugins/BloodMoonPlus/config.ymland run/luna reload.
๐ Updating from 1.0.1
Only the .jar needs to be replaced. Nothing is migrated and no data is deleted.
- If an event is running, run
/luna stopand stop the server. - Delete the old jar from
plugins/. That is the one thing you must remove: both jars declarename: BloodMoonPlusand Bukkit rejects the second with "plugin name is already in use". - Copy the new
BloodMoonPlus-1.0.2-beta.jarintoplugins/and start the server.
Do NOT delete: data.yml (running event, serial numbers of unique items and pity โ mythics would become available again), statistics.yml (history), config.yml (it did not change in this version), locales/*.yml (your translations) or worlds/<world>/config.yml.
bosses.yml: your server's file is never overwritten. If you keep it, you keep your bosses and tuning, but the new creeper_cargado will not exist. The old bar-color: BLACK on the shadow hunter no longer deletes the boss (each field is validated separately and falls back to RED with a clear warning); the shipped file uses PURPLE. To get the new boss without losing your changes, back up your file, let the plugin generate the new one once and re-apply your adjustments.
items.yml needs no changes (the vanishing-curse default lives in the code), and messages.yml is no longer read โ you can delete it.
๐ฎ Commands
Main command: /luna (aliases: /bm, /lunadesangre, /bloodmoon).
| Command | Description |
|---|---|
/luna ยท /luna status |
Current event, time left and next Blood Moon |
/luna next |
Lists the next 6 scheduled moons |
/luna start [xN] [minutes] [world] |
Starts the event manually |
/luna stop [world|all] |
Stops the event (whole server or one world) |
/luna difficulty <xN> [world] |
Adjusts the difficulty of the current event |
/luna boss <id> [player|world] |
Summons a specific boss, next to a player or in a world |
/luna horde [player] |
Forces a wave (optionally only on a player) |
/luna killmobs [world] |
Removes the event mobs and bosses |
/luna refresh <player|all> |
Applies the gear update immediately |
/luna give <player> <item> [amount] |
Gives one of the plugin's items |
/luna items |
Lists the available items |
/luna chances <table> |
Shows the real drop chances of a table |
/luna reload |
Reloads the configuration and locales |
Spanish aliases work too: /luna estado, /luna iniciar, /luna detener, /luna dificultad, /luna jefe, /luna horda, /luna actualizarโฆ
Permissions
| Permission | Description | Default |
|---|---|---|
bloodmoon.use |
View status and upcoming events | Everyone |
bloodmoon.admin |
Manage the event | OP |
๐๏ธ Schedules & difficulty
In weekly mode, each entry accepts either a simple time or a block with difficulty and duration:
schedule:
mode: weekly
timezone: America/Mexico_City
days:
MONDAY:
- time: "21:30"
difficulty: 1
duration-minutes: 20
FRIDAY:
- time: "13:40"
difficulty: 2
duration-minutes: 20
- time: "20:40" # two runs on the same day
difficulty: 3
duration-minutes: 25
Difficulty is a continuous multiplier (0.1 โ 10.0). It scales health, damage, speed, wave size, spawn rate, loot chance and rarity luck.
๐ฉธ Bosses
| Boss | Min. difficulty |
|---|---|
| Bloody Zombie King | 1.0 |
| Bone Sentinel | 1.0 |
| Crimson Archer | 1.0 |
| Shadow Hunter | 1.0 |
Fauces del Cataclismo (creeper_cargado, 2ร tall, 320 HP) |
1.0 |
| Crimson Necromancer | 1.5 |
| Ancestral Devastator | 1.5 |
| Night Executioner | 1.5 |
| Abyssal Warden | 2.0 |
| Crimson Scourge (Wither) | 2.5 |
Every boss has a health bar, an enrage phase below 40% health, its own ability rotation and its own loot table. The Cataclysm Maw mixes SLAM, VORTEX (absorption), CHARGE, SWARM (3 minions, max 6 alive) and EXPLODE (15-block radius, up to 12 damage, crater only when enraged). See the project's README for every drop in detail.
๐งฉ Placeholders
With PlaceholderAPI installed (namespace %bloodmoon_*%): event status, time left, next moon, difficulty, live bosses (name, health, percentage, state), current wave, participants, survivors, real participation seconds/percent, per-player stats and lifetime history โ 40+ placeholders, including long names such as %bloodmoon_last_event_death_count% or %bloodmoon_boss_health_percent%.
๐ซ Wither datapack (optional)
The plugin already blocks the normal Wither on its own. If you also want a data-layer safeguard, the project ships the BloodMoonWitherControl datapack (in datapacks/), which removes any Wither that is not the Blood Moon boss. It is optional.
โก Performance
Designed for ~40 player networks: local (not whole-world) entity scans, item-parse caching, one player lookup per boss per tick, capped particles and explosion work, and lock-free statistics reads. For very large servers you can tune horde.wave-max-size and horde.max-alive-per-player in the config.
๐ ๏ธ Build from source
git clone <your-repository>
cd BloodMoonPlus
./gradlew build
The .jar is produced in build/libs/. Built with Java 25; the project ships 109 unit tests.
๐ License
All rights reserved. The source code is public for reading and security review only; copying, modifying, reusing or redistributing it is not allowed. You may download and run the compiled plugin on your server. See the LICENSE file for details.
โค๏ธ Credits
Inspired by โ and built to surpass โ BloodMoon-Reborn. Made with care for Spanish-speaking communities. ๐๐ฉธ


