Home | Crossfire Wiki

Current	YAML	XML	JSON	TOML
Pros: Known within crossfire community Does allow comments Does not require quoting Cons: Completely custom Notes:	Pros: Common, well-known Does allow comments Does allow multiline strings Does not require quoting Easy to read Whitespace forces nice formatting Cons: Whitespace dependant YAML spec is complicated Notes: Not using quotes can lead to ambiguity between numbers and strings	Pros: Common, well-known Does allow comments Does allow multiline strings XSD Validation Cons: Hard to read Notes: Spec here is arbitrary	Pros: Common, well-known Easy to read Cons: Requires commas Requires quotes Does not allow comments Does not allow multiline strings Does not allow trailing commas Notes: Should "ingred" allow plain strings to signify [1, "item"], mixed with [7, "water"]?	Pros: Does allow comments Does allow multiline strings Does allow trailing commas Easy to read Cons: Requires quotes Does not have a null Arrays must be same type "ingred" list is more complicated Notes:
># formulae -- herein lie the formulae for alchemical products # # The code is designed... <snipped> # >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> # F O R M U L A E B E G I N # >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> # # -------------- # Basic formulae - these formulae make some of the most often used # ingredients. # -------------- # # true lead Object NONE arch true_lead yield 3 chance 5 diff 20 exp 100000 skill alchemy cauldron cauldron ingred lead,pile of philosophical salt,bottle of philosophical oil,pile of philosophical sulphur,pile of philosophical phosphorus # # water of the wise Object the wise arch water chance 30 diff 8 exp 1000 yield 7 skill alchemy cauldron cauldron ingred 7 water	>comment: \| formulae -- herein lie the formulae for alchemical products The code is designed... <snipped> # >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> # F O R M U L A E B E G I N # >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> # # -------------- # Basic formulae - these formulae make some of the most often used ingredients. # -------------- formulae: - comment: true lead object: null arch: true_lead yield: 3 chance: 5 diff: 20 exp: 100000 skill: alchemy cauldron: cauldron ingred: - lead - pile of philosophical salt - bottle of philosophical oil - pile of philosophical sulphur - pile of philosophical phosphorus - comment: water of the wise object: the wise arch: water chance: 30 diff: 8 exp: 1000 yield: 7 skill: alchemy cauldron: cauldron ingred: - [7, water]	><?xml version="1.0" encoding="UTF-8"?> <formulae> <comment> formulae -- herein lie the formulae for alchemical products The code is designed... [snipped] </comment> <!-- >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> F O R M U L A E B E G I N >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> ============== Basic formulae - these formulae make some of the most often used ingredients. ============== --> <formula> <comment>true lead</comment> <object></object> <arch>true_lead</arch> <yield value="3"/> <chance value="5"/> <diff value="20"/> <exp value="100000"/> <skill>alchemy</skill> <cauldron>cauldron</cauldron> <ingreds> <ingred>lead</ingred> <ingred>pile of philosophical salt</ingred> <ingred>bottle of philosophical oil</ingred> <ingred>pile of philosophical sulphur</ingred> <ingred>pile of philosophical phosphorus</ingred> </ingreds> </formula> <formula> <comment>water of the wise</comment> <object>the wise</object> <arch>water</arch> <chance value="30"/> <diff value="8"/> <exp value="1000"/> <yield value="7"/> <skill>alchemy</skill> <cauldron>cauldron</cauldron> <ingreds> <ingred quantity="7">water</ingred> </ingreds> </formula> </formulae>	>{ "comment": "formulae -- herein lie the formulae for alchemical products\nThe code is designed... <snipped>\n>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>\nF O R M U L A E B E G I N\n>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>\n--------------\nBasic formulae - these formulae make some of the most often used ingredients.", "formulae": [ { "comment": "true lead", "object": null, "arch": "true_lead", "yield": 3, "chance": 5, "diff": 20, "exp": 100000, "skill": "alchemy", "cauldron": "cauldron", "ingred": [ "lead", "pile of philosophical salt", "bottle of philosophical oil", "pile of philosophical sulphur", "pile of philosophical phosphorus" ] }, { "comment": "water of the wise", "object": "the wise", "arch": "water", "chance": 30, "diff": 8, "exp": 1000, "yield": 7, "skill": "alchemy", "cauldron": "cauldron", "ingred": [ [ 7, "water" ] ] } ] }	>comment = ''' formulae -- herein lie the formulae for alchemical products The code is designed... <snipped> ''' # >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> # F O R M U L A E B E G I N # >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> # # -------------- # Basic formulae - these formulae make some of the most often used ingredients. # -------------- [[formulae]] comment = "true lead" object = "NONE" arch = "true_lead" yield = 3 chance = 5 diff = 20 exp = 100000 skill = "alchemy" cauldron = "cauldron" [[formulae.ingred.lead]] [[formulae.ingred."pile of philosophical salt"]] [[formulae.ingred."bottle of philosophical oil"]] [[formulae.ingred."pile of philosophical sulphur"]] [[formulae.ingred."pile of philosophical phosphorus"]] [[formulae]] comment = "water of the wise" object = "water" arch = "water" chance = 30 diff = 8 exp = 1000 yield = 7 skill = "alchemy" cauldron = "cauldron" [[formulae.ingred.water]] quantity = 7

Current

YAML

XML

JSON

TOML

Pros:

Known within crossfire community
Does allow comments
Does not require quoting

Cons:

Completely custom

Notes:

Pros:

Common, well-known
Does allow comments
Does allow multiline strings
Does not require quoting
Easy to read
Whitespace forces nice formatting

Cons:

Whitespace dependant
YAML spec is complicated

Notes:

Not using quotes can lead to ambiguity between numbers and strings

Pros:

Common, well-known
Does allow comments
Does allow multiline strings
XSD Validation

Cons:

Hard to read

Notes:

Spec here is arbitrary

Pros:

Common, well-known
Easy to read

Cons:

Requires commas
Requires quotes
Does not allow comments
Does not allow multiline strings
Does not allow trailing commas

Notes:

Should "ingred" allow plain strings to signify [1, "item"], mixed with [7, "water"]?

Pros:

Does allow comments
Does allow multiline strings
Does allow trailing commas
Easy to read

Cons:

Requires quotes
Does not have a null
Arrays must be same type
"ingred" list is more complicated

Notes:

><?xml version="1.0" encoding="UTF-8"?>
<formulae>
  <comment>
    formulae -- herein lie the formulae for alchemical products

The code is designed... [snipped]
  </comment>
  <!--
  >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  F O R M U L A E  B E G I N
  >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>

==============
  Basic formulae - these formulae make some of the most often used ingredients.
  ==============
  -->
  <formula>
    <comment>true lead</comment>
    <object></object>
    <arch>true_lead</arch>
    <yield value="3"/>
    <chance value="5"/>
    <diff value="20"/>
    <exp value="100000"/>
    <skill>alchemy</skill>
    <cauldron>cauldron</cauldron>
    <ingreds>
      <ingred>lead</ingred>
      <ingred>pile of philosophical salt</ingred>
      <ingred>bottle of philosophical oil</ingred>
      <ingred>pile of philosophical sulphur</ingred>
      <ingred>pile of philosophical phosphorus</ingred>
    </ingreds>
  </formula>
  <formula>
    <comment>water of the wise</comment>
    <object>the wise</object>
    <arch>water</arch>
    <chance value="30"/>
    <diff value="8"/>
    <exp value="1000"/>
    <yield value="7"/>
    <skill>alchemy</skill>
    <cauldron>cauldron</cauldron>
    <ingreds>
      <ingred quantity="7">water</ingred>
    </ingreds>
  </formula>
</formulae>

>{
  "comment": "formulae -- herein lie the formulae for alchemical products\nThe code is designed... <snipped>\n>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>\nF O R M U L A E  B E G I N\n>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>\n--------------\nBasic formulae - these formulae make some of the most often used ingredients.",
  "formulae": [
    {
      "comment": "true lead",
      "object": null,
      "arch": "true_lead",
      "yield": 3,
      "chance": 5,
      "diff": 20,
      "exp": 100000,
      "skill": "alchemy",
      "cauldron": "cauldron",
      "ingred": [
        "lead",
        "pile of philosophical salt",
        "bottle of philosophical oil",
        "pile of philosophical sulphur",
        "pile of philosophical phosphorus"
      ]
    },
    {
      "comment": "water of the wise",
      "object": "the wise",
      "arch": "water",
      "chance": 30,
      "diff": 8,
      "exp": 1000,
      "yield": 7,
      "skill": "alchemy",
      "cauldron": "cauldron",
      "ingred": [
        [
          7,
          "water"
        ]
      ]
    }
  ]
}

Crossfire Format Comparison