SchemPaste
English | 简体中文
一个 Minecraft Fabric 模组,帮助你在服务器上粘贴 Litematica 蓝图。
依赖项
大型蓝图的优化
- 在 RMS Server(搭载 Intel i7-14600k CPU)上测试,粘贴包含 1000 万个方块、总体积达 2 亿个方块的蓝图耗时 9 分 46 秒(平均每秒处理 20,000 个方块),TPS 保持稳定且无掉帧。
注意:此性能数据仅代表该模组在 RMS Server 上的表现,仅供参考,不代表你服务器上的实际性能。
支持版本
提示:如果你需要更多支持版本,请在 GitHub 上提交问题或添加我的 QQ(2628883576(@qq.com,如需通过邮件联系我,请说明目的))。
命令详情
主要命令
/sp paste - 粘贴命令
基本语法:
/sp paste stop - 停止所有正在进行的粘贴任务
/sp paste <index> - 通过索引粘贴结构图
/sp paste <index> addition <参数> - 使用附加参数粘贴结构图
索引参数:
<index> - 整数,建筑索引从 1 开始,对应 placements.json 中的建筑
附加参数:
替换行为参数:
replace none - 不替换任何现有方块
replace all - 替换所有方块(包括空气)
replace with_non_air - 仅在非空气位置放置方块(默认行为)
图层控制参数:
axis <x|y|z> - 设置层轴(默认 y 轴)
mode <模式> - 设置层模式:
all - 粘贴所有层(默认)
single 或 single_layer - 仅粘贴单个层
all_above - 粘贴指定坐标之上的所有层
all_below - 粘贴指定坐标之下的所有层
range 或 layer_range - 粘贴指定范围内的层
层坐标参数:
single <坐标> - 单层模式下的坐标值
above <坐标> - “上方”模式的起始坐标
below <坐标> - “下方”模式的结束坐标
rangemin <坐标> - 范围模式的最小坐标
rangemax <坐标> - 范围模式的最大坐标
使用示例:
/sp paste 1 # 粘贴建筑 1
/sp paste 2 addition replace none # 粘贴建筑 2,不替换现有方块
/sp paste 3 addition rate 100 # 粘贴建筑 3,每刻处理 100 个方块
/sp paste 4 addition replace all rate 50 # 粘贴建筑 4,替换所有方块,每刻 50 个方块
/sp paste 5 addition axis y mode single single 64 # 粘贴建筑 5,仅粘贴 Y=64 层
/sp paste 6 addition mode all_above above 100 # 粘贴建筑 6,仅粘贴 Y>100 的部分
/sp paste 7 addition mode range rangemin 60 rangemax 80 # 粘贴建筑 7,仅粘贴 Y=60-80 范围
/sp paste 8 addition axis x mode single single 150 replace none # 粘贴建筑 8,X=150 切片,不替换
/sp paste stop # 停止所有粘贴任务
/sp list - 列表命令
权限要求
所有命令都需要 OP 权限
配置文件
主配置文件 (config/schempaste.json)
性能相关配置:
{
"backgroundThreads": 2,
// 后台处理线程数
"mainThreadBudgetMs": 40,
// 主线程每刻预算时间(毫秒)
"enableProgressMessages": true,
// 启用进度消息
"progressUpdateIntervalMs": 2000
// 进度更新间隔(毫秒)
}
默认行为配置:
{
"defaultReplace": "with_non_air",
// 默认替换行为
"suppressNeighborUpdates": true,
// 抑制相邻方块更新
"fixChestMirror": true,
// 修复箱子镜像问题
"clearInventories": false
// 清空容器物品
}
图层控制配置:
{
"defaultLayerAxis": "y",
// 图层轴(x/y/z)
"defaultLayerMode": "all",
// 图层模式
"defaultLayerSingle": 0,
// 单层层坐标
"defaultLayerRangeMin": 0,
// 范围模式最小坐标
"defaultLayerRangeMax": 0
// 范围模式最大坐标
}
区块管理配置:
{
"enableDynamicChunkLoading": true,
// 启用动态区块加载
"maxLoadedChunks": 32
// 最大加载区块数
}
安装
- 安装 Fabric 加载器
- 下载模组 JAR 文件
- 将文件放入
mods 文件夹
待办事项
- 移除对 Syncmatica 的依赖,允许直接从客户端加载
.litematica 文件
许可证
CC0-1.0
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 i7-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
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
- Install Fabric Loader
- Download the mod jar file
- Place the file in the
mods folder
TODO
- Remove dependency on Syncmatica, allow direct loading of .litematica files from client
License
CC0-1.0
评论 0
登录后参与评分
还没有评论,来抢沙发吧