JourneyMap TFC Integration

English

[1.0.2] — 2026-07-13

Fixed

• Cache loss (Critical): loadOnce() was previously triggered by client requests. External mods (e.g. SimpleBackups) could fire LevelEvent.Save immediately after server init, when memory only contained incomplete spawn chunk data, causing save() to irreversibly overwrite the full historical disk cache.
  • loadOnce() moved to JMTFCServerPlugin.initialize() — loads at server startup, no longer depends on client.
  • save() now guarded by loadedFromDisk flag — refuses to overwrite disk before loadOnce() completes.
  • loadOnce() merge with existing in-memory data from ChunkEvent.Load, disk takes priority, with merge count logging.

Added

• /jmtfc clearcache command: OP level 2, clears all TFC cache (memory + disk file).
• Full-chain diagnostic logging: covers loadOnce / save / warmup / buildPayload / handleRequestCache / handleCacheData / onCacheDataReceived / toggleOverlay / renderOverlay; INFO level reserved for lifecycle events only.

Changed

• Log downgrade: per-request logs (warmup, buildPayload, toggleOverlay, etc.) lowered to DEBUG to reduce noise.
• Fixed fully-qualified ChunkAccess reference in TFCDataAccess.

中文

[1.0.2] — 2026-07-13

Fixed

• 缓存丢失（Critical）：loadOnce() 原本依赖客户端请求触发，外部模组（如 SimpleBackups）可在服务端初始化后立即触发 LevelEvent.Save，此时内存中仅有 spawn chunks 的不完整数据，save() 直接覆盖磁盘上完整的历史缓存文件，造成不可逆的数据丢失。
  • loadOnce() 移至 JMTFCServerPlugin.initialize() 中执行——服务端就绪即加载，不再依赖客户端。
  • save() 新增 loadedFromDisk 守卫——loadOnce() 未完成前拒绝覆盖磁盘。
  • loadOnce() 加载时与内存已有 ChunkEvent.Load 数据合并，磁盘优先，追加合并计数日志。

Added

• /jmtfc clearcache 命令：OP 权限（level 2），清除全部 TFC 缓存（内存 + 磁盘文件）。
• 全链路诊断日志：覆盖 loadOnce / save / warmup / buildPayload / handleRequestCache / handleCacheData / onCacheDataReceived / toggleOverlay / renderOverlay 各环节，INFO 仅保留关键生命周期事件。

Changed

• 日志降级：per-request 日志（warmup、buildPayload、toggleOverlay 等）降至 DEBUG，减少正常使用时的日志噪音。
• 修复 TFCDataAccess 中 ChunkAccess 全限定名引用。