世界语义

本文件定义“什么是真的”。数据库、网络协议和渲染器都必须遵守这里的语义,不能各自创造一套世界。

1. 世界

一个世界由以下权威信息组成:

World
├── world_id
├── seed
├── epoch
├── clock
├── terrain_version
├── regions
├── active_environment_events
└── decay_ruleset_version
  • world_id:世界的稳定标识。
  • seed:程序化地形及确定性环境生成的根种子。
  • epoch:世界时间的起点。
  • clock:当前权威世界时间。
  • terrain_version:地形生成算法版本。
  • regions:空间分区。
  • active_environment_events:风、雨等当前有效的环境事件。
  • decay_ruleset_version:解释痕迹衰减的规则版本。

2. 权威世界时间

服务端时间是唯一权威时间。客户端不得直接以设备墙上时钟判断痕迹年龄。

客户端维护:

estimated_world_time =
  last_server_world_time
  + monotonic_elapsed_since_sync

要求:

  • 每次区域快照和重要服务端消息都携带 server_time。
  • 客户端使用单调计时器计算同步后的经过时间。
  • 设备系统时间变化不影响世界时间。
  • 重连后立即以新快照校正,不播放“倒着恢复”的痕迹动画。
  • 服务端重启后,世界时间继续前进,不因进程生命周期重置。

3. 空间与区域

世界被划分为区域,以限制同步和查询范围。

区域必须满足:

  • 坐标系和边界在同一 terrain_version 内稳定;
  • 相邻区域允许短暂重叠订阅,避免跨边界时痕迹突然出现或消失;
  • 客户端只接收视野附近及预取范围内的数据;
  • 区域只是工程分区,不应在画面中形成可见边界。

建议的权威坐标采用世界平面坐标:

x: 东西方向
z: 南北方向
y: 由地形函数推导,痕迹事件通常不必保存

如果未来支持洞穴或垂直地形,再升级空间模型,不在 MVP 中提前复杂化。

4. 四类状态

4.1 永久世界配置

包括世界 seed、地形版本、区域划分和规则版本。它们很少变化,变化时必须产生新版本。

4.2 有限寿命事件

包括人的路径、动物经过和环境变化。它们是权威事实,但只在自己的生命周期内存在。

4.3 短暂在线状态

包括当前旅人的位置、朝向和连接状态。它只用于实时偶遇,会话结束后失效。

4.4 客户端派生状态

包括脚印透明度、边缘侵蚀、粒子、光照、LOD、镜头和动画状态。它们不写入权威存储。

5. 共同事实与个人表现

同一区域的观察者必须在语义上共享:

  • 哪条路径曾经产生;
  • 哪只动物何时经过;
  • 哪段时间发生过强风;
  • 某条痕迹是否仍处于可见生命周期。

不同设备可以在以下方面有所不同:

  • 沙粒和粒子数量;
  • 脚印网格精度;
  • 阴影质量;
  • 远处对象细节等级;
  • 低性能设备上的动画采样率。

但不能出现一台设备判定痕迹已经被遗忘,另一台仍判定它有效的情况。

6. 动物语义

动物是共享但短暂的世界事件。

服务端或确定性世界调度器决定:

哪种动物
在什么时间
从哪个区域
沿哪条路径
经过多久
留下哪种痕迹

客户端负责:

  • 按共享路径播放动物运动;
  • 根据物种步态生成足迹;
  • 按相同时间轴显示或隐藏动物;
  • 在动物离开后继续渲染尚未消失的足迹。

不得由每个客户端独立随机生成共享动物,否则多人在同一地点会看到不同世界。

7. 人类旅人语义

  • 用户输入首先是移动意图,不是权威位置。
  • 服务端验证并接受路径片段后,该片段才成为共享事实。
  • 实时位置可以低频同步;痕迹路径应按连续片段提交。
  • 公开协议只提供短期 presence_id,不提供稳定用户标识。
  • 断线后,实时存在立即或短暂超时后消失;已被接受的脚印继续按规则衰减。

8. 环境事件

风和雨等环境变化以有时间范围的事件表达,而不是逐个修改脚印。

EnvironmentEvent
├── event_id
├── region_id
├── kind
├── starts_at
├── ends_at
├── intensity
├── direction(可选)
└── ruleset_version

痕迹状态由其生命周期与覆盖该时间区间的环境事件共同决定。

9. 规则版本

事件必须记录创建时适用的规则版本,避免部署新算法后让历史痕迹突然恢复或提前消失。

规则升级原则:

  • 新事件使用新版本;
  • 尚未过期的旧事件继续使用旧版本解释;
  • 不对旧事件批量改写;
  • 所有旧版本必须至少保留到使用它们的最后一条事件被清理。

10. 确定性边界

必须确定性一致的部分:

  • 生命周期阶段;
  • 是否可见;
  • 是否可以清理;
  • 动物经过的时空路径;
  • 规则版本选择。

允许非确定性或设备差异的部分:

  • 粒子细节;
  • 沙纹微扰;
  • 不影响事实判断的视觉噪声;
  • 音频混合中的轻微变化。