Modding:XML File Format Primer - Revision history

Sightglass: Note about order of elements

2024-02-22T01:13:25Z

Note about order of elements

← Older revision		Revision as of 01:13, 22 February 2024
Line 40:		Line 40:

	Tags can also have '''attributes''', which are key-value pairs included in the opening tag and formatted like: <code><tag key1="value1" key2="value2"></tag></code>. Each attribute in a tag must be unique.		Tags can also have '''attributes''', which are key-value pairs included in the opening tag and formatted like: <code><tag key1="value1" key2="value2"></tag></code>. Each attribute in a tag must be unique.

			The order in which elements appear usually does not matter. When the game is looking for an element with a specific name, it will find the first matching one within the scope. If the game is looking for multiple elements with a name, it will generally iterate through all of them in a certain scope.
	[[Category:Modding Guides]]		[[Category:Modding Guides]]

Sightglass: Add Modding Guide category tag

2024-02-21T05:44:54Z

Add Modding Guide category tag

← Older revision		Revision as of 05:44, 21 February 2024
Line 40:		Line 40:

	Tags can also have '''attributes''', which are key-value pairs included in the opening tag and formatted like: <code><tag key1="value1" key2="value2"></tag></code>. Each attribute in a tag must be unique.		Tags can also have '''attributes''', which are key-value pairs included in the opening tag and formatted like: <code><tag key1="value1" key2="value2"></tag></code>. Each attribute in a tag must be unique.
			[[Category:Modding Guides]]

Sightglass: Page created

2024-02-21T05:34:37Z

Page created

Páàjì titun

Lilith's Throne modding system loads in content as Extensible Markup Language (XML) text files. It's just text formatted to fit a certain structure, and they can be opened and edited by any text editor, though some will have tools like syntax highlighting and XML-checking tools to help catch mistakes.

Here's a dummy example, to show how things are structured:<blockquote><?xml version="1.0" encoding="UTF-8" standalone="no"?>

<tag>

<element>text content</element>

<emptyTag/>

<cdataElement><![CDATA[CData Stuff]]></cdataElement>

<elementWithAttribute attribute="attribute value" secondAttribute="second value">this is also content</elementWithAttribute>

<emptyTagWithAttribue attribute="this is also an attribute value"/>

<outerElement>

<nestedElement attribute="yet another attribute">this is content too</nestedElement>

<nestedElement attribute="yet another attribute">contented for a second</nestedElement>

</outerElement>

</tag></blockquote>An XML file is arranged as '''elements''', each having an '''opening tag''' <code><tag></code> and a '''closing tag''' <code></tag></code>.

The name of an element (which goes in the tag) follows a few simple rules:

# Must start with a letter or underscore ( _ )
# Cannot start with <code>xml</code>
# '''Are case sensitive!'''
# '''Cannot contain spaces!'''
# Can also have digits, hyphens, and periods, in addition to letters and underscores, but can't start with those (rule 1)

(Note: Most tag names used for LT are only letters with occasional numbers, and are usually in <code>camelCase</code>)

The stuff between the tags of an element, there may be '''content''': <code><element>text content</element></code>. An element without content is usually entered as a '''self-closing tag''' ending in a slash: <code><emptyTag/></code>, or otherwise entered as tags with nothing between them: <code><tag></tag></code>. An element's content may be '''text''' or another element, which is called a '''child element''': <code><element><childElement/></element></code>. Child elements can open with the same tag as others nested in the same parent.

Content for a tag in the form of <code><![CDATA[CData Stuff]]></code> is "'''character data'''", used to encapsulate text that may otherwise be interfere with the syntax of an XML document. For LT, it usually marks something that is sent to through a parser to perform scripting commands and/or displayed on screen as text.

Tags can also have '''attributes''', which are key-value pairs included in the opening tag and formatted like: <code><tag key1="value1" key2="value2"></tag></code>. Each attribute in a tag must be unique.