Thanks a lot for taking the time to address all the points and for your notes!
Once I find some time I will catchup with all the new releases and will let you know if something new comes up.

Sound is of type struct or array[ SoundDefinition ] and SoundDefinition is of type struct or FileName . However, Sound itself is sometimes used as a single SoundDefinition or FileName , e.g.

data.raw["gui-style"]["default"]["button"]["left_click_sound"] = "__core__/sound/gui-click.ogg"
(or line ...

DamageTileTriggerEffectItem::type has the same value "damage" as DamageTriggerEffectItem . The description of this union member for TriggerEffect says:

Loaded when the type is "damage-tile".
Example usage:

data.raw["land-mine"]["land-mine"]["action"]["action-delivery"]["source-effects"][4 ...

TriggerEffect contains the unknown union member DamageEntityTriggerEffectItem, which was probably meant to be named DamageTriggerEffectItem , e.g:

data.raw["tile"]["lava"]["trigger_effect"][1] = {
"type": "damage",
"damage":
{
"amount": 50,
"type": "fire"
}
}
(or see lines 142084-142091 of ...

CreateTrivialSmokeEffectItem::only_when_visible has a type of float, but a default value of false and is only used as a bool, e.g:

data.raw["explosion"]["carbonic-asteroid-explosion-2"]["created_effect"]["action_delivery"]["target_effects"][2]["only_when_visible"] = true
(or see line 276904 of ...

CustomInputPrototype::linked_game_control has an empty default value of "", which is no valid union member of LinkedGameControl.

Interesting choices, thanks for the quick clarification and references.

Ran into this as well with version 2.0.34. Just to understand the dumping process better: Is the JSON generated directly from Lua or with C++ after data.raw was parsed? How are the types from the API docs generated? Is the same type information available during the data dump?

Hello there!
Thanks for the reference and your insights. I was under the assumption that the data dump comes from the engine, but if it comes from Lua then that explains some of the points already. I will follow up on this in your thread.

I'd make several separate posts for them tho. Provides ...

When deserializing the data-raw-dump.json file (extracted via the --dump-data command line parameter ) with a type safe language, some adjustments have to be made. The following list is complete (for version 2.0.34 without additional mods) and grouped into two main categories, with no specific order ...