Types/Order - Revision history

BilkaBot: Removed old prototype docs

2024-10-25T14:32:14Z

Removed old prototype docs

← Older revision		Revision as of 14:32, 25 October 2024
Line 2:		Line 2:

	</p><p>This wiki page is no longer updated and '''will be removed at some point in the future''', so please update your browser bookmarks or other links that sent you here. If you'd like to contribute to the new docs, you can leave your feedback [https://forums.factorio.com/viewforum.php?f=233 on the forums].</p></div>		</p><p>This wiki page is no longer updated and '''will be removed at some point in the future''', so please update your browser bookmarks or other links that sent you here. If you'd like to contribute to the new docs, you can leave your feedback [https://forums.factorio.com/viewforum.php?f=233 on the forums].</p></div>



	~~__NOTOC__~~
	~~== Basic ==~~
	The order property is a '''simple''' [[Types/string\|string]]. When the game needs to sort prototypes, it looks at their order properties and sorts those alphabetically. A prototype with an order string of "a" will be listed before other prototypes with order string "b" or "c". The "-" or "[]" structures that can be found in vanilla order strings ''do not'' have any special meaning.

	~~== Advanced ==~~
	When the game compares two prototypes (of the same type) if the order strings aren't equal they're [[:Wikipedia:Lexicographical_order\|lexicographically compared]] to determine if a given prototype is shown before or after another. If the order strings are equal then the game falls back to comparing the prototype names to determine order.

	~~== Examples ==~~

	~~=== Two item prototypes ===~~
	~~The second item is shown before the first one (in the crafting grid/inventory etc)~~

	~~<syntaxhighlight lang="lua">{~~
	~~type = "item",~~
	~~name = "item-1",~~
	~~order = "ad",~~
	},

	{
	~~type = "item",~~
	~~name = "item-2",~~
	~~order = "ab",~~
	~~},</syntaxhighlight>~~

	~~=== Some sorted strings ===~~
	~~Using an UTF-8 character list, the sort order of special characters can be identified. This is the sort order for common characters:~~
	* "-"
	* "0"
	* "9"
	* "A"
	* "Z"
	* "["
	* "]"
	* "a"
	* "z"

	~~Example using the above ordering:~~
	* "a"
	* "ab"
	* "azaaa" (<code>b</code> is sorted before <code>z</code>, so "ab" comes before "az", regardless of the rest of the letters after "az")
	* "b"
	* "b-zzzz"
	* "b[aaaa]" (<code>[</code> is sorted after <code>-</code> in UTF-8)
	* "bb" (<code>b</code> is sorted after <code>[</code> in UTF-8)

BilkaBot: Updated styling of prototype doc migration note

2023-09-21T10:42:19Z

Updated styling of prototype doc migration note

← Older revision		Revision as of 10:42, 21 September 2023
Line 1:		Line 1:
	'''The prototype docs have moved to a new website with an improved format.''' This documentation page can now be found here: [https://lua-api.factorio.com/latest/types/Order.html https://lua-api.factorio.com/latest/types/Order.html]		<div class="stub"><p>'''The prototype docs have moved to a new website with an improved format.''' This documentation page can now be found here: [https://lua-api.factorio.com/latest/types/Order.html https://lua-api.factorio.com/latest/types/Order.html]

	This wiki page is no longer updated and '''will be removed at some point in the future''', so please update your browser bookmarks or other links that sent you here. If you'd like to contribute to the new docs, you can leave your feedback [https://forums.factorio.com/viewforum.php?f=233 on the forums].		</p><p>This wiki page is no longer updated and '''will be removed at some point in the future''', so please update your browser bookmarks or other links that sent you here. If you'd like to contribute to the new docs, you can leave your feedback [https://forums.factorio.com/viewforum.php?f=233 on the forums].</p></div>

BilkaBot: Protected "Types/Order": Migrated prototype doc to separate website ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

2023-08-16T17:51:26Z

Protected "Types/Order": Migrated prototype doc to separate website ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))

← Older revision		Revision as of 17:51, 16 August 2023
(No difference)

BilkaBot: Migrated prototype doc to separate website

2023-08-16T17:51:26Z

Migrated prototype doc to separate website

← Older revision		Revision as of 17:51, 16 August 2023
Line 1:		Line 1:
			'''The prototype docs have moved to a new website with an improved format.''' This documentation page can now be found here: [https://lua-api.factorio.com/latest/types/Order.html https://lua-api.factorio.com/latest/types/Order.html]

			This wiki page is no longer updated and '''will be removed at some point in the future''', so please update your browser bookmarks or other links that sent you here. If you'd like to contribute to the new docs, you can leave your feedback [https://forums.factorio.com/viewforum.php?f=233 on the forums].



	__NOTOC__		__NOTOC__
	== Basic ==		== Basic ==

Bilka: /* Advanced */ grammar

2018-09-07T20:45:25Z

Advanced: grammar

← Older revision		Revision as of 20:45, 7 September 2018
Line 4:		Line 4:

	== Advanced ==		== Advanced ==
	When the game compares two prototypes (of the same type) if the order strings aren't equal they're [[:Wikipedia:Lexicographical_order\|lexicographically compared]] to determine if a given prototype is shown before or after another. ~~When~~ the order strings are equal the game ~~then~~ falls back to comparing the prototype names to determine order.		When the game compares two prototypes (of the same type) if the order strings aren't equal they're [[:Wikipedia:Lexicographical_order\|lexicographically compared]] to determine if a given prototype is shown before or after another. If the order strings are equal then the game falls back to comparing the prototype names to determine order.

	== Examples ==		== Examples ==

Bilka: grammar

2018-09-06T20:18:53Z

grammar

← Older revision		Revision as of 20:18, 6 September 2018
Line 4:		Line 4:

	== Advanced ==		== Advanced ==
	When the game compares 2 prototypes (of the same type) if the order strings aren't equal they're [[:Wikipedia:Lexicographical_order\|lexicographically compared]] to determine if a given prototype is shown before or after another. When the order strings are equal the game then falls back to comparing the prototype names to determine order.		When the game compares two prototypes (of the same type) if the order strings aren't equal they're [[:Wikipedia:Lexicographical_order\|lexicographically compared]] to determine if a given prototype is shown before or after another. When the order strings are equal the game then falls back to comparing the prototype names to determine order.

	== Examples ==		== Examples ==
Line 24:		Line 24:

	=== Some sorted strings ===		=== Some sorted strings ===
	Using a UTF-8 character list, the sort order of special characters can identified~~, here~~ the sort order for common characters:		Using an UTF-8 character list, the sort order of special characters can be identified. This is the sort order for common characters:
	* "-"		* "-"
	* "0"		* "0"

Daniel34 at 19:24, 6 September 2018

2018-09-06T19:24:00Z

← Older revision		Revision as of 19:24, 6 September 2018
Line 1:		Line 1:
	__NOTOC__		__NOTOC__
	== Basic ==		== Basic ==
	The order property is a '''simple''' [[Types/string\|string]]. When the game needs to sort prototypes, it looks at their order properties and sorts those alphabetically. ~~So, something~~ with ~~the~~ order "a" ~~comes~~ before ~~something~~ with ~~the~~ order "b" or "c". The "-" or "[]" structures that can be found in vanilla order strings ''do not'' have any special meaning.		The order property is a '''simple''' [[Types/string\|string]]. When the game needs to sort prototypes, it looks at their order properties and sorts those alphabetically. A prototype with an order string of "a" will be listed before other prototypes with order string "b" or "c". The "-" or "[]" structures that can be found in vanilla order strings ''do not'' have any special meaning.

	== Advanced ==		== Advanced ==

Bilka: grammar

2018-09-06T19:01:00Z

grammar

← Older revision		Revision as of 19:01, 6 September 2018
Line 4:		Line 4:

	== Advanced ==		== Advanced ==
	When the game compares 2 ~~like~~ prototypes if the order strings aren't equal they're [[:Wikipedia:Lexicographical_order\|lexicographically compared]] to determine if a given prototype ~~comes~~ before or after another. When the order strings are equal the game then falls back to comparing the prototype names to determine order.		When the game compares 2 prototypes (of the same type) if the order strings aren't equal they're [[:Wikipedia:Lexicographical_order\|lexicographically compared]] to determine if a given prototype is shown before or after another. When the order strings are equal the game then falls back to comparing the prototype names to determine order.

	== Examples ==		== Examples ==

Bilka: notoc

2018-09-06T10:45:37Z

notoc

← Older revision		Revision as of 10:45, 6 September 2018
Line 1:		Line 1:
			__NOTOC__
	== Basic ==		== Basic ==
	The order property is a '''simple''' [[Types/string\|string]]. When the game needs to sort prototypes, it looks at their order properties and sorts those alphabetically. So, something with the order "a" comes before something with the order "b" or "c". The "-" or "[]" structures that can be found in vanilla order strings ''do not'' have any special meaning.		The order property is a '''simple''' [[Types/string\|string]]. When the game needs to sort prototypes, it looks at their order properties and sorts those alphabetically. So, something with the order "a" comes before something with the order "b" or "c". The "-" or "[]" structures that can be found in vanilla order strings ''do not'' have any special meaning.

Bilka: more simple explanation, more examples

2018-09-06T10:41:33Z

more simple explanation, more examples

@@ Line 1: / Line 1: @@
-The order property is a simple [[Types/string|string]]. When the game compares 2 like prototypes if the order strings aren't equal they're [[:Wikipedia:Lexicographical_order|lexicographically compared]] to determine if a given prototype comes before or after another. When the order strings are equal the game then falls back to comparing the prototype names to determine order.
+== Basic ==
-Example: The second item is shown before the first one (in the crafting grid/inventory etc)
+== Advanced ==
+== Examples ==
      type = "item",
      name = "item-1",
-     order = "a-d",
+     order = "ad",
    },
@@ Line 12: / Line 19: @@
      type = "item",
      name = "item-2",
-     order = "a-b",
+     order = "ab",
-  },
+  },</syntaxhighlight>