schematics-api — Platform-Neutral Sponge (.schem) & Litematica (.litematic) Decoder and Planner¶
Zero-platform-dependency Java 17 library for decoding Sponge Schematic v2/v3 (.schem, .schematic) and Litematica (.litematic) files, caching decoded structures in memory, and planning 3D world block placements (BlockDelta, BlockPlacement) and container block-entity restorations (PlacedBlockEntity).
Key Capabilities¶
SpongeSchematicDecoder: Dependency-free GZIP-NBT decoder supporting Sponge v2/v3 (varint-packedBlockData/Blocks.Data,Palette,BlockEntities,Offset) and Litematica.litematic(Regions, negative regionSizeaxes,BlockStatePaletteproperty maps, cross-long bit-packedBlockStateslong[], andTileEntities).SchematicPlacementPlanner: Anchor-aware (BOTTOM_CENTER,SURFACE_CENTER,CENTER,ORIGIN) coordinate planner producingList<BlockPlacement>,List<BlockDelta>, andList<PlacedBlockEntity>from explicit(x, y, z)coordinates or anySchematicCoordinateimplementation (such asRTPLocation).SchematicFileLoader: Thread-safe normalized-path schematic cache with off-tick decode andServerAccessorsfailure auditing (S-004,S-005).- Package compatibility: Preserves
io.github.dailystruggle.rtp.api.schematicandio.github.dailystruggle.rtp.api.platform.BlockDeltapackage coordinates soLeafRTP,LeafSleuth, and third-party consumers share identical binary types.