Bobby Share 是一款高性能 Fabric 模组,旨在将 Minecraft 服务器中的区块数据协作式流式传输至客户端,以动态填充 Bobby 模组的渲染缓存。
? 工作原理
Bobby 是一个客户端模组,允许你拥有超出服务器限制的渲染距离,通过在本地计算机上缓存区块来实现。通常情况下,你需要亲自前往那些区域才能缓存它们。
Bobby Share 填补了这一空白:
- 当你加入服务器或移动到新区域时,你的客户端会检查本地 Bobby 缓存中是否缺少区块数据。
- 如果缺少该区块,客户端会向服务器发送一个轻量级的网络请求。
- 服务器异步加载区块数据(或直接从服务器内存中序列化当前活跃的区块),对其进行优化后流式传输回给你。
- 你的客户端将区块保存在本地并显示出来,使你能够瞬间看到远超服务器渲染距离的景象。
? 实时区块缓存失效与无缝热替换 (v1.3.0+ & v1.4.0)
再也不用担心过远的视距导致过时数据或视觉空洞了!
- 即时同步: 每当玩家在服务器上破坏方块、放置方块或炸毁地形时,Bobby Share 会实时更新使受影响的区块失效。
- 零额外开销: 仅向已连接的客户端发送一个微小的 8 字节通知数据包。
- 无缝热替换更新 (v1.4.0 新增): 修改后的区块会被直接更新并注入到客户端 Bobby 的活跃视觉内存中,无需卸载,彻底消除渲染闪烁、卡顿和巨大的黑色虚空。
- 过期数据包丢弃: 如果在网络数据包传输过程中区块被修改,会自动丢弃乱序的飞行中响应。
⚡ 性能、安全性与并发优化
设计用于从 3 名玩家扩展到 100+ 名并发玩家,而不会导致 TPS 下降或堵塞网络通道:
- 线程安全的实时区块流式传输 (v1.4.0 新增): 在分发包之前,安全地在服务器线程上序列化玩家附近活跃加载的区块,彻底消除了
PalettedContainer多线程竞争条件以及在重度探索下的服务器看门狗崩溃问题。 - 高负载压力测试: 在玩家大量移动的重度流量下,经过严格测试可处理数万次实时区块请求,无崩溃或内存泄漏。
- 服务端 LRU 缓存: 在内存中缓存多达 4096 个优化后的区块复合体(约 100MB RAM),以便立即服务于热门区域,无需重复读取磁盘。
- 限流客户端队列: 将出站客户端请求限制为每刻 3 个区块(60 个区块/秒),彻底消除洞穴或密集地形中的延迟尖峰。
- 令牌桶速率限制: 限制每个玩家的请求量(突发:200 个区块,补充:80 个区块/秒),以防止服务器被垃圾请求淹没。
- NBT 剥离 (带宽优化): 在发送前从区块中剥离重型且与渲染无关的数据(结构、实体刻钟、雕刻掩码、方块实体),将载荷大小减少 50% 至 80%。
- 主线程安全: 使用 Minecraft 的线程安全加载 API 异步获取区块数据。在客户端,文件写入在后台线程运行,以保持游戏完全无卡顿。
- 安全解耦: 优雅地处理缺少 Bobby 或仅限客户端的环境,不会导致 mixin 注入失败或服务器崩溃。
⚙️ 配置与命令 (服务端)
你可以使用服务器上的自动生成配置文件 config/bobbyshare.json 来配置 Bobby Share 的性能设置:
rateLimitBurst- 玩家可以在短时间内请求的最大区块数(默认值:200)。rateLimitRefill- 每秒恢复给玩家的区块请求数量(默认值:80)。cacheCapacity- 存储在服务器 RAM 中的最大剥离区块数(默认值:4096)。maxRequestDistance- 请求区块距离玩家的安全限制(默认值:34.0)。blacklistedDimensions- 禁用区块流式传输的维度标识符列表(默认值:["minecraft:the_end"])。
管理员命令 (需要 OP 等级 2):
/bobbyshare stats- 显示实时服务器性能仪表板:RAM 缓存占用率、命中率 %、实时内存捕获、磁盘读取次数、受限请求数和发出的失效通知数。/bobbyshare reload- 从磁盘重新加载配置文件并立即应用更改。/bobbyshare clearcache- 清除服务端 RAM 区块缓存。
? 安装与设置
为了成功流式传输区块,Bobby Share 必须安装在服务器和客户端上:
- 客户端: 将
bobbyshare-1.4.0+mc<version>.jar以及 原始的bobby-*.jar放入.minecraft/mods/目录。 - 服务端: 仅将
bobbyshare-1.4.0+mc<version>.jar放入服务器的mods/目录。 (警告:切勿在服务端放置原始 Bobby 模组,因为它仅限客户端使用,会在启动时导致服务器崩溃)。
支持的 Minecraft 版本:1.20.1 至 26.2,共有 13 个专用版本构建可在 GitHub Releases、Modrinth 和 CurseForge 中找到。
Bobby Share is a high-performance Fabric mod designed to collaboratively stream chunk data from the Minecraft server directly to clients to dynamically fill the rendering cache of the Bobby mod.
? How It Works
Bobby is a client-side mod that allows you to have a render distance greater than the server's limit by caching chunks locally on your computer. Normally, you have to visit the chunks yourself to cache them.
Bobby Share bridges this gap:
- When you join the server or move into new areas, your client checks if it is missing chunk data in its local Bobby cache.
- If the chunk is missing, the client sends a lightweight network request to the server.
- The server loads the chunk data asynchronously (or serializes live active chunks directly from server RAM), optimizes it, and streams it back to you.
- Your client saves the chunk locally and displays it, allowing you to instantly see far beyond the server's render distance.
? Real-Time Chunk Cache Invalidation & Seamless Hot-Swapping (v1.3.0+ & v1.4.0)
Never worry about outdated distant view distances or visual holes again!
- Instant Sync: Whenever a player breaks a block, places a block, or explodes terrain on the server, Bobby Share invalidates the modified chunk in real time.
- Zero Overhead: Sends a tiny 8-byte notification packet to connected clients.
- Seamless Hot-Swap Updating (New in v1.4.0): Modified chunks are updated and injected directly into Bobby's active visual memory on the client without unloading, completely eliminating render flashes, stutter, and gaping black voids.
- Stale Packet Discard: Automatically discards out-of-order in-flight responses if a chunk was modified while network packets were in transit.
⚡ Performance, Safety & Concurrency Optimizations
Designed to scale smoothly from 3 players to 100+ concurrent players without causing TPS drops or clogging network channels:
- Thread-Safe Live Chunk Streaming (New in v1.4.0): Actively loaded chunks near players are safely serialized on the server thread before packet dispatch, completely eliminating
PalettedContainermulti-threading race conditions and server watchdog crashes under heavy exploration. - Stress-Tested Under Heavy Traffic: Rigorously tested serving tens of thousands of real-time chunk requests under heavy player movement with zero crashes or leaks.
- Server-Side LRU Cache: Caches up to 4096 optimized chunk compounds in memory (~100MB of RAM) to serve popular regions instantly without repeating disk reads.
- Throttled Client Queue: Throttles outgoing client requests to 3 chunks per tick (60 chunks/sec), completely eliminating ping spikes in caves or dense terrain.
- Token Bucket Rate Limiting: Limits requests per player (Burst: 200 chunks, Refill: 80 chunks/second) to protect the server from being spammed.
- NBT Stripping (Bandwidth Optimization): Strips heavy, rendering-irrelevant data from chunks (structures, entity ticks, carving masks, block entities) before sending, reducing payload sizes by 50% to 80%.
- Main-Thread Safety: Fetches chunk data asynchronously using Minecraft's thread-safe loading APIs. On the client, file writing runs on background threads to keep the game completely lag-free.
- Safe Decoupling: Gracefully handles environments where Bobby is missing or client-only without failing mixin injections or crashing the server.
⚙️ Configuration & Commands (Server-Side)
You can configure Bobby Share's performance settings using the auto-generated config file at config/bobbyshare.json on your server:
rateLimitBurst- Maximum chunks a player can request in a quick burst (default:200).rateLimitRefill- Number of chunk requests restored to a player per second (default:80).cacheCapacity- Maximum stripped chunks stored in server RAM (default:4096).maxRequestDistance- Safety limit of how far from the player requested chunks can be (default:34.0).blacklistedDimensions- List of dimension identifiers to disable chunk streaming for (default:["minecraft:the_end"]).
Admin Commands (Requires OP level 2):
/bobbyshare stats- Displays live server performance dashboard: RAM cache occupancy, hit rate %, live RAM captures, disk reads, rate-limited requests, and invalidations sent./bobbyshare reload- Reloads the configuration file from disk and applies changes instantly./bobbyshare clearcache- Clears the server-side RAM chunk cache.
? Installation & Setup
To stream chunks successfully, Bobby Share must be installed on both the server and client:
- Client-Side: Place the
bobbyshare-1.4.0+mc<version>.jarAND the originalbobby-*.jarin your.minecraft/mods/directory. - Server-Side: Place ONLY the
bobbyshare-1.4.0+mc<version>.jarin your server'smods/directory. (WARNING: Do NOT put the original Bobby mod on the server, as it is client-side only and will crash the server on startup).
Supported Minecraft Versions: 1.20.1 to 26.2 across 13 dedicated version builds available in GitHub Releases, Modrinth, and CurseForge.
下载 Bobby Share
下载 Bobby Share
下载 Bobby Share
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Bobby Share
下载 Bobby Share
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Bobby Share
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Bobby Share
下载 Bobby Share
下载 Bobby Share
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Bobby Share
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
Bobby Share v1.4.0+mc26.3 - Beta
Minecraft 26.3 的首个测试版构建。
- 已更新以适配 Minecraft 26.3、Fabric Loader 0.20.1、Fabric API 0.165.2+26.3 以及 Bobby 5.2.16+mc26.3。
- 已将区块变更 mixin 适配至 26.3 中新的四参数
Level.setBlock(..., int, int)签名。 - 已在生产环境的 Fabric 服务器与客户端上验证:区块流式加载、实时/磁盘缓存读取及区块失效功能均可正常运行,无错误。
此为测试版构建。如有任何问题,请在 GitHub 上报告。
? Bobby Share v1.4.0 - 服务器稳定性与无缝区块更新
?️ 修复服务器崩溃与死锁
- 解决实时区块序列化导致的崩溃: 修复了可能导致服务器冻结或看门狗崩溃的并发竞争条件(
PalettedContainer状态变异)以及线程池饥饿问题。现在,实时区块会在数据包发送前在服务端线程上安全且同步地进行序列化。 - 压力测试验证: 在玩家大量移动的情况下,已验证该模组在处理数万条实时区块请求时具备极高的稳定性,无任何崩溃或内存泄漏。
?️ 修复客户端视觉错误
- 消除区块消失 / 黑洞现象: 修复了一个问题,即通过 Bobby 请求的假区块在到达时会立即被卸载,导致玩家在附近飞行时看到区块闪烁、消失或出现巨大的虚空空洞。
- 无缝热交换更新: 修改方块的无效化更新现在可以无缝地在内存中热交换 Bobby 假区块,无需卸载或渲染闪烁。
? 优化与清理
- 完全移除了内部调试日志和诊断开销。
- 已在所有支持的 Minecraft 版本分支(从 1.20.1 到 26.2)中全面更新并验证。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
缓冲的原始输入和线程化的事件轮询
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
原版世界生成优化模组
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
查看物品与配方
模组
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
评论 0
登录后参与评分
还没有评论,来抢沙发吧