Citizens

本页面已存在其他语言的内容，请协助翻译为本地化的中文。

• 点击此处开始翻译。
• 如本模板出现在原文存档页面，请注意更新主页面后，仍需要去除此处该模板。
• 如当前页面已经没有需要翻译的内容，请删去待翻译模板。
• 有标题的大篇幅文章，如果短时间内无法全部翻译，请先把所有的标题翻译出来，以便之后的贡献者选择与翻译章节内容。

Citizens 是一款用到 Bukkit API的NPC插件. 可以给你的服务器添加不同类型的NPC. Citizens 也拥有简单易懂的 API 来让插件开发者创建角色. 下载: 下载 Spigot页面: Spigot 插件开发者: fullwall 和 aPunch 源码: Github 问题反馈: Issues on Github, but please see Troubleshooting first. Discord聊天频道: Discord 捐助: fullwall

欢迎来到 Citizens Wiki! Citizens2 is an advanced NPC plugin for CraftBukkit. Unlike the original Citizens, Citizens2 allows developers to extend basic NPCs to provide varied gameplay and functionality.

关键特点

• NPCs can walk, stand and talk naturally to players.
• Easy to use API for developers. This allows for brand new Traits that enhance your NPC experience.
• Monster and animal NPCs. You can create intimidating blazes around a Nether portal, welcoming sheep near the spawn, and helpful villagers in your villages. See the Commands page to see how to create a mob NPC.
• Ridable and controllable NPCs.
• Robust text editing. The new text-editing interface allows for adding, removing, and editing NPC text.
• Player- and server-owned NPCS. Server-owned NPCs can be edited by anyone with the citizens.admin permission.
• Admins can optionally charge for NPC creation and limit the number of NPCs per player.

我可以保留Citizens 1的NCP吗?

You'll have to convert your old npc-profiles.yml files first. A converter can be found here. Once you get the saves.yml file, place it in ./plugins/Citizens/saves.yml .

Still using Citizens 1.2? The old documentation, while no longer updated or supported, can be found here.

更新记录

https://www.spigotmc.org/resources/citizens.13811/

旧版本: http://dev.bukkit.org/server-mods/citizens/files/

The latest dev build for specific server versions are listed here.

感谢名单

Citizens would not be where it is today without the contributions of these people:

fullwall and aPunch - creators of the Citizens plugin
Creeperhost - Citizens website server host
AgentK - Wiki editor, 1.x converter and script repo programmer.
aufdemrand - Wiki editor, graphic designer, and trait programmer
mcmonkey and Morphan1 - Trait programmer, wiki editor
All character/trait authors, including those not mentioned here - talk to us on Discord!
You, for trying out and using Citizens!

Also, a special thanks to all of those on Discord who have tested and to all of those who have donated! We would be nowhere without you!

<spoiler>

欢迎查看 Citizens Wiki! Citizens2 是一款强大的 NPC 编辑插件.拥有丰富的扩展插件,你可以使用它在游戏里创建NPC，不同的NPC执行不同的行为
NPC可以是护卫,铸造师,命令执行者，任务发布者等功能，如果你的脑洞大可以根据Citizens2 API开发更吊的插件·

主要特性

• NPC可以像普通玩家一样`自由的行走，站立,说话
• 简单易用的 API . 它可以帮助开发人员开发更吊的其他插件·
• Monster and animal NPCs. You can create intimidating blazes around a Nether portal, welcoming sheep near the spawn, and helpful villagers in your villages. See the Commands page to see how to create a mob NPC.
• Ridable and controllable NPCs.
• Robust text editing. The new text-editing interface allows for adding, removing, and editing NPC text.
• Player- and server-owned NPCS. Server-owned NPCs can be edited by anyone with the citizens.admin permission.
• Admins can optionally charge for NPC creation and limit the number of NPCs per player.

Can I keep my NPCs from Citizens 1?

You'll have to convert your old npc-profiles.yml files first. A converter can be found here. Once you get the saves.yml file, place it in ./plugins/Citizens/saves.yml .

Still using Citizens 1.2? The old documentation, while no longer updated or supported, can be found here.

Changelog

https://www.spigotmc.org/resources/citizens.13811/

Previous versions: http://dev.bukkit.org/server-mods/citizens/files/

The latest dev build for specific server versions are listed here.

Credits

Citizens would not be where it is today without the contributions of these people:

fullwall and aPunch - creators of the Citizens plugin
Creeperhost - Citizens website server host
AgentK - Wiki editor, 1.x converter and script repo programmer.
aufdemrand - Wiki editor, graphic designer, and trait programmer
mcmonkey and Morphan1 - Trait programmer, wiki editor
All character/trait authors, including those not mentioned here - talk to us on IRC!
You, for trying out and using Citizens!

Also, a special thanks to all of those in IRC who have tested and to all of those who have donated! We would be nowhere without you!

创建NPC方法

一、新建/删除/选择一个NPC。

/npc [ create|remove ] <NPC的名称> 例： /npc create ztcjohn 通过该命令你可以创建一个名为ztcjohn的NPC。 /npc remove ztcjohn 通过该命令你可以删除ztcjohn。

• NPC的ID若是正版用户，那么将从mojang官网下载皮肤，并且在您创建的NPC上显示哦。

/npc list 通过该命令你可以查看在服务器上当前的NPC列表。在NPC前面的数字为NPC的序号。

/npc select <序号> 通过该命令你可以选择某个NPC，并且对其进行进一步定义操作。(此步尤为重要) 此命令支持命令方块。

二、NPC的对话设置。(需要选择好序号

/npc text 通过该命令可以看到提示: 意思是： 输入add为当前NPC增加一段对话内容， 输入remove为当前NPC删除一段对话内容，输入edit为当前NPC编辑一段对话内容，输入close选择NPC在别人靠近时是否启动对话，输入item设置NPC手中的项目，输入range设置NPC感应对话的范围，输入random选择NPC是否随机从对话里选择内容(默认是按顺序对话，当对话内容超过5条的时候建议打开)，输入help重新显示此项。

• 从上述功能中选择你要操作的方式，然后输入内容即可。若要退出对话编辑，再次输入/npc text即可退出。

例： /npc text add 大家好，我是<npc>。 /npc text

三、NPC的装备设置。

/npc equip 通过该命令你可以对NPC进行装备编辑，包括护甲、武器和手中的物品。 使用护甲右键NPC即可将护甲穿在NPC身上，支持附魔。 使用武器或者物品，即可将其装备在NPC的手上，武器同样支持附魔。 (NPC的装备对守卫扩展插件的作用非常重要) 再次输入/npc equip即可退出装备编辑。

四、NPC的移动轨迹

/npc path 通过该命令我们可以看到 Left Click to add a waypoint , right click to remove . type toggle path to toggle showing entities at waypoints , triggers to enter the trigger editor and clear to clear all waypoints. 意思为，左键点击地面为NPC的移动路径设置一个关键点，右键点击则是取消一个关键点。输入toggle path则是设置在记录关键点的时候是否显示坐标信息。输入clear清空路径。 再次输入/npc path退出并且保存路径。 例： /npc path 移动到其他坐标左键点击地面 /npc path 这样子NPC就会在两个点来回巡逻了。

/npc speed <0.1-5> 通过该命令你可以为NPC设置其移动的速度，默认为1，最佳设置为0.8，建议不要超过2，给服务器造成负担。

五、其他细项功能:

NPC的传送(需要选择好NPC序号) /npc [ tp|tphere ] 通过该命令你可以传送到NPC的方位，或者将NPC传送到面前。 /npc moveto <x轴坐标> <y轴坐标(高度)> <z轴坐标> <地图名称> 通过该命令你可以将npc移动到某个世界的固定坐标点。 此命令支持命令方块。 /npc look 通过该命令你可以选择NPC在人物靠近时是否会视线跟随，默认关闭，建议打开。 /npc rename <新的名称> 通过该项命令你可以为你的NPC重命名。 /npc copy <原来的名字> <新的名字> 复制一个NPC的设置并且应用到的名字。

附属插件CommandNPC

CommandNPC是一个可以将命令绑定到你NPC身上的一个插件。通过这个插件可以实现很多功能！

使用说明

命令和权限 给NPC增加命令你需要权限 'commandnpc.admin'

/npc addcmd <是否允许在控制台执行(true/false)> <customPerm/noPerm> <command> - 添加一个指令到NPC身上.

/npc resetcmds - 删除你所选定NPC身上的命令 你可以使用变量 '%name' 来触发点击者的名字！ </spoiler>