Configuration: Difference between revisions

From Citizens Wiki

No edit summary
No edit summary
 
(23 intermediate revisions by 4 users not shown)
Line 1: Line 1:
Citizens.yml is one of the primary plugin [[Configuration|configuration]] files. It controls plugin-wide settings for things such as [[Database Usage|databases]], [[Message Formatting|chat]], and [[Debugging|debugging]].
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.
==Example Layout==
 
==Default Configuration==
<pre>
# 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-chunk-loads: false # for advanced debugging of when chunks are loaded and why
  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: <red> # the error message colour, default red
    message-highlight: <yelloe> # the highlight colour, default yellow
    message: <green> # the default message colour, default green
  translation:
    locale: '' # if you want to use a specific language translation such as fr_FR etc.
  reload-warning-enabled: true # whether to require /citizens reload entered twice
npc:
  always-use-name-holograms: false # whether to always use name holograms (armor stands) for nameplates rather than custom names
  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
      talk-to-npcs: true # whether to include NPCs in chat
    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:
    new-finder:
      iterations-per-tick: 5000 # how many steps to run of the new pathfinder every tick. Useful when you want to spread pathfinding over multiple ticks
      check-bounding-boxes: false # whether to check bounding boxes of entities can fit e.g. through single block gaps or fences etc
      open-doors: false # whether to open/close doors while pathfinding
    defaults:
      destination-teleport-margin: -1 # teleport to the destination when below this threshold. e.g. you may want to teleport to the exact destination if <2 blocks away
    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: 10000 # the maximum number of blocks to search while pathfinding using the new pathfinder
    minecraft:
      max-fall-distance: 3 # the maximum fall distance to check while pathfinding (old pathfinder)
    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 # minecraft by default will try to use 'fallback' pathfinding where it returns the closest reachable block to the destination. by default try to reach the destination only.
  default:
    bossbar-view-range: 64 # the bossbar view range, blocks
    look-close:
      enabled: false
      range: 5 # range in blocks
      random-look-enabled: false
      random-look-delay: 60 # delay in ticks
      disable-while-navigating: true
    pathfinding:
      range: 75.0 # the maximum pathfinding range to destination 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'
    block-breaker-radius: -1 # the default radius in blocks for the NPC to pathfind to when breaking blocks
    talk-close:
      enabled: false
      range: 5
    text: # default text
      '0': Hi, I'm <npc>!
    waypoints:
      cache-paths: false # whether to cache paths found for /npc path. eliminates pathfinding when used
  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
    placeholder-update-frequency-ticks: 6000 # how often to update skin placeholders, in ticks
  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
  follow:
    teleport-across-worlds: true # whether to teleport cross-world when /npc follow is enabled
  commands:
    global-delay-seconds: 1 # the global delay between click commands in seconds. set to 0 for no delay between commands
    error-messages:
      maximum-times-used: You have reached the maximum number of uses ({0}).
      missing-item: Missing {1} {0}
      no-permission: You don't have permission to do that.
      not-enough-experience: You need at least {0} experience.
      not-enough-money: You need at least ${0}.
      on-cooldown: Please wait for {minutes} minutes and {seconds_over} seconds.
      on-global-cooldown: Please wait for {minutes} minutes and {seconds_over} seconds.
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
 
</pre>
 
 
{{hidden|old config|
Mouse over each field to see what each one is used for.
Mouse over each field to see what each one is used for.
  <nowiki></nowiki># Citizens Configuration
  <nowiki></nowiki># Citizens Configuration
  <nowiki></nowiki>{{H:title|The NPC block. All NPC specifics go here|npc:}}
  <nowiki></nowiki>{{H:title|The NPC block. All NPC specifics go here|npc:}}
   {{H:title|Chat specific settings|chat:}}
   {{H:title|Chat specific settings|chat:}}
     {{H:title|The prefix that is put before all NPC dialogue lines|prefix: '[<npc>]: '}}
     {{H:title|Prefix that is put before all NPC dialogue lines|prefix: '[<npc>]: '}}
   {{H:title|Configuration on how to select NPCs|selection:}}
   {{H:title|Configuration on how to select NPCs|selection:}}
     {{H:title|Whether to enable quick select. true/false|quick-select: false}}
     {{H:title|Whether to go to next task right after selecting NPC instead of having to click again|quick-select: false}}
     {{H:title|What item to use as the selection tool|item: 280}}
     {{H:title|ID of item to use as selection tool|item: 280}}
     {{H:title|What message to output to the player when they've selected an NPC|message: <nowiki><b>You selected <a><npc><b>!</nowiki>}}
     {{H:title|Message outputted to the player when they've selected an NPC|message: <nowiki><b>You selected <a><npc><b>!</nowiki>}}
  {{H:title|Default settings for NPCs. Can be changed per-NPC via commands|default:}}
    {{H:title|Whether to look at the player when they come within 5 blocks|look-close: false}}
    {{H:title|Randomly choose line to talk instead of talking in order|random-talker: true}}
    {{H:title|Whether to talk when the player comes within 5 blocks|talk-close: false}}
  {{H:title|Talk settings|talk:}}
    {{H:title|Maximum time before the NPC will talk again|max-cooldown: 60}}
    {{H:title|Minimum time before the NPC will talk again|min-cooldown: 30}}
    {{H:title|Item you have to right-click the NPC with for them to talk|talk-item: 340}}
  {{H:title|Whether the server owns an NPC by default|server-ownership: false}}
<nowiki></nowiki>
  <nowiki></nowiki>{{H:title|General settings regarding Citizens|general:}}
  <nowiki></nowiki>{{H:title|General settings regarding Citizens|general:}}
   {{H:title|Whether to be in debug mode or not. Prints more messages to console about Citizens. true/false|debug-mode: false}}
   {{H:title|Whether to be in debug mode or not. Prints more messages to console about Citizens.|debug-mode: false}}
  <nowiki></nowiki>{{H:title|Whether to use databases or not. true/false|use-database: false}}
  <nowiki></nowiki>{{H:title|Subplugin settings|subplugins:}}
<nowiki></nowiki>{{H:title|The name of the database|database:}}
   {{H:title|The folder to load subplugins from|folder: 'plugins'}}
   {{H:title|The password for the database connection.|password: ''}}
}}
  {{H:title|The username for the database connection.|username: ''}}
{{NavBox}}
  {{H:title|The URL for connecting to the database.|url: ''}}
[[Category:Configuration]]
  {{H:title|The driver to use when connecting to the database.|driver: ''}}

Latest revision as of 16:28, 15 December 2022

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-chunk-loads: false # for advanced debugging of when chunks are loaded and why
  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: <red> # the error message colour, default red
    message-highlight: <yelloe> # the highlight colour, default yellow
    message: <green> # the default message colour, default green
  translation:
    locale: '' # if you want to use a specific language translation such as fr_FR etc.
  reload-warning-enabled: true # whether to require /citizens reload entered twice
npc:
  always-use-name-holograms: false # whether to always use name holograms (armor stands) for nameplates rather than custom names
  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
      talk-to-npcs: true # whether to include NPCs in chat
    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:
    new-finder:
      iterations-per-tick: 5000 # how many steps to run of the new pathfinder every tick. Useful when you want to spread pathfinding over multiple ticks
      check-bounding-boxes: false # whether to check bounding boxes of entities can fit e.g. through single block gaps or fences etc
      open-doors: false # whether to open/close doors while pathfinding
    defaults:
      destination-teleport-margin: -1 # teleport to the destination when below this threshold. e.g. you may want to teleport to the exact destination if <2 blocks away
    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: 10000 # the maximum number of blocks to search while pathfinding using the new pathfinder 
    minecraft:
      max-fall-distance: 3 # the maximum fall distance to check while pathfinding (old pathfinder)
    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 # minecraft by default will try to use 'fallback' pathfinding where it returns the closest reachable block to the destination. by default try to reach the destination only.
  default:
    bossbar-view-range: 64 # the bossbar view range, blocks
    look-close:
      enabled: false
      range: 5 # range in blocks
      random-look-enabled: false
      random-look-delay: 60 # delay in ticks
      disable-while-navigating: true
    pathfinding:
      range: 75.0 # the maximum pathfinding range to destination 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'
    block-breaker-radius: -1 # the default radius in blocks for the NPC to pathfind to when breaking blocks
    talk-close:
      enabled: false
      range: 5
    text: # default text
      '0': Hi, I'm <npc>!
    waypoints:
      cache-paths: false # whether to cache paths found for /npc path. eliminates pathfinding when used
  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 
    placeholder-update-frequency-ticks: 6000 # how often to update skin placeholders, in ticks
  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
  follow:
    teleport-across-worlds: true # whether to teleport cross-world when /npc follow is enabled
  commands:
    global-delay-seconds: 1 # the global delay between click commands in seconds. set to 0 for no delay between commands
    error-messages:
      maximum-times-used: You have reached the maximum number of uses ({0}).
      missing-item: Missing {1} {0}
      no-permission: You don't have permission to do that.
      not-enough-experience: You need at least {0} experience.
      not-enough-money: You need at least ${0}.
      on-cooldown: Please wait for {minutes} minutes and {seconds_over} seconds.
      on-global-cooldown: Please wait for {minutes} minutes and {seconds_over} seconds.
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:|}}