Template:DifficultyDef - Revision history

76561198026315966: obelisk-bot: Pushing translation table rework

2026-05-14T20:47:59Z

obelisk-bot: Pushing translation table rework

← Older revision		Revision as of 20:47, 14 May 2026
Line 5:		Line 5:

	* The source <code>nameSid</code> values (<code>EasyDifficultySid</code>, <code>NormalDifficultySid</code>, …) are ''not'' L10n entries — they don't resolve in any <code>Lang/<locale>/</code> file. We store them on the row for fidelity, but the canonical display name is the <code>id</code> itself.		* The source <code>nameSid</code> values (<code>EasyDifficultySid</code>, <code>NormalDifficultySid</code>, …) are ''not'' L10n entries — they don't resolve in any <code>Lang/<locale>/</code> file. We store them on the row for fidelity, but the canonical display name is the <code>id</code> itself.
	* The source <code>descriptionSid</code> field carries literal English text ("This is an Easy difficulty setting."), not an L10n key~~. We store it as a plain <code>description</code> string column~~.		* The source <code>descriptionSid</code> field carries literal English text ("This is an Easy difficulty setting."), not an L10n key.

	Because ~~of those~~, this table ~~doesn~~'~~t carry a companion~~ <code>~~<nowiki>{{TranslationDef}}</nowiki>~~</code> ~~row~~ — the ~~source data ships in English only~~.		Because the source ships English-only, this table's [[Template:TranslationDef\|Translation]] rows exist only for <code>language=en</code> — a query in any other language correctly returns nothing. The lookup path stays uniform with every other entity even though there's just the one language.

	== Page layout ==		== Page layout ==
	<code>Data:Difficulty/<id></code> carries a single <code><nowiki>{{DifficultyDef}}</nowiki></code> row.		<code>Data:Difficulty/<id></code> carries a single <code><nowiki>{{DifficultyDef}}</nowiki></code> row followed by one <code><nowiki>{{TranslationDef \| type=difficulty \| language=en}}</nowiki></code> row.

	== Schema ==		== Schema ==
Line 16:		Line 16:
	\| id = String		\| id = String
	\| name_sid = String		\| name_sid = String
	~~\| description = Wikitext~~
	\| neutral_power_multiplier = Float		\| neutral_power_multiplier = Float
	\| player_gold = Integer		\| player_gold = Integer
Line 39:		Line 38:
	\| id = String <!-- Easy / Normal / Hard / Expert / Impossible -->		\| id = String <!-- Easy / Normal / Hard / Expert / Impossible -->
	\| name_sid = String <!-- nullable; not actually in L10n corpus -->		\| name_sid = String <!-- nullable; not actually in L10n corpus -->
	~~\| description = Wikitext <!-- literal English from source descriptionSid -->~~
	\| neutral_power_multiplier = Float <!-- 0.5 / 0.75 / 1.0 / 1.5 / 2.0 -->		\| neutral_power_multiplier = Float <!-- 0.5 / 0.75 / 1.0 / 1.5 / 2.0 -->
	\| player_gold = Integer		\| player_gold = Integer
Line 66:		Line 64:

	== Related tables ==		== Related tables ==
			* [[Template:TranslationDef\|Translation]] — the difficulty's description, joined on <code>id = Translation.target_id WHERE Translation.type='difficulty' AND Translation.language='en'</code> (English-only; the source ships no other languages).
	* [[Template:EntryDef\|<code>Resource</code>]] — the seven per-side <code><player\|ai>_<resource></code> columns mirror the resource ids on the Resource Entry rows (gold / wood / ore / gemstones / crystals / mercury / dust).		* [[Template:EntryDef\|<code>Resource</code>]] — the seven per-side <code><player\|ai>_<resource></code> columns mirror the resource ids on the Resource Entry rows (gold / wood / ore / gemstones / crystals / mercury / dust).

Line 72:		Line 71:
	\| id = {{{id\|}}}		\| id = {{{id\|}}}
	\| name_sid = {{{name_sid\|}}}		\| name_sid = {{{name_sid\|}}}
	~~\| description = {{{description\|}}}~~
	\| neutral_power_multiplier = {{{neutral_power_multiplier\|}}}		\| neutral_power_multiplier = {{{neutral_power_multiplier\|}}}
	\| player_gold = {{{player_gold\|}}}		\| player_gold = {{{player_gold\|}}}

76561198026315966: obelisk-bot: uploading initial Cargo templates

2026-05-13T01:12:37Z

obelisk-bot: uploading initial Cargo templates

← Older revision		Revision as of 01:12, 13 May 2026
Line 89:		Line 89:
	\| ai_dust = {{{ai_dust\|}}}		\| ai_dust = {{{ai_dust\|}}}
	\| source_path = {{{source_path\|}}}		\| source_path = {{{source_path\|}}}
	}}</includeonly>		}}
			Created <code>Difficulty</code> entry: <code>{{{id\|}}}</code></includeonly>

76561198026315966: obelisk-bot: uploading initial Cargo templates

2026-05-13T00:02:18Z

obelisk-bot: uploading initial Cargo templates

← Older revision		Revision as of 00:02, 13 May 2026
Line 7:		Line 7:
	* The source <code>descriptionSid</code> field carries literal English text ("This is an Easy difficulty setting."), not an L10n key. We store it as a plain <code>description</code> string column.		* The source <code>descriptionSid</code> field carries literal English text ("This is an Easy difficulty setting."), not an L10n key. We store it as a plain <code>description</code> string column.

	Because of those, this table doesn't carry a companion <code>{{TranslationDef}}</code> row — the source data ships in English only.		Because of those, this table doesn't carry a companion <code><nowiki>{{TranslationDef}}</nowiki></code> row — the source data ships in English only.

	== Page layout ==		== Page layout ==
	<code>Data:Difficulty/<id></code> carries a single <code>{{DifficultyDef}}</code> row.		<code>Data:Difficulty/<id></code> carries a single <code><nowiki>{{DifficultyDef}}</nowiki></code> row.

	== Schema ==		== Schema ==

76561198026315966: obelisk-bot: uploading initial Cargo templates

2026-05-12T23:33:16Z

obelisk-bot: uploading initial Cargo templates

New page

<noinclude>
One row per game difficulty setting. 5 entries in 2026-05-05: Easy / Normal / Hard / Expert / Impossible. Each carries the balance inputs the engine actually uses: per-side starting-resource buckets and the global <code>neutral_power_multiplier</code> (the scalar applied to adventure-map encounter strength).

Two source-data quirks worth flagging up front:

* The source <code>nameSid</code> values (<code>EasyDifficultySid</code>, <code>NormalDifficultySid</code>, …) are ''not'' L10n entries — they don't resolve in any <code>Lang/<locale>/</code> file. We store them on the row for fidelity, but the canonical display name is the <code>id</code> itself.
* The source <code>descriptionSid</code> field carries literal English text ("This is an Easy difficulty setting."), not an L10n key. We store it as a plain <code>description</code> string column.

Because of those, this table doesn't carry a companion <code>{{TranslationDef}}</code> row — the source data ships in English only.

== Page layout ==
<code>Data:Difficulty/<id></code> carries a single <code>{{DifficultyDef}}</code> row.

== Schema ==
{{#cargo_declare:_table=Difficulty
| id = String
| name_sid = String
| description = Wikitext
| neutral_power_multiplier = Float
| player_gold = Integer
| player_wood = Integer
| player_ore = Integer
| player_gemstones = Integer
| player_crystals = Integer
| player_mercury = Integer
| player_dust = Integer
| ai_gold = Integer
| ai_wood = Integer
| ai_ore = Integer
| ai_gemstones = Integer
| ai_crystals = Integer
| ai_mercury = Integer
| ai_dust = Integer
| source_path = String
}}

<pre><nowiki>
{{DifficultyDef
| id = String 
| name_sid = String 
| description = Wikitext 
| neutral_power_multiplier = Float 
| player_gold = Integer
| player_wood = Integer
| player_ore = Integer
| player_gemstones = Integer
| player_crystals = Integer
| player_mercury = Integer
| player_dust = Integer
| ai_gold = Integer
| ai_wood = Integer
| ai_ore = Integer
| ai_gemstones = Integer
| ai_crystals = Integer
| ai_mercury = Integer
| ai_dust = Integer
| source_path = String
}}
</nowiki></pre>

== Field notes ==
* '''<code>id</code>''' comes from the source <code>sid</code> field. Five fixed values; new difficulty tiers would be a balance change worth flagging.
* '''<code>neutral_power_multiplier</code>''' is the headline balance number. 1.0 is "Hard" (the canonical reference point); Easy halves encounter strength, Impossible doubles it.
* '''Resource columns''': source-side <code>alchemicalDust</code> is normalized to <code>dust</code> to match the canonical naming in [[Template:EntryDef|<code>Resource</code>]] (per <code>DB/res/resources_info.json</code>).
* '''Asymmetry''': on Easy, the player starts with 3× the resources the AI does; this flips on Hard+, with the Impossible AI getting 5× the player's gold. That's the ''primary'' difficulty mechanism — <code>neutral_power_multiplier</code> only modulates map encounters.

== Related tables ==
* [[Template:EntryDef|<code>Resource</code>]] — the seven per-side <code><player|ai>_<resource></code> columns mirror the resource ids on the Resource Entry rows (gold / wood / ore / gemstones / crystals / mercury / dust).

[[Category:Cargo Definitions]]
</noinclude><includeonly>{{#cargo_store:_table=Difficulty
| id = {{{id|}}}
| name_sid = {{{name_sid|}}}
| description = {{{description|}}}
| neutral_power_multiplier = {{{neutral_power_multiplier|}}}
| player_gold = {{{player_gold|}}}
| player_wood = {{{player_wood|}}}
| player_ore = {{{player_ore|}}}
| player_gemstones = {{{player_gemstones|}}}
| player_crystals = {{{player_crystals|}}}
| player_mercury = {{{player_mercury|}}}
| player_dust = {{{player_dust|}}}
| ai_gold = {{{ai_gold|}}}
| ai_wood = {{{ai_wood|}}}
| ai_ore = {{{ai_ore|}}}
| ai_gemstones = {{{ai_gemstones|}}}
| ai_crystals = {{{ai_crystals|}}}
| ai_mercury = {{{ai_mercury|}}}
| ai_dust = {{{ai_dust|}}}
| source_path = {{{source_path|}}}
}}</includeonly>