Index: docs/plotdict.xml
===================================================================
--- docs/plotdict.xml (revision 190)
+++ docs/plotdict.xml (working copy)
@@ -488,6 +488,36 @@
use door
Instantly uses the numbered door, just as if you had stepped into it. An automatic [wait](1) occurs immediately after this command.
+
+ door exists (number)
+ door exists
+ Returns [true] if there is a door with ID number
on the current map. This command is useful for avoiding script errors due to invalid door IDs.
+
+
+ get door x (number)
+ get door x
+ Returns the x coordinate (in tiles) of the numbered door.
+
+
+ get door y (number)
+ get door y
+ Returns the y coordinate (in tiles) of the numbered door.
+
+
+ get door destination id (number)
+ get door destination id
+ Returns the door id of the door linked to by the numbered door. To get the door's location, use [getdoorx] and [getdoory] when the player is on the destination map. If door number
does not exist, or is not currently linked to any other door, then -1 is returned. A door's destination can vary depending on the current game state. Check your doorlinks if you get unexpected results!
+
+ [getdoorx]
+ [getdoory]
+ [getdoordestinationmap]
+
+
+
+ get door destination map (number)
+ get door destination map
+ Returns the map id of the door linked to by the numbered door. If door number
does not exist, or is not currently linked to any other door, then -1 is returned. A door's destination can vary depending on the current game state. Check your doorlinks if you get unexpected results!
+
teleport to map (map, x, y)
teleport to map
@@ -1455,6 +1485,13 @@
This command replaces the old get attack name
which required you to use atk:name -- 2
or the attack id number -- 1
+
+ get attack caption (ID, attack)
+ get attack caption
+ This command will take the caption of attack
and stick it in string #ID
, overwriting its contents. Use the atk:name
constants from your HSI file.
+ If you want to use this command with attack ID numbers, you must add 1 to the ID number.
+
+
get global string (ID, global)
get global string
@@ -4453,6 +4490,33 @@
[readenemydata]
+
+ read enemy normal attack (enemyid, index)
+ read enemy normal attack
+ Reads an entry from an enemy's standard attack set. The index
argument specifies which of the five attacks to read (from 0 to 4).
+
+ [readenemyaloneattack]
+ [readenemydesperationattack]
+
+
+
+ read enemy alone attack (enemyid, index)
+ read enemy alone attack
+ Reads an entry from an enemy's Alone attack set. The index
argument specifies which of the five attacks to read (from 0 to 4).
+
+ [readenemyattack]
+ [readenemydesperationattack]
+
+
+
+ read enemy desperation attack (enemyid, index)
+ read enemy desperation attack
+ Reads an entry from an enemy's Desperation attack set. The index
argument specifies which of the five attacks to read (from 0 to 4).
+
+ [readenemyattack]
+ [readenemyaloneattack]
+
+
add enemy to formation (formation, enemy id, x, y, slot)
add enemy to formation
@@ -5013,6 +5077,43 @@
The case command is used to enclose a block of commands for one possible result of a [switch] command. See [switch] for more details.
+
+
+ read attack target class (attackid)
+ read attack target class
+ Returns the target class of the given attack (one of [targetclass:enemy], [targetclass:ally], [targetclass:self], [targetclass:all], [targetclass:allyincludingdead], [targetclass:allyexcludingself], [targetclass:revenge], [targetclass:revengewholebattle], [targetclass:previoustarget], [targetclass:recordedtarget], [targetclass:deadallies], [targetclass:thankvenge], or [targetclass:thankvengewholebattle]).
+
+
+ read attack target setting (attackid)
+ read attack target setting
+ Returns the target setting of the given attack (one of [targetsetting:focused], [targetsetting:spread], [targetsetting:optionalspread], [targetsetting:random], or [targetsetting:firsttarget]).
+
+
+ read attack damage equation (attackid)
+ read attack damage equation
+ Returns the damage equation of the given attack (one of [damageequation:normal], [damageequation:blunt], [damageequation:sharp], [damageequation:puredamage], [damageequation:nodamage], [damageequation:percentofmax] or [damageequation:percentofcurrent]).
+
+
+
+ read attack item (attackid, slot)
+ read attack item
+ Returns the item ID + 1 of the given attack's chosen item cost slot (from 0 to 2).
+
+ [readattackitemquantity]
+
+
+
+ read attack item quantity (attackid, slot)
+ read attack item quantity
+ Returns the quantity consumed of the given attack's chosen item cost slot (from 0 to 2).
+
+ [readattackitem]
+
+
set hero picture (who,picture,type)
@@ -5368,6 +5469,11 @@
[herobaseelementalresistasint]
+
+ enemy elemental resist as int (id, element)
+ enemy elemental resist as int
+ Gets the amount of damage that an enemy receives from attacks of a certain element, as a percentage of normal. The argument id
is the enemy id. The argument element
is a number from 0 to whatever the highest enabled element is. The result is rounded to the nearest integer. For example, if the enemy takes 2.5% damage (1/40 normal), then the result will be 3.When floating point support is added to HamsterSpeak, an alternative to this command will be added.
+
read global (id)
read global
@@ -5993,5 +6099,125 @@
song:sameaslastmap
song: same as map
+
+ targetclass: enemy
+ targetclass: enemy
+ Used with [readattacktargetclass] to indicate an attack that targets enemies.
+
+
+ targetclass: ally
+ targetclass: ally
+ Used with [readattacktargetclass] to indicate an attack that targets living allies.
+
+
+ targetclass: self
+ targetclass: self
+ Used with [readattacktargetclass] to indicate an attack that targets the caster.
+
+
+ targetclass: ally including dead
+ targetclass: ally including dead
+ Used with [readattacktargetclass] to indicate an attack that targets allies, living or dead.
+
+
+ targetclass: ally excluding self
+ targetclass: ally excluding self
+ Used with [readattacktargetclass] to indicate an attack that targets allies other than the caster.
+
+
+ targetclass: revenge
+ targetclass: enemy
+ Used with [readattacktargetclass] to indicate an attack that targets the last enemy to damage the caster.
+
+
+ targetclass: revenge whole battle
+ targetclass: revenge whole battle
+ Used with [readattacktargetclass] to indicate an attack that targets all enemies who have damaged the caster in this battle.
+
+
+ targetclass: previous target
+ targetclass: previous target
+ Used with [readattacktargetclass] to indicate an attack that targets the target of the previous attack.
+
+
+ targetclass: recorded target
+ targetclass: recorded target
+ Used with [readattacktargetclass] to indicate an attack that targets the recorded target.
+
+
+ targetclass: dead allies
+ targetclass: dead allies
+ Used with [readattacktargetclass] to indicate an attack that targets dead allies.
+
+
+ targetclass: thankvenge
+ targetclass: thankvenge
+ Used with [readattacktargetclass] to indicate an attack that targets the last ally to heal the caster.
+
+
+ targetclass: thankvenge whole battle
+ targetclass: thankvenge whole battle
+ Used with [readattacktargetclass] to indicate an attack that targets all allies who have healed the caster in this battle.
+
+
+ targetsetting: focused
+ targetsetting: focused
+ Used with [readattacktargetsetting] to indicate an attack that affects one target.
+
+
+ targetsetting: spread
+ targetsetting: spread
+ Used with [readattacktargetsetting] to indicate an attack that affects multiple targets.
+
+
+ targetsetting: optional spread
+ targetsetting: optional spread
+ Used with [readattacktargetsetting] to indicate an attack that affects one or multiple targets.
+
+
+ targetsetting: random focus
+ targetsetting: random focus
+ Used with [readattacktargetsetting] to indicate an attack that affects a single random target.
+
+
+ targetsetting: first target
+ targetsetting: spread
+ Used with [readattacktargetsetting] to indicate an attack that affects the first available target.
+
+
+ damageequation: normal
+ damageequation: normal
+ Used with [readattackdamageequation] to indicate an attack that uses the standard damage formula.
+
+
+ damageequation: blunt
+ damageequation: blunt
+ Used with [readattackdamageequation] to indicate an attack that uses the Blunt damage formula.
+
+
+ damageequation: sharp
+ damageequation: sharp
+ Used with [readattackdamageequation] to indicate an attack that uses the Sharp damage formula.
+
+
+ damageequation: pure damage
+ damageequation: pure damage
+ Used with [readattackdamageequation] to indicate an attack that deals unmitigated damage.
+
+
+ damageequation: no damage
+ damageequation: no damage
+ Used with [readattackdamageequation] to indicate an attack that deals no damage.
+
+
+ damageequation: percent of max
+ damageequation: percent of max
+ Used with [readattackdamageequation] to indicate an attack that sets the target stat to a percentage of its maximum value.
+
+
+ damageequation: percent of current
+ damageequation: percent of current
+ Used with [readattackdamageequation] to indicate an attack that sets the target stat to a percentage of its current value.
+
-
+
\ No newline at end of file
Index: plotscr.hsd
===================================================================
--- plotscr.hsd (revision 191)
+++ plotscr.hsd (working copy)
@@ -535,6 +535,22 @@
524,getdoordestinationmap,1,0 #map number of given door's exit
525,doorexists,1,0 #returns true if the given door exists
526,getattackcaption,2,0,0 #puts an attack's caption in a string (string id, attack id+1 / attack .hsi constant)
+527,enemyelementalresistasint,2,-1,0 # percentage damage taken from an element rounded to an int (enemy, element)
+528,readattacktargetclass,1,0 #returns the target class (ally, enemy, etc.) of the given attack
+529,readattacktargetsetting,1,0 #returns the target setting (focused, spread, etc.) of the given attack
+530,readattackdamageequation,1,0 #returns the damage equation (normal, sharp, etc.) of the given attack
+531,readattackextradamage,1,0 #returns the extra damage modifier of the given attack
+532,readattackitem,2,0,0 #returns item ID+1 of the given attack's nth item cost (attack, n [0..2])
+533,readattackitemquantity,2,0,0 #returns item quantity of the given attack's nth item cost (attack, n [0..2])
+534,readattackchain,2,0,0 #returns attack ID+1 of the given attack's chain (attack)
+535,readattackchainrate,2,0,0 #returns chain rate of the given attack's chain (attack)
+536,readattackelsechain,2,0,0 #returns attack ID+1 of the given attack's else chain (attack)
+537,readattackelsechainrate,2,0,0#returns chain rate of the given attack's else chain (attack)
+538,readattackinsteadchain,2,0,0 #returns attack ID+1 of the given attack's chain (attack)
+539,readattackinsteadchainrate,2,0,0 #returns chain rate of the given attack's chain (attack)
+540,readenemynormalattack,2,0,0 #returns the nth attack ID+1 of given enemy's normal attack set (id, n [0..4])
+541,readenemyaloneattack,2,0,0 #returns the nth attack ID+1 of given enemy's alone attack set (id, n [0..4])
+542,readenemydesperationattack,2,0,0 #returns the nth attack ID+1 of given enemy's desperation attack set (id, n [0..4])
end
#--------------------------------------------------------------------------
@@ -1583,6 +1599,31 @@
0,trans:solid
1,trans:fuzzy
2,trans:hollow
+0,targetclass:enemy
+1,targetclass:ally
+2,targetclass:self
+3,targetclass:all
+4,targetclass:ally including dead
+5,targetclass:ally excluding self
+6,targetclass:revenge
+7,targetclass:revenge whole battle
+8,targetclass:previous target
+9,targetclass:recorded target
+10,targetclass:dead allies
+11,targetclass:thankvenge
+12,targetclass:thankvenge whole battle
+0,targetsetting:focused
+1,targetsetting:spread
+2,targetsetting:optional spread
+3,targetsetting:random
+4,targetsetting:first target
+0,damageequation:normal
+1,damageequation:blunt
+2,damageequation:sharp
+3,damageequation:pure damage
+4,damageequation:no damage
+5,damageequation:percent of max
+6,damageequation:percent of current
end
#
Index: yetmore.bas
===================================================================
--- yetmore.bas (revision 191)
+++ yetmore.bas (working copy)
@@ -2914,7 +2914,103 @@
IF valid_plotstr(retvals(0), 5) AND bound_arg(retvals(1), 1, gen(genMaxAttack)+1, "attack ID", , , 5) THEN
plotstr(retvals(0)).s = readattackcaption(retvals(1) - 1)
scriptret = 1
+ END IF
+ CASE 527 '--enemy elemental resist as int
+ IF in_bound(retvals(0), 0, gen(genMaxEnemy)) AND bound_arg(retvals(1), 0, gen(genNumElements) - 1, "element number") THEN
+ DIM enemy as EnemyDef
+ loadenemydata enemy, retvals(0)
+ scriptret = 100 * enemy.elementals(retvals(1))
END IF
+ CASE 528 '--read attack target class
+ IF bound_arg(retvals(0), 1, gen(genMaxAttack)+1, "attack ID", , , 5) THEN
+ DIM attack as AttackData
+ loadattackdata attack, retvals(0)
+ scriptret = attack.targ_class
+ END IF
+ CASE 529 '--read attack target setting
+ IF bound_arg(retvals(0), 1, gen(genMaxAttack)+1, "attack ID", , , 5) THEN
+ DIM attack as AttackData
+ loadattackdata attack, retvals(0)
+ scriptret = attack.targ_set
+ END IF
+ CASE 530 '--read attack damage equation
+ IF bound_arg(retvals(0), 1, gen(genMaxAttack)+1, "attack ID", , , 5) THEN
+ DIM attack as AttackData
+ loadattackdata attack, retvals(0)
+ scriptret = attack.damage_math
+ END IF
+ CASE 531 '--read attack extra damage
+ IF bound_arg(retvals(0), 1, gen(genMaxAttack)+1, "attack ID", , , 5) THEN
+ DIM attack as AttackData
+ loadattackdata attack, retvals(0)
+ scriptret = attack.extra_damage
+ END IF
+ CASE 532 '--read attack item
+ IF bound_arg(retvals(0), 1, gen(genMaxAttack)+1, "attack ID", , , 5) AND in_bound(retvals(1), 0, 2) THEN
+ DIM attack as AttackData
+ loadattackdata attack, retvals(0)
+ scriptret = attack.item(retvals(1)).id
+ END IF
+ CASE 533 '--read attack item quantity
+ IF bound_arg(retvals(0), 1, gen(genMaxAttack)+1, "attack ID", , , 5) AND in_bound(retvals(1), 0, 2) THEN
+ DIM attack as AttackData
+ loadattackdata attack, retvals(0)
+ scriptret = attack.item(retvals(1)).number
+ END IF
+ CASE 534 '--read attack chain
+ IF bound_arg(retvals(0), 1, gen(genMaxAttack)+1, "attack ID", , , 5) THEN
+ DIM attack as AttackData
+ loadattackdata attack, retvals(0)
+ scriptret = attack.chain.atk_id
+ END IF
+ CASE 535 '--read attack chain rate
+ IF bound_arg(retvals(0), 1, gen(genMaxAttack)+1, "attack ID", , , 5) THEN
+ DIM attack as AttackData
+ loadattackdata attack, retvals(0)
+ scriptret = attack.chain.rate
+ END IF
+ CASE 536 '--read attack else chain
+ IF bound_arg(retvals(0), 1, gen(genMaxAttack)+1, "attack ID", , , 5) THEN
+ DIM attack as AttackData
+ loadattackdata attack, retvals(0)
+ scriptret = attack.elsechain.atk_id
+ END IF
+ CASE 537 '--read attack else chain rate
+ IF bound_arg(retvals(0), 1, gen(genMaxAttack)+1, "attack ID", , , 5) THEN
+ DIM attack as AttackData
+ loadattackdata attack, retvals(0)
+ scriptret = attack.elsechain.rate
+ END IF
+ CASE 538 '--read attack instead chain
+ IF bound_arg(retvals(0), 1, gen(genMaxAttack)+1, "attack ID", , , 5) THEN
+ DIM attack as AttackData
+ loadattackdata attack, retvals(0)
+ scriptret = attack.instead.atk_id
+ END IF
+ CASE 539 '--read attack instead chain rate
+ IF bound_arg(retvals(0), 1, gen(genMaxAttack)+1, "attack ID", , , 5) THEN
+ DIM attack as AttackData
+ loadattackdata attack, retvals(0)
+ scriptret = attack.instead.rate
+ END IF
+ CASE 540 '--read enemy normal attack
+ IF in_bound(retvals(0), 0, gen(genMaxEnemy)) AND in_bound(retvals(1), 0, 4) THEN
+ DIM enemy as EnemyDef
+ loadenemydata enemy, retvals(0)
+ scriptret = enemy.regular_ai(retvals(1))
+ END IF
+ CASE 541 '--read enemy alone attack
+ IF in_bound(retvals(0), 0, gen(genMaxEnemy)) AND in_bound(retvals(1), 0, 4) THEN
+ DIM enemy as EnemyDef
+ loadenemydata enemy, retvals(0)
+ scriptret = enemy.alone_ai(retvals(1))
+ END IF
+ CASE 542 '--read enemy desperation attack
+ IF in_bound(retvals(0), 0, gen(genMaxEnemy)) AND in_bound(retvals(1), 0, 4) THEN
+ DIM enemy as EnemyDef
+ loadenemydata enemy, retvals(0)
+ scriptret = enemy.desperation_ai(retvals(1))
+ END IF
END SELECT
END SUB