随从

👥 随从 — 管理与部署你的动态NPC随从团队

⚠️ 重要警告：早期预览版本

这是随从系统的早期预览版本。目前已知在某些情况下会导致世界崩溃和数据损坏。强烈建议仅将本插件用于隔离的测试或开发服务器。请不要在正式生产服务器上运行，并确保你有频繁的自动世界备份。

随从系统是一个强大的、数据驱动的NPC随从、名册与任务管理框架，专为Hytale服务器设计。它允许服务器管理员定义完全自定义的NPC同伴，并赋予玩家招募、编队及部署他们执行沉浸式任务的能力。

虽然该框架设计用于支持未来各种辅助系统，但渐进式结构建造是首个完整实现的模块——让你的随从使用玩家提供的材料，逐块物理建造预置建筑。

---

🌟 主要特性

👥 完全动态的NPC名册与招募

管理一个完全由你的服务器定制的随从阵容。随从系统使用动态、数据驱动的目录，绝对没有硬编码的NPC。

• 自定义NPC： 招募直接从你的服务器数据库（npcs.json 和 prefabs.csv）加载的独特同伴并编入名册。
• 可解锁槽位： 玩家以基础槽位数开始，可以使用你服务器的游戏内货币购买或解锁额外的名册槽位。
• 自定义皮肤与头像： 插件会自动从你的自定义NPC皮肤中捕获、缓存并预渲染高质量2D大头照头像，以提供高级的UI体验。

🧱 沉浸式"点滴式"建造 (初始模块)

玩家无需瞬间粘贴大型结构而破坏生存沉浸感，而是可以将建造任务分配给他们活跃的随从：

• 渐进式建造： 观看你的随从实时、逐块地物理建造预置建筑。
• 对服务器友好的性能： 计算经过高度优化，并在游戏刻之间点滴处理，防止大型基地建造期间出现服务器延迟或崩溃。
• 材料管理： 访问你随从的持久建造者袋/背包，以提供其建造队列所需的方块。
• 任务持久性： 服务器重启？没问题。建造任务在重启后依然存在，并会从上次中断的地方精确恢复。

📐 实时3D预置预览

• 轨道自由视角： 切换专门的摄像机模式，在确认建造指令前完美调整结构的位置、旋转、抬升或深度。
• 冒险模式安全（FAKE_BLOCKS）： 利用高级渲染技术，让玩家在冒险模式下安全预览蓝图，而无需放置实际方块实体或冒复制漏洞的风险。

🎒 随从工具

• 将自定义的随从工具（一个书本物品）交给你的玩家。右键或左键点击即可立即打开自定义的随从中心UI——无需施法时间、无需尴尬的动画，也完全不需要输入命令。

---

🛠️ 命令与权限

随从系统拥有简洁、轻量的权限结构，可与任何标准的Hytale权限插件（如 LuckPerms）无缝协作。

命令	别名	权限	描述
/retinue	/ret	retinue.admin	打开主管理员目录，以添加、删除或管理预置和同伴。

💡 玩家访问说明： 玩家不需要任何命令！访问完全通过游戏玩法，利用随从工具物品进行处理，该物品可安全地打开面向玩家的中心页面。

---

🚀 快速入门指南

1. 打开中心： 左键或右键点击随从工具以打开你的自定义随从中心。
2. 编入随从： 将自定义同伴招募到你的活跃名册中，并将其分配到一个空槽位。
3. 填充袋子： 打开你随从的袋子，将所需的建造方块直接存入其背包。
4. 部署蓝图： 在工作台解锁预置蓝图配方，使用轨道摄像机视图完美定位，然后分配你的随从开始工作！

---

🔌 兼容性与集成

随从系统的构建旨在感觉像是游戏原生的一部分。它具备开箱即用的兼容性，可与以下系统协同工作：

• Ecotale经济系统（或你服务器的自定义货币系统）
• Hytale原生的自定义UI页面系统
• 自定义服务器HUD