Skript-Citizens - ：NPC脚本扩展

借助 Skript 脚本，您可以在服务器中直接调用 Citizens 插件的强大功能。本插件为 Skript 脚本语言提供了与 Citizens NPC 交互的完整支持，让您能够通过简单的脚本代码来创建、控制和定制 NPC 的行为，实现复杂的游戏内交互与剧情。

💡核心功能

• NPC 创建与管理：通过 Skript 脚本动态生成和移除 Citizens NPC。
• 属性控制：在脚本中直接设置 NPC 的名称、外观（皮肤）、位置、装备等属性。
• 交互事件：捕获玩家与 NPC 的交互事件（如点击、对话），并触发自定义的脚本逻辑。
• 路径点导航：为 NPC 设置路径点，实现自动移动、巡逻等行为。
• 与 Skript 变量集成：将 NPC 对象存储在 Skript 变量中，便于后续调用和状态管理。

🎮脚本语法示例

创建与基础设置

# 创建一个名为“向导”的 NPC
set {_npc} to a new npc named "向导" at player's location
set skin of {_npc} to "Steve"
set {_npc}’s display name to "&a村庄向导"

交互与事件

# 当玩家右击名为“商人”的 NPC 时
on npc right click:
    if name of event-npc is "商人":
        send "欢迎光临！需要看看我的商品吗？" to player
        # 此处可触发更多脚本，如打开一个虚拟商店

移动与路径

# 命令 NPC 移动到指定位置
make npc {_guard} pathfind to location at player
# 或设置一系列路径点进行巡逻
set path of {_guard} to {_waypoint1}, {_waypoint2}, {_waypoint3}

🔧安装与要求

前置需求

• 服务器需安装并运行 Spigot、Paper 或其衍生服务端（1.13+）。
• 必须安装以下两个插件作为运行基础：

- **Skript** (最新版本)

- **Citizens** (最新版本)

安装步骤

• 确保服务器已正确安装并配置好 Skript 和 Citizens 插件。
• 将 Skellett 或 SkQuery（具体名称请以实际下载文件为准）的 jar 文件放入服务器的 plugins 文件夹。
• 重启服务器。
• 插件安装成功后，即可在 Skript 脚本中使用其提供的语法。

❓常见问题

• 问：NPC 创建了但没有显示出来？

- 答：请确认 Citizens 插件已正确加载，并且您拥有在当前位置生成 NPC 的权限。同时，检查 Skript 脚本是否有语法错误。

• 问：我可以让 NPC 执行更复杂的动作或对话树吗？

- 答：可以。通过组合 Skript 的条件判断、变量和循环语句，您可以构建出分支对话、任务链等复杂的 NPC 交互逻辑。

• 问：这个插件支持所有 Citizens 的特性吗？

- 答：它支持 Citizens 的大部分核心功能。对于某些非常高级或特定的特性，可能需要查阅插件的具体文档或表达式列表来确认。

✨提示与进阶

• 善用 Skript 的 function（函数）来封装常用的 NPC 交互模块，可以使您的脚本更整洁、易于维护。
• 结合其他 Skript 附属插件（如效果库、数据库支持插件），可以进一步增强 NPC 的功能，例如保存 NPC 数据、创建更华丽的特效等。
• 建议在正式部署到服务器前，在测试环境中充分调试您的 NPC 脚本。