CitizensText - NPC对话插件

借助此插件，NPC 可以与玩家对话。所有操作均可通过一个命令在游戏内完成，并支持丰富的自定义功能，包括消息格式、音效、随机消息和 PlaceholderAPI 集成。

💡功能特性

• 可在配置文件中自定义消息格式。
• 所有操作均可通过游戏内的 /text 命令完成。
• 支持命令补全，显示所有可用命令和子命令。
• 可为消息添加点击执行的命令（支持控制台选项和自动执行）。
• 可为每条配置的消息自动播放音效。
• NPC 可以拥有与头顶显示名称不同的自定义对话名称。
• NPC 可以从其列表中随机选择一条消息讲述。
• 支持将默认 Citizens 文本编辑器中的文本转换过来。
• 可配置计时器，防止玩家过快看到下一条消息。
• “靠近玩家”选项：当玩家进入以 NPC 为中心的一定半径内时，自动开始对话。
• 兼容 PlaceholderAPI。

消息格式

在配置中，你可以使用以下占位符自定义消息格式

• {0} = NPC 名称
• {1} = 消息内容
• {2} = 当前消息的 ID
• {3} = 消息总数

示例配置

npcTexts: "§6[{2}/{3}] §e§l{0} :§r§e {1}" # 显示消息序号
npcTexts: "§e§l{0} :§r§e {1}" # 仅显示消息

🎮命令与权限

主要命令为 /text，它包含用于管理 NPC 对话的多个子命令。

权限列表

使用以下权限节点来精确控制玩家能执行的操作

• citizenstext.command - 使用 /text 命令的基础权限。
• citizenstext.add - 添加或插入消息。
• citizenstext.remove - 移除消息。
• citizenstext.cmd - 为消息添加可执行命令。
• citizenstext.list - 列出所有消息。
• citizenstext.clear - 清除所有消息。
• citizenstext.sound - 为消息设置音效。
• citizenstext.name - 设置 NPC 的自定义对话名称。
• citizenstext.convert - 从默认编辑器转换文本。
• citizenstext.random - 切换随机消息模式。
• citizenstext.delete - 从内存中删除文本实例。
• citizenstext.reload - 重载配置文件。
• citizenstext.save - 在游戏中保存配置。
• citizenstext.* - 授予所有插件权限。

🔧依赖与要求

• 本插件必须安装 Citizens 才能正常运行。
• 可选安装 PlaceholderAPI 以实现更高级的变量替换功能。