跳到正文
返回搜索

LeviOptimize

作者 LiteLDev

A performance optimization mod for Minecraft Bedrock Dedicated Server and the Bedrock client

0.18.0

README0.18.0

LeviOptimize

English 中文

LeviOptimize 是运行在 LeviLamina 上的 Minecraft 基岩版服务端 / 客户端性能模组。 它针对 TPS 偏低的热点原版路径做替换:区块发送、实体广播、红石更新、定位栏、随机刻和异步 worker 调度。

每个功能相互独立,都有自己的开关,可以在运行时用 /lo 启用或禁用。

目录

安全性

LeviOptimize 是独立项目,不隶属于 Mojang 或 Microsoft,也不受其官方支持。项目开源且免费使用;请自行承担使用风险, 作者不对服务器或数据可能造成的损害负责。

安装

LeviOptimize 需要 LeviLamina 26.51.x。

使用 lip

在专用服务器上使用 lip 安装:

lip install github.com/LiteLDev/LeviOptimize

在基岩版客户端上安装 client 变体:

lip install github.com/LiteLDev/LeviOptimize#client

手动安装

  1. 从发布页面下载最新版本;
  2. 服务端解压 LeviOptimize-server-windows-x64.zip,客户端解压 LeviOptimize-client-windows-x64.zip;
  3. 服务端复制 LeviOptimize 目录到 plugins/,客户端复制到 mods/。

使用

首次启动时,模组会在服务端的 plugins/LeviOptimize/config/ 或客户端的 mods/LeviOptimize/config/ 生成 config.json。每个安装目录拥有自己的配置文件。

配置包含版本号和按功能分区的内容。只有开关的功能直接写布尔值;带参数的功能写成对象:

{
    "version": 1,
    "features": {
        "chunk_leak_fix": true,
        "chunk_caches_opt": true,
        "push_entity_opt": {
            "enable": true,
            "disable_vec0_push": true,
            "max_push_times": -1,
            "unlimited_player_push": false
        }
    },
    "commands": {
        "server_feature_manage_command": true,
        "client_feature_manage_command": true
    },
    "diagnostics": {
        "full_frame_timing": true
    }
}
  • features:性能功能;
  • commands:命令功能本身;
  • diagnostics:测量工具。

缺失条目按默认值处理,未知分区和未知功能条目在回写时原样保留;修改后执行 /lo reload 即可生效,无需重启服务端。

命令

命令本身也是功能,可以在 commands 里关闭。

服务端:/lo(GameDirectors)

  • /lo list:列出服务端功能及其运行 / 配置状态;
  • /lo triggers:列出已注册的触发器;
  • /lo reload:重新读取 config.json 并重新判断触发器;
  • /lo reload <feature>:只重载某个功能;
  • /lo enable <feature> / /lo disable <feature>:切换功能开关并写回配置;
  • /lo profile:查看 full_frame_timing 诊断的当前 / 平均全帧 MSPT 与 TPS。

客户端:/clilo

动作与服务端一致,权限为 Any。客户端命令不依赖服务端事件。

功能

功能配置键说明
ChunkCachesOptchunk_caches_opt提高区块混合 / 存在性缓存上限,避免玩家分散时反复清空缓存;会保留更多内存。
ChunkLeakFixchunk_leak_fix玩家断线时通过原生清理移除地图 tracker、装饰和脏状态。
CircuitSceneGraphOptcircuit_scene_graph_opt电路更新前清理失效的红石供电关联,保留仍待加入的组件。
EntityPacketRecipientsOptentity_packet_recipients_opt仅服务端:实体广播只读一次实体 ID,按玩家附近实体批量收集接收者;ID 无效时回退原生路径。
LocatorOptlocator_opt按观察者 / 被观察玩家缓存上次发送的定位位置,没变化时跳过原生可见性判断。
ParkedChunksOptparked_chunks_opt暂存暂时发不出的 publisher 队列节点,在区块加载或视野变化时重新检查。
PlayerNetworkingOptplayer_networking_opt玩家网络处理结束后,每个区块生成优先级列表只重建一次,而不是每个玩家重建一次。
PlayerSnapshotOptplayer_snapshot_opt复用经过校验的活动玩家快照,加速维度遍历和人数统计。
PushEntityOptpush_entity_opt可选的实体推动限制:关闭零向量推动、限制每 tick 推动次数、玩家相关推动不限次。
RandomChunkOptrandom_chunk_opt自动保存时对区块坐标采样,避免每次都遍历整个区块表。
RandomTickPrefetchOptrandom_tick_prefetch_opt预测原版随机刻要读的存储并预取,不推进游戏 RNG。
SeenPercentOptseen_percent_opt按坐标和包围盒缓存 SeenPercent 值。
VanillaWaypointsOptvanilla_waypoints_opt定位栏路标的跟踪集合和图标没变化时,直接跳过原生更新。
WorkerBacklogOptworker_backlog_opt校验目标字段后,把异步 worker 的积压等待从 0.05 秒设为零。

诊断

FullFrameTiming(full_frame_timing,位于 diagnostics)是测量工具,不是优化。它统计 Minecraft::update 的整帧时间,并用 Level::tick 切分补跑 tick;/lo profile 输出最近 20 个样本。 可以像其他功能一样关闭。

从源码构建

需要 xmake 和 LLVM/clang-cl 工具链。

# 专用服务端
xmake f -c -m release --target_type=server
xmake

# 客户端
xmake f -c -m release --target_type=client
xmake

打包后的模组输出在 bin/LeviOptimize。

贡献

欢迎提交 issue、提问和 PR。

许可证

GPL-3.0-or-later © LeviMC

安装 LeviOptimize

运行端
  • 服务端
平台
  • win-x64

在服务端目录中用 lip 运行:

lip install github.com/LiteLDev/LeviOptimize@0.18.0
从 GitHub 下载