Configuration: Difference between revisions

From Citizens Wiki

No edit summary
No edit summary
Line 4: Line 4:
<pre>
<pre>
# Citizens Configuration
# 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:
npc:
   chat:
   chat:
     options:
     options:
       bystandersheartargetedchat: true
       bystanders-hear-targeted-chat: true  
       maxnumberoftargetstoshow: 2
       max-number-of-targets-to-show: 2
       multipletargetsformat: <target>|, <target>| & <target>| & others
       multiple-targets-format: <target>|, <target>| & <target>| & others
       range: 5
       range: 5
      max-text-range: 500
     format:
     format:
       notargets: '[<npc>]: <text>'
       no-targets: '[<npc>]: <text>'
       withtargettobystanders: '[<npc>] -> [<target>]: <text>'
       with-target-to-bystanders: '[<npc>] -> [<target>]: <text>'
       totarget: '[<npc>] -> You: <text>'
       to-target: '[<npc>] -> You: <text>'
       withtargetstobystanders: '[<npc>] -> [<targets>]: <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:
   default:
     lookclose: # NPCs turning heads towards players settings
     look-close:
       enabled: false # whether look close is enabled by default
       enabled: false
       range: 5 # the look close range
       range: 5
      random-look-enabled: false
      random-look-delay: 60
      disable-while-navigating: true
     pathfinding:
     pathfinding:
       range: 25.0 # the maximum pathfinding range to search through before giving up
       range: 25.0 # the maximum pathfinding goal range in blocks
     randomtalker: true # whether the NPC will randomly select a text item instead of sequentially
     random-talker: true  
     realisticlooking: false # whether the NPC will ensure potential players to look at / talk to aren't obscured by walls
     realistic-looking: false # whether to check line of sight when looking close
     stationaryticks: -1 # how long the NPC will be stationary while pathfinding before giving up
     stationary-ticks: -1 # how many ticks can an NPC be stuck in the same block before teleporting to the goal / performing the 'stuck action'
     talkclose:
     talk-close:
       enabled: false # default talk close
       enabled: false
       range: 5 # range before NPC talks
       range: 5
     text:
     text: # default text
       '0': Hi, I'm <npc>! # default text
       '0': Hi, I'm <npc>!
   limits:
   limits:
     defaultlimit: 10 # the default per-player NPC limit
     default-limit: 10
     maxpermissionchecks: 100 # the maximum number of per-player NPCs a player can have
     max-permission-checks: 100 # number of permission nodes to check when using NPC limits
     maxspeed: 100 # the maximum speed an NPC can have
    max-packet-entries: 15
     max-speed: 100
  tablist:
    disable: true # whether to keep NPCs on the tab list
   chunks:
   chunks:
     alwayskeeploaded: false # whether to always keep chunks loaded with NPCs in them or unload them when there are no other players inside the chunk
     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:
   selection:
     quickselect: false # no message will be sent
     quick-select: false  
     item: '280' # the selector item: default is stick
     item: stick # selection item
     message: <b>You selected <a><npc><b>! # the message sent on select
     message: <b>You selected <a><npc><b>!
   player:
   player:
     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
     remove-from-list: true
   serverownership: false # whether the server owns NPCs by default
   server-ownership: false
   text:
   text:
     maxtalkcooldown: 1 # the maximum cooldown before the NPC will talk close in seconds : the cooldown is chosen at random between the min/max
     max-talk-cooldown: 5
     mintalkcooldown: 1 # the minimum cooldown before the NPC will talk close in seconds
     min-talk-cooldown: 10
     talkitem: '340' # the items that will cause the NPC to talk to you on right click : default is book
     talk-item: book
   pathfinding:
   teleport-delay: -1
     usenewfinder: false # EXPERIMENTAL: enable non-Minecraft pathfinder
  player-scoreboard-teams:
     enable: true
advanced:
advanced:
   checkminecraftversion: true # set this to false to disable minecraft compatibility checks. Should not normally be used.
   check-minecraft-version: true
storage:
  savetask:
    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.
general:
  debugmode: false # enable debug output
  colorscheme:
    messagehighlight: <e> # set the default highlight colour: usually yellow.
    message: <a> # set the default message colour: usually green.
  translation:
    locale: '' # set the locale explicitly if needed: eg. en_US is US English, de_DE is the generic German locale
economy:
economy:
   npc:
   npc:
     cost: 100.0 # the cost of an NPC. NOTE: requires Vault
     cost: 100.0 # the cost of /npc create if using economy integration
storage:
  save-task:
    delay: 72000
  file: saves.yml
  type: yaml
subplugins:
subplugins:
   folder: plugins # subplugins like Denizen etc can be placed into Citizens/<subplugins folder> for organisational purposes.
   folder: plugins
 
</pre>
</pre>



Revision as of 03:17, 1 May 2020

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.

Default Configuration

# 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


{{#if:|}}