單位 API
作為製作者,在編寫你創造的技能(abilities) 的邏輯推理(logic) 時,你可以在單位上呼叫方法(call methods)。
類別方法(Class Methods)
以下是你可以使用的各種方法:
unit.heal(amount)
在HP增加指定的生命值。
生命值不能超過最大生命值。
參數(Arguments)
amount
(數字number):要增加的HP量。
unit.takeDamage(amount)
在HP減去指定的生命值。
如果單位被綁定了,受傷害時會被解綁。
生命值不能低於0,如生命值到了0,單位將死亡並消失。
參數(Arguments)
amount
(數字number):要減去的HP量。
unit.damage(receiver, amount)
傷害另一個單位。
如果其他單位死亡,取決於單位是敵人或是同伴,傷害者將分別賺取或損失等同於死亡單位獎勵的分數。
參數(Arguments)
receiver
(單位Unit):要傷害的單位。
amount
(數字number):要傷害的HP量。
unit.isAlive()
判斷單位是否生存。
如果一個單位佔有一個位置,它是生存的。
傳回(Returns)
(布爾boolean):這單位是否生存。
unit.release(unit)
釋放(解綁) 另一個單位。
如果另一個單位是同伴,釋放者可賺取等同於釋放單位獎勵的分數。
參數(Arguments)
receiver
(單位Unit):要釋放的單位。
unit.unbind()
解綁單位。
unit.bind()
解綁那個單位。
unit.isBound()
判斷該單位是否被綁定。
傳回(Returns)
(布爾boolean):這單位是否被綁定。
unit.earnPoints(points)
添加指定分數到總分。
參數(Arguments)
points
(數字number):要賺取的分數。
unit.losePoints(points)
從總分減去指定的分數。
參數(Arguments)
points
(數字number): 要失去的分數。
unit.triggerEffect(effect)
觸發指定的效果。
參數(Arguments)
effect
(字串string):效果的名字。
unit.isUnderEffect(effect)
判斷這個單位是否在效果的影響下。
參數(Arguments)
effect
(字串string):效果的名字。
傳回(Returns)
(布爾boolean):這單位是否在效果的影響下。
unit.getOtherUnits()
傳回塔層中減去了這單位的其他單位。
傳回(Returns)
(單位Unit[]):層塔的其他單位。
unit.getSpace()
傳回這單位身處的空格。
傳回(Returns)
(空格Space):這單位身處的空格。
unit.getSensedSpaceAt(direction, forward = 1, right = 0)
傳回這個方向感應到的空格及其數量。
在傳回從感官技感應到的空格時可使用這方法,任何時候都要傳回感應到的空格給玩家。
參數(Arguments)
direction
(字串string):方向。
forward
(數字number):前進的空格數量。
right
(數字number):右邊的空格數。
傳回(Returns)
(感應空格SensedSpace):感應到的空格。
unit.getSpaceAt(direction, forward = 1, right = 0)
傳回這方向的空格及其數量。
對內使用這方法,永遠不要傳回固定空格給玩家
參數(Arguments)
direction
(字串string):方向。
forward
(數字number):前進的空格數量。
right
(數字number):右邊的空格數。
傳回(Returns)
(空格Space): 空格。
unit.getDirectionOfStairs()
傳回指向這單位的樓梯方向。
傳回(Returns)
(字串string):樓梯的相對方向。
unit.getDirectionOf(space)
傳回指向這單位的某個指定空格的方向。
參數(Arguments)
space
(感應空格SensedSpace):要獲取方向的空格。
傳回(Returns)
(字串string):空格的相對方向。
unit.getDistanceOf(space)
傳回指定空格與單位之間的距離。
參數(Arguments)
space
(感應空格SensedSpace):用來計算距離的空格。
傳回(Returns)
(數字number):與空格之間的距離。
unit.move(direction, forward = 1, right = 0)
按指定方向及空格數移動單位。
參數(Arguments)
direction
(字串string):方向。
forward
(數字number):前進的空格數量。
right
(數字number):右邊的空格數。
unit.rotate(direction)
按指定方向為單位轉向。
參數(Arguments)
direction
(字串string):要轉向的方向。
unit.vanish()
讓單位在塔層消失。
unit.log(message)
在遊戲日誌記錄訊息。
參數(Arguments)
message
(字串string):要紀錄的訊息。
物件屬性
name
(string)
單位的名字。
character
(string)
塔層圖上表示單位的字元。
health
(number)
在單位死亡前能承受的總傷害,以 HP顯示。
maxHealth
(number)
最大生命(health)
值。
reward
(number)
交流時可獲獎勵的分數。
enemy
(boolean)
單位是否屬於敵人陣營。
bound
(boolean)
單位是否被綁定。