MagicalChalk

Minecraft 1.21.1 · NeoForge · Create, import, export and place structures · Magic Chalk Studio (built-in builder) · API for other mods · EN / FR

Author: MickDev

---

Summary

Create, import and place Minecraft structures with magical chalk. Export .chalk, JSON and datapack .nbt, Litematica/WorldEdit conversion, graphical import manager, build studio with WorldEdit-like tools, biome/structure API for other mods. NeoForge 1.21.1.

---

Overview

MagicalChalk is a server + client mod for NeoForge 1.21.1 that lets you:

• Select an in-game area with structure chalk (2 clicks)
• Save structures to server world storage
• Place blueprints with Magical Chalk (right-click, replaces obstacles)
• Import / export .chalk, .json and .nbt files
• Convert WorldEdit schematics (.schem), Litematica (.litematic) and vanilla structures (.nbt)
• Build in an advanced creative mode with Magic Chalk Studio (/builder)
• Expose an API so other mods can register structures and bind them to existing biomes

The mod includes built-in showcase structures (hub, End fortress, etc.) and works on dedicated servers, LAN and single-player.

LuckPerms: compatible and optional (otherwise OP level 2 by default for most admin actions).

---

Compatibility

Item	Details
Minecraft	1.21.1
Loader	NeoForge (21.1.x)
Side	Server + client (import GUI, preview, studio)
LuckPerms	Optional — magicalchalk.* nodes
Third-party mod API	JSON in data/<modid>/magicalchalk/structures/ or Java

---

Quick start

1. Create a structure
   /chalk → click 2 corners → /chalk magic create my_tower

2. Place a structure
   /magicalchalk my_tower → magical chalk in hand → right-click to place the blueprint

3. Import a file
   Drop .chalk or .json in config/magicalchalk/structures/ → /chalk import (GUI) or /chalk import <name>

4. Builder mode
   /builder or /build → B keybind (configurable) → tools, blocks, undo/redo

---

Commands — /chalk

Requires OP 2 or magicalchalk.admin / magicalchalk.use permission (see permissions).

Command	Description
/chalk	Gives Structure Chalk and starts a selection (2 clicks)
/chalk magic create <name>	Saves the selection as a structure (magicalchalk.create)
/chalk cancel	Cancels the current selection
/chalk remove <name>	Removes the structure from server world storage
/chalk remove <name> <true|false>	Removes + optional deletion of exported files
/chalk export <name>	Exports .chalk → config/magicalchalk/structures/
/chalk legacyexport <name>	Exports legacy JSON → config/magicalchalk/structures/
/chalk exportmcstructure <name>	Exports vanilla .nbt → config/magicalchalk/mcstructures/ (datapacks / biomes)
/chalk import	Opens the graphical manager (list, search, info panel, Import button)
/chalk import <name>	Direct import from .chalk or .json
/chalk rename <old> <new>	Renames a structure (world + exported files)
/chalk convert <file>	Converts an external file into a MagicalChalk structure
/chalk convert <file> <name>	Same with a custom structure name
/chalk reload	Reloads config, datapacks and API registrations

Formats supported by /chalk convert

Extension	Source
.litematic	Litematica / Forgematica
.schem	WorldEdit / Sponge schematic
.nbt	Vanilla Minecraft structure template

Search paths: absolute/relative path, config/magicalchalk/structures/, schematics/ folder at game root.

---

Commands — /magicalchalk

Permission: magicalchalk.place (or OP 2 / admin).

Command	Description
/magicalchalk	Lists all loaded structures
/magicalchalk <name>	Equips Magical Chalk with the chosen structure
/magicalchalk info <name>	Shows metadata (size, blocks, megabuild, etc.)

Structure IDs: use a namespace to avoid conflicts — e.g. mymod:my_tower (no namespace → magicalchalk:my_tower).

---

Commands — Builder (Magic Chalk Studio)

Permission: magicalchalk.builder (or OP 2 / admin).

Command	Description
/builder	Opens the studio and enables builder mode
/build	Alias for /builder

---

Magic Chalk Studio — tools & shortcuts

Available tools

Single place · 3×3 brush · Line · Filled / hollow rectangle · Filled / hollow circle · Filled / hollow ellipse · Filled / hollow sphere · Pyramid · Selection · Paste · Erase

Placement modes

Normal · Bottom-up · Extend

Keybinds (configurable)

Key	Action
B	Open / toggle Magic Chalk Studio
H	Show / hide studio menu
R	Pick a tool
N	Pick a block (with search bar)
G	Activate tool / place
V / U	Layer up / Layer down
Z / Y	Undo / Redo

The HUD shows the active tool, selected block and current Y layer.

---

Import manager (/chalk import)

Litematica-style interface:

• Search bar (filter by name, file, ID)
• Scrollable list of .json and .chalk files
• Info panel: name, ID, format, date, dimensions, volume, blocks, file size
• Import button to load the selected structure

Scanned folder: config/magicalchalk/structures/

---

Folders & file formats

Path	Contents
config/magicalchalk/structures/	.chalk (recommended) and .json (legacy) files
config/magicalchalk/mcstructures/	.nbt exports for datapacks / structure generation
data/<modid>/magicalchalk/structures/	Structures bundled in a mod (loaded on startup)

Formats

• .chalk — native MagicalChalk binary format (recommended, compact)
• .json — legacy text format / tool-compatible
• .nbt — vanilla Minecraft structure template (/chalk exportmcstructure)

---

Mod items

Item	Usage
Structure Chalk	Select an area (2 clicks) before /chalk magic create
Magical Chalk	Place a structure blueprint in-game (right-click)

---

LuckPerms permissions

Without LuckPerms, admin commands require OP level 2 by default.

Permission	Access
magicalchalk.admin	Full admin access (equivalent to OP 2)
magicalchalk.use	Admin alias / general usage
magicalchalk.select	/chalk — selection
magicalchalk.create	/chalk magic create, /chalk remove, /chalk rename
magicalchalk.place	/magicalchalk — list and equip
magicalchalk.import	/chalk export, legacyexport, exportmcstructure, import
magicalchalk.convert	/chalk convert
magicalchalk.builder	/builder, /build, Magic Chalk Studio

LuckPerms example (YAML)

magicalchalk.admin:
  description: MagicalChalk admin
  default: op

magicalchalk.builder:
  description: Magic Chalk Studio
  default: false

magicalchalk.place:
  description: Place structures
  default: op

---

API for mod developers

MagicalChalk exposes a public API to register structures and bind them to existing biomes (vanilla, Terralith, BOP, etc.) without creating biomes.

Simple method (no Java code)

Place a JSON in your mod:

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

Then in-game: /magicalchalk <modid:my_structure>

Java method

Event RegisterMagicalChalkStructuresEvent — classes in com.mickdev.magicalchalk.api.

Full documentation (EN / FR): magicalchalk-api-en.txt and magicalchalk-api-fr.txt in the repo.

---

Languages

UI translated in English (en_us) and French (fr_fr).

---

What the mod actually does

• In-game cuboid selection + client preview
• Persistent structure storage (server SavedData)
• Blueprint placement with block replacement
• Megabuild / large structures supported
• Multi-format export (chalk, JSON, NBT datapack)
• Conversion from Litematica, WorldEdit and vanilla NBT
• Graphical import manager
• Built-in creative build studio (tools, clipboard, undo/redo, layers)
• Moddable API for structures + biome bindings
• Showcase structures included in the mod

---

Dependencies

• NeoForge 21.1.x (Minecraft 1.21.1)
• LuckPerms: optional

---