SchemFlow

插件

· 作者 c4g7

为 Paper 和 Purpur 网络提供基于 S3/MinIO 的蓝图管理器。在服务器间共享蓝图,并根据需求即时生成包含完整生物群系、光照和展示实体模型的迷你游戏地图。

0 本站下载 0 关注 更新于 1 个月前

最新 0.5.17 · 26.3 · Paper / Purpur

一键开服(送7天)

? SchemFlow

SchemFlow Logo

⚡ 支持本地存储的云原生结构图管理器,具备闪电般的 Tab 补全速度和按需世界生成 API

专为多服务器网络打造——适用于建筑服、创造服和迷你游戏服

? 下载 • ? Wiki • ? Issues • ? Discord


? 为什么选择 SchemFlow?

别再手动在服务器之间复制 .schem 文件了。SchemFlow 将每个结构图存储在兼容 S3 的对象存储中(AWS S3、MinIO、Cloudflare R2、Wasabi、DigitalOcean Spaces…),并按需向任何服务器提供服务,支持分组、回收站与恢复、撤销/重做以及智能缓存的 Tab 补全。其 开发者 API 允许其他插件即时生成每轮地图:在主线程之外粘贴,完全照明,并保留生物群系和显示实体模型。完全兼容原生的 WorldEdit / FastAsyncWorldEdit 格式。

⚡ v0.5.17 新增功能

  • ? 26.x 版本再次回复命令:由于过时的聊天库,/schemflow 的回复(帮助、列表、错误、确认)在 Minecraft 26.x 中被静默丢弃。现在它们通过 Paper 内置的消息系统发送。

⚡ v0.5.16 新增功能

  • ? 显示实体模型得以保留:由骑乘在根实体上的块/物品/文本显示构建的模型(如灯具、家具、装饰)在粘贴后不再消失。现有的结构图会按原样还原,无需重新导出。
  • ? 生物群系随地图迁移:地图导出时会存储生物群系,粘贴时会将它们写回,从而使草地、植被、水面和天空颜色及积雪与原图保持一致。重新导出旧地图即可获取其生物群系数据。

⚡ v0.5.15 新增功能

  • ? 亮化的回合地图:生成的地图不再昏暗。provisionRoundWorld 仅在地图被照亮后才完成,因此随后卸载或复制的世界会保持其光照状态。

⚡ v0.5.14 新增功能

  • ? 无卡顿的回合地图生成:在 FastAsyncWorldEdit 支持下,粘贴操作在主线程之外运行。大型地图的主线程冻结时间从约 2.9 秒缩短至约 110 毫秒。
  • ?️ 无头地图捕获:/schemflow savemap 和 saveRegionAsMap(...) 可将任何世界的区域保存到 S3,无需在游戏内进行选择。

✨ 功能展示

? 混合式结构图管理

  • 云存储:使用 S3/MinIO 实现跨服务器同步
  • 本地支持:通过 local:name 实现离线访问
  • 智能缓存:瞬间响应的缓存 Tab 补全
  • 安全更新:带有确认机制的专用更新命令
  • 分组管理:通过 group:name 组织结构图

? 高级 WorldEdit 支持

  • 完全兼容 FastAsyncWorldEdit
  • 支持带 -e 参数的实体处理,包括显示实体模型
  • 支持带 -a 参数的空气方块控制
  • 存储和还原生物群系(-b,默认开启)
  • 通过服务器光照引擎进行亮化粘贴

? 自动化与开发者 API

  • 按需世界生成 API(支持反射,零编译期依赖)
  • 绝对原点粘贴以保留有效的作者坐标
  • 带有自定义语法的 Skript 集成
  • 回收站与恢复 + 撤销/重做
  • 分组生命周期管理(创建/删除/重命名)

? 云存储集成

  • MinIO 自建部署
  • AWS S3 企业级服务
  • 兼容提供商:Cloudflare R2、DO Spaces、Wasabi 等
  • 临时缓存配合自动清理

? 适用场景

? 建筑服 ? 创造服网络 ? 迷你游戏服 ? 生存服
模板管理 地块结构图存储 每轮地图加载 结构备份
建筑保存 玩家作品提交 竞技场分发 城镇规划
协作工具 竞赛存档 快速部署与拆除 修复工具

? 要求

  • Minecraft: 1.21 – 1.21.11 和 26.1 – 26.3 (Paper / Purpur)
  • Java: 21+
  • WorldEdit 7.2.18+ 或 FastAsyncWorldEdit(推荐:生成类粘贴操作在主线程之外运行;26.3 需要 FAWE 2.16.0+)
  • (可选) Skript 2.7+ 用于自动化

⚡ 快速开始

  1. 将 SchemFlow-x.y.z-all.jar 放入 plugins/ 目录并启动服务器一次。
  2. 编辑 plugins/SchemFlow/config.yml,配置你的 S3/MinIO endpoint、accessKey、secretKey 和 bucket。
  3. 运行 /schemflow reload。完成。

? 命令

命令 描述
/schemflow pos1 · pos2 设置选区角点
/schemflow upload <name> [-eab] [-group g] 导出选区 → S3
/schemflow update <name> --confirm 安全覆盖现有结构图
/schemflow paste [group:]name [-eab] · paste local:name 从 S3 或本地缓存粘贴
/schemflow fetch [group:]name 下载到本地缓存
/schemflow list · local 列出服务器/本地结构图
/schemflow delete [group:]name · restore name · trash clear --confirm 回收站与恢复
/schemflow undo · redo 撤销/重做上次粘贴或删除操作
/schemflow groups · group create/delete/rename 分组管理
/schemflow savemap <world> <x1 y1 z1> <x2 y2 z2> <group> <name> 将任意世界的区域保存为地图(无需选区)
/schemflow provision <world> · cache · reload 世界配置、缓存、热重载

权限粒度细(schemflow.<command>);schemflow.admin 授予所有权限。


? 开发者 API

其他插件可以按需驱动 SchemFlow:即时配置一个新世界,在精确的作者坐标处粘贴地图,并获得完成信号,无需编译时依赖。所有内容都基于 WorldProvisioner,并且可以从任何线程安全调用。

方法 返回值 用途
provisionRoundWorld(world, group, schematic, pasteAtOrigin, gamerules) CompletableFuture<World> 创建空世界,从 S3 获取并在主线程外粘贴,应用游戏规则。仅在地图已粘贴、模型已生成且已点亮后完成。幂等操作。
disposeWorld(world) CompletableFuture<Void> 卸载(不保存)+ 删除文件夹。
inspect(group, schematic) SchematicInfo 尺寸 + 作者定义的最小角点(用于固定点粘贴)。
saveSelectionAsMap(player, group, name) CompletableFuture<Void> 将 pos1/pos2 选区保存到 S3,保留绝对原点。
saveRegionAsMap(pos1, pos2, group, name) CompletableFuture<Void> 同上,无头模式:任意加载世界中的两个角点,无需玩家参与。
Object plugin = Class.forName("com.c4g7.schemflow.SchemFlowPlugin")
        .getMethod("getInstance").invoke(null);
Object prov = plugin.getClass().getMethod("getProvisioner").invoke(plugin);

CompletableFuture<?> future = (CompletableFuture<?>) prov.getClass()
        .getMethod("provisionRoundWorld", String.class, String.class, String.class, boolean.class, java.util.Map.class)
        .invoke(prov, "round_42", "blockparty", "W-BLOCKPARTY-regular-Island", true, null);

future.whenComplete((world, error) -> {
    if (error != null) return;          // 处理失败
    // (org.bukkit.World) world 已粘贴、点亮并填充:可安全传送玩家进入
});

按原点粘贴会在其作者定义的坐标处还原方块,要求通过 saveSelectionAsMap 或 saveRegionAsMap 保存的地图;来自 /schemflow upload 的结构图则是相对粘贴。方法签名是一个稳定的反射契约。


⚙️ 配置

endpoint: "minio.example.com:9000"   # 主机:端口,或完整 http(s):// URL
secure: true
accessKey: "YOUR_ACCESS_KEY"
secretKey: "YOUR_SECRET_KEY"
bucket: "schematics"
extension: "schem"                    # schem(推荐)或 schematic

storage:
  rootDir: "FlowStack/SchemFlow"      # 存储桶中的对象键前缀
  defaultGroup: "default"

downloadDir: "plugins/SchemFlow/schematics"
cacheRefreshSeconds: 30               # 0 禁用定期刷新

lighting:                             # 粘贴后重新照亮(Paper 1.21+)
  relightAfterPaste: true
  maxWaitSeconds: 60
  chunksPerTick: 32

maps:                                 # 地图导出和圆形粘贴
  copyBiomes: true
  restorePassengers: true             # 重建显示实体模型
  entitiesPerTick: 128

? SchemFlow v0.5.17 — 面向建造与游戏网络的按需世界配置

⭐ GitHub • ? 下载 • ? Discord

开源 • Apache-2.0 • 为 Minecraft 社区构建

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源