世界缓存 - 更快的世界加载

世界缓存 - 更快的世界加载

将Valheim生成的世界保存在磁盘上,Minecraft风格:已访问或已准备的地点从缓存加载,而不是重新生成。一个准备世界按钮在后台提前工作,并在战斗中暂停。你的存档永远不会被触碰;每个玩家的缓存都是本地的,服务器不需要该模组。为世界生成模组提供开放API。

WorldCache

Valheim 生成的世界保存在你的磁盘上 - 类似 Minecraft

Сгенерированный мир Valheim хранится на диске, как в Minecraft

描述 / Описание

EN: 你在游玩时游戏(或世界生成模组)生成的每个地方都会写入你的磁盘。下次你到那里时,它会从磁盘读取,而不是重新生成。你用一些磁盘空间换取更快的加载速度。准备世界按钮会在后台提前完成这件事。

你的存档绝不会被改动。缓存可以随时删除 - 地方只会被重新生成。

每个玩家的缓存都是自己的。服务器和其他玩家不需要这个模组。

RU: 游戏(或世界生成模组)在游玩过程中生成的一切都会保存到磁盘。当你再次来到这个地方时,它会从磁盘读取,而不是重新生成。付出磁盘空间 - 获得更快的加载速度。**«准备世界»**按钮会在后台提前完成这件事。

世界存档不会被改动。缓存可以随时删除 - 地方只会被重新生成。

每个玩家的缓存都是自己的。服务器和其他玩家不需要这个模组。

诚实的数字:用接入 API 的球形世界模组测量,进入世界无缓存 18.0 秒,有缓存 16.3 秒 - 约快 9%,723 块地形从磁盘读取,没有一块被重新生成。在原版游戏中收益更小 - 每次加载不到一秒,外加服务器客户端的世界地图(否则游戏每次加入都会重建)。 Честно: замер с модом сферического мира, подключённым к API: вход в мир 18,0 с без кэша и 16,3 с с кэшем - примерно на 9% быстрее, 723 куска рельефа прочитаны с диска, ни один не сгенерирован заново. В чистой игре выигрыш меньше - доли секунды на загрузку плюс карта мира у клиента сервера.

主要功能 / Основные возможности

  • 区域地形缓存 - 区域和远处地形的高度与生物群系遮罩:传送门或你基地附近的区域不必等待游戏的构建线程
  • 世界地图缓存,用于他人服务器的客户端 - 游戏只为自己机器上保存的世界保留地图
  • 永不陈旧 - 键包含种子、世界、游戏版本、模组以及生成上的 Harmony 补丁及其设置(包括服务器发送的);任何变化都会清除缓存,日志会说明什么变了
  • 抽查 - 进入世界时会重新生成几块缓存并比较;不匹配会清除该阶段并列出修补生成的模组
  • 磁盘限制(500 MB - 20 GB),淘汰最久未使用的,优先其他世界
  • 首次进入没有缓存的世界:加载屏幕上显示提示和选择 - 等待(现在准备最近的地方)或游玩(探索时缓存)
  • 离开世界绝不等待磁盘 - 写入在后台完成
  • 开放 API 供世界生成模组使用:模组注册自己的生成阶段,WorldCache 负责存储、检查、限制和准备

世界中的物体(树木、岩石、建筑)不会被缓存 - 游戏将它们保存在存档中。地形编辑照常从服务器传来,并叠加在缓存的地面之上。

准备世界 / Подготовить мир

选择一个容量(500 MB / 1 / 2 / 5 GB / 自定义)和一个模式:

  • 智能 - 你周围 → 基地和传送门 → 地图上已探索的 → 祭坛和发现的地点 → 其余按距离
  • 我周围 - 从你开始的环状
  • 整个世界 - 直到磁盘限制

它在后台以小批量运行,在低 FPS、战斗中以及加载时暂停,在屏幕顶部显示进度条,并在你下次进入世界时继续。只生成生成数据,不生成物体。

主机(或通过运行 WorldCache 的服务器管理员)可以邀请安装了模组的玩家准备基地和传送门;每个玩家自行决定。没有模组的玩家什么也看不到。

安装 / Установка

EN:

  1. 安装 BepInEx for Valheim。
  2. 下载 WorldCache。
  3. 将 WorldCache.dll 放入: Valheim/BepInEx/plugins/
  4. 启动游戏。

RU:

  1. 安装 BepInEx for Valheim。
  2. 下载 WorldCache。
  3. 将 WorldCache.dll 文件放入文件夹: Valheim/BepInEx/plugins/
  4. 启动游戏。

卸载:删除 DLL。要释放空间,删除 %USERPROFILE%\AppData\LocalLow\IronGate\Valheim\worldcache\(每个世界一个文件夹)。

兼容性 / Совместимость

  • 仅客户端 - 服务器和其他玩家不需要它。除了主机的可选邀请外,没有任何东西通过网络传输。
  • Valheim 1.0.20,BepInEx 5.4.23+。
  • 与其他模组兼容:改变地形生成的模组会通过其 Harmony 补丁被检测到,并成为缓存键的一部分。
  • 早期版本(0.1.x) - 请附上你的 LogOutput.log 报告问题。

Только клиент: серверу и другим игрокам мод не нужен. Моды, меняющие генерацию, учитываются автоматически.

设置 / Настройки

设置 → 图形,World cache - WorldCache 部分:开/关、磁盘限制、已用空间、清除(此世界 / 所有世界)、准备模式和容量、准备 / 停止、进度。每一行都有 ! 提示。此外还有 AdminMenu(F7)中的 World cache 标签页(如果已安装),以及控制台命令 worldcache。

BepInEx/config/chistix.worldcache.cfg - LimitMB (2048)、AskOnFirstEntry、SpotChecks、准备线程和暂停。旧版本的设置会自动继承。故障排除:BepInEx/LogOutput.log,查找 "WorldCache"。

作者 / Авторы

  • 由 Chistix 设计、指导和测试。代码使用 Claude Code(Anthropic)编写。
  • 使用 BepInEx 和 Harmony。图标由脚本绘制;不包含游戏美术资源。

保留所有权利。你可以使用该模组、在视频和直播中展示它,并将其列为依赖项;重新上传或修改版本需要作者许可。


链接

在 Patreon 上支持我 Patreon

我的 YouTube 开发频道 YouTube

我在 Nexus Mods 上的模组 Nexus Mods

在 Steam 上添加我 Steam

在 Twitch 上观看我 Twitch