AvernumScript/附录/基本脚本和 I/O 调用
< AvernumScript | 附录
- 类似于
print_str()，但打印更自定义的文本。在一行中打印字符串 str，后跟数字 num_to_print，最后是字符串 str2。
示例:
print_big_str(“您受到 “, 10000, “ 点伤害。”); // 将“您受到 10000 点伤害。”打印到文本窗口。
- 类似于
print_big_str()，但可以为文本设置不同的颜色。颜色在print_str_color()的描述中列出。
- 此重要调用可阻止角色访问调用该脚本的地形位置/区域。如果从由步行触发的特殊遭遇中调用，此调用将阻止队伍/角色进入该空间。如果在搜索容器时调用，则阻止队伍获取容器内的物品。
do_blockage 的值是
| 0 | – 允许访问/进入。 |
| 1 | – 阻止访问/进入。 |
- 如果在脚本中调用，则立即停止运行该脚本。如果在对话节点的代码中调用，也会结束对话。
- 返回一个随机数。游戏生成 num_dice 个随机数，每个随机数都在 min 到 max 之间。然后将它们加起来并返回总和。
示例:
get_ran(3,1,4); // 将返回 3-12 之间的随机数（或 1-4 + 1-4 + 1-4）。
- 返回当前在队伍名单区域中选定的角色的编号（从 0 到 3）。
- 不言自明。
返回
| 0 | – 队伍不在战斗模式下。 |
| 1 | – 队伍在战斗模式下。 |
返回
| 0 | – 队伍不在户外模式下。 |
| 1 | – 队伍在户外模式下。 |
备注:
- 在户外战斗不算在户外模式下。
- 不言自明。
返回
| 0 | – 队伍不在城镇模式下。 |
| 1 | – 队伍在城镇模式下。 |
- 播放声音 which_sound。声音在附录中列出。如果声音的编号为正数，则在声音播放期间停止操作。如果为负数，则在游戏继续时播放声音。
- 在游戏文本区域显示文本 to_print。允许的最大文本长度为 70 个字符。
- 类似于
print_str()，但还可以为文本设置不同的颜色。
color 的值是
| 0 | – 黑色。 |
| 1 | – 红色。（通常用于错误。） |
| 2 | – 蓝色。 |
| 3 | – 紫红色。 |
| 4 | – 绿色。 |
- 立即运行当前 城镇脚本，状态为 which_node。场景脚本停止运行后，调用该函数的脚本将继续正常运行。您只能在对话、生物或地形脚本中进行此调用。
void set_incidental_sound(short on_or_off)
[edit | edit source]- 设置背景中是否播放环境音效（鸟叫声等）。如果环境音效被关闭，则除非使用此调用再次打开，否则它们将保持关闭状态。
on_or_off 的值是
| 0 | – 打开环境音效。 |
| 1 | – 关闭环境音效。 |
void set_state(short new_state)
[edit | edit source]- 将脚本的状态更改为 new_state 并立即停止运行脚本。在对话脚本或状态 INIT_STATE、DEAD_STATE 或其他预定义状态类型（除 START_STATE 外）中无效。
备注:
- 请参阅 常量，其中列出了可用于 new_state 的常量及其已知值（如果有）。
void set_state_continue(short new_state)
[edit | edit source]- 与
set_state()完全相同，只是它不会停止运行脚本。
备注:
- 尽管官方文档指出
set_state_continue()的工作方式与set_state()完全相同，但set_state_continue()确实 在预定义状态（至少部分）中起作用，并且可能在所有预定义状态中都起作用。 - 请参阅 常量，其中列出了可用于 new_state 的常量及其已知值（如果有）。