魔法粉笔

魔法粉笔

结构生成器，构建结构及更多

MagicalChalk

Minecraft 1.21.1 · NeoForge · 创建、导入、导出和放置结构 · 魔法粉笔工作室（内置建造器）· 适用于其他模组的 API · 英文 / 法语

作者： MickDev

摘要

使用魔法粉笔创建、导入和放置 Minecraft 结构。支持导出 .chalk、JSON 和数据包 .nbt 文件，支持 Litematica/WorldEdit 转换，图形化导入管理器，带有类似 WorldEdit 工具的工作室，为其他模组提供生物群系/结构 API。支持 NeoForge 1.21.1。

概述

MagicalChalk 是一款适用于 NeoForge 1.21.1 的服务器 + 客户端模组，可让你：

  • 选择 使用结构粉笔选择游戏内区域（点击 2 次）
  • 保存 将结构保存到服务器世界存储中
  • 放置 使用魔法粉笔放置蓝图（右键点击，可替换障碍物）
  • 导入 / 导出 .chalk、.json 和 .nbt 文件
  • 转换 WorldEdit 原理图（.schem）、Litematica（.litematic）和原版结构（.nbt）
  • 建造 使用魔法粉笔工作室（/builder）在高级创造模式中建造
  • 提供 API 使其他模组能够注册结构并将它们绑定到现有生物群系

该模组包含内置展示结构（中心枢纽、末地堡垒等），并可在专用服务器、局域网和单人游戏中使用。

LuckPerms：兼容且可选（否则默认大多数管理操作需要 OP 等级 2）。

兼容性

项目 详情
Minecraft 1.21.1
加载器 NeoForge（21.1.x）
端 服务器 + 客户端（导入 GUI、预览、工作室）
LuckPerms 可选 — magicalchalk.* 权限节点
第三方模组 API data/<modid>/magicalchalk/structures/ 中的 JSON 或 Java

快速开始

  1. 创建结构
    /chalk → 点击 2 个角落 → /chalk magic create my_tower

  2. 放置结构
    /magicalchalk my_tower → 手持魔法粉笔 → 右键点击放置蓝图

  3. 导入文件
    将 .chalk 或 .json 文件放入 config/magicalchalk/structures/ → /chalk import（GUI）或 /chalk import <名称>

  4. 建造模式
    /builder 或 /build → B 键（可配置）→ 工具、方块、撤销/重做

命令 — /chalk

需要 OP 等级 2 或 magicalchalk.admin / magicalchalk.use 权限（参见权限）。

命令 描述
/chalk 给予结构粉笔并开始选择（点击 2 次）
/chalk magic create <名称> 将选区保存为结构（magicalchalk.create）
/chalk cancel 取消当前选区
/chalk remove <名称> 从服务器世界存储中移除结构
/chalk remove <名称> <true|false> 移除 + 可选删除导出文件
/chalk export <名称> 导出 .chalk → config/magicalchalk/structures/
/chalk legacyexport <名称> 导出旧版 JSON → config/magicalchalk/structures/
/chalk exportmcstructure <名称> 导出原版 .nbt → config/magicalchalk/mcstructures/（数据包 / 生物群系）
/chalk import 打开图形化管理器（列表、搜索、信息面板、导入按钮）
/chalk import <名称> 从 .chalk 或 .json 直接导入
/chalk rename <旧名称> <新名称> 重命名结构（世界 + 导出文件）
/chalk convert <文件> 将外部文件转换为 MagicalChalk 结构
/chalk convert <文件> <名称> 同上，并指定自定义结构名称
/chalk reload 重新加载配置、数据包和 API 注册

/chalk convert 支持的格式

扩展名 来源
.litematic Litematica / Forgematica
.schem WorldEdit / Sponge 原理图
.nbt 原版 Minecraft 结构模板

搜索路径：绝对/相对路径、config/magicalchalk/structures/、游戏根目录的 schematics/ 文件夹。

命令 — /magicalchalk

权限：magicalchalk.place（或 OP 等级 2 / 管理员）。

命令 描述
/magicalchalk 列出所有已加载的结构
/magicalchalk <名称> 为所选结构装备魔法粉笔
/magicalchalk info <名称> 显示元数据（尺寸、方块、大规模建造等）

结构 ID： 使用命名空间以避免冲突 — 例如 mymod:my_tower（无命名空间 → magicalchalk:my_tower）。

命令 — 建造者（魔法粉笔工作室）

权限：magicalchalk.builder（或 OP 等级 2 / 管理员）。

命令 描述
/builder 打开工作室并启用建造模式
/build /builder 的别名

魔法粉笔工作室 — 工具与快捷键

可用工具

单点放置 · 3×3 笔刷 · 线段 · 实心/空心矩形 · 实心/空心圆形 · 实心/空心椭圆 · 实心/空心球体 · 金字塔 · 选区 · 粘贴 · 橡皮擦

放置模式

普通 · 自下而上 · 扩展

按键绑定（可配置）

按键 操作
B 打开 / 切换魔法粉笔工作室
H 显示 / 隐藏工作室菜单
R 选择工具
N 选择方块（带搜索栏）
G 激活工具 / 放置
V / U 图层上移 / 图层下移
Z / Y 撤销 / 重做

HUD 显示当前工具、所选方块和当前 Y 图层。

导入管理器（/chalk import）

类似 Litematica 风格的界面：

  • 搜索栏（按名称、文件、ID 过滤）
  • 可滚动列表，包含 .json 和 .chalk 文件
  • 信息面板：名称、ID、格式、日期、尺寸、体积、方块、文件大小
  • 导入按钮，用于加载所选结构

扫描文件夹：config/magicalchalk/structures/

文件夹与文件格式

路径 内容
config/magicalchalk/structures/ .chalk（推荐）和 .json（旧版）文件
config/magicalchalk/mcstructures/ .nbt 导出，用于数据包 / 结构生成
data/<modid>/magicalchalk/structures/ 模组附带的结构（启动时加载）

格式

  • .chalk — MagicalChalk 原生二进制格式（推荐，紧凑）
  • .json — 旧版文本格式 / 工具兼容
  • .nbt — 原版 Minecraft 结构模板（/chalk exportmcstructure）

模组物品

物品 用途
结构粉笔 在 /chalk magic create 前选择一个区域（点击 2 次）
魔法粉笔 在游戏内放置结构蓝图（右键点击）

LuckPerms 权限

如果没有 LuckPerms，管理员命令默认需要 OP 等级 2。

权限 访问权限
magicalchalk.admin 完全管理员访问权限（等同于 OP 等级 2）
magicalchalk.use 管理员别名 / 常规使用
magicalchalk.select /chalk — 选择
magicalchalk.create /chalk magic create、/chalk remove、/chalk rename
magicalchalk.place /magicalchalk — 列表和装备
magicalchalk.import /chalk export、legacyexport、exportmcstructure、import
magicalchalk.convert /chalk convert
magicalchalk.builder /builder、/build、魔法粉笔工作室

LuckPerms 示例（YAML）

magicalchalk.admin:
  description: MagicalChalk 管理员
  default: op

magicalchalk.builder:
  description: 魔法粉笔工作室
  default: false

magicalchalk.place:
  description: 放置结构
  default: op

模组开发者 API

MagicalChalk 提供公开 API，用于注册结构并将它们绑定到现有生物群系（原版、Terralith、BOP 等）而无需创建新生物群系。

简单方法（无需 Java 代码）

在模组中放置一个 JSON 文件：

src/main/resources/data/<modid>/magicalchalk/structures/my_structure.json

然后在游戏内：/magicalchalk <modid:my_structure>

Java 方法

事件 RegisterMagicalChalkStructuresEvent — 类位于 com.mickdev.magicalchalk.api。

完整文档（英文 / 法语）：仓库中的 magicalchalk-api-en.txt 和 magicalchalk-api-fr.txt。

语言

界面已翻译为英语（en_us）和法语（fr_fr）。

模组功能总览

  • 游戏内长方体选区 + 客户端预览
  • 持久化结构存储（服务器 SavedData）
  • 蓝图放置支持方块替换
  • 支持大规模建造 / 大型结构
  • 多格式导出（chalk、JSON、NBT 数据包）
  • 支持 Litematica、WorldEdit 和原版 NBT 转换
  • 图形化导入管理器
  • 内置创意建造工作室（工具、剪贴板、撤销/重做、图层）
  • 可模组化的结构 + 生物群系绑定 API
  • 模组内置展示结构

依赖

  • NeoForge 21.1.x（Minecraft 1.21.1）
  • LuckPerms：可选