games/vcmi
1
0
Fork 0
mirror of https://github.com/vcmi/vcmi.git synced 2025-06-29 00:41:38 +02:00
Code Issues Releases Activity

Initial version of bonus system usage guide

Browse Source
This commit is contained in:
Ivan Savenko
2025-06-06 14:10:30 +03:00
parent 8f0bca05de
commit 5bc27d3d90
5 changed files with 203 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
docs/modders/Entities_Format/Battle_Obstacle_Format.md
View File

@ -36,7 +36,7 @@ How blocked tiles are defined depends on whether obstacle is `absolute` or not:
Non-absolute obstacles specify their coordinates relative to bottom-left corner of obstacle. If you wish to have obstacle that takes multiple rows, substracting 17 from hex number would block tile directly above bottom-left corner of your obstacle.
For example, obstacle that blocks tiles `[1, 2, 3, -15, -16, -31]` would result in following layout on the battlefield:
For example, obstacle that blocks tiles `[1, 2, 3, -14, -15, -31]` would result in following layout on the battlefield:
![Battlefield Relative Obstacle Example](../../images/Battle_Field_Relative_Obstacle.svg)

10
docs/modders/Entities_Format/Spell_Format.md
View File

@ -55,8 +55,8 @@
},
// List of flags that describe this spell
// positive - this spell is positive to target (buff)
// negative - this spell is negative to target (debuff)
// positive - this spell is positive to target (buff) and can target allies
// negative - this spell is negative to target (debuff) and can target enemies
// indifferent - spell is neither positive, nor negative
// damage - spell does damage (direct or indirect).
// If set, AI will avoid obstacles with such effect, and spellbook popup will also list damage of the spell
@ -216,7 +216,7 @@ TODO
// modifiers make sense for creature target
"targetModifier":
{
// If true, then if this spell targets area, it will exclude targets if:
// If true, then this spell will not affect units if:
// - target is friendly and spell is negative
// - target is enemy, and spell is positive
// Othervice, all units in affected area will be hit by a spell, provided they are not immune
@ -285,6 +285,10 @@ Following bonuses will only affect `damage`, `heal` and `demonSummon` effects
- SPELL_DAMAGE for specific spell school (Sorcery)
- SPECIFIC_SPELL_DAMAGE for the spell (Luna / Ciele)
## Smart target modifier
To restrict spell from casting it on "wrong" side in combat, you can use `smart` target modifier. If this flag is set, and spell has `positive` flag, it can only affect friendly units. Similarly, spells with `negative` flag and `smart` target modifier can only affect enemies. This affects both primary targets and any secondary targets in case of area of effect or massive spells.
## Configurable battle effects
### Common format