MultiverseCreatures

插件

· 作者 pablo.elias.miranda.292003

用于在 Spigot/Paper 上创建自定义主题生物和物品的插件

0 本站下载 0 关注 更新于 4 小时前

最新 5.1-RELEASE · 26.2 · Paper / Purpur

一键开服(送7天)

⚠️ 已整合至 Drakes-Suites(Chagui68 的多宇宙套件):
所有针对 Paper/Purpur 1.21.11+ 的活跃开发与官方支持均在 Drakes-Suites monorepo 的 drakes-multiverse 模块中进行,同时保留 Chagui68 的所有权与设计主权。

MultiverseCreatures

✦ MultiverseCreatures ✦

源自多元宇宙的 themed 生物、Boss 与传说物品

一款适用于 Paper/Purpur/Spigot 的插件,引入自适应 Boss、标志性武器以及受 JoJo、咒术回战、空洞骑士、探险活宝、亚瑟王传说、半条命、史酷比、暗黑破坏神等启发的主题生物。

? 在 Modrinth 下载 · ? 网站与 3D 查看器 · ? 完整 Wiki · ? 报告问题

? 加入 DrakesCraft 官方社区!

在我们的技术生存网络中,使用此附加组件及 80 多个优化扩展进行实时游玩!



? MultiverseCreatures 是什么?

MultiverseCreatures 是一款面向 Minecraft 1.21+ 的内容插件,将服务器变成一个多元宇宙游乐场。每个原版生物的生成都有几率被替换为主题自定义生物;每个生物都有独特的 AI,掉落专门的合成材料,并作为引用不同宇宙的传说物品的来源。

✨ 核心亮点

  • ?️ THE OBSIDIAN SENTINEL — 拥有完全动画的 5 阶段 ArmorStand 最终 Boss,具备 45 种攻击(13 种空中 · 14 种地面 · 12 种远程 · 6 种防御),包含 Boss 血条、Megalovania 音乐、魔法封印、召唤增援、防御状态——以及当脚下地板消失时仍能继续战斗而非 idle 的地面恢复 fallback。其阶段阶梯(phase-thresholds)、三种防御持续时间和无玩家检测消散计时器均为 config.yml 中的配置项。
  • ? NIX — 第三个 Boss,拥有独立的召唤仪式、多阶段战斗和专属竞技场。
  • ? JACK STAR — 系统架构师:5 个阶段,3 条命,仪式召唤与建造防御。
  • ? 自适应 Boss — Mahoraga 每 tick 读取你的完整背包并根据实时数据进化属性(锋利度 → 抗性提升,保护 → 力量,击退 → 击退免疫,距离 → 速度)。
  • ? 原始武术 Boss — Garou [Hero Hunter] 拥有水龙流岩碎拳、宇宙突进闪避、反击以及 Cosmic Core 遗物掉落。
  • ⚔️ 传说武器 — Excalibur、Cinder Greatsword、Nullshear Edge、Soulreap Scythe、Aether Pullshot、Skyfire Talisman —— 每种都具备被动 + 主动能力、冷却时间及主题背景故事。
  • ? 主题遗物 — Ice King's Crown(冰弹 + 暴风雪 + 冰径)、Mantis Claws(通过数据包拦截实现贴墙 + 蹬墙跳)、Wirt's Lantern(驱散生物 + 夜视 + 免疫)。
  • ? 护甲套装 — Eight-Handled Wheel(伤害来源适应)、Obsidian Bastion(4 件套奖励:生命值 +40%,击退免疫,火/岩浆免疫),以及副手遗物 Marrow Aegis(伤害反射)、Veilwalker Mantle(隐身 + 背刺)和 Frost Heart(霜冻光环 + 冰行者)。
  • ? 主题食物与实用道具 — Scooby Cookie(抗性提升 VI)、Head Slime Gelatin(Head Slime 免疫)、Military Mine(自动伪装 TNT)。
  • ? 自然生成替换 — 僵尸、骷髅、苦力怕、蜘蛛、女巫、烈焰人、铁傀儡、末影人、凋灵骷髅、唤魔者、史莱姆——每种都有各自的生成几率,完全可配置。
  • ? 满月军事伏击 — 满月期间有罕见的 0.1% 几率生成 ZombieHorseTrap,释放一支由 5 个单位组成的亡灵军队。
  • ? 多元宇宙商人 — 30% 的流浪商人生成会变为 "Shaggy",提供自定义的多元宇宙交易。
  • ? NBS 音乐引擎 — 自定义音乐播放(随附 Megalovania 作为 Boss 主题曲)。
  • ? 仪式结构与专属 Boss 维度 — 为未来 Boss 召唤剧情搭建的脚手架。
  • ⚙️ 完全可配置 — 每个生成几率、Boss 属性、物品冷却时间、死亡消息和效果放大器均位于 config.yml 中。

? 文档 Wiki

该项目拥有一个内置于仓库中的完整文档站点。它详细涵盖了每个 Boss、生物、物品、命令和配置选项——所有内容均由源代码生成。

? 在 GitHub 浏览完整 Wiki:

页面 主题
Home 概览 + 精选主题
Bosses THE OBSIDIAN SENTINEL · NIX · Jack Star · Mahoraga · Garou
Creatures 14 种自然生成替换生物 + ZombieHorseTrap 军队
Weapons Excalibur, Cinder Greatsword, Nullshear Edge, Soulreap Scythe, Aether Pullshot, Skyfire Talisman, Chaos Forge
Armor-and-Relics Eight-Handled Wheel, Obsidian Bastion 套装,副手遗物(Marrow Aegis, Veilwalker Mantle, Frost Heart)
Items Ice King's Crown, Mantis Claws, Wirt's Lantern, Military Mine, Scooby Cookie, Head Slime Gelatin
Components 16 种生物掉落制作材料 + 战利品 → 物品转换链
Commands 完整的 /msc 参考文档(spawn, give, attack, music, dimtp, kill, debug)
Architecture 代码结构、约定及如何扩展该插件
Tests JUnit 测试套件:如何运行以及每个测试类涵盖的内容
Installation 逐步安装指南、config.yml 配置说明、故障排除

? 扩展:复用 45 种 Boss 攻击

Boss 攻击位于一个小型接口之后,因此它们不与特定 Boss 绑定。

public interface BossHost {
    MultiverseCreatures getPlugin();
    void resetBossPose(BossInstance instance);
    Player detectTarget(ArmorStand stand);
    void spawnShockwaveWave(World world, Location center, double maxRadius);
    // plus defaults: getValidPlayers, getValidPlayersNear, launchPlayer,
    // getGroundY, isOnGround, countPlayersInRange, findNearestPlayer
}

任何实现 BossHost 接口的 Boss 都可以直接复用这些攻击类。除三个例外外,其余攻击均与宿主无关;这三个例外需要访问只有 THE OBSIDIAN SENTINEL 才拥有的属性——下界合金长矛、盾牌时机和天空五角星——并显式调用,同时附有注释说明。

地形和玩家查询逻辑位于 BossArena 中作为无状态辅助方法,因此可以从任何地方调用并单独测试。“此玩家是否为有效目标?”的规则(跳过死亡、创造模式和旁观者)仅在唯一一处决定。

如果您正在编写非 ArmorStand 的 Boss 请注意: 攻击通过 ArmorStand 姿态对 Boss 进行动画处理——包括 setHeadPose、setBodyPose、手臂姿态等——在 45 个类中共有 250 次调用。基于生物的 Boss 可以复用攻击的效果(伤害、粒子、投射物),但不能复用其编排动作。如果需要,将每种攻击拆分为“效果”和“动画”是自然的下一步。


? 测试 & CI

测试套件无需服务器或网络即可运行:可以在隔离状态下检查的逻辑被保留在接收普通参数的类中(阶段阶梯、帮助分页、命令目录、击杀过滤器、结构验证器),因此它们可以直接在纯 JUnit 5 环境下运行。

mvn verify                          # 编译 + 测试 + 阴影 Jar
mvn test -Dtest=CommandCatalogueTest  # 仅运行一个类

CI 会在每次推送和拉取请求时运行 mvn verify (verify.yml),而 Modrinth 发布工作流仅在该检查通过后才会发布。Tests wiki page 记录了每个测试类;西班牙语版本位于 wiki-es/dev/Tests.md。


? 安装

  1. 从 Modrinth 页面 下载最新的 .jar 文件。
  2. 将其放入服务器的 plugins/ 文件夹中。
  3. 启动服务器一次以生成默认的 config.yml。
  4. (可选)编辑 plugins/MultiverseCreatures/config.yml 以调整生成几率、冷却时间、Boss 属性、死亡信息和效果增幅器。
  5. 重启并享受游戏。使用 /msc spawn <type> 召唤任意内容,或等待自然生成被替换。

要求: Paper / Purpur 1.21.11, 26.1 或 26.2(针对 purpur-api 1.21.11 构建,使用 mvn -P api-26.1 compile / mvn -P api-26.2 compile 针对 paper-api 26.1 和 26.2 进行检查)· Java 21+(26.x 服务器运行于 Java 25)

完整的安装指南位于 Installation wiki page。


? 从源代码构建

git clone https://github.com/Chagui68/MultiverseCreatures.git
cd MultiverseCreatures
mvn clean package -DskipTests

输出的 JAR 文件将位于 target/MultiverseCreatures-v<version>.jar。


?️ 命令(快速参考)

所有交互均使用 /msc 命令。权限: msc.admin(默认为服务器 OP)。

/msc spawn <type>              在您的位置召唤生物/Boss/商人 (/msc spawn help)
/msc give <item> [n] [who]     获取物品(数量 1–64,指定玩家或 @a)(/msc give help)
/msc attack <name> [range]     强制执行 96 种哨兵攻击之一或机制 (/msc attack help)
/msc music <play|stop|list|disc> 播放或停止 NBS 歌曲,或获取音乐唱片
/msc dimtp <world>             跨世界传送
/msc kill [type|all] [radius]  安全清除 MSC 自定义生物
/msc reload                    重新加载 config.yml 并同步实体和 Boss

完整的分解(所有生成类型、可给予的物品和攻击名称)位于 Commands wiki page。


?️ 项目结构

src/main/java/com/Chagui68/
├── MultiverseCreatures.java      
├── commands/                     /msc 调度器 + 数据表 + 菜单
│   ├── MSCCommand.java           权限门控、路由与 Tab 补全
│   ├── CommandMenu.java          所有帮助菜单 + 分页逻辑
│   ├── SpawnCatalogue.java       生成点名称、消息和帮助页面
│   ├── GiveCatalogue.java        物品名称 + 帮助页面
│   ├── AttackCatalogue.java      攻击名称 + 帮助页面
│   └── MscKillFilter.java        “是否属于我们?”谓词判断
├── entities/
│   ├── boss/                    
│   │   ├── attack/{aerial,ground,ranged,defensive}/  
│   │   └── MagicSealListener / BossInstance
│   ├── miniboss/                
│   └── handler/               
├── items/
│   ├── armor/ components/ food/
│   ├── misc/                     
│   │   └── offhand/              
│   └── weapons/{melee,ranged,magic}/
├── listener/                   
├── music/                       
├── ritual/                       
└── utils/                      

wiki-en/  wiki-es/                 (英文 / 西班牙语文档)
├── Home.md
├── Bosses.md
├── Creatures.md
├── Weapons.md
├── Armor-and-Relics.md
├── Items.md
├── Components.md
├── Commands.md
├── Installation.md
└── dev/
    ├── Architecture.md
    └── Tests.md

wiki-en/ 和 wiki-es/ 文件夹包含纯 Markdown 文档,已排除在 Maven 构建之外 —— 它们仅存在于 GitHub 上供参考,绝不会打包进插件 JAR 文件中。


? 许可证与主权作者声明

版权所有 © 2026 Chagui68 · DrakesCraft Labs。

本项目是 Chagui68 为 DrakesCraft 网络打造的原创主权作品。所有智力成果归属 Chagui68 所有。严禁商业转售、在付费整合包中重新包装或移除创作者署名。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源