实体导演

Entity Director

Entity Director 是一个游戏内工具箱，用于在 Minecraft 整合包和服务器中控制生物生成与战利品、创建遭遇战，以及自动化游戏事件。

现已可用： Minecraft 1.21.1，基于 NeoForge 21.1.x。当前 JAR 不支持 Forge、Fabric 及其他 Minecraft 版本。请在 Files 标签页查看每个发行版对应的确切版本和加载器。

通过可视化编辑器构建并测试受支持的规则，无需反复手动编辑 JSON。已保存的服务器规则可在世界运行时应用。

---

为什么选择 Entity Director？

任务	仅用 JSON 的工作流	Entity Director
配置规则	手动编辑文件	在游戏内用 /edgui 浏览生物并编辑规则
应用受支持的规则更改	重载文件或重启	在世界运行时从编辑器保存
测试生成规则	等待符合条件的生成	用 /ed test <mob_id> 在你所在位置预览判定
阻止特定生物	找到并输入其注册 ID	看向它并运行 /ed deny-target
检查拥挤程度	手动统计附近生物	用 /eddensity 查看 5×5 区块密度网格
构建游戏事件	维护独立的命令逻辑	在游戏内配置遭遇战和事件驱动的自动化

---

核心功能

• 生成规则： 创建、设置优先级、启用并测试生物和方块规则。可按维度、生物群系、结构、场景组合、Y 范围、光照、时间、天气和附近生物密度进行筛选。
• 自定义生成器： 添加基于时间、概率的生物生成，并带有放置检查和附近数量上限。
• 自定义战利品： 通过条件和加权概率添加、移除或替换生物掉落物。
• 预设与分享： 从规则模板开始，并通过剪贴板复制或导入规则配置。

• 规则测试： 使用 /ed test <mob_id> 在你当前位置预览生成判定。
• 目标阻止： 瞄准 32 格内的生物并使用 /ed deny-target 创建阻止规则。

• 诊断： 使用调试 HUD、World Inspector、规则预览、/eddensity 和 /edheatmap。热力图会用粒子高亮附近生物数量至少为 20 的区块；它不是全屏图表。
• 遭遇战： 构建分阶段战斗，包含加权实体组、生成预算、目标、奖励、区域、精英修饰符、阵型，以及可选的队伍行为。
• 自动化： 将游戏事件连接到条件和动作，并带可复用的阶段、区域、变量和计数器。
• 可选的 FTB Quests 桥接： 在任务完成时启动遭遇战，将开始条件限制在任务进度之后，或在遭遇战胜利后计入一个 Custom Task。模组的其余部分无需 FTB Quests 即可运行。

---

入门指南

1. 运行 /edgui，或从 Mods 界面打开 Entity Director → Config。编辑器的按键可在 Minecraft 的 Controls 设置中查看或更改。
2. 选择一个生物或创建一条生成规则。对于分阶段战斗，打开 Encounters 并添加一个遭遇战，然后配置其阶段。
3. 保存更改并在你的世界副本中测试。游戏内 Guide 说明了编辑器的工作流程。

命令参考

• /edgui — 打开主编辑器。
• /ed test <mob_id> — 在你所在位置预览生成规则。
• /ed deny-target — 阻止你准星指向的生物。
• /ed density 或 /eddensity — 打印附近 5×5 区块的生物密度网格。
• /edheatmap — 切换对附近拥挤区块的粒子高亮。
• /edhud — 切换调试 HUD（默认也可通过 F8 使用）。
• /encounter edit — 打开遭遇战编辑器。
• /encounter status — 显示正在进行的遭遇战运行。
• /edguide — 打开游戏内 Guide。
• /ed reload — 从磁盘重新加载受支持的服务器配置文件。

管理命令需要相应的权限。

---

技术规格与兼容性

• 当前发行版： Minecraft 1.21.1、NeoForge 21.1.x、Java 21。
• 多人游戏： 若要在游戏内编辑，请在客户端和服务器上安装相同版本的 Entity Director。专用服务器可以在没有 GUI 的情况下使用服务器端规则。
• 配置： 存储在 config/encounterdirector/ 下。更新前请备份你的世界和配置。
• 可选依赖： FTB Quests，仅用于任务桥接。
• 许可证： LGPL-3.0-only。

---

YouTuber 与整合包作者

正在用 Entity Director 制作视频、模组展示或整合包？尽管去做！ 欢迎你在内容中展示它，或将其纳入整合包。若能附上本模组页面的链接，让其他玩家也能找到它，不胜感激。

如果这个模组对你的项目有帮助，考虑支持我——捐赠有助于资助我的短片制作。 🎬

FAQ

更改规则后需要重启服务器吗？

受支持的规则编辑可以在世界运行时保存并应用。安装或更新模组仍需正常重启。

哪个按键打开编辑器？

请查看 Controls → Entity Director。你可以在那里重新绑定，或使用 /edgui。

我需要 FTB Quests 吗？

不需要。它仅用于可选的任务集成。

我可以在整合包中使用 Entity Director 或制作关于它的视频吗？

可以。欢迎你纳入本模组并展示它。若能附上本页面的链接，不胜感激。

我可以制作非官方移植版吗？

1.1.0 发行版采用 LGPL-3.0-only 许可。非官方移植版和修改版本必须遵守适用的许可条款；请明确标注其为非官方，以免玩家将其与本项目的发行版混淆。