自定义怪物框架

自定义怪物框架

一个高级、高性能且完全可配置的生物创建系统，你只需要提供模型即可。

🎮 玩家功能

📖 1. 自定义生物图鉴

通过精美的暗色主题图鉴界面解锁、记录并追踪你遭遇过的自定义生物。

  • 3D 旋转视口： 查看每个自定义生物的实时 3D 预览。
  • 解锁进度： 未发现的生物将以神秘的黑色剪影显示，并附带通用的背景描述，直到你击败它们。

⚔️ 2. 精英生物与Boss战

挑战世界中动态生成或通过袭击事件生成的自定义生物。

  • 精英生物： 自定义生物的变种，拥有更高的生命值、伤害和特殊前缀名称。
  • 自定义远程攻击： 面对能够发射自定义投射物的生物，这些投射物带有重力调整、自定义速度和爆炸或粒子拖尾效果。

🌍 3. 自然生成与栖息地

在探索世界时自然地遭遇自定义生物。

  • 动态生成控制： 生物基于配置的权重在指定的生物群系中动态生成。
  • 栖息地限制： 体验限定在特定生物群系、维度或结构中的定制生成。

🛠️ 管理员功能

🖥️ 1. 游戏内生物创建器

使用一个可动态扩展的图形界面编辑器，直接在游戏中设计和自定义新的生物模板。

  • 灵活模型集成： 支持任何模型类型！包括标准原版生物、GeckoLib 动画 JSON 模型和自定义 Java 类。
  • 高级AI目标选择： 切换并配置复杂行为，例如近战、远程、潜行、飞行/悬浮物理、传送（命中时、低生命时或目标背后）、钻地、召唤仆从以及逃离/寻找水源、火焰、雨水或光线。
  • 可视化碰撞箱编辑器： 使用精确滑块缩放碰撞箱（X/Y/Z），不影响模型尺寸，并可在游戏中切换线框预览以查看活跃的碰撞箱。

☄️ 2. 游戏内投射物创建器

在可视化设计界面中从零开始构建自定义远程攻击。

  • 自定义纹理和模型： 为投射物分配特定的 3D 模型 ID 或物品纹理。
  • 物理控制器： 切换重力标志（启用或禁用重力计算以实现直线轨迹）。
  • 视觉效果： 绑定自定义粒子拖尾，并自定义爆炸效果（可切换是否破坏方块）。

🗄️ 3. 异步 SQLite 引擎

旨在确保零延迟，即使在玩家众多的服务器上也是如此。

  • 异步数据库队列： 发现记录、统计数据和世界数据通过一个独立的单线程队列保存到本地世界的 SQLite 数据库中，以防止服务器主线程冻结。
  • 双层缓存： 生物模板和图鉴条目被缓存在内存中，以实现 GUI 的即时加载，并具有定期的后台数据库刷新机制。

🧠 4. AI行为与优先级覆盖

使用可视化目标选择器微调你的实体如何导航并与玩家和环境互动。

  • 目标层级： 为行为分配优先级，以控制哪些动作优先（例如，近战或远程战斗 vs. 被动游荡）。
  • 潜行转换： 整合战斗前的潜行阶段，在生物被看到/丢失特定次数之前，限制战斗目标。
  • 传送至背后的攻击： 在传送目标期间触发即时攻击和视角覆盖，使玩家措手不及。

🌍 5. 自定义自然生成规则

配置模板属性以控制你的自定义生物如何在生存模式下原生生成。

  • 生物群系过滤器： 使用标准资源位置（例如 minecraft:desert，minecraft:plains）定义白名单/黑名单过滤器。
  • 权重与群体大小： 配置生成权重以控制频率，并为原生生成设置最小/最大群体大小。
  • 动态重载： 对模板和生成属性的更改可在游戏中动态重载，无需重启客户端或服务器。

⚔️ 6. 自定义袭击与生成器系统

设置可放置的生成器来触发基于波次的战斗遭遇，并提供独特奖励。

  • 袭击生成器方块： 在世界中放置生成器方块，并将其绑定到特定的自定义袭击模板。
  • 波次配置： 配置波次数、每波次的生成池以及同时存在的最大生物数量。
  • 自定义奖励表： 在玩家成功完成袭击后，给予物品或执行自定义控制台命令。

🔧 7. 配置与命令

管理员可以通过 server_config.json 文件配置模组设置，或使用游戏内命令（需要权限等级 2）：

💬 命令参考

管理员命令

管理员（需要权限等级 2/操作员权限）可以执行以下命令来配置和管理框架：

  • /custom_mobs creator-ui - 打开主可视化生物创建器 GUI 编辑器。
  • /custom_mobs projectile-creator-ui - 打开可视化投射物创建器 GUI 编辑器。
  • /custom_mobs reload-config - 从文件重载所有生物模板、配置和袭击。
  • /custom_mobs status - 显示当前维度中活跃的自定义生物统计数据。
  • /custom_mobs killall - 清理并移除所有活跃的自定义生物。
  • /custom_mobs spawn <mob_id> [count] - 生成一个自定义生物，可以指定数量。
  • /custom_mobs spawn-mob <mob_id> <is_elite> - 生成一个自定义生物，并指定是否为精英变种。
  • /custom_mobs spawn-projectile <projectile_id> - 从玩家当前的视线方向发射一个自定义投射物。
  • /custom_mobs bestiary add <player> <mob_id> - 为一名玩家在生物图鉴中解锁一个发现记录。
  • /custom_mobs bestiary remove <player> <mob_id> - 从一名玩家的生物图鉴中移除一个发现记录。
  • /custom_mobs raid start <raid_id> - 开始一次自定义袭击（全局或在最近的袭击生成器方块上）。
  • /custom_mobs raid stop <raid_id> - 停止一次正在进行的袭击。
  • /custom_mobs raid info - 列出所有当前正在进行的袭击。
  • /custom_mobs add-raid-reward <raid_id> <reward_type> <value> - 向一个袭击模板添加一个奖励（物品或命令）。

📌 依赖与安装

🌐 支持的语言

包含对英语、德语、西班牙语、法语、日语、韩语、葡萄牙语、俄语和简体中文的 100% 翻译支持。