Bukkit

YML Configurator

Description

YML Configurator is a tool for edit all .yml file on your server without using any text editor.

Commands

<> = Required [] = Optional
You can use /ymlconfigurator or /ymlconfig or /ymlconf or /yml

• /yml list/ls [startAt] [endAt]
  • Show all yml files in current directory
  • Example: /yml list 1 5
• /yml edit/open/read <file>
  • Open yml file
  • Example: /yml edit config.yml
• /yml show
  • **Show contents of file
• /yml set <path> <value>
  • **Set value to path (see details below)
  • Example: /yml set SMP.SaveOnExit b:true
• /yml save
  • **Save changes to file
• /yml format/style <normal/node>
  • Set how configurator show yml file contents (see details below)
  • Example: /yml format node

** Works after open file

Value params

YML has many data types to use. YML Configurator lets you set various of data types as following...

• null
  • This is null. Set to this value to delete path
• VALUE
  • This is string.
• [VALUE,VALUE,...]
  • This is string list.
• TYPE:VALUE
  • This is type-specific value. By replace VALUE with value you want to set and TYPE with following type you want...
    • b
      • This will set value as Boolean
    • d
      • This will set value as Double
    • i
      • This will set value as Integer
    • l
      • This will set value as Long.
    • otherwise
      • This will set value as Object.
• TYPE:[VALUE,VALUE,...]
  • This is type-specific list. By replace VALUE with value you want to set and TYPE with following type you want...
    • b
      • This will set as Boolean List.
    • d
      • This will set as Double List.
    • i
      • This will set as Integer List.
    • l
      • This will set as Long List.
    • f
      • This will set as Float List.
    • otherwise
      • This will set as List.

Example:
Commands: /yml set SMP.TestNode.TestOptions null
Result: Remove path "SMP.TestNode.TestOptions"

Commands: /yml set SMP.TestNode.TestOptions b:true
Result: Set "SMP.TestNode.TestOptions" to boolean "true"

Commands: /yml set SMP.TestNode.TestOptions [Hello,World]
Result: Set "SMP.TestNode.TestOptions" to String List contains "Hello" and "World"

Commands: /yml set SMP.TestNode.TestOptions d:[15,50.51]
Result: Set "SMP.TestNode.TestOptions" to Double List contains "15" and "50.51"

Commands: /yml set SMP.TestNode.TestOptions Welcome
Result: Set "SMP.TestNode.TestOptions" to String "Welcome"

YML Format/Style

After you open yml file, these options will help you see all of value path in that file in 2 ways which is "normal" and "node"...

• Normal
  
• Node
  

Tool Limitation

• YML Configurator cannot set these following data types...
  • String contains space
  • StringList contains space
  • ItemStack
  • OfflinePlayer
  • Following list...
    • Byte list
    • Character list
    • Map list
    • Short list
  • Set
  • Vector
  • And unknown data type