🩸 BloodMoonPlus — Blood Moon · 1.0.2-beta
适用于 Paper 服务器的 Blood Moon 事件插件:7 种完整语言、10 个 Boss、分布在不同稀有度的 45 件物品、受保护的月之装备、最高 7 级附魔、渐进式波次、占位符、完全沉浸感(红色雾气、闪电、环境音效和公告)以及稀有掉落物直接交付到背包。
专为在 40+ 玩家的服务器上流畅运行而设计,且不会改变原有游戏玩法。
需要 Paper 26.2 或 26.3 · Java 25。 从 1.0.1 版本升级?只需替换 .jar 文件即可。
请参阅 从 1.0.1 升级。
✨ 亮点
- 🌍 7 种语言 — 西班牙语、英语、葡萄牙语、法语、德语、意大利语和俄语,完整支持。可在
locales/locales.yml 中切换,并通过 /luna reload 实时生效(无需重启服务器)。若检测到未知代码会发出警告并回退至英语;如果翻译丢失了键值或 {placeholder},构建将失败。
- 🟩 新 Boss — Fauces del Cataclismo (
creeper_cargado):一个充能苦力怕,高度翻倍,拥有 320 点生命值,免疫所有爆炸伤害。它会使用 VORTEX 技能吸收玩家,使用 SWARM 技能召唤 Crías del Cataclismo,并且每 50 秒自爆一次而不死亡——只有在狂暴阶段,其爆炸才会炸出一个陨石坑。
- 🛡️ 月之装备无法被移除效果 — 磨石禁止用于处理 Blood Moon 物品;铁砧和锻造台永远无法生成附魔或能力更少的结果;玩家已拥有的装备在加入服务器时会自动升级(包括重命名过的物品)。使用
/luna refresh <player|all> 可立即强制刷新。
- 🗓️ 修复后的时间表 —
weekly 模式(按星期几在特定时间触发,支持配置时区,默认为 America/Mexico_City)或 interval 模式(每隔 N 小时)。您可以设置同一天内的多次运行。
- 🌐 全服事件 — 所有加载的世界同时发生一次 Blood Moon(
event.global: true):夜晚、怪物潮、Boss、Boss 血条和幸存者奖励在所有世界中同步进行。将其设置为 false 可恢复为 worlds 列表模式。
- 👹 10 个 Boss,拥有自定义血条、狂暴阶段、最低难度设定、独特技能及其专属掉落物。
- 🎁 45 件物品,按稀有度分类:普通(必定掉落)、稀有、史诗、传说和 神话(极罕见,约 0.1%,服务器上限 3 件,带有唯一序列号)。
- 💀 消失诅咒:应用于所有 稀有至神话 级别的武器、工具和护甲部件,因此高稀有度装备会在玩家死亡时如预期般消失(可通过
settings.vanishing-curse-min-rarity 切换此功能)。
- 📦 稀有掉落物交付:稀有、史诗、传说和神话级别的掉落物在击杀者在线时直接放入其背包。
- ⚔️ 自定义附魔:最高可达 7 级,每种附魔拥有独特能力(暴击、雷电守护、冲击波、漂浮、流血……)。
- 🌊 渐进式波次 — 第 1 波:5 个怪物,第 2 波:10 个,第 3 波:15 个……直至达到可配置的上限。
- 🌫️ 沉浸感 — 红色雾气、当怪物潮/Boss 出现时伴有闪电、环境音效和定期公告。无降雨,但有雷声。
- 📊 统计与幸存者 — 记录谁幸存下来、谁造成了最大伤害、排名及 MVP 奖励,所有数据均基于实际参与时间而非估算值计算。
- 🔌 可选集成:支持 PlaceholderAPI、Multiverse-Core 和 WorldGuard(MythicMobs 可作为替代的 Boss 模式)。
- 🚫 凋灵控制 — 普通凋灵被禁止生成;仅允许 Crimson Scourge Boss 生成。
- ⚡ 无 TPS 下降 — 占位符/统计路径在写入文件时不再占用锁,从而解决了此前导致主线程卡顿并触发 Paper watchdog 的问题。
🌍 语言
| 语言 |
代码 |
语言 |
代码 |
| 西班牙语 |
es |
意大利语 |
it |
| 英语 |
en |
俄语 |
ru |
| 葡萄牙语 |
pt |
法语 |
fr |
| 德语 |
de |
|
|
修改 plugins/BloodMoonPlus/locales/locales.yml 中的 Language: 字段,然后运行 /luna reload。首次启动时会复制所有文件;插件永远不会覆盖您编辑过的文件,任何缺失的键都会回退到 jar 包内的副本,因此您永远不会看到 [i18n missing]。
📥 安装
- 从 Versions 标签页下载
.jar 文件。
- 将其放入您的 Paper 服务器的
plugins/ 文件夹中。
- 重启服务器。
- (可选)安装 PlaceholderAPI 以支持占位符。
- 配置
plugins/BloodMoonPlus/config.yml 并运行 /luna reload。
🔄 从 1.0.1 升级
只需替换 .jar 文件。 无需迁移数据,也不会删除任何数据。
- 如果有事件正在运行,请运行
/luna stop 并停止服务器。
- 删除
plugins/ 中的旧版 jar 文件。这是您必须移除的唯一文件:两个 jar 都声明了 name: BloodMoonPlus,Bukkit 会因为 "plugin name is already in use" 而拒绝加载第二个。
- 将新的
BloodMoonPlus-1.0.2-beta.jar 复制到 plugins/ 并启动服务器。
请勿删除: data.yml(运行中的事件、唯一物品的序列号和保底机制——否则神话物品会再次变为可用)、statistics.yml(历史记录)、config.yml(此版本未更改)、locales/*.yml(您的翻译内容)或 worlds/<world>/config.yml。
bosses.yml: 您服务器上的该文件永远不会被覆盖。如果您保留它,您将保留原有的 Boss 和调整参数,但新的 creeper_cargado 将不存在。旧的 shadow hunter 上 bar-color: BLACK 不再会导致 Boss 被删除(每个字段单独验证,若无效则回退至 RED 并给出清晰警告);官方提供的文件使用的是 PURPLE。若想在不丢失更改的情况下获得新 Boss,请先备份您的文件,让插件重新生成一次新文件,然后再重新应用您的调整。
items.yml 无需更改(消失诅咒的默认值已在代码中处理),messages.yml 不再被读取——您可以安全地删除它。
🎮 命令
主要命令:/luna(别名:/bm, /lunadesangre, /bloodmoon)。
| 命令 |
描述 |
/luna · /luna status |
当前事件、剩余时间以及下一次血月 |
/luna next |
列出接下来排期的 6 个月亮周期 |
/luna start [xN] [minutes] [world] |
手动启动事件 |
/luna stop [world|all] |
停止事件(整个服务器或单个世界) |
/luna difficulty <xN> [world] |
调整当前事件的难度 |
/luna boss <id> [player|world] |
召唤特定 Boss,位于玩家身旁或世界中 |
/luna horde [player] |
强制生成一波敌人(可选:仅针对某玩家) |
/luna killmobs [world] |
移除事件中的怪物和 Boss |
/luna refresh <player|all> |
立即应用装备更新 |
/luna give <player> <item> [amount] |
给予插件中的一种物品 |
/luna items |
列出可用物品 |
/luna chances <table> |
显示某个掉落表的实际掉落概率 |
/luna reload |
重新加载配置和语言文件 |
西班牙语别名同样有效:/luna estado, /luna iniciar, /luna detener, /luna dificultad, /luna jefe, /luna horda, /luna actualizar…
权限
| 权限 |
描述 |
默认值 |
bloodmoon.use |
查看状态和即将发生的事件 |
所有人 |
bloodmoon.admin |
管理事件 |
OP |
🗓️ 排期与难度
在 weekly(每周)模式下,每个条目可以接受简单的时间设置,也可以是一个包含难度和持续时间的代码块:
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" # 同一天运行两次
difficulty: 3
duration-minutes: 25
难度是一个连续乘数(0.1 – 10.0)。它会按比例缩放生命值、伤害、速度、波次规模、生成速率、掉落概率以及稀有度运气。
🩸 Boss
| Boss |
最低难度 |
| Bloody Zombie King |
1.0 |
| Bone Sentinel |
1.0 |
| Crimson Archer |
1.0 |
| Shadow Hunter |
1.0 |
Fauces del Cataclismo (creeper_cargado, 两倍高, 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 |
每个 Boss 都有生命条、低于 40% 生命值时触发的狂暴阶段、独立的技能循环以及专属的掉落表。Cataclysm Maw 混合了 SLAM(重击)、VORTEX(吸收)、CHARGE(冲锋)、SWARM(3 个小兵,存活上限 6 个)和 EXPLODE(15 格半径,最高 12 点伤害,仅在狂暴时产生弹坑)。有关每种掉落的详细信息,请参阅项目的 README。
🧩 占位符
安装 PlaceholderAPI 后(命名空间 %bloodmoon_*%),可使用以下占位符:事件状态、剩余时间、下一次月亮、难度、实时 Boss 信息(名称、生命值、百分比、状态)、当前波次、参与者、幸存者、真实参与秒数/百分比、单人统计数据以及终身历史记录——共 40+ 个占位符,包括长名称如 %bloodmoon_last_event_death_count% 或 %bloodmoon_boss_health_percent%。
🚫 凋灵数据包(可选)
插件本身已经阻止了普通凋灵的生成。如果你还需要一层数据层的安全保障,项目提供了 BloodMoonWitherControl 数据包(位于 datapacks/ 中),该数据包会移除所有非 Blood Moon Boss 的凋灵。此为可选功能。
⚡ 性能
专为约 40 名玩家的网络设计:采用局部(而非全地图)实体扫描、物品解析缓存、每 Tick 每个 Boss 仅进行一次玩家查找、限制粒子效果和爆炸工作负载,以及无锁统计读取。对于非常大的服务器,你可以在配置中调整 horde.wave-max-size 和 horde.max-alive-per-player。
🛠️ 从源码构建
git clone <your-repository>
cd BloodMoonPlus
./gradlew build
.jar 文件将生成在 build/libs/ 中。使用 Java 25 构建;该项目包含 109 个单元测试。
🔒 许可证
保留所有权利。 源代码公开仅供阅读和安全审查;禁止复制、修改、重用或再分发。你可以在你的服务器上下载并运行编译好的插件。详情请参阅 LICENSE 文件。
❤️ 鸣谢
灵感来源于 — 并旨在超越 — BloodMoon-Reborn。用心打造,服务于西班牙语社区。 🌙🩸
🩸 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 .jar needs 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.yml with /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 with VORTEX, summons Crías del Cataclismo with SWARM and 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 —
weekly mode (per weekday at a real time, configurable timezone, defaults to America/Mexico_City) or interval mode (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 to false to go back to a worlds list.
- 👹 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
.jar from 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.yml and 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 stop and stop the server.
- Delete the old jar from
plugins/. That is the one thing you must remove: both jars declare name: BloodMoonPlus and Bukkit rejects the second with "plugin name is already in use".
- Copy the new
BloodMoonPlus-1.0.2-beta.jar into plugins/ 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. 🌙🩸
评论 0
登录后参与评分
还没有评论,来抢沙发吧