|
|
| (10 intermediate revisions by 3 users not shown) |
| Line 1: |
Line 1: |
| This page only describes nodes in the core plugin. For per-type node descriptions, see the type's corresponding page.
| | {{NoSupport}} |
| ''
| | Citizens is configured with a few YAML files. Configuration files will generate automatically when you first install Citizens. If a file is missing a setting, it will automatically generate. |
| citizens.yml'' and ''mobs.yml'' will generate automatically when you first install Citizens. If a file is missing a setting, it will automatically generate.
| |
|
| |
|
| == citizens.yml == | | == Configuration files == |
| <pre>
| |
| range:
| |
| #number of blocks a player needs to be near an NPC in order for the NPC to look at the player
| |
| look: 5
| |
| #range a pathing NPC looks within while searching for entities to target
| |
| pathfinding: 16.0
| |
| items:
| |
| #items used to select an NPC with, '*' means all, ''DO NOT remove single quotes''
| |
| select-items: '*'
| |
| #items used to make an NPC talk, leave a trailing comma
| |
| talk-items: 340,
| |
| ticks:
| |
| saving:
| |
| #whether to save settings/properties often
| |
| save-often: true
| |
| #
| |
| use-task: true
| |
| #delay between each save-task save
| |
| delay: 72000
| |
| pathing:
| |
| #maximum amount of ticks an NPC can remain stationary while pathing
| |
| max-stationary: -1
| |
| #maximum amount of ticks an NPC can path for
| |
| max-pathing: -1
| |
| waypoints:
| |
| #amount of ticks to pause an NPC if right-clicked while pathing
| |
| right-click-pause: 70
| |
| economy:
| |
| #if you have NPC types on your server, more settings will generate here
| |
| prices:
| |
| #price for creating a basic NPC (with /npc create)
| |
| basic:
| |
| creation: 100
| |
| #whether or not to use an economy plugin, if false, above economy settings are ignored
| |
| use-economy: true
| |
| general:
| |
| defaults:
| |
| #default setting for whether an NPC looks at a player when close
| |
| enable-following: true
| |
| #default setting for whether an NPC talks when a player is close
| |
| talk-when-close: false
| |
| #whether to select and execute an NPC type's right-click option at the same time (i.e. select and teleport at the same time)
| |
| quick-select: false
| |
| #whether to print debug messages to the console
| |
| debug-mode: false
| |
| colors:
| |
| #whether to use an NPC's nameplate color as their color in chat
| |
| use-npc-colours: true
| |
| #the color to use as an NPC's chat color if ''use-npc-colours'' is false
| |
| npc-colour: f
| |
| #whether to notify those with the 'citizens.admin.notifyupdates' of any Citizens update
| |
| notify-updates: true
| |
| chat:
| |
| #character used to have spaces in NPC names
| |
| space-char: /
| |
| #message that is sent when an NPC is selected
| |
| selection-message: <g>You selected <y><npc><g> (ID <y><npcid><g>).
| |
| #default text of an NPC, leave a trailing semi-colon
| |
| default-text: Hello.;How are you today?;Having a nice day?;Good weather today.;Stop hitting me!;I'm bored.;
| |
| #message that is sent when an NPC is created
| |
| creation-message: <g>The NPC <y><npc><g> was born!
| |
| #message format used for when an NPC speaks
| |
| format: '[%name%]: '</pre>
| |
|
| |
|
| == mobs.yml ==
| | [[citizens.yml]] control the core components of Citizens.<br> |
| | [[mobs.yml]] contain configuration nodes for [[Evil NPCs]].<br> |
| | [[npc_profiles.yml]] contain information about toggleable [[Characters]].<br> |
| | [[quests.yml]] contain your quest files for [[Quester]]s. |
|
| |
|
| | | {{NavBox}} |
| === Default File ===
| | [[Category:Citizens1]] |
| <pre>
| |
| evil:
| |
| spawn:
| |
| #whether to spawn evil NPCs
| |
| spawn: false
| |
| #maximum amount of evil NPCs that can spawn
| |
| max: 2
| |
| #perfect chance of an evil NPC spawning
| |
| chance: 100
| |
| items:
| |
| #item to tame an evil NPC with
| |
| tame-item: 354
| |
| #list of items that an evil NPC may drop when killed, leave a trailing comma
| |
| drops: 260,357,2256,
| |
| misc:
| |
| #message to send when a player fails at taming an evil NPC, leave a trailing semi-colon
| |
| failed-tame-messages: Ha! You can't tame me!;Nice try, <name>!;Muahahaha, I am evil!;
| |
| #list of names that an evil NPC can spawn with, leave a trailing comma
| |
| names: Evil_aPunch,Evil_fullwall,Evil_Notch,Herobrine,
| |
| #percent chance of taming an evil NPC
| |
| tame-chance: 5
| |
| general:
| |
| spawn:
| |
| #delay between each creature NPC random spawn
| |
| delay: 200</pre>
| |