《文字游戏世界》魔法书

设置事件参数

@[set_event_params] {
    "target": "物件名称",
    "需要更改的参数": 更改后的参数
}

用于直接修改指定物件或玩家当前持有的事件参数。根据最新研究，@[set_event_params] 不仅能改常见显示参数，还能改不少底层移动、渲染、音效与运行状态字段。

target 取值

• "self"：当前执行该指令的物件自身。
• "player"：玩家。
• "具体物件名"：场景中的目标物件。

常用可修改参数

下表优先列出实用性较高、风险较低的字段。示例中的值仅作演示，实际效果请结合关卡逻辑测试。

可用于补间的参数

研究表明，以下字段更适合通过 @[tween_parameter] 平滑修改，而不是直接硬切：

如果只是想做动画，请优先使用补间；如果是想永久改物件状态，则优先使用 @[set_event_params]。

新发现的渲染参数

这些字段适合做显示控制、颜色变化、局部透明等效果：

理论上可改，但要谨慎的运行时参数

@[set_event_params] 的实现方式决定了：只要该物件能通过 get() 访问到对应字段，而且字段不是 null，理论上就有机会被修改。因此除导出变量外，还有一批运行时字段也可能生效。

物件 / 玩家共用父类中的常见字段

风险更高的字段

下列字段虽然理论可改，但容易影响解释器状态、存在判定或子事件结构，不建议在正式关卡中随意操作：

其中 sub_events 需要保持如下字典结构：

{
  "子事件字符1": [命令列表],
  "子事件字符2": [命令列表]
}

注意事项

• 普通物件与玩家使用同一个父类，所以某些移动相关字段对玩家也可能生效。这也是“等待期间玩家无法行动”这一现象的重要解释之一。
• type 虽然可改为 Event 或 Player 标记，但研究指出它更像引擎内部标记，改完不会真的把物件变成玩家。
• 若要修改位置，优先考虑 @[transport_event]；强行改部分底层位置参数可能造成显示与碰撞不同步。
• 若要做平滑过渡，请优先改用 @[tween_parameter]，避免直接设置导致跳变。
• 研究笔记指出：用补间直接改“事件参数”类字段可能出现异常，因此改物件属性优先使用 @[set_event_params]，做动画优先使用补间可安全支持的字段。
• commands、move_route、sub_events 这类结构化字段不建议手写热修改，除非已经确认格式完全正确。