查看“Citizens”的源代码

{{待翻译}}
<center>'''<big>请前往https://wiki.citizensnpcs.co/Citizens_Wiki 搬运插件页面</big>'''<br />

'''<big>可以参考[http://www.mcbbs.net/thread-383763-1-1.html mcbbs]的旧翻译</big>'''</center>


__NOTOC__

{{InfoBox}}
欢迎来到 Citizens Wiki!
Citizens2 是一款强大的 NPC 编辑插件,可以让插件开发者拓展基础的NPC动作.


==关键特点==
* NPC可以行走、站立和向周围的玩家聊天.
* 对于插件开发者来说简单的 [[Citizens/API|API]] . 通过 [[Citizens/路径 路径]] 来增强你的NPC体验.
* [[Types|Monster and animal NPCs]]. 你可以在地狱传送门附近创建吓人的烈焰人,也可以在主城附近热情的吸氧羊, 或是在村庄添加友善的村民. 查看 [[Citizens/指令]]来查看怎样创建各种生物类型的NPC.
* 骑乘和 [[Citizens/控制NPC|控制 NPC]].
* 实用的文本编辑器. 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.

{{FNavBox}}

==我可以保留Citizens 1的NPC吗?==
You'll have to convert your old npc-profiles.yml files first. A converter can be found [http://citizensnpcs.co/converter/ 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 [[1.x|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 [[Versions|here]].

==感谢名单==

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

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

Also, a special thanks to all of those on [https://discord.gg/Q6pZGSR Discord] who have tested and to all of those who have donated! We would be nowhere without you!



<spoiler>


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

==主要特性==
* NPC可以像普通玩家一样`自由的行走，站立,说话
* 简单易用的 [[API]] . 它可以帮助开发人员开发更吊的其他插件·
* [[Types|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|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 [http://citizensnpcs.co/converter/ 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 [[1.x|here]].

==更新记录==
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 [[Versions|here]].

==Credits==

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

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

Also, a special thanks to all of those in [http://webchat.esper.net/?channels=citizens 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身上.<br />

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