LitematicaFolia

v0.3.0+26.1.2 — Servux Direct Paste end-to-end

Added

• Real Litematica 0.27.6 clients can now Direct-Paste their schematics to the server with full block-state, tile-entity, entity and pending-tick fidelity — validated in production with 869,514 blocks + 6,516 TEs in 5.6 s.
• Inline LitematicaPaste task handler (the maruohon Litematica payload schema, separate from the upstream Servux multi-frame Transmit protocol — both now handled).
• Servux BulkRequest fulfillment with per-player rate limiter.
• Easy Place V3 server-side scaffold (PacketEvents 2.7, gated off by default).
• Java protocol bot for autonomous validation (test-harness/protocol-bot/).
• Local Fabric client harness for visual smoke testing.

Fixed

• Brigadier StackOverflowError at command registration (recursive flag dedup via bitmask).
• /litematica paste parses off the command thread → no more Folia Watchdog ERRORs on big files.
• PackedLongArray switched to compact cross-word packing (the .litematic format).
• 7 Servux wire-format discrepancies vs upstream sakura-ryoko/servux 26.1.2-0.10.2.
• PacketSplitter cap raised 16 MiB → 128 MiB, configurable.
• Proactive S2C_METADATA push 3 s after PlayerJoin so Litematica clients enter Servux mode without user action.

Production gotchas documented (in README + TUTORIAL)

• Litematica client config: must set ENTITY_DATA_SYNC = true in Generic config — PASTE_USING_SERVUX = true alone is useless.
• Velocity 3.5: set [packet-limiter] decompressed-bytes-per-second = -1 (default 5 MiB/s kicks Direct Paste).
• Paper: add -Dpaper.playerconnection.keepalive=120 for clients running DataFixer on old .litematic files.

Performance

• 4,194,304 blocks + 629,533 tile entities in 9.5 s (stress fixture).
• 870 k blocks + 6.5 k tile entities in 5.6 s (real client Direct Paste).
• 62 JUnit tests + 3 smoke harnesses all green.