BetterView

插件

· 作者 booky10

一个 Paper 插件和 Fabric 模组,用于在不牺牲服务器性能的前提下扩展正常的服务器视距

0 本站下载 0 关注 更新于 1 个月前

最新 2.2.1+paper · 26.3 · Bukkit / Folia

一键开服(送7天)

BetterView

描述

BetterView 是一款高性能的 Paper 插件和 Fabric 模组,适用于 Minecraft 服务器。它通过异步玩家处理、直接从磁盘读取区块以及缓存区块数据,在不牺牲服务器性能的前提下扩展了常规视距。

功能

  • 在网络线程上异步快速处理玩家逻辑
  • 直接从磁盘读取区块,无需加载它们
  • 优化的区块状态追踪与区块迭代
  • 可配置的区块数据缓存以实现快速访问
  • 可配置的限制以控制区块发送和区块生成
  • 支持按维度(Dimension)配置选项
  • 支持集成式或独立式 Fabric 服务器
  • 为扩展区块提供轻量级反 X 光支持
示例:视距为 127 个区块时的加载速度

下面的截图是在末地维度坐标 0 2250 0 处拍摄的,视距设置为 127 个区块(已禁用雾效)。在 AMD Ryzen 7 5800X 处理器上,加入服务器后,所有可见区块在冷缓存情况下约需 12 秒传输至客户端,在热缓存情况下约需 9 秒。

支持的软件

Minecraft 版本 Paper Fabric
26.3.x ✅ ✅
26.2.x ✅ ✅
26.1.x ✅ ✅
1.21.11 ✅ ✅
1.21.10 ✅ ✅
1.21.9 ✅ ✅
1.21.8 ✅ ✅
1.21.7 ✅ ✅
1.21.6 ✅ ✅
1.21.5 ✅ ✅
1.21.4 ✅ ✅
1.21.3 ✅ ✅
1.21.1 ✅ ✅

在 Fabric 环境下,此模组依赖 Moonrise 和 adventure-platform-mod 才能正常工作。

用法

在 Paper 服务器上,将 jar 文件放入 plugins 目录并重启服务器。在 Fabric 服务器/客户端上, 将 jar 文件放入 mods 目录并重启服务器或客户端。默认情况下,BetterView 将为每个维度配置 32 个区块的视距。

配置

首次启动时,该插件会自动创建一个配置文件。如果使用 Paper,它将创建于 plugins/BetterView/config.yml;如果使用 Fabric,它将创建于你的世界目录内的 betterview.yml 文件中 (例如独立服务器的 world 目录)。在其中,你可以配置以下选项:

  • config-version:请勿修改此项
  • integrated-server-render-distance:仅对单人世界有效,此选项允许替换集成服务器的渲染距离。否则 BetterView 将不起作用(默认值:-1,已禁用)
  • global:
    • enabled:是否启用或禁用整个插件/模组(默认值:true)
    • chunk-generation-limit:每个刻(tick)全局可生成的新区块数量上限(默认值:3)
    • chunk-send-limit:每个刻发送给单个玩家的最大区块数量(默认值:3)
  • dimensions:
    • <dimension>(例如 minecraft:overworld):
      • enabled:是否在此维度中启用或禁用该插件/模组(默认值:true)
      • chunk-generation-limit:每个刻可为此层级生成的新区块数量上限(默认值:2)
      • chunk-queue-size:每个玩家可同时排队的区块数量上限(默认值:16)
      • view-distance:此维度的最大扩展视距(默认值:32)
      • cache-duration:扩展区块在内存中保留的缓存时长(默认值:PT5M,即 5 分钟)
        • 请根据服务器的用途调整缓存时长; 例如,对于静态大厅服务器,可以使用比动态 SMP 服务器更长的缓存时长。 如果缓存时间过长,玩家在重新加入后可能会看到过时的区块内容。
      • anti-xray:
        • 请注意,本插件实现了一个轻量级的反 X 光功能,它不会检查方块是否暴露在空气中。这意味着除 HIDE 之外的所有引擎模式可能看起来效果不佳。
        • enabled:是否在此世界中启用或禁用反 X 光功能(默认值:false)
        • engine-mode:反 X 光的引擎模式,可选 HIDE、OBFUSCATE 或 OBFUSCATE_LAYER (默认值:HIDE)
        • hidden-blocks:需要隐藏/混淆的方块列表(默认值:所有矿石以及所有维度的所有基础方块)
      • chunk-batches:
        • 区块批次用于确保客户端/玩家的网络连接不会因为一次性发送过多区块而过载。如果启用,BetterView 会发送一个区块批次并等待玩家确认已接收完整的区块批次。只有在收到确认后,才会发送下一批区块。
          这会产生一个副作用:连接良好但延迟较高的玩家将比理论速度更慢地接收区块。
          注意:区块批次可能会跨越多个刻进行发送。
        • enabled:是否在此维度中启用或禁用区块批次功能(默认值:true)
        • chunks-per-batch:单个批次中的区块数量(默认值:12)
        • prepare-chunks-while-waiting:在等待前一批次确认期间,BetterView 是否应继续准备区块(默认值:true)
        • batch-timeout:如果在指定时间内未发送任何区块,则批次过期(默认值:PT5S)
        • batch-wait-timeout:超时时间,超过此时间后即使没有玩家响应,BetterView 也会自动将批次标记为完成(默认值:PT30S)

您可以随意调整区块生成和发送限制,以在您的服务器设置中获得最佳体验。

API 用法

Maven 仓库:https://repo.minceraft.dev/releases/
Maven 构件:dev.booky.betterview:betterview-api:2.2.1
Javadoc:

Paper 示例
// 使用 Bukkit 的 ServicesManager 获取 BetterView API 实例
// 这是在 Paper 上使用 API 与 Fabric 之间的唯一区别
BvManager bvManager = Bukkit.getServicesManager().load(BvManager.class);
if (bvManager == null) {
    throw new IllegalStateException("Failed to load BetterView API");
}
// 使主世界坐标 0,0 处的区块缓存失效
BvLevel overworld = bvManager.getLevel(Key.key(Key.MINECRAFT_NAMESPACE, "overworld"));
overworld.invalidateChunkCache(0, 0);
// 刷新主世界中所有玩家的区块
for (BvPlayer player : overworld.getPlayers()) {
    // (切换到适当的线程以确保线程安全)
    player.getExecutor().execute(() -> {
        if (!player.isActive() || player.getLevel() != overworld) {
            // 玩家不活跃或不在主世界——也许在这段代码运行的短时间内他们切换了维度?
            return;
        }
        // 确保 BetterView 实际上“拥有”坐标 0,0 处的区块
        if (player.getChunkLifecycle(0, 0).isOwned()) {
            // 最后,排队刷新该区块!
            player.refreshChunk(0, 0);
        }
    });
}
Fabric 示例
// 使用 Fabric 的 ObjectShare 获取 BetterView API 实例
// 这是在 Paper 和 Fabric 上使用 API 的唯一区别
BvManager bvManager = (BvManager) FabricLoader.getInstance().getObjectShare().get("betterview:api");
if (bvManager == null) {
    throw new IllegalStateException("加载 BetterView API 失败");
}
// 重载世界中坐标为 0, 0 的区块缓存失效
BvLevel overworld = bvManager.getLevel(Key.key(Key.MINECRAFT_NAMESPACE, "overworld"));
overworld.invalidateChunkCache(0, 0);
// 为重载世界中的所有玩家刷新区块
for (BvPlayer player : overworld.getPlayers()) {
    // (切换到合适的线程以确保线程安全)
    player.getExecutor().execute(() -> {
        if (!player.isActive() || player.getLevel() != overworld) {
            // 玩家未激活或不在重载世界中——可能在这段代码执行期间他们切换了维度?
            return;
        }
        // 确保 BetterView 实际上“拥有”坐标为 0, 0 的区块
        if (player.getChunkLifecycle(0, 0).isOwned()) {
            // 最后,将区块加入刷新队列!
            player.refreshChunk(0, 0);
        }
    });
}

请注意,该 API 仍在开发中。请随时在 Discord 或问题追踪器中提出建议、增强功能或其他想法。

构建

  1. 克隆项目(git clone https://github.com/MinceraftMC/BetterView.git)
  2. 进入克隆的目录(cd BetterView)
  3. 构建 jar 文件(Linux/MacOS 上运行 ./gradlew build,Windows 上直接运行 gradlew build)

jar 文件位于 build → libs 目录中。

贡献

如果您想为 BetterView 做出贡献,请随意分叉仓库并创建拉取请求。请确保遵循项目中使用的代码风格和约定。如果您有任何问题或需要帮助,欢迎在 Discord 中提问。

您可以通过运行 ./gradlew :paper:runServer 或分别运行 ./gradlew :fabric:prodServer/./gradlew :fabric:prodClient 来测试您的更改。这将启动一个本地服务器,自动安装已编译的插件或模组,并在 IDE 中准备好进行调试。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源