本文件定义“什么是真的”。数据库、网络协议和渲染器都必须遵守这里的语义,不能各自创造一套世界。
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. 确定性边界
必须确定性一致的部分:
- 生命周期阶段;
- 是否可见;
- 是否可以清理;
- 动物经过的时空路径;
- 规则版本选择。
允许非确定性或设备差异的部分:
- 粒子细节;
- 沙纹微扰;
- 不影响事实判断的视觉噪声;
- 音频混合中的轻微变化。