Talecraft

Talecraft

将你的 Minecraft 建筑导入 Hytale！

实验性：此模组仍处于早期开发阶段。部分功能可能不完整或会在未来版本中更改。欢迎提供反馈和错误报告！

此模组是一个利用业余时间开发的热情项目。如果你想提供帮助，请考虑支持该项目。

Talecraft 是一个模组，允许你将 Minecraft 原理图直接导入你的 Hytale 世界。无论你是想将 Minecraft 中的大型建筑迁移过来，还是想使用网络上成千上万的原理图，Talecraft 都能轻松实现。

功能

• 支持 Minecraft 原理图：导入传统的 MCEdit .schematic 文件以及现代的 WorldEdit/Sponge .schem 文件
• 方块映射：自动将 Minecraft 方块转换为 Hytale 中的对应方块
• 方块属性：保留方块的朝向、旋转和状态（楼梯朝向、台阶类型、原木轴等）
• 下载原理图：无需离开游戏，直接从 URL 下载原理图
• 撤销系统：犯错了？撤销你的粘贴并恢复原始地形
• 支持大型建筑：高效处理包含数千个方块的原理图

安装

1. 从发布页面下载最新的 Talecraft-X.X.X.jar 文件
2. 将 JAR 文件放入你的 Hytale 服务器的 mods 文件夹中
3. 启动/重启你的服务器
4. 将原理图放入 plugins/Talecraft/schematics/ 文件夹中

命令

命令	描述	用法
/schematic list	列出原理图文件夹中所有可用的原理图	/schematic list
/schematic paste <filename>	在你当前位置粘贴一个原理图	/schematic paste castle.schem
/schematic download <url> [filename]	从 URL 下载一个原理图	/schematic download https://example.com/build.schem
/schematic undo	撤销你上次的原理图粘贴，恢复原始方块	/schematic undo

别名： 所有命令也可以使用 /schem（例如，/schem list，/schem paste）

命令详情

/schematic list

显示原理图文件夹中找到的所有原理图文件（.schematic 和 .schem）。使用此命令查看你有哪些可用的建筑。

/schematic paste

在当前位置粘贴指定的原理图。原理图的原点将放置在你的脚下。

示例：

/schematic paste medieval_house.schem

粘贴后，你将看到：

• 成功放置的方块数量
• 跳过的方块数量（未映射的 Minecraft 方块）
• 提醒你可以使用 /schem undo 进行回滚

/schematic download [filename]

从互联网下载一个原理图文件并将其保存到你的原理图文件夹中。

示例：

/schematic download https://example.com/castle.schem
/schematic download https://example.com/build.schem my_castle.schem

• 如果未提供文件名，则使用 URL 中的原始文件名
• 文件必须是有效的 .schematic 或 .schem 文件
• 在保存前会验证下载的文件

/schematic undo

将地形恢复到上次粘贴前的状态。每个玩家都有自己的撤销历史，支持多次撤销。

注意：

• 你必须在进行粘贴的同一世界内
• 撤销历史是按玩家和按会话记录的（服务器重启后清除）

支持的文件格式

格式	扩展名	描述
Sponge 原理图	.schem	WorldEdit、Litematica 等工具使用的现代格式。支持所有现代 Minecraft 方块。
传统原理图	.schematic	经典的 MCEdit 格式。仅限于前 1.13 版本的方块 ID（0-255）。

建议： 尽可能使用 .schem 文件，因为它们具有更好的方块支持并保留更多方块属性。

方块映射

Talecraft 会自动将 Minecraft 方块映射到 Hytale 中的对应方块。映射保留：

• 方块朝向：楼梯朝向、原木轴等
• 方块变种：羊毛颜色、木材类型、石材变种
• 方块状态：台阶位置（上/下）、活板门状态等

部分 Minecraft 特有的方块可能没有直接的 Hytale 对应方块，这些方块在粘贴过程中将被跳过。命令输出会显示哪些方块无法映射。

该模组仍处于非常早期的阶段，我正在努力在未来支持更多的方块和生物，敬请期待。如果你能提供资金帮助，欢迎支持该项目。

故障排除

"原理图未找到"

• 确保文件位于 plugins/Talecraft/schematics/ 中
• 检查文件名拼写（区分大小写）
• 使用 /schematic list 查看可用的文件

"没有可用的解析器"

• 文件可能已损坏或格式不受支持
• 尝试从 WorldEdit/Litematica 重新导出

许多方块被跳过

• 部分 Minecraft 方块尚没有 Hytale 对应方块
• 传统的 .schematic 文件支持的方块有限
• 尝试改用现代的 .schem 文件

支持

• Discord

---

Talecraft 与 Hypixel Studios 或 Mojang 无关联。Minecraft 是 Mojang Studios 的商标。