AvernumScript/附錄/物品、特殊物品和金幣呼叫

void change_coins(short coin_amount)

根據coin_amount（可以為負數）更改隊伍擁有的金幣數量。如果數字為負數，則金幣被扣除。如果隊伍的金幣不夠，則不會扣除任何金幣。

void change_spec_item(short which_item,short how_many)

更改隊伍擁有的特殊物品which_item的數量，增加或減少how_many個。如果how_many為負數，則特殊物品which_item的數量將減少how_many個。如果你嘗試拿走比隊伍擁有的物品數量更多的物品，隊伍將只剩下0個該物品。

void char_give_item(short which_char_or_group,short which_item)

嘗試將which_char_or_group型別的物品which_item交給角色。如果你對一個組呼叫char_give_item()，會給每個組成員一個該物品。該物品不會自動識別。如果角色沒有足夠的空間來拿取物品，則不會發生任何事情，遊戲會提示“無法拿取物品”。

注意：該呼叫是在場景格式版本2中新增的，僅與 Mac 版本 1.1 或更高版本或 Windows 版本 1.0 或更高版本一起使用。

short char_has_item(short which_char,short which_item)

返回值

0	– 角色which_char沒有型別為which_item的物品。
1	– 角色which_char有型別為which_item的物品。

short char_has_item_of_class_equip(char char_num,short which_class,short take_item)

返回值

0	– 沒有隊伍成員沒有具有特殊類別which_class的物品。
1	– 至少有一個隊伍成員有具有特殊類別which_class的物品。

take_item的值是

0	– 沒有特殊類別為which_class的物品被拿走。
1	– 一個特殊類別為which_class的物品被拿走。

注意：該呼叫是在場景格式版本2中新增的，僅與 Mac 版本 1.1 或更高版本或 Windows 版本 1.0 或更高版本一起使用。

void char_take_item(short which_char_or_group,short which_item)

嘗試從which_char_or_group處拿取一個型別為which_item的物品。（如果物品有電荷，它會拿取1個電荷）。

short coins_amount()

返回隊伍擁有的金幣數量。

short has_item(short which_item)

返回值

0	– 角色which_char沒有型別為which_item的物品。
1	– 角色which_char有型別為which_item的物品。

short has_item_of_class(short which_class,short take_item)

返回值

0	– 隊伍沒有具有特殊類別which_class的物品。
1	– 隊伍有具有特殊類別which_class的物品。

take_item的值是

0	– 沒有特殊類別為which_class的物品被拿走。
1	– 一個特殊類別為which_class的物品被拿走。

short has_num_of_item(short which_item)

返回隊伍擁有多少個which_item型別的物品。如果隊伍沒有which_item型別的物品，則返回0。如果所討論的物品有電荷，則此呼叫將返回電荷總數。

short has_special_item(short which_item)

返回隊伍擁有的特殊物品which_item的數量，如果他們沒有，則返回0。

short item_of_class_on_spot(short loc_x,short loc_y,short what_class)

返回值

0	– 城鎮空間 {loc_x,loc_y} 上 **沒有** 特殊類別 what_class 的物品。
1	– 城鎮空間 {loc_x,loc_y} 上 **有** 特殊類別 what_class 的物品。

注意: 如果 what_class 為 -1，則如果空間上有任何物品，則返回 1，否則返回 0。

void move_item_on_spot(short loc_x,short loc_y,short dest_x,short dest_y)

將城鎮空間 {loc_x,loc_y} 上的所有物品移動到 {dest_x,'dest_y}。

注意: 如果 dest_x 為負值，則該空間上的物品會被直接銷燬。

short pay_coins(short coin_amount)

嘗試從隊伍中取走 coin_amount 枚金幣。

返回值

0	– 隊伍 **沒有** 足夠的金幣。
1	– 隊伍 **有** 足夠的金幣。

void put_item_on_spot(short loc_x,short loc_y,short what_item)

將型別為 what_item 的物品放置在城鎮空間 {loc_x,loc_y} 上。如果該空間是容器，物品不會被放到容器內。

short reward_give(short which_item)

嘗試將編號為 which_item 的物品送給隊伍。如果隊伍無法容納它，則嘗試將物品放置在他們腳下。（將物品放在他們腳下只在室內有效）。

返回值

0	– 將獎勵送給隊伍 **失敗** 了。
1	– 將獎勵送給隊伍 **成功** 了。

short take_all_of_item(short which_item)

從隊伍中取走所有編號為 which_item 的物品，並返回取走的物品數量。如果給出的物品帶有電量，則返回取走的總電量。

short take_all_of_item_class(short which_class,short gold_to_pay)

從隊伍中取走所有特殊類別為 which_class 的物品，併為每個取走的物品給予隊伍 gold_to_pay 枚金幣。

返回值

0	– 隊伍 **沒有** 該型別的物品。
1	– 隊伍 **有** 該型別的物品。

注意: 如果取走的物品帶有電量，則會為每個取走的電量支付金幣。

void take_item(short which_item)

在隊伍的庫存中搜索，直到找到型別為 which_item 的物品並取走它。（如果物品帶有電量，則會取走一個電量。）

short take_item_of_class_on_spot(short loc_x,short loc_y,short what_class)

如果城鎮空間 {loc_x,loc_y} 上有特殊類別 what_class 的物品，則返回 1，否則返回 0。

• 如果該空間上有該型別的物品，則會銷燬其中一個。（如果物品帶有電量，則會取走一個電量。）
• 如果 what_class 為 -1，則會銷燬城鎮空間 {loc_x,loc_y} 上的所有物品，如果銷燬了物品，則返回 TRUE。

void take_num_of_item(short which_item,short num_to_take)

從隊伍中取走 num_to_take 個型別為 which_type 的物品。

注意:	如果隊伍中該型別的物品少於 num_to_take 個，則會全部取走。
	如果物品帶有電量，則會取走這些電量。

void take_special_item(short which_item)

從隊伍中取走 **1** 個編號為 which_item 的特殊物品。如果隊伍中沒有該特殊物品，則該呼叫不會執行任何操作。