From Nitradopedia EN
Revision as of 13:02, 22 May 2015 by Cranken (talk | contribs) (Created page with "{{Infobox Plugin |NAME=<span style="font-size:1.4em">'''Citizens'''</span> |LOGO=Pluginlogo-Citizens2.png |SERVERMOD=Bukkit‎ |CATEGORY=Fun | Admin | Info |DEVELOPER=fullwall...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search
Servermod: Bukkit‎
Category: Fun
Developer: fullwall und aPunch
Developer Website:
Description: Create Npcs
Features: Npcs can interact
Download: -


Go to the DevBukkit project site and download the plugin which uses your server version.
Now you have to upload the plugin to the plugins folder in your server folder. You can do this by using the FTP server which is explained here.


Path /minecraftbukkit/plugins/Essentials/config.yml

Do NOT change the following lines:

    min: 3
    max: 13
  look: 5
  pathfinding: 16.0
    max-stationary: -1
    max-pathing: -1
    delay: 72000
    save-often: true
    use-task: true
    right-click-pause: 70

Citizens.yml (General)

# Citizens Configuration
      bystandersheartargetedchat: true
      maxnumberoftargetstoshow: 2
      multipletargetsformat: <target>|, <target>| & <target>| & others
      range: 5
      notargets: '[<npc>]: <text>'
      withtargettobystanders: '[<npc>] -> [<target>]: <text>'
      totarget: '[<npc>] -> You: <text>'
      withtargetstobystanders: '[<npc>] -> [<targets>]: <text>'
    lookclose: # NPCs turning heads towards players settings
      enabled: false # whether look close is enabled by default
      range: 5 # the look close range
      range: 25.0 # the maximum pathfinding range to search through before giving up
    randomtalker: true # whether the NPC will randomly select a text item instead of sequentially
    realisticlooking: false # whether the NPC will ensure potential players to look at / talk to aren't obscured by walls
    stationaryticks: -1 # how long the NPC will be stationary while pathfinding before giving up
      enabled: false # default talk close
      range: 5 # range before NPC talks
      '0': Hi, I'm <npc>! # default text
    defaultlimit: 10 # the default per-player NPC limit
    maxpermissionchecks: 100 # the maximum number of per-player NPCs a player can have
    maxspeed: 100 # the maximum speed an NPC can have
    alwayskeeploaded: false # whether to always keep chunks loaded with NPCs in them or unload them when there are no other players inside the chunk
    quickselect: false # no message will be sent
    item: '280' # the selector item: default is stick
    message: <b>You selected <a><npc><b>! # the message sent on select
    removefromlist: true # setting this to false will enable human NPCs to be recognised by mobs; it will also make them just like a normal player, which means other plugins will recognise them as well. This can be enabled per-NPC using /npc playerlist
  serverownership: false # whether the server owns NPCs by default
    maxtalkcooldown: 1 # the maximum cooldown before the NPC will talk close in seconds : the cooldown is chosen at random between the min/max
    mintalkcooldown: 1 # the minimum cooldown before the NPC will talk close in seconds
    talkitem: '340' # the items that will cause the NPC to talk to you on right click : default is book
    usenewfinder: false # EXPERIMENTAL: enable non-Minecraft pathfinder
  checkminecraftversion: true # set this to false to disable minecraft compatibility checks. Should not normally be used.
    delay: 72000 # the delay in ticks before everything gets serialised to disk
  file: saves.yml # the storage file
  type: yaml # the type: can be NBT, YAML.
  debugmode: false # enable debug output
    messagehighlight: <e> # set the default highlight colour: usually yellow.
    message: <a> # set the default message colour: usually green.
    locale: '' # set the locale explicitly if needed: eg. en_US is US English, de_DE is the generic German locale
    cost: 100.0 # the cost of an NPC. NOTE: requires Vault
  folder: plugins # subplugins like Denizen etc can be placed into Citizens/<subplugins folder> for organisational purposes.


Admin Commands

Commands used for administration of Citizens.

Admin Commands
Command Permission Description
/citizens citizens.admin Show basic plugin information
/citizens reload citizens.admin Reload Citizens
/citizens save citizens.admin Save NPCs and configuration

Help Commands

Commands used in-game to show the help screen.

Help Commands
Command Args Description Permission Description
/citizens help (Page) - Page number to display Show Citizens help menu
/npc help (Page) - Page number to display Show NPC help menu
/trait help (Page) - Page number to display Show trait help menu
/script help (Page) - Page number to display Show scripting help menu
/template help (Page) - Page number to display Show template help menu
/waypoints help (Page) - Page number to display Show waypoints help menu

NPC Commands

General commands used for all NPCs.

'/npc trait' has been replaced, there is a new set of commands for adding, removing and copying traits.

/trait {traitname] is now used to add traits and characters.
NPC Commands
Command Args Description Require Selected Require Ownership Require Mob Types Permission Description


/npc None Yes Yes No None Show basic NPC information
/npc age [adult, baby, integer, -l] - Adult sets as adult, baby as baby, age integer specifies an exact age, -l toggles whether the age is locked Yes Yes Yes - COW, SHEEP, CHICKEN, PIG, VILLAGER, OCELOT, WOLF citizens.npc.age Modify a NPC's age
/npc anchor anchor (--save [name], --assume [name], --remove [name]) (-a)(-c) - saves a location as an 'anchor' which can be assumed via assume [name] Yes Yes No citizens.npc.anchor Changes/saves/lists NPC's location anchors
/npc behaviour behaviour [scripts] (-r) -- scripts is a comma separated list of script file names to look for, -r flag removes them from the NPC. Yes Yes No citizens.npc.behaviour Adds and removes behaviours from an NPC. A behaviour is a script file that is executed and adds 'goals' to the NPC which can run every tick. These can do anything you can program/think of!
/npc controllable None Yes Yes No citizens.npc.controllable.[npc type name] Toggles the NPC's controllable status. Controllable NPCs can be right clicked to be mounted and controlled with WASD. Ghasts, Blazes and Endersragons can be flown by left clicking once mounted to pause/unpause flying.
/npc copy (--name NewName) -- new name is the name of the copied NPC. Yes Yes No citizens.npc.copy Create a new NPC from the currently selected NPC, copying all traits.
/npc create [NPC Name] - Name to give NPC
(--type [type]) - Mob type to use
--trait [trait1] [trait2] ... - A list of traits to apply to the NPC
Yes Yes No citizens.npc.create.mobtype or citizens.npc.create.* Create a new NPC.

Example : /npc create Jimbo Stevenson --type PIG

/npc despawn (id) the ID of the NPC to despawn Yes Yes No citizens.npc.despawn Despawn a NPC
/npc gamemode [gamemode] the gamemode to use Yes Yes PLAYER citizens.npc.gamemode Sets a Player NPC's game mode.
/npc gravity None Yes Yes No citizens.npc.gravity Toggles gravity on the NPC.
/npc equip None Yes Yes Yes - PLAYER, PIG, SHEEP, ENDERMAN citizens.npc.edit.equip Toggle equipment editor. Used for player armor, player and endermen items, sheep color/sheared, and pig saddles.
/npc list (-a) - List all NPCs
(--owner (owner)) - Owner
(--type (type)) - Mob type
(--char (character)) - Character
No No No citizens.npc.list List NPCs that match at least one of the given conditions
/npc lookclose None Yes Yes No citizens.npc.lookclose Toggle a NPC's look-close state
/npc moveto --x [x] --y [y] --z [z] --world [world] Yes Yes No citizens.npc.moveto The NPC's current location is taken as the base location. Value arguments are used to modify this base.
/npc mount None Yes Yes No citizens.npc.mount Mount the currently selected NPC, if it is controllable.
/npc owner (name) - Name of the new owner, set as "server" if you want Citizens Admins (players with "citizens.admin" permission) to be owner Yes Yes No citizens.npc.owner Sets the owner of a NPC
/npc path None Yes Yes No citizens.npc.edit.path Toggle path editor. Left click to add a waypoint, right click to remove, mousewheel or number keys to select individual waypoints.
/npc pathrange [range] - New range for the NPC Yes Yes No citizens.npc.pathfindingrange Set the range in number of blocks in which the NPC can find a path.
/npc playerlist None Yes Yes PLAYER citizens.npc.playerlist Toggles an NPC as a 'real' player, so that it will be more recognised by other plugins, will keep chunks loaded and crops ticking.
/npc pose (-a) - Sets the position of the NPC's head to the current position of the Player's head. Useful for setting where NPCs are specifically looking post-creation.
''(--save [name]|--load [name]|--remove [name)''
Yes Yes Yes - PLAYER citizens.pose Changes/Stores NPC's head position based on the Player's current position.
/npc power None Yes Yes Yes - CREEPER citizens.npc.power Toggle whether a creeper NPC is powered
/npc profession BLACKSMITH, LIBRARIAN, BUTCHER, FARMER, or PRIEST Yes Yes Yes - VILLAGER citizens.npc.profession Change a villager-type NPC's profession.
/npc remove (all) - Will remove all NPCs Yes (Not if "all" is used) Yes No citizens.npc.remove, (citizens.admin.remove.all) Remove a NPC
/npc rename [name] - New name for the NPC Yes Yes No citizens.npc.rename Rename a NPC
/npc select [id] - ID of the NPC to select No Yes No Selects a NPC with the given ID
/npc size [size] - the integer size for the slime Yes Yes SLIME citizens.npc.size Sets a slime's size.
/npc skeletontype [type] - 0 or NORMAL for normal, 1 or WITHER for wither skeleton Yes Yes SKELETON citizens.npc.skeletontype Changes a Skeleton NPC's type (currently between WITHER and NORMAL)
/npc spawn [id] - ID of the NPC you want to spawn Yes Yes No citizens.npc.spawn Spawn a existing NPC
/npc speed Yes Yes No citizens.npc.speed changes the NPC's default speed multiplier. i.e. use 2 to double the normal speed.
/npc text None Yes Yes No citizens.npc.edit.text Toggle text editor. Note that players need the permission to hear NPCs!
/npc tphere None Yes Yes No citizens.npc.tphere Teleport a NPC to your location
/npc tp None Yes Yes No Teleport to a NPC
/npc type [type] - the new entity type Yes Yes No citizens.npc.type Changes an NPC's mob type.
/npc vulnerable None Yes Yes No citizens.npc.vulnerable Toggles whether the NPC can take damage and die, and whether monsters will target it when it is on the player list
/npc zombiemod (-b, -v) - -b for baby, -v for villager Yes Yes ZOMBIE citizens.npc.zombiemodifier Sets a zombie NPC's modifiers.
/trait [trait1] [trait2] ... [traitN - A list of traits to apply Yes Yes No citizens.npc.trait.* or citizens.npc.trait.<trait-name> for per-trait permissions Adds the trait type to the NPC. NPCs can have multiple traits.

Example: /trait sentry }}