MagicalChalk

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

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

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

1. 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

---