游戏叙事与剧情 / 系统课时
让游戏代码调用 Ink 函数
让游戏代码调用 Ink 函数
当伤害计算、关系判定或剧情规则已经写在 Ink 中时,游戏代码不必再复制一套逻辑。Ink 运行时允许宿主程序按函数名调用脚本函数、传入参数并取得返回值,从而让剧情规则保持在脚本侧,同时由游戏侧决定何时触发。
学习目标
- 能在 Ink 中定义适合由游戏代码调用的函数
- 能通过运行时 API 传参并取得函数返回值
- 能区分“游戏调用 Ink”与“Ink 调用游戏”的边界
把可复用规则写成 Ink 函数
适合暴露给游戏代码的 Ink 函数通常具有明确输入和返回值。例如奖励点数既受基础值影响,又受剧情中的额外加成影响,可以把这条规则集中写在脚本中。
下面是一份最小 Ink 源码。它包含一个可调用函数和一个正常的故事入口;源码需要先编译为运行时使用的 Ink JSON。
=== function reward_points(base, bonus) ===
~ return base + bonus
=== start ===
奖励系统已就绪。
-> ENDreward_points 没有直接修改界面,也不知道按钮、动画或存档系统的存在。它只负责剧情规则:接收两个数并返回结果。这样的函数边界容易测试,也不会把游戏引擎细节带进脚本。
从游戏代码调用函数
以 inkjs 为例,已经创建好的 Story 实例可以使用 EvaluateFunction 调用 Ink 函数。下面是片段示例,假设 story 已由编译后的故事 JSON 初始化完成。
const base = 10;
const bonus = 5;
// 函数名必须与 Ink 中定义的名称一致,参数按声明顺序传入。
const points = story.EvaluateFunction("reward_points", [base, bonus]);
console.log(points);预期输出
15这里的调用不会要求游戏代码手动跳转到某个 knot。运行时执行函数后直接取得返回值,因此很适合“查询或计算一条剧情规则”这类同步操作。
处理返回文本和副作用
Ink 函数最好优先返回数据,而不是依赖函数内部输出对白。这样游戏代码拿到的是稳定的布尔值、数字或字符串,可以自行决定后续表现。例如返回奖励点数后,游戏侧再负责播放音效、刷新 HUD 或写入业务状态。
如果函数需要读取 Ink 内部变量,也应让这些变量成为剧情规则的一部分,而不要让函数顺便承担大量界面控制。函数调用次数增加后,清晰的输入、输出和副作用边界会直接影响脚本是否容易维护。
选择适合放在脚本侧的逻辑
可以把“是否满足剧情条件”“根据剧情状态计算奖励”“把多项剧情变量归纳成一个结果”等规则放进 Ink 函数。它们与叙事状态关系紧密,而且策划修改规则时不需要同时修改一份游戏代码。
相反,创建游戏对象、播放声音、发起网络请求、访问文件系统这类能力属于宿主环境,不应伪装成 Ink 内部函数。让 Ink 函数保持为可预测的剧情规则,再由游戏代码根据返回值执行引擎行为,双方的职责会更清楚。