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 自身对直接服务器端粘贴的要求一致。
安装
- 下载插件 jar 文件。
- 将 jar 文件放入服务器的
plugins/ 文件夹 然后重启服务器(或使用 /reload confirm,但对于涉及网络和 world 注册的插件,建议完全重启)。
- 检查控制台输出:
=================================
Papermatica
Litematica -> Paper Bridge
=================================
...
Servux bridge initialized (channel: servux:litematics)
Papermatica enabled.
- (可选)调整权限。 两个节点默认均为
op;如果你希望非 op 玩家也能进行粘贴,请通过你的权限插件明确授予它们权限:
papermatica.admin —— /papermatica 诊断命令。
papermatica.servux.paste —— 通过 Servux 粘贴蓝图。
核心粘贴功能不需要插件配置文件——只要插件启用且拥有相应权限的玩家连接了兼容的 Litematica,即可立即使用。
客户端设置(供玩家使用)
这部分容易被忽略——即使安装了 Papermatica,Litematica 默认也不会尝试检测 Servux 服务器:
- 确保你的 Litematica 具备 “Entity Data Sync” 选项(见上方要求——如果看不到该选项,请更新 Litematica)。
- 打开 Litematica 的配置 (
M → Configs → Generic) 并启用 “Entity Data Sync” (entityDataSync)。该选项默认为关闭;如果不启用,Litematica 永远不会发送握手信息来发现 Papermatica,粘贴操作会静默回退到有缺陷的 /setblock 命令路径。
- 确认 “Paste Using Servux” (
pasteUsingServux) 已启用——它默认为 开启,所以如果粘贴似乎仍未走直接路径,这只是一个 sanity check(常规检查)。
- 加入服务器,像往常一样加载蓝图放置,切换到创造模式,并使用正常的粘贴/执行操作快捷键进行粘贴。无需新的快捷键或额外模组。
大型蓝图与客户端 FPS
粘贴本身是在服务器端完成的,几乎瞬间完成,但 Litematica 仍然会在客户端渲染加载蓝图的完整幽灵/全息预览,无论粘贴速度多快,这在大型建筑中都会严重降低 FPS。如果出现这种情况,请在 Litematica 的 Hotkeys 配置中绑定一个用于 “Toggle Schematic Rendering” (enableSchematicRendering) 的热键,在粘贴大型蓝图前将其关闭,并在之后重新开启以恢复叠加层。
已知限制
- 包含真正红石反馈回路(时钟、火把/中继器振荡器)的蓝图在粘贴后仍可能偶尔处于错误的相位。这是原版红石按顺序评估更新的固有属性,并非任何蓝图粘贴工具(WorldEdit、Litematica+Servux 或 Papermatica)能完全消除的问题,尽管有实现方案可以修复此问题。
ReplaceMode 和 Litematica 的粘贴图层范围限制已从客户端接收但尚未应用——目前每次粘贴都会放置完整的蓝图。
- “缺失材料”对比叠加层(Litematica 查询现实世界中方块/实体 NBT 以突出差异)尚未实现——仅支持直接粘贴路径。
Papermatica
Litematica → Paper bridge with full NBT support.
Litematica's schematic paste tool normally can't carry block-entity data (chest, barrel,
and hopper contents) or entity data across to a Paper server — when a Servux server isn't
detected, Litematica falls back to spamming /setblock and /summon commands, neither of
which can carry NBT, and which can flood the command/packet limits on a large paste.
Papermatica fixes this by implementing the real Servux network protocol (servux:litematics)
server-side. Litematica already speaks this protocol natively — it just needs a server on the
other end. With Papermatica installed, pasting a schematic places every block directly
server-side, with its saved data restored exactly:
- Chests, barrels, hoppers, and other block entities paste with their full inventories intact.
- Entities (minecarts, item frames, armor stands, etc.) paste with their saved data and a
fresh identity, so re-pasting the same schematic never collides with earlier copies.
- No commands, no packet-limit kicks — every block is written directly to the world.
- Redstone comes out settled, not mid-toggle: placement happens with all side effects
suppressed, then a single clean update pass runs once the whole structure exists, followed by
a pass that restores every block to exactly what the schematic saved (catching anything a
block flipped while reacting to its now-real neighbors).
- No extra client-side mod required — players just need Litematica itself, no companion mod
and no special build; see requirements below.
Requirements
- Server: plain, official Paper for Minecraft 1.21.11 — no fork or custom build
needed, this is a normal plugin.
- Players who want to paste: a build of Litematica for 1.21.11 that has an "Entity Data
Sync" option in its config (
M → Configs → Generic). That option is the client half of
the Servux protocol Papermatica speaks. Litematica's Servux support started out in a
community fork (sakura-ryoko) rather than the original mod, but has since made it into the
commonly distributed builds — if your Litematica shows that option, you're already good; if
it doesn't, update Litematica.
- Players pasting must be op (or hold the
papermatica.servux.paste permission) and in
Creative mode, matching Litematica's own requirements for direct server-side pasting.
Installation
- Download the plugin jar.
- Drop the jar into your server's
plugins/ folder and restart (or /reload confirm,
though a full restart is recommended for a plugin doing network/world registration).
- Check the console for:
=================================
Papermatica
Litematica -> Paper Bridge
=================================
...
Servux bridge initialized (channel: servux:litematics)
Papermatica enabled.
- (Optional) Adjust permissions. Both nodes default to
op; grant them explicitly through
your permissions plugin if you want non-op players to paste:
papermatica.admin — the /papermatica diagnostics command.
papermatica.servux.paste — pasting schematics via Servux.
No plugin configuration file is needed for the core paste feature — it works as soon as the
plugin is enabled and a player with the right permission connects with a compatible Litematica.
Client setup (for players)
This is the part that's easy to miss — Litematica does not attempt to detect a Servux server
by default, even with Papermatica installed:
- Make sure your Litematica has the "Entity Data Sync" option at all (see Requirements above —
update Litematica if you don't see it).
- Open Litematica's config (
M → Configs → Generic) and enable "Entity Data Sync"
(entityDataSync). This is off by default; without it, Litematica never sends the handshake
that lets it discover Papermatica, and paste silently falls back to the broken /setblock
command path.
- Confirm "Paste Using Servux" (
pasteUsingServux) is enabled — it defaults to on, so
this is just a sanity check if pastes still don't seem to be using the direct path.
- Join the server, load a schematic placement as usual, switch to Creative, and paste with the
normal paste/execute-operation keybind. No new keybind or extra mod is needed.
Large schematics and client FPS
Pasting itself is server-side and effectively instant, but Litematica still renders a full
ghost/hologram preview of a loaded schematic client-side, which can tank FPS on huge builds
regardless of how fast the paste is. If that happens, bind a hotkey for "Toggle Schematic
Rendering" (enableSchematicRendering) in Litematica's Hotkeys config, turn it off right
before pasting a large schematic, and turn it back on afterward if you want the overlay back.
Known limitations
- A schematic containing a genuine redstone feedback loop (a clock, a torch/repeater oscillator)
can still occasionally come out of paste in the wrong phase. This is an inherent property of
how vanilla redstone evaluates updates in order, not something any schematic-paste tool
(WorldEdit, Litematica+Servux, or Papermatica) can fully guarantee away tho there is a implementation to fix that issue.
ReplaceMode and Litematica's paste layer-range restriction are accepted from the client but
not yet applied — every paste currently places the full schematic.
- The "missing materials" comparison overlay (Litematica querying real in-world block/entity NBT
to highlight differences) is not implemented — only the direct-paste path is.
评论 0
登录后参与评分
还没有评论,来抢沙发吧