AvernumScript/附錄/場景初始化呼叫

這些呼叫都應該在場景指令碼中進行，無論是在狀態 LOAD_SCEN_STATE 還是 START_SCEN_STATE。當然，它們也可以在任何地方進行。

void add_item_to_shop(short which_shop,short which_item,short how_many)

此呼叫應該在狀態 START_SCEN_STATE 中進行。此呼叫會將一個或多個“物品”放置在商店 which_shop 中。which_shop 的範圍為 0–129。通常，放置的“物品”是型別為 which_item 的物品。引數 how_many 定義新增到商店的物品數量。

但是，如果選擇特定的 which_item 的高值，則可以將除了物品之外的東西放到商店裡——還可以有法術、鍊金術配方和技能。

which_item 的值如下

0–499	數量為 how_many 的型別為 which_item 的物品。
2000 + x	法師法術 x。 (x 的範圍為 0–19，how_many 是可以在商店購買的最高等級的法術。)
3000 + x	牧師法術 x。 (x 的範圍為 0–19，how_many 是可以在商店購買的最高等級的法術。)
4000 + x	鍊金術配方 x。 (x 的範圍為 0–19，how_many 應該為 1。)
5000 + x	技能 x。 (每次購買都會使角色獲得 1 級技能。how_many 是可以購買的技能的最高等級。)

注意:

物品
- 任何一個商店最多隻能有 25 種不同的物品庫存。
- 如果 how_many 大於 500，則商店將擁有無限數量的物品 which_item。
在所有情況下，你都希望為 how_many 設定一個大於 0 的數字。如果不這樣做，物品將從商店中消失。

此呼叫應該在狀態 START_SCEN_STATE 中進行。初始化船隻 which_boat，其範圍為 0–29。船隻被放置在城鎮 which_town 的空間 [loc_x, loc_y] 中。

others_property 的值如下

0 –	隊伍可以進入船隻。
1 –	隊伍不能進入船隻，直到它透過指令碼被設定為隊伍財產。

此呼叫應該在狀態 START_SCEN_STATE 中進行。初始化馬匹 which_horse，其範圍為 0–29。馬匹被放置在城鎮 which_town 的空間 [loc_x, loc_y] 中。

others_property 的值如下

0 –	隊伍可以騎乘馬匹。
1 –	隊伍不能騎乘馬匹，直到它透過指令碼被設定為隊伍財產。

此呼叫應該在狀態 LOAD_SCEN_STATE 中進行。它將任務 which_quest 的名稱設定為 quest_name，並將描述文字設定為 quest_desc。

注意:

此呼叫應該在狀態 LOAD_SCEN_STATE 中進行。它將特殊物品 which_item 的名稱設定為 item_name，並將描述文字設定為 item_desc。

注意:

將生物型別 which_type 的等級設定為等級 what_level。這是唯一更改生物型別的呼叫，通常這些更改是透過 scennamedata 指令碼進行的。提供此呼叫是因為為了平衡一個場景，你可能需要調整至少一些生物型別的等級。