Configuration: Difference between revisions

From Citizens Wiki

No edit summary
(7 intermediate revisions by 2 users not shown)
Line 4: Line 4:
<pre>
<pre>
# Citizens Configuration
# Citizens Configuration
npc:
npc:
   chat:
   chat:
     prefix: '[<npc>]: '
     options:
      bystandersheartargetedchat: true
      maxnumberoftargetstoshow: 2
      multipletargetsformat: <target>|, <target>| & <target>| & others
      range: 5
    format:
      notargets: '[<npc>]: <text>'
      withtargettobystanders: '[<npc>] -> [<target>]: <text>'
      totarget: '[<npc>] -> You: <text>'
      withtargetstobystanders: '[<npc>] -> [<targets>]: <text>'
   default:
   default:
     look-close:
     lookclose: # NPCs turning heads towards players settings
       range: 5
      enabled: false # whether look close is enabled by default
       enabled: false
       range: 5 # the look close range
     random-talker: true
    pathfinding:
     talk-close:
       range: 25.0 # the maximum pathfinding range to search through before giving up
       range: 5
     randomtalker: true # whether the NPC will randomly select a text item instead of sequentially
       enabled: false
     realisticlooking: false # whether the NPC will ensure potential players to look at / talk to aren't obscured by walls
    stationaryticks: -1 # how long the NPC will be stationary while pathfinding before giving up
    talkclose:
       enabled: false # default talk close
       range: 5 # range before NPC talks
     text:
     text:
       '0': Hi, I'm <npc>!
       '0': Hi, I'm <npc>! # default text
    realistic-looking: false
  limits:
     look-close-range: 5
     defaultlimit: 10 # the default per-player NPC limit
     talk-close-range: 5
     maxpermissionchecks: 100 # the maximum number of per-player NPCs a player can have
     pathfinding:
     maxspeed: 100 # the maximum speed an NPC can have
      range: 25.0
  chunks:
     stationary-ticks: -1
     alwayskeeploaded: false # whether to always keep chunks loaded with NPCs in them or unload them when there are no other players inside the chunk
   selection:
   selection:
     quick-select: false
     quickselect: false # no message will be sent
     item: '280'
     item: '280' # the selector item: default is stick
     message: <b>You selected <a><npc><b>!
     message: <b>You selected <a><npc><b>! # the message sent on select
   server-ownership: false
   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
  serverownership: false # whether the server owns NPCs by default
   text:
   text:
     max-talk-cooldown: 60
     maxtalkcooldown: 1 # the maximum cooldown before the NPC will talk close in seconds : the cooldown is chosen at random between the min/max
     min-talk-cooldown: 30
     mintalkcooldown: 1 # the minimum cooldown before the NPC will talk close in seconds
     talk-item: '340'
     talkitem: '340' # the items that will cause the NPC to talk to you on right click : default is book
   pathing:
   pathfinding:
     default-pathfinding-range: 25.0
     usenewfinder: false # EXPERIMENTAL: enable non-Minecraft pathfinder
   limits:
advanced:
    default-limit: 10
   checkminecraftversion: true # set this to false to disable minecraft compatibility checks. Should not normally be used.
    max-permission-checks: 100
storage:
storage:
   database:
   savetask:
     driver: ''
     delay: 72000 # the delay in ticks before everything gets serialised to disk
    password: ''
   file: saves.yml # the storage file
    url: ''
   type: yaml # the type: can be NBT, YAML.
    username: ''
   file: saves.yml
   type: yaml
  save-task:
    delay: 72000
general:
general:
   debug-mode: false
   debugmode: false # enable debug output
subplugins:
  colorscheme:
   folder: plugins
    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
     cost: 100.0 # the cost of an NPC. NOTE: requires Vault
subplugins:
  folder: plugins # subplugins like Denizen etc can be placed into Citizens/<subplugins folder> for organisational purposes.
</pre>
</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
Line 77: Line 90:
     {{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'}}
 
}}
{{NavBox}}
{{NavBox}}
[[Category:Configuration]]
[[Category:Configuration]]

Revision as of 05:55, 18 November 2014

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
npc:
  chat:
    options:
      bystandersheartargetedchat: true
      maxnumberoftargetstoshow: 2
      multipletargetsformat: <target>|, <target>| & <target>| & others
      range: 5
    format:
      notargets: '[<npc>]: <text>'
      withtargettobystanders: '[<npc>] -> [<target>]: <text>'
      totarget: '[<npc>] -> You: <text>'
      withtargetstobystanders: '[<npc>] -> [<targets>]: <text>'
  default:
    lookclose: # NPCs turning heads towards players settings
      enabled: false # whether look close is enabled by default
      range: 5 # the look close range
    pathfinding:
      range: 25.0 # the maximum pathfinding range to search through before giving up
    randomtalker: true # whether the NPC will randomly select a text item instead of sequentially
    realisticlooking: false # whether the NPC will ensure potential players to look at / talk to aren't obscured by walls
    stationaryticks: -1 # how long the NPC will be stationary while pathfinding before giving up
    talkclose:
      enabled: false # default talk close
      range: 5 # range before NPC talks
    text:
      '0': Hi, I'm <npc>! # default text
  limits:
    defaultlimit: 10 # the default per-player NPC limit
    maxpermissionchecks: 100 # the maximum number of per-player NPCs a player can have
    maxspeed: 100 # the maximum speed an NPC can have
  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
  selection:
    quickselect: false # no message will be sent
    item: '280' # the selector item: default is stick
    message: <b>You selected <a><npc><b>! # the message sent on select
  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
  serverownership: false # whether the server owns NPCs by default
  text:
    maxtalkcooldown: 1 # the maximum cooldown before the NPC will talk close in seconds : the cooldown is chosen at random between the min/max
    mintalkcooldown: 1 # the minimum cooldown before the NPC will talk close in seconds
    talkitem: '340' # the items that will cause the NPC to talk to you on right click : default is book
  pathfinding:
    usenewfinder: false # EXPERIMENTAL: enable non-Minecraft pathfinder
advanced:
  checkminecraftversion: true # set this to false to disable minecraft compatibility checks. Should not normally be used.
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:
  npc:
    cost: 100.0 # the cost of an NPC. NOTE: requires Vault
subplugins:
  folder: plugins # subplugins like Denizen etc can be placed into Citizens/<subplugins folder> for organisational purposes.


{{#if:|}}