GlymeraSchematic

GlymeraSchematic - 将你的 Minecraft 建筑带入 Hytale

想念你的 Minecraft 家园吗？把它带到 Hytale 来吧！GlymeraSchematic 可以将 .schem、.litematic 和旧版 .schematic 文件直接导入你的 Hytale 世界 —— 包含 1595 种方块映射、正确的朝向、放置时零掉落，并且大型建筑可以流畅载入，不会冻结你的服务器。

---

什么是 GlymeraSchematic？

你花了数百小时在 Minecraft 中建造梦想中的城堡、村庄、大教堂或哥特式摩天大楼，而现在你正在迁移到 Hytale。GlymeraSchematic 可以加载任何 Minecraft 原理图文件，将每个方块转换为最接近的 Hytale 对应方块，并通过一条命令将整个结构放置到你的世界中 —— 无需手动逐方块复制，不会出现朝向错误，也不会生成充满随机石头的区块。

无论你是从 Planet Minecraft 下载的建筑、使用 Litematica 导出的自己的世界，还是从 FastAsyncWorldEdit 中提取的 .schem 文件，它都能正常工作。

---

工作原理

1. 将文件放入导入文件夹

将以下任意格式的文件放入 plugins/GlymeraSchematic/imports/：

• .schem (Sponge v1 / v2 / v3) — 现代 WorldEdit / FAWE 格式
• .litematic (Litematica mod 导出格式)
• .schematic (旧版 pre-1.13 格式 — 请参阅下方说明)

2. 站在你想要的位置

飞行或走到你希望结构左下角（北-西角）所在的位置。

3. 导入

/gsch import <文件名>

插件通过内置的映射表解析所有方块，分两次智能放置（先放置稳定方块，再放置火把、植物等易碎方块，确保没有任何掉落物），并确认放置的方块数量。

可选旋转：/gsch import <文件名> N|E|S|W 可将整个建筑旋转 0/90/180/270 度。

4. 改变主意了？

/gsch undo

逐方块将区域恢复到上次导入前的精确状态，旋转方向也正确还原。

---

功能特性

• 1595 种方块映射，涵盖几乎所有 Minecraft 1.21.6 方块 —— 石头、木材、金属、玻璃、羊毛/混凝土、植物、作物、树叶、楼梯、台阶、墙壁、栅栏、门、活板门、告示牌、旗帜、地毯、铜变种、幽匿块、蛙明灯、蘑菇、陶器、头颅等
• 正确的方块朝向 —— 楼梯指向正确方向，门在正确的合页侧开启，墙壁与相邻方块连接，活板门悬挂在正确的一侧，熔炉面朝前方，箱子面向玩家一侧
• 导入时零掉落 —— 两次放置先放下所有提供支撑的方块，然后再放置易碎方块（植物、火把、铁轨、按钮、压力板、告示牌、床等）。花朵不会掉落，火把不会弹出。
• 后续无挖掘卡顿 —— 每个导入的方块都被标记为“装饰”，并接受完整的方块更新处理，因此连接状态、光照和方块实体数据从一开始就完全初始化
• 树木腐烂免疫 —— 原木地板、木梁和艺术性原木雕塑即使远离自然树木也能保持稳定
• 建筑稳定性 —— 你挖掘方块时，相邻方块不会坍塌；装饰标记会保留在剩余的导入方块上
• 保持原理图完整性 —— 在 Minecraft 中对称的结构在 Hytale 中依然对称
• 未知方块变为空气，绝不会变成可见的石头占位符，因此你的草地保持草地的样子
• 导入时支持旋转 —— 选择建筑在世界中面向的方位
• 撤销 —— 任何导入后可通过基于快照的完整逐方块回滚
• 大型建筑流式导入 （3.0 新增） —— 大型导入按批次跨游戏刻放置，而非一次性巨型操作，因此服务器在教堂逐渐生成时保持响应。在 25/50/75% 时显示进度消息，/gsch cancel 可中止导入并完全回滚
• 可配置大小限制 （3.0 新增） —— 200 万单元格上限现在只是配置默认值；在 config.json 中提高 maxBlocks，即可导入数百万方块的城市
• 无需资源包 —— 所有内容都包含在单个 JAR 文件中

---

命令

所有命令均为 仅限 OP。前缀为 /gsch。

命令	描述
/gsch list	列出导入文件夹中当前的所有原理图文件
/gsch info <文件名>	显示原理图的尺寸、方块数和调色板大小
/gsch import <文件名> [N|E|S|W]	在当前位置导入，可指定旋转方向
/gsch undo	回滚最近一次导入
/gsch cancel	中止正在进行的流式导入并回滚所有已放置的方块
/gsch reload	编辑后重新读取映射文件和配置
/gsch read	检查你脚下/旁边的方块（ID、旋转、偏航/俯仰/翻滚）—— 方便调试映射
/gsch test	在你周围放置一个小型测试区域（开发者工具）
/gsch teststairs	沿四个方向放置八段直楼梯以验证旋转
/gsch calibrate	放置校准方块以验证 Hytale 的偏航约定

---

支持的格式

格式	文件扩展名	支持程度
Sponge Schematic v1 / v2 / v3	.schem	完整支持 —— 方块状态属性（朝向、半块、形状、连接等）被完整解析
Litematica	.litematic	完整支持 —— 与 Sponge 相同的内部格式，保真度相同
旧版 Minecraft Schematic（pre-1.13）	.schematic	支持方块类型，不支持朝向。 旧格式以数值方式存储数据值，没有方块状态字符串。楼梯、门、墙壁、活板门等将以默认朝向放置。对于对朝向敏感的建筑，请先使用转换器（WorldEdit、Litematica）升级为 .schem 或 .litematic 格式。

---

配置

方块映射 —— plugins/GlymeraSchematic/mapping.json（首次启动时创建）

这是完整的 Minecraft → Hytale 方块转换表，共 1595 条。编辑任意映射可重新指定特定方块（例如在服务器上将橡木木板更倾向于 Wood_Redwood_Planks 而不是 Wood_Goldenwood_Planks），然后执行 /gsch reload 即可无需重启生效。

表中未包含的方块会被放置为空气 —— 这可以防止未知/模组方块产生随机石头伪影。

限制与流式导入 —— plugins/GlymeraSchematic/config.json（首次启动时创建）

设置项	默认值	含义
maxBlocks	2,000,000	硬性上限 —— 超过此单元格数（宽 × 高 × 长，包含空气）的导入将被拒绝。提高此值可导入大型建筑。
batchThreshold	100,000	超过此单元格数时，导入将以批次方式跨游戏刻进行，而非一次性应用。
batchSize	10,000	每个批次处理的单元格数。
batchIntervalMs	50	批次之间的毫秒数（50 = 一个服务器游戏刻）。

/gsch reload 可实时应用配置更改 —— 无需重启服务器。

提高 maxBlocks 时需要注意一点：撤销快照存在于内存中（每个已放置方块约 40 字节，因此导入 1000 万方块的建筑在下次导入或重启前将占用约 400 MB 内存）。请确保服务器有足够的内存来匹配你的雄心。

---

安装

1. 将 GlymeraSchematic-3.0.0.jar 放入服务器的 mods/ 文件夹。
2. 启动（或重启）服务器。
3. 将原理图文件放入 plugins/GlymeraSchematic/imports/。
4. 执行 /gsch import <文件名>。

无需外部资源包，无需修改清单文件，不锁定 Hytale 版本 —— 插件声明 ServerVersion: "*"，可与任何当前版本兼容。

---

温馨提示

• 插件针对每种方块类型使用特定家族的旋转校准（Hytale 中楼梯 / 活板门 / 门 / 箱子 / 墙壁 / 栅栏的渲染默认值略有不同 —— 插件会按家族应用正确的偏移量）
• 墙壁/栅栏/玻璃板会根据源原理图的连接属性（北/南/东/西 = 无/矮/高 或 真/假）重建其连接轴，因此 T 形接头和 L 形拐角都能正确呈现
• Hytale 没有内置的转角楼梯变体；Minecraft 的 shape=inner_left/outer_right 等会被渲染为直楼梯。视觉效果可接受，但会有差异
• Hytale 的原木没有 axis 属性，因此 Minecraft 的原木朝向（水平原木、立柱）会统一变为竖直方向。对于水平走向，请使用 Hytale 自带的横梁/装饰性木材变体
• 旗帜、蜡烛蛋糕、悬挂式告示牌和一些红石内部方块会被有意跳过（放置为空气），因为 Hytale 中没有合理的对应物

---

由 Glymera 为 Hytale 社区精心制作