From Citizens Wiki
Revision as of 03:17, 1 May 2020 by Fullwall
Citizens configuration is handled in the file /plugins/Citizens/config.yml. See below for detailed information on each setting. For more information on text nodes such as <npc>, see the Text Syntax page.
# Citizens Configuration general: authlib: profile-url: https://sessionserver.mojang.com/session/minecraft/profile/ # generally shouldn't be touched, but allows you to configure a custom GameProfile server for advanced users debug-file: '' # whether to log debug output to a file instead of to console debug-mode: false # enables debugging mode with extra information on spawning, skin fetching, etc. debug-pathfinding: false # enables pathfinding debugging which shows a visual display (yellow flowers) of where NPCs are pathfinding to color-scheme: message-error: <c> # the error message colour, default red message-highlight: <e> # the highlight colour, default yellow message: <a> # the default message colour, default green translation: locale: '' # if you want to use a specific language translation such as fr_FR etc. npc: chat: options: bystanders-hear-targeted-chat: true max-number-of-targets-to-show: 2 multiple-targets-format: <target>|, <target>| & <target>| & others range: 5 max-text-range: 500 format: no-targets: '[<npc>]: <text>' with-target-to-bystanders: '[<npc>] -> [<target>]: <text>' to-target: '[<npc>] -> You: <text>' with-targets-to-bystanders: '[<npc>] -> [<targets>]: <text>' pathfinding: default-distance-margin: 2 # the distance from the goal to stop early while moving along a path measured in blocks squared default-path-distance-margin: 1 # the distance from the goal to stop early while finding a path measured in blocks update-path-rate: 20 # how often to update the path in ticks, typically for entity targeting maximum-new-pathfinder-iterations: 50000 # the maximum number of blocks to search while pathfinding using the new pathfinder new-finder-open-doors: false # whether the NPC should open doors while moving (new finder only) attack-range: 3.0625 use-new-finder: false # whether to use the built in Citizens A* pathfinder instead of Minecraft's disable-mc-fallback-navigation: true default: look-close: enabled: false range: 5 random-look-enabled: false random-look-delay: 60 disable-while-navigating: true pathfinding: range: 25.0 # the maximum pathfinding goal range in blocks random-talker: true realistic-looking: false # whether to check line of sight when looking close stationary-ticks: -1 # how many ticks can an NPC be stuck in the same block before teleporting to the goal / performing the 'stuck action' talk-close: enabled: false range: 5 text: # default text '0': Hi, I'm <npc>! limits: default-limit: 10 max-permission-checks: 100 # number of permission nodes to check when using NPC limits max-packet-entries: 15 max-speed: 100 tablist: disable: true # whether to keep NPCs on the tab list chunks: always-keep-loaded: false controllable: max-ground-speed: 0.5 # maximum speed while on the ground use-boat-controls: true # using WASD type controls ground-direction-modifier: 1.0 # % speed modifier to turning while on the ground skins: max-retries: -1 # maximum time to try from Mojang retry-delay: 120 # delay in ticks between retries rotation-update-degrees: 90.0 use-latest-by-default: false # whether to always fetch new skin updates view-distance: 100.0 packets: update-delay: 30 # performance option, lower = faster updates to equipment, higher = slower updates but more performance selection: quick-select: false item: stick # selection item message: <b>You selected <a><npc><b>! player: remove-from-list: true server-ownership: false text: max-talk-cooldown: 5 min-talk-cooldown: 10 talk-item: book teleport-delay: -1 player-scoreboard-teams: enable: true advanced: check-minecraft-version: true economy: npc: cost: 100.0 # the cost of /npc create if using economy integration storage: save-task: delay: 72000 file: saves.yml type: yaml subplugins: folder: plugins