Papermatica

插件

· 作者 Vulkann_

本项目修复了 PaperMC 和 Litematica 的 NBT 相关问题。

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

最新 1.0.5 · 1.21.11 · Paper

一键开服(送7天)

Papermatica

Litematica 与 Paper 之间的桥梁,完整支持 NBT 数据。

Litematica 的蓝图粘贴工具通常无法将方块实体数据(箱子、桶和漏斗的物品内容)或实体数据传输到 Paper 服务器——当未检测到 Servux 服务器时,Litematica 会退化为大量发送 /setblock 和 /summon 命令,这些命令均无法携带 NBT 数据,并且在大范围粘贴时可能会耗尽命令/数据包限制。

Papermatica 通过在服务器端实现真实的 Servux 网络协议 (servux:litematics) 来解决这个问题。Litematica 原生支持该协议——它只需要另一端有一个服务器即可。安装 Papermatica 后,粘贴蓝图会在服务器端直接放置每个方块,并精确恢复其保存的数据:

  • 箱子、桶、漏斗和其他方块实体在粘贴时会保留完整的物品栏。
  • 实体(矿车、物品展示框、盔甲架等)在粘贴时会保留保存的数据并获得一个新的身份标识,因此重复粘贴同一蓝图不会与之前的副本发生冲突。
  • 无需命令,也不会因数据包限制被踢出——每个方块都直接写入世界。
  • 红石状态稳定,不会出现中间切换的状态:放置过程会抑制所有副作用,然后在整个结构存在后运行一次干净的更新传递,随后再运行一次传递以将每个方块恢复为蓝图中保存的确切状态(捕捉任何方块在响应其真实邻居时发生的翻转)。
  • 无需额外的客户端模组——玩家只需安装 Litematica 本身,无需配套模组或特殊构建;详见下方要求。

要求

  • 服务器: 官方原版 Paper,适用于 Minecraft 1.21.11 —— 不需要任何分支或自定义构建,这是一个普通插件。
  • 希望进行粘贴的玩家: 需要为 1.21.11 版本的 Litematica 构建版本,其配置中包含 “Entity Data Sync”(实体数据同步)选项(M → Configs → Generic)。该选项是 Papermatica 所使用的 Servux 协议的客户端部分。Litematica 的 Servux 支持最初来自社区分支 (sakura-ryoko),而非原始模组,但后来已合并到广泛分发的构建版本中——如果你的 Litematica 显示该选项,则你已满足条件;如果没有,请更新 Litematica。
  • 进行粘贴的玩家必须是 op(或持有 papermatica.servux.paste 权限),并且处于 创造模式,这与 Litematica 自身对直接服务器端粘贴的要求一致。

安装

  1. 下载插件 jar 文件。
  2. 将 jar 文件放入服务器的 plugins/ 文件夹 然后重启服务器(或使用 /reload confirm,但对于涉及网络和 world 注册的插件,建议完全重启)。
  3. 检查控制台输出:
    =================================
              Papermatica
       Litematica -> Paper Bridge
    =================================
    ...
    Servux bridge initialized (channel: servux:litematics)
    Papermatica enabled.
    
  4. (可选)调整权限。 两个节点默认均为 op;如果你希望非 op 玩家也能进行粘贴,请通过你的权限插件明确授予它们权限:
    • papermatica.admin —— /papermatica 诊断命令。
    • papermatica.servux.paste —— 通过 Servux 粘贴蓝图。

核心粘贴功能不需要插件配置文件——只要插件启用且拥有相应权限的玩家连接了兼容的 Litematica,即可立即使用。

客户端设置(供玩家使用)

这部分容易被忽略——即使安装了 Papermatica,Litematica 默认也不会尝试检测 Servux 服务器:

  1. 确保你的 Litematica 具备 “Entity Data Sync” 选项(见上方要求——如果看不到该选项,请更新 Litematica)。
  2. 打开 Litematica 的配置 (M → Configs → Generic) 并启用 “Entity Data Sync” (entityDataSync)。该选项默认为关闭;如果不启用,Litematica 永远不会发送握手信息来发现 Papermatica,粘贴操作会静默回退到有缺陷的 /setblock 命令路径。
  3. 确认 “Paste Using Servux” (pasteUsingServux) 已启用——它默认为 开启,所以如果粘贴似乎仍未走直接路径,这只是一个 sanity check(常规检查)。
  4. 加入服务器,像往常一样加载蓝图放置,切换到创造模式,并使用正常的粘贴/执行操作快捷键进行粘贴。无需新的快捷键或额外模组。

大型蓝图与客户端 FPS

粘贴本身是在服务器端完成的,几乎瞬间完成,但 Litematica 仍然会在客户端渲染加载蓝图的完整幽灵/全息预览,无论粘贴速度多快,这在大型建筑中都会严重降低 FPS。如果出现这种情况,请在 Litematica 的 Hotkeys 配置中绑定一个用于 “Toggle Schematic Rendering” (enableSchematicRendering) 的热键,在粘贴大型蓝图前将其关闭,并在之后重新开启以恢复叠加层。

已知限制

  • 包含真正红石反馈回路(时钟、火把/中继器振荡器)的蓝图在粘贴后仍可能偶尔处于错误的相位。这是原版红石按顺序评估更新的固有属性,并非任何蓝图粘贴工具(WorldEdit、Litematica+Servux 或 Papermatica)能完全消除的问题,尽管有实现方案可以修复此问题。
  • ReplaceMode 和 Litematica 的粘贴图层范围限制已从客户端接收但尚未应用——目前每次粘贴都会放置完整的蓝图。
  • “缺失材料”对比叠加层(Litematica 查询现实世界中方块/实体 NBT 以突出差异)尚未实现——仅支持直接粘贴路径。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源