Compatibility
Minecraft: Java Edition
Platforms
Links
Tags
Creators
Details
๐ฉธ BloodMoonPlus โ Blood Moon
A Blood Moon event plugin for Paper servers, featuring fixed schedules (Mexico time), 9 bosses, 45 items spread across rarities, enchantments up to level 7, progressive waves, placeholders, multi-language support and full immersion (red fog, lightning, ambient sounds and constant announcements).
Built to run smoothly on 40+ player servers without changing the gameplay.
โจ Highlights
- ๐๏ธ 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. - ๐น 9 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%).
- โ๏ธ 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.
- ๐ Multi-language (i18n) and per-world configuration.
- ๐ Optional integrations with PlaceholderAPI, Multiverse-Core and WorldGuard (MythicMobs as an alternative mode).
- ๐ซ Wither control โ the normal Wither is blocked; only the Crimson Scourge boss can spawn.
๐ฅ 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.
Requires Paper. Compatible with Paper 26.2 and 26.3.
๐ฎ Commands
Main command: /luna (aliases: /bm, /lunadesangre, /bloodmoon).
| Command | Description |
|---|---|
/luna next |
Shows the next Blood Moon |
/luna start [difficulty] |
Starts the event manually |
/luna stop |
Stops the event |
/luna difficulty <n> |
Adjusts the difficulty of the current event |
/luna boss <id> |
Summons a specific boss |
/luna horde |
Forces a wave |
/luna killmobs |
Removes the event mobs |
/luna give <item> [amount] |
Gives one of the plugin's items |
/luna items |
Lists the available items |
/luna chances |
Shows the drop chances |
/luna reload |
Reloads the configuration |
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 |
| 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, enrage phases and its own loot table. See the project's full README for every drop in detail.
๐งฉ Placeholders
With PlaceholderAPI installed (namespace %bloodmoon_*%): event status, time left, next moon, difficulty, live bosses, current wave, survivors, player stats and more.
๐ซ 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, optimized placeholder snapshots and efficient menus/action bars. 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.
๐ 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. ๐๐ฉธ


