SchemPaste

SchemPaste

一个帮助你在服务器中粘贴投影模组的模组

工具

SchemPaste

English | 简体中文

一个帮助你在服务器上粘贴 Litematica 投影的 Minecraft Fabric 模组。

依赖

Fabric Loader Fabric API Syncmatica

大型投影的优化

  • 在 RMS 服务器上使用 Intel i7-14600k CPU 测试后,粘贴一个包含 1000 万个方块、体积为 2 亿个方块的投影耗时 9 分 46 秒(平均每秒 2 万个方块),TPS 保持稳定且无下降。

注意:此性能数据仅代表该模组在 RMS 服务器上的性能,仅供参考。它不代表在你的服务器上的实际性能。

支持的版本

  • 1.17.1
  • 1.20.1

提示:如果你需要更多支持的版本,请在 Github 上提交 issue 或添加我的 QQ(2628883576(@qq.com,如果你需要通过邮件联系我),请说明来意)

命令详解

主命令

/sp paste - 粘贴命令

基本语法:

  • /sp paste stop - 停止所有活动的粘贴任务
  • /sp paste <index> - 按索引粘贴投影
  • /sp paste <index> addition <parameters> - 带附加参数粘贴投影

索引参数:

  • <index> - 整数,建筑索引从 1 开始,对应 placements.json 中的建筑

附加参数:

替换行为参数:

  • replace none - 不替换任何现有方块
  • replace all - 替换所有方块(包括空气)
  • replace with_non_air - 仅在非空气位置放置方块(默认行为)

层控制参数:

  • axis <x|y|z> - 设置层轴(默认 y 轴)
  • mode <mode> - 设置层模式:
    • all - 粘贴所有层(默认)
    • single 或 single_layer - 仅粘贴单层
    • all_above - 粘贴指定坐标以上的所有层
    • all_below - 粘贴指定坐标以下的所有层
    • range 或 layer_range - 粘贴指定范围内的层

层坐标参数:

  • single <coordinate> - 单层模式的坐标值
  • above <coordinate> - "以上"模式的起始坐标
  • below <coordinate> - "以下"模式的结束坐标
  • rangemin <coordinate> - 范围模式的最小坐标
  • rangemax <coordinate> - 范围模式的最大坐标

用法示例:

/sp paste 1                                           # 粘贴建筑 1
/sp paste 2 addition replace none                     # 粘贴建筑 2,不替换现有方块
/sp paste 3 addition rate 100                        # 粘贴建筑 3,每 tick 处理 100 个方块
/sp paste 4 addition replace all rate 50             # 粘贴建筑 4,替换所有方块,每 tick 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,
    // 每 tick 主线程预算时间(毫秒)
    "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
    // 最大加载区块数
}

安装

  1. 安装 Fabric Loader
  2. 下载模组 jar 文件
  3. 将文件放入 mods 文件夹

TODO

  • 移除对 Syncmatica 的依赖,允许从客户端直接加载 .litematica 文件

许可证

CC0-1.0