Template:BonusDef - Revision history

76561198026315966: obelisk-bot: Pushing translation table rework

2026-05-14T20:47:55Z

obelisk-bot: Pushing translation table rework

← Older revision		Revision as of 20:47, 14 May 2026
Line 1:		Line 1:
	<noinclude>		<noinclude>
	A unified Cargo table for bonus effects across multiple parent entity types. ~~Per D-031: hero~~ specializations, hero sub-classes, artifacts, item-set tiers, and faction laws all share one Bonus table with <code>parent_type</code> + <code>parent_id</code> discriminator columns.		A unified Cargo table for bonus effects across multiple parent entity types. Hero specializations, hero sub-classes, artifacts, item-set tiers, and faction laws all share one Bonus table with <code>parent_type</code> + <code>parent_id</code> discriminator columns.

	The bot emits each row inline on the parent entity's wiki page. There are no individual <code>Data:Bonus/…</code> pages.		The bot emits each row inline on the parent entity's wiki page. There are no individual <code>Data:Bonus/…</code> pages.

76561198026315966: obelisk-bot: uploading initial Cargo templates

2026-05-13T01:12:35Z

obelisk-bot: uploading initial Cargo templates

@@ Line 1: / Line 1: @@
 <noinclude>
-A unified Cargo table for bonus effects across multiple parent entity types. Per D-031: hero specializations, hero sub-classes, artifacts, item-set tiers, and faction laws all carry the same
+A unified Cargo table for bonus effects across multiple parent entity types. Per D-031: hero specializations, hero sub-classes, artifacts, item-set tiers, and faction laws all share one Bonus table with <code>parent_type</code> + <code>parent_id</code> discriminator columns.
 The bot emits each row inline on the parent entity's wiki page. There are no individual <code>Data:Bonus/…</code> pages.
@@ Line 25: / Line 21: @@
 | fraction = String
 }}
 == Field notes ==
-* '''Primary key is <code>(parent_type, parent_id, ordinal)</code>'''.
+* Primary key is <code>(parent_type, parent_id, ordinal)</code>.
-* '''<code>parent_type</code>''' identifies the parent entity table:
+* <code>parent_type</code> identifies the parent: <code>hero_specialization</code>, <code>hero_sub_class</code>, <code>artifact</code>, <code>item_set_tier</code>, <code>law_level</code>.
-** <code>hero_specialization</code> — joined to <code>HeroSpecialization.id</code>
+* <code>type</code> is the effect category (~13 distinct values; <code>heroStat</code>, <code>unitStat</code>, <code>heroBattleAbility</code> most common).
-** <code>hero_sub_class</code> — joined to <code>HeroSubClass.id</code>
+* <code>parameters</code> is comma-joined, type-dependent.
-** <code>artifact</code> — joined to <code>Artifact.id</code>
+* Sparse fields vary by parent type.
-** <code>item_set_tier</code> — joined to <code>ItemSetTier.id</code>
+* <code>action_area</code> (law-bonus only) qualifies which side an effect applies to.
-** <code>law_level</code> — joined to <code>LawLevelDef</code> on <code>parent_id = law_id || '_L' || level</code> Add new values as new bonus-bearing entities come online.
+* <code>fraction</code> (law-bonus only) is a target-faction filter; column name preserves the source JSON's misspelling.
 [[Category:Cargo Definitions]]
@@ Line 81: / Line 47: @@
 | action_area = {{{action_area|}}}
 | fraction = {{{fraction|}}}
-}}</includeonly>
+}}

76561198026315966: obelisk-bot: uploading initial Cargo templates

2026-05-13T00:31:18Z

obelisk-bot: uploading initial Cargo templates

← Older revision		Revision as of 00:31, 13 May 2026
Line 63:		Line 63:
	** Law-level bonuses use <code>receivers</code>, <code>receiver_allegiance</code>, <code>action_area</code>, <code>fraction</code>. They never use <code>activation_level</code>, <code>upgrade_*</code>, <code>battle_type</code>, or <code>receiver_role</code>.		** Law-level bonuses use <code>receivers</code>, <code>receiver_allegiance</code>, <code>action_area</code>, <code>fraction</code>. They never use <code>activation_level</code>, <code>upgrade_*</code>, <code>battle_type</code>, or <code>receiver_role</code>.
	* '''<code>action_area</code>''' (law-bonus only so far) — qualifier for which side a <code>barrackUpgradeUnitsHiring</code> etc. effect applies to. Values observed: <code>allied</code>.		* '''<code>action_area</code>''' (law-bonus only so far) — qualifier for which side a <code>barrackUpgradeUnitsHiring</code> etc. effect applies to. Values observed: <code>allied</code>.
	'' ''*`fractio		* '''<code>fraction</code>''' (law-bonus only so far) — target faction filter for a bonus restricted to a single faction. Column name preserves the source JSON's misspelling (<code>fraction</code> ↔ canonical English "faction") for traceability with the raw data.

	[[Category:Cargo Definitions]]		[[Category:Cargo Definitions]]

76561198026315966: obelisk-bot: uploading initial Cargo templates

2026-05-12T23:33:15Z

obelisk-bot: uploading initial Cargo templates

New page

<noinclude>
A unified Cargo table for bonus effects across multiple parent entity types. Per D-031: hero specializations, hero sub-classes, artifacts, item-set tiers, and faction laws all carry the same
<code>(type, parameters, [activationLevel], [upgrade], [receivers], …)</code>
source pattern, so they share one Bonus table with <code>parent_type</code> +
<code>parent_id</code> discriminator columns instead of separate <code><Entity>Bonus</code>
tables.

The bot emits each row inline on the parent entity's wiki page. There are no individual <code>Data:Bonus/…</code> pages.

== Schema ==
{{#cargo_declare:_table=Bonus
| parent_type = String
| parent_id = String
| ordinal = Integer
| type = String
| parameters = List (,) of String
| activation_level = Integer
| upgrade_increment = Float
| upgrade_level_step = Integer
| receivers = List (,) of String
| battle_type = String
| receiver_role = String
| receiver_allegiance = String
| action_area = String
| fraction = String
}}

<pre><nowiki>
{{BonusDef
| parent_type = String 
| parent_id = String 
| ordinal = Integer 
| type = String 
| parameters = List (,) of String 


| activation_level = Integer
| upgrade_increment = Float
| upgrade_level_step = Integer
| receivers = List (,) of String
| battle_type = String
| receiver_role = String
| receiver_allegiance = String
| action_area = String 
| fraction = String 
}}
</nowiki></pre>

== Field notes ==
* '''Primary key is <code>(parent_type, parent_id, ordinal)</code>'''.
* '''<code>parent_type</code>''' identifies the parent entity table:
** <code>hero_specialization</code> — joined to <code>HeroSpecialization.id</code>
** <code>hero_sub_class</code> — joined to <code>HeroSubClass.id</code>
** <code>artifact</code> — joined to <code>Artifact.id</code>
** <code>item_set_tier</code> — joined to <code>ItemSetTier.id</code>
** <code>law_level</code> — joined to <code>LawLevelDef</code> on <code>parent_id = law_id || '_L' || level</code> Add new values as new bonus-bearing entities come online.
* '''<code>type</code>''' is the effect category. ~13 distinct values across the 2026-05-03 corpus, with <code>heroStat</code> (~895), <code>unitStat</code> (~330), <code>heroBattleAbility</code> (~235) the most common. Artifacts add a few new ones (<code>heroMagicAddition</code> for spell scrolls, <code>heroTemporallyActiveSubSkills</code>).
* '''<code>parameters</code>''' is comma-joined, type-dependent. Same encoding as the original *Bonus tables. Wiki side parses by <code>type</code>.
* '''Sparse fields''' vary by parent type:
** Spec bonuses use the full schema.
** Sub-class bonuses don't carry <code>activation_level</code>, <code>upgrade_*</code>, <code>battle_type</code>, or <code>receiver_role</code> in the 2026-05-03 corpus.
** Artifact bonuses use most fields except <code>battle_type</code> and <code>receiver_role</code>.
** Law-level bonuses use <code>receivers</code>, <code>receiver_allegiance</code>, <code>action_area</code>, <code>fraction</code>. They never use <code>activation_level</code>, <code>upgrade_*</code>, <code>battle_type</code>, or <code>receiver_role</code>.
* '''<code>action_area</code>''' (law-bonus only so far) — qualifier for which side a <code>barrackUpgradeUnitsHiring</code> etc. effect applies to. Values observed: <code>allied</code>.
'' ''*`fractio

[[Category:Cargo Definitions]]
</noinclude><includeonly>{{#cargo_store:_table=Bonus
| parent_type = {{{parent_type|}}}
| parent_id = {{{parent_id|}}}
| ordinal = {{{ordinal|}}}
| type = {{{type|}}}
| parameters = {{{parameters|}}}
| activation_level = {{{activation_level|}}}
| upgrade_increment = {{{upgrade_increment|}}}
| upgrade_level_step = {{{upgrade_level_step|}}}
| receivers = {{{receivers|}}}
| battle_type = {{{battle_type|}}}
| receiver_role = {{{receiver_role|}}}
| receiver_allegiance = {{{receiver_allegiance|}}}
| action_area = {{{action_area|}}}
| fraction = {{{fraction|}}}
}}</includeonly>