SchemPaste

English | 简体中文

A Minecraft Fabric mod that helps you paste Litematica schematics on servers.

Dependencies

Optimization for large schematics

• After testing in RMS Server with Intel i5-14600k CPU, pasting a schematic with 10 million blocks and a volume of 200 million blocks took 9 minutes and 46 seconds (averaging 20,000 blocks per second), with TPS remaining stable and no drops.

Note

This performance data only represents the mod's performance on the RMS Server and is for reference purposes only. It does not indicate the actual performance on your server.

Supported Versions

• 1.17.1
• 1.20.1

Tip

If you need more supported versions, please raise an issue on Github or add my QQ (2628883576 (@qq.com, if you need to contact me via email), please indicate the purpose)

Command Details

Main Commands

/sp paste - Paste Command

Basic syntax:

• /sp paste stop - Stop all active paste tasks
• /sp paste <index> - Paste schematic by index
• /sp paste <index> addition <parameters> - Paste schematic with additional parameters

Index Parameter:

• <index> - Integer, building index starting from 1, corresponding to buildings in placements.json

Additional Parameters:

Replace Behavior Parameters:

• replace none - Don't replace any existing blocks
• replace all - Replace all blocks (including air)
• replace with_non_air - Only place blocks at non-air positions (default behavior)

Layer Control Parameters:

• axis <x|y|z> - Set layer axis (default y-axis)
• mode <mode> - Set layer mode:
  • all - Paste all layers (default)
  • single or single_layer - Paste only a single layer
  • all_above - Paste all layers above specified coordinate
  • all_below - Paste all layers below specified coordinate
  • range or layer_range - Paste layers within specified range

Layer Coordinate Parameters:

• single <coordinate> - Coordinate value for single layer mode
• above <coordinate> - Starting coordinate for "above" mode
• below <coordinate> - Ending coordinate for "below" mode
• rangemin <coordinate> - Minimum coordinate for range mode
• rangemax <coordinate> - Maximum coordinate for range mode

Usage Examples:

/sp paste 1                                           # Paste building 1
/sp paste 2 addition replace none                     # Paste building 2, don't replace existing blocks
/sp paste 3 addition rate 100                        # Paste building 3, process 100 blocks per tick
/sp paste 4 addition replace all rate 50             # Paste building 4, replace all blocks, 50 blocks per tick
/sp paste 5 addition axis y mode single single 64    # Paste building 5, only paste Y=64 layer
/sp paste 6 addition mode all_above above 100        # Paste building 6, only paste Ye100 parts
/sp paste 7 addition mode range rangemin 60 rangemax 80  # Paste building 7, only paste Y=60-80 range
/sp paste 8 addition axis x mode single single 150 replace none  # Paste building 8, X=150 slice, no replace
/sp paste stop                                        # Stop all paste tasks

/sp list - List Command

• Display list of all available projections

Permission Requirements

All commands require OP permissions

Configuration Files

Main Configuration File (config/schempaste.json)

Performance Related Configuration:

{
    "backgroundThreads": 2,
    // Number of background processing threads
    "mainThreadBudgetMs": 40,
    // Main thread budget time per tick (milliseconds)
    "enableProgressMessages": true,
    // Enable progress messages
    "progressUpdateIntervalMs": 2000
    // Progress update interval (milliseconds)
}

Default Behavior Configuration:

{
    "defaultReplace": "with_non_air",
    // Default replace behavior
    "suppressNeighborUpdates": true,
    // Suppress neighbor block updates
    "fixChestMirror": true,
    // Fix chest mirror issues
    "clearInventories": false
    // Clear container items
}

Layer Control Configuration:

{
    "defaultLayerAxis": "y",
    // Layer axis (x/y/z)
    "defaultLayerMode": "all",
    // Layer mode
    "defaultLayerSingle": 0,
    // Single layer coordinate
    "defaultLayerRangeMin": 0,
    // Range mode minimum coordinate
    "defaultLayerRangeMax": 0
    // Range mode maximum coordinate
}

Chunk Management Configuration:

{
    "enableDynamicChunkLoading": true,
    // Enable dynamic chunk loading
    "maxLoadedChunks": 32
    // Maximum loaded chunks
}

Installation

1. Install Fabric Loader
2. Download the mod jar file
3. Place the file in the mods folder

TODO

• Remove dependency on Syncmatica, allow direct loading of .litematica files from client

License

CC0-1.0