Configuration: Difference between revisions

From Citizens Wiki

No edit summary
 
(4 intermediate revisions by the same user not shown)
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-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:
npc:
  always-use-name-holograms: false # whether to always use name holograms (armor stands) for nameplates rather than custom names
   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
      talk-to-npcs: true # whether to include NPCs in chat
     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:
    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:
   default:
     lookclose: # NPCs turning heads towards players settings
     bossbar-view-range: 64 # the bossbar view range, blocks
       enabled: false # whether look close is enabled by default
    look-close:
       range: 5 # the look close range
       enabled: false
      range: 5 # range in blocks
      random-look-enabled: false
       random-look-delay: 60 # delay in ticks
      disable-while-navigating: true
     pathfinding:
     pathfinding:
       range: 25.0 # the maximum pathfinding range to search through before giving up
       range: 75.0 # the maximum pathfinding range to destination 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:
     block-breaker-radius: -1 # the default radius in blocks for the NPC to pathfind to when breaking blocks
       enabled: false # default talk close
     talk-close:
       range: 5 # range before NPC talks
       enabled: false
     text:
       range: 5
       '0': Hi, I'm <npc>! # default text
     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:
   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
    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:
   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
  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:
advanced:
   checkminecraftversion: true # set this to false to disable minecraft compatibility checks. Should not normally be used.
   check-minecraft-version: true
storage:
  database:
    driver: '' # should be sqlite/mysql/h2, depending on the database
    password: '' # the database password if needed
    url: '' # the database URL: eg. sqlite://path/to/my.db
    username: '' # the database username if needed
  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, database, 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>


Line 95: Line 154:
     {{H:title|Item you have to right-click the NPC with for them to talk|talk-item: 340}}
     {{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}}
   {{H:title|Whether the server owns an NPC by default|server-ownership: false}}
  <nowiki></nowiki>{{H:title|The name of the database|database:}}
  <nowiki></nowiki>
  {{H:title|The password for the database connection.|password: ''}}
  {{H:title|The username for the database connection.|username: ''}}
  {{H:title|The URL for connecting to the database.|url: ''}}
  {{H:title|The driver to use when connecting to the database. Eg. MySQL, SQLite, H2|driver: ''}}
  <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.|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.|use-database: false}}
  <nowiki></nowiki>{{H:title|Subplugin settings|subplugins:}}
  <nowiki></nowiki>{{H:title|Subplugin settings|subplugins:}}
   {{H:title|The folder to load subplugins from|folder: 'plugins'}}
   {{H:title|The folder to load subplugins from|folder: 'plugins'}}

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:|}}