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

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

Formats supported by /chalk convert

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

Commands — /magicalchalk

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

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

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)

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

Formats

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

Mod items

LuckPerms permissions

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

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