MagicalChalk

MagicalChalk

Minecraft 1.21.1 · NeoForge · Создание, импорт, экспорт и размещение структур · Magic Chalk Studio (встроенный строитель) · API для других модов · EN / FR Автор: 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)
• Строить в продвинутом креативном режиме с Magic Chalk Studio (/builder)
• Предоставлять API, чтобы другие моды могли регистрировать структуры и привязывать их к существующим биомам Мод включает встроенные демонстрационные структуры (хаб, крепость Края и т. д.) и работает на выделенных серверах, в LAN и одиночной игре. LuckPerms: совместим и опционален (иначе по умолчанию уровень OP 2 для большинства административных действий).

Совместимость

Быстрый старт

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 convert

Пути поиска: абсолютный/относительный путь, config/magicalchalk/structures/, папка schematics/ в корне игры.

Команды — /magicalchalk

Разрешение: magicalchalk.place (или OP 2 / admin).

ID структур: используйте пространство имён во избежание конфликтов — например, mymod:my_tower (без пространства имён → magicalchalk:my_tower).

Команды — Builder (Magic Chalk Studio)

Разрешение: magicalchalk.builder (или OP 2 / admin).

Magic Chalk Studio — инструменты и горячие клавиши

Доступные инструменты

Одиночная установка · кисть 3×3 · линия · заполненный / полый прямоугольник · заполненный / полый круг · заполненный / полый эллипс · заполненная / полая сфера · пирамида · выделение · вставка · стирание

Режимы размещения

Обычный · снизу вверх · расширение

Горячие клавиши (настраиваются)

HUD показывает активный инструмент, выбранный блок и текущий слой Y.

Менеджер импорта (/chalk import)

Интерфейс в стиле Litematica:

• Строка поиска (фильтр по имени, файлу, ID)
• Прокручиваемый список файлов .json и .chalk
• Панель информации: имя, ID, формат, дата, размеры, объём, блоки, размер файла
• Кнопка Import для загрузки выбранной структуры Сканируемая папка: config/magicalchalk/structures/

Папки и форматы файлов

Форматы

• .chalk — нативный бинарный формат MagicalChalk (рекомендуется, компактный)

• .json — устаревший текстовый формат / совместим с инструментами
• .nbt — ванильный шаблон структуры Minecraft (/chalk exportmcstructure)

Предметы мода

Права LuckPerms

Без LuckPerms админ-команды по умолчанию требуют уровень OP 2.

Пример LuckPerms (YAML)

magicalchalk.admin:
  description: MagicalChalk admin
  default: op

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

magicalchalk.place:
  description: Place structures
  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. Полная документация (EN / FR): 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: опционально