Talk:Object instance format
From VCMI Project Wiki
Possible enchancements
- Mine : "army" - already supported by engine, but can't be configured in map
- Should we prepare army/guards option for _all_ objects?
- Only those that can have army in H3. Mines can have guards set by player.
- Should we prepare army/guards option for _all_ objects?
- Random dwelling : instead of using "linked" field just don't save unused field. So if dwelling is linked "sameAsTown" is present, while "allowedFactions" is not and vice versa.
- Random dwelling : Perhaps we can find better way to store references to other object without specifying coordinates? By some unique ID for example? (same applies to quests and what else uses such scheme)
- We can introduce instance ID for all objects as incremented counter (vector position will not work for map editor) (and may be reuse it in engine too as separate std::map<si32, CGObjectInstance>).
- Scholar : save only active reward? Scholar with skill will have "skill" : "wisdom", scholar with spell will have "spell" : "magicArrow" field
- Ok [Done], may we need to unify rewards with other objects?
- For example? If you mean using same code for giving rewards - then I suggest to wait.
- Ok [Done], may we need to unify rewards with other objects?
- Monster : remove "randomCount" - if "count" is not defined, assume that count is random
- [Done]
Fields renames/tweaks
- Stack instance: "creCount" -> "amount" - readability
- [Done]
- Stack instance: "creID" -> "type" - readability
- [Done] Hate this one: "type" is a keyword in pascal (but can be used as identifier in form &type).
- In cases like this I'm fine with any other word that makes sense :)
- [Done] Hate this one: "type" is a keyword in pascal (but can be used as identifier in form &type).
- Garrison: "garrison" -> "army" - for consistency with hero, town, etc.
- [Done]
- Hero: "sex" (string) -> "female" (bool) - to match engine & modding format
- This need 3 values: female, male, and "defined by config"
- true, false and null? Null is valid value for json and so is lack of entry.
- The question is how to define this in code cleanly? Simple types are not nullable. (I can use Variant, and recheck how is it serialized).
- true, false and null? Null is valid value for json and so is lack of entry.
- This need 3 values: female, male, and "defined by config"
- Hero: "id" - I don't like this word. Type? Base Hero?
- [Done] set to type, see above :)
- Check for case inconsistencies - I see "spellID" and "spellId" in some fields. Same applies to other types of id's
- Or just remove "id" part from all fields. "spell" : "slow". Looks fine for me.
- [Done]
Notes
- IIRC there is difference between "empty" garrison in town and "undefined" garrison. Game spawns 1-2 stack in town for undefined garrisons. For format that means that entry with 0 items is not identical to lack of entry.
- Let array of empty objects be empty garrison, array of zero elements be undefined garrison.
- Any reason to have any actual default values? What "mana" : -1 means for hero? If default value should be used then just don't write this entry in map. (or write null entry: "mana" : null).
- where did you fined that? In pandora or local event? There it means take 1 mana. Default there is 0 and not saved (examples was made with explicit serialization of default values). Also serialize simple types as null is not trivial.
- Check hero format - it has several "-1". Not mana but patrol radius & primary skills. As for serialization - prehaps you use something similar to c++ boost::optional?
- In real save they will be null, all default values are omitted by serializer and default equals null on de-serialisation. I`ll fix examples.