Creative Toolkit+

Creative Toolkit+

Лёгкая утилита для Fabric на Minecraft 26.1.x, которая превращает правый клик в тот самый инструмент зачарования, каким он всегда должен был быть, а сверху добавляет продуманный набор удобств для креатива — меню зачарований, настоящий менеджер путевых точек, команду /back с полной историей телепортаций, мелкие утилитарные команды, которые ты всё собираешься поставить (/heal, /feed, /enderchest, /day …), клиентские твики движения и экран настроек в игре с вкладками для всего этого.

Ощущение ваниллы. Безопасно для серверов. Ни один GUI не лезет под руку, пока сам не попросишь.

Сейчас это публичная бета (b2.6.3). Заменяет любую b2.x.x без правок. Баг-репорты приветствуются.

Кратко

• Правый клик или shift-клик любым предметом с книгой зачарований накладывает её чары — сохраняются имена, лор, прочность, кастомный NBT и данные модов.
• Два меню зачарований: одно валидное для выживания (/ec menu) и одно без ограничений только для операторов (/ec menu-op). В обоих есть живой поиск, кнопка Очистить всё в один клик, шесть видимых строк и метки на всю ширину для длинных названий чар.
• /ec sharpness 5 — /ec работает как сокращение для /enchant, с самонацеливанием, если цель не указана, плюс /ec clear для снятия чар с предмета.
• /creativetoolkitplus (алиас /ctp) — дерево команд всего мода с help, info, version, mode, config, reload, features, feature, report.
• Менеджер путевых точек — /waypoint открывает интерфейс в ванильном стиле: поиск, переключатель сортировки (8 порядков), сетка цветов, перетаскиваемый скроллбар, удаление с подтверждением в два шага, проверка имени на месте, информативные строки с расстоянием и возрастом и кнопка Переместить путевую точку на мою текущую позицию в один клик.
• /back [n] — телепорт обратно на прошлое место с полной историей, включая смерти, /tp, телепорты к путевым точкам и смены измерения.
• Утилитарные команды — /heal, /feed, /enderchest / /echest, /day, /night, /noon, /midnight.
• Сокращения для игровых режимов — `/gm , /gm , плюс фиксированные /survival, /creative, /spectator, /adventure(у каждой опциональные). Op-2, работают рядом с ванильным /gamemode`.
• Экран настроек в игре с вкладками и интеграцией с Mod Menu, индикатором несохранённых изменений, сбросом с подтверждением в два шага и проверкой на месте — шесть вкладок (General, Enchanting, Waypoint, Time, Player, Control) плюс Lists и About.
• Клиентские твики управления — автоспринт при движении вперёд, вторая клавиша спринта, вторая клавиша выброса (один предмет / весь стак), защита от случайного выброса.
• Назначаемые клавиши быстрых действий для каждой утилиты — heal, feed, /back, время суток, открыть эндер-сундук, открыть меню зачарований, открыть менеджер путевых точек.
• Переключатели для каждой функции, чтобы админы серверов могли аккуратно отключить любую часть. executionMode позволяет переключаться между client_only, server_only и both.

Что он делает

Наложение правым кликом

Находясь в креативе (или в выживании, если включишь), возьми книгу зачарований на курсор в любом инвентаре и правым кликом или shift-кликом по другому предмету перенеси чары книги на него.

• Существующие чары повышаются, если уровень в книге выше, остаются, если равны или выше, или добавляются, если их не было.
• В креативе книги по умолчанию не расходуются.
• Частицы и тихий звук стола зачарований при успехе; глухой стук при неудаче.
• Все твои кастомные имена, лор, прочность и модовый NBT сохраняются.
• Если курсор пуст, можно использовать книгу в руке — переключается через enableHandInteraction.

Меню зачарований

Положи любой зачаровываемый предмет в слот ввода; список справа покажет доступные чары с кнопками +1 / +10 / −1 / −10 / X в каждой строке.

• /ec menu — экран, допустимый в ванилле. Показывает только те зачарования, которые предмет мог бы честно получить в выживании, с их правильными максимальными уровнями. Конфликты учитываются.
• /ec menu-op — без ограничений. Показывает все зачарования из реестра. Добавляет ступени +100 / −100. Наложи Sharpness 255 на палку, уровень 32 767 Mending на удочку. Потолок настраивается.
• Строка живого поиска над списком. Фильтрует по отображаемому имени (sharp, Curse of Vanishing) или id в реестре (minecraft:sharpness, mod:custom_enchant). Поиск подстроки без учёта регистра.
• Кнопка Clear all рядом со слотом ввода — снимает все зачарования с предмета в слоте ввода одним пакетом, сохраняя имена, лор, прочность, кастомный NBT и данные модов.
• Просторная раскладка (280×280) с шестью видимыми строками, подписями на всю ширину (чтобы Curse of Vanishing не обрезалось), кнопками побольше в каждой строке и всплывающей подсказкой на строке под курсором.

Команда зачарования /ec

/ec — общий корень для зачарований. Только для op-2.

• **`/ec [level]`** — зачаровать предмет в руке. Цель не нужна.
• **`/ec [level]** — тот же синтаксис и правила, что у ванильного /enchant`.
• /ec clear — снять все зачарования с предмета в руке.
• **`/ec clear `** — снять все зачарования с предметов в основной руке у целей.
• /ec menu, /ec menu-op, /ec help — буквальные подкоманды.
• Старые алиасы: /ec-menu, /ec-menu-op и клиентский /ec-config (открывает экран конфига в игре даже на ванильном сервере).

Команды мода /ctp

Каноническое дерево команд для всего, что не является операцией с зачарованиями. Оба корня связаны через Brigadier redirect(), чтобы автодополнение и подсказки оставались синхронными.

• /ctp help — полная справка по моду, разбитая по функциям. Скрывает разделы, у которых выключен главный переключатель.
• /ctp version / /ctp info — быстрый штамп версии / многострочная информационная карточка.
• /ctp mode [client|server|both] — посмотреть (без аргумента) или задать и сохранить режим выполнения (op).
• /ctp config — открыть экран конфигурации в игре.
• /ctp reload — перезагрузить creativetoolkitplus.json с диска (op).
• /ctp features — список всех переключателей функций и их состояний.
• **`/ctp feature `** — показать подробности одной функции.
• **`/ctp feature <on|off|toggle>** — переключить и сохранить функцию (op). Принимает on/off/true/false/yes/no/1/0/enable/disable/enabled/disabled/toggle/flip`.
• /ctp report — готовый к копированию диагностический дамп в чат и в консоль сервера.

Путевые точки

Личные телепорт-закладки для каждого игрока с настоящим интерфейсом.

Экран управления (/waypoint или /waypoint menu):

• Строка поиска сверху фильтрует по имени, цвету или измерению.
• Переключатель сортировки рядом с полем поиска. Клик перебирает восемь порядков: Имя A→Z / Z→A, Ближайшие / Дальние (записи из других измерений всегда внизу), Новые / Старые, По измерению, По цвету.
• Информативные строки. По одной на путевую точку: образец цвета · имя · короткое название измерения · текущее расстояние · относительный возраст (just now, 5m ago, 3d ago, 8w ago, 1y ago). Кнопки в каждой строке: TP, Edit, Delete.
• Скроллбар с перетаскиванием. Клик + перетаскивание ползунка для непрерывной прокрутки, клик выше/ниже него для пролистывания страницы вверх/вниз. Колесо мыши по-прежнему листает по одной строке.
• Двухшаговое подтверждение удаления на кнопке Delete в строке — первый клик взводит её (надпись меняется на Confirm?), второй клик в течение 3 секунд действительно удаляет.
• Форма создания здесь внизу: поле имени (с встроенной проверкой плохих имён), переключатель цвета, кнопка Create here.

Режим редактирования (кнопка Edit в каждой строке):

• Поле имени с валидацией на лету — при недопустимом имени сообщение валидатора появляется красным прямо рядом с меткой Name.
• Сетка цветов 4×4 (16 стандартных цветов красителей) с кольцом-галочкой на выбранном образце.
• Кнопка Move waypoint to my current position — заменяет координаты / yaw / pitch / измерение точки на то, где вы стоите сейчас, сохраняя её имя, цвет и время создания.
• Строка с координатами (X / Y / Z / yaw + измерение + относительное время создания) на вдавленном фоне.
• Нижний ряд: Delete (тоже с подтверждением в два шага), Cancel, Save — Save сохраняет и переименование, и смену цвета одним кликом.

Команды в чате:

• **`/waypoint create [color]** — сохранить текущую позицию. Имена: буквы, цифры, _, -, .`; максимум 32 символа. 16 стандартных цветов.
• /waypoint list — список в чате с координатами + измерением.
• **`/waypoint tp ** / **/tp-to `** — телепорт (работает между измерениями).
• **`/waypoint delete **, **/waypoint rename **, **/waypoint setcolor `** — управление из чата.
• **`/waypoint setpos `** — аналог кнопки "Move here" из интерфейса для чата.
• Автодополнение по Tab работает для всех аргументов с именами и цветами (подсказывает только ваши собственные точки).
• Точки хранятся отдельно для каждого игрока в `/data/creativetoolkitplus/.json`.
• Лимит по умолчанию — 64 на игрока (настраивается; 0 = без ограничений).
• Всю подсистему можно отключить через enableWaypoints: false.

/back

• /back — телепорт на один шаг назад.
• **`/back ** — телепорт на n` шагов назад (до 64).
• Отслеживает любой телепорт, перемещающий вас больше чем на 32 блока за один тик: ванильный /tp, /waypoint tp, смену измерения, порталы, телепорты командных блоков.
• Смерть тоже отслеживается — /back после возрождения вернёт вас туда, где вы умерли, — идеально, чтобы забрать свой лут.
• История хранится в памяти (не сохраняется между перезапусками) и ограничена 64 записями.
• Отключается через enableBack: false.

Утилитарные команды

Все зависят от enableUtilityCommands.

• /enderchest / /echest — открыть свой эндерчест, как будто вы стоите перед ним. Блок не нужен.
• /heal [amount] — восстановить здоровье. Без аргумента — до максимума. /heal 6 добавляет 6 HP (3 сердца). /heal 50% добавляет половину вашего максимального HP.
• /feed [amount] — то же самое, но для голода. Насыщение тоже пополняется, чтобы шкала не начала сразу убывать обратно.
• /day, /night, /noon, /midnight — установить время мира на соответствующую отметку. Использует новую систему часов 26.1, так что хорошо работает с кастомными часами/таймлайнами.

Ярлыки игровых режимов

Все зависят от enableGameModeCommands (по умолчанию true). Ванильный /gamemode не заменяется — эти пять имён регистрируются рядом с ним.

• **`/gm ** — установить свой игровой режим. Режим задаётся свободно: полные названия (survival, creative, adventure, spectator), короткие формы (s, c, a, sp, а также sur, cre, adv, spec) и старые числовые id (0, 1, 2, 3`) — всё распознаётся без учёта регистра. Автодополнение по Tab предлагает четыре полных названия.
• **`/gm ** — установить игровой режим выбранным игрокам. Использует EntityArgument.players()`, так что подходят только игроки онлайн.
• **`/survival []`** — ярлык с фиксированным режимом. Без целей устанавливает выполняющему; с целями — выбранным игрокам.
• **`/creative []`** — то же самое, режим Creative.
• **`/spectator []`** — то же самое, режим Spectator.
• **`/adventure []`** — то же самое, режим Adventure.
• Все пять команд требуют op-2 (как ванильный /gamemode). Сторонние системы прав (LuckPerms и т. п.) работают прозрачно.
• Сообщения обратной связи различают случаи себя, одной цели и нескольких целей, а также показывают `/, когда часть игроков уже была в запрошенном режиме (в этом случае ванильный setGameModeвозвращаетfalse`).
• Отключается чисто через enableGameModeCommands: false (или /ctp feature gamemode off + перезапуск), если другой мод занял одно из этих пяти имён.

Экран настроек

Открыть его можно в любой момент командой /ctp config (в чате) или /ec-config (работает на ванильных серверах), либо назначить Open Creative Toolkit+ configuration на любую клавишу в Настройки → Управление. Пользователи Mod Menu получают кнопку в один клик прямо в списке модов.

Экран представляет собой панель с вкладками:

• General — режим выполнения (клиент / сервер / оба), включение клавиш быстрых действий, задержка клика, баннер integrated-vs-dedicated.
• Enchanting — сгруппировано в Apply behavior (creativeOnly, allowSurvival, allowUnsafe, ignoreMaxLevels, requireOp), Books / cursor (consumeBooks, взаимодействие с рукой, применение по горячей клавише) и Menus (vanillaMenuRequiresOp, звук применения, максимальный уровень в OP-меню), плюс клавиши зачарования.
• Waypoint — enableWaypoints, максимум путевых точек на игрока, клавиши путевых точек.
• Time — enableUtilityCommands (главный переключатель для /heal, /feed, /enderchest и т.д.), клавиши времени.
• Player — enableBack, размер истории /back, enableGameModeCommands, клавиши игрока.
• Control — автоспринт при движении вперёд, фиксация переключателя автоспринта, дополнительная клавиша спринта, дополнительная клавиша выброса, безопасный выброс, клавиши управления.
• Lists — счётчики только для чтения по четырём чёрным / белым спискам. Редактируются через JSON.
• About — версия, автор, определение Mod Menu, строка с подсказкой.

Нижний колонтитул:

• Save & Apply — записывает рабочую копию обратно в creativetoolkitplus.json. Показывает золотую звёздочку * в конце, когда есть несохранённые изменения.
• Reset to Defaults — подтверждение в два шага. Первый клик взводит, второй клик в течение 3 секунд выполняет сброс.
• Cancel — закрывает без сохранения.

Встроенная проверка для каждого целочисленного поля — значение вне диапазона или нечисловой ввод показывает красную метку рядом с полем, пока вы это не исправите.

Настройки управления

Опциональны, все по умолчанию выключены. Полезнее всего тем, кто устал удерживать спринт или хочет дополнительные клавиши-модификаторы:

• Auto-sprint while moving forward — удерживает спринт, пока вы идёте вперёд (и не приседаете / не используете предмет / не голодаете). Клавиша-переключатель может либо фиксировать спринт постоянно, либо работать как разовый запуск спринта.
• Secondary sprint key — назначить вторую клавишу (кнопку на большом пальце и т.п.) на ванильный спринт, не переназначая сам спринт.
• Secondary drop key — добавляет вторую клавишу выброса (один предмет) плюс независимую третью (весь стак).
• Safe drop — поглощает ванильные нажатия клавиши выброса, когда основная рука пуста, чтобы вы случайно не выбросили ничего, разбираясь с раскладкой инвентаря.

Клавиши быстрых действий

Назначьте любую из них в Настройки → Управление → Creative Toolkit+, и они выполнят соответствующее серверное действие одним нажатием:

• Open Creative Toolkit+ configuration — доступна всегда; единственная клавиша, не зависящая от главного переключателя быстрых действий.
• Open waypoint manager / Open enchant menu (vanilla-valid) / Open enchant menu (OP).
• Quick heal (full) / Quick feed (full) / Teleport back (1 step) / Open ender chest.
• Set time: Day / Night / Noon / Midnight.
• Apply book to hovered stack (устаревшее применение по горячей клавише, ограничено op через enableHotkeyApply).
• Все клавиши быстрых действий можно глобально отключить через enableQuickActions: false, не отвязывая их.

Зачем это нужно

• Создателям карт — быстро снаряжать экипировку точными наборами зачарований; отмечать каждую площадку постройки как путевую точку; возвращаться туда, где вы тестировали, через /back; переключать время суток одним нажатием.
• Администраторам серверов — выдавать себе имбалансную экипировку за секунды, затем /ctp reload, чтобы подправить конфиг без перезапуска; /heal, /feed, /enderchest всегда под рукой; /ctp report для готовой к вставке диагностики в баг-репортах.
• Строителям и тестировщикам — необычные комбинации зачарований, обмен кастомным NBT, телепорты между измерениями для тестирования кода биомов/структур, эндер-сундук, который можно открыть откуда угодно.
• Чистым креативщикам — потому что клик правой кнопкой с книгой должен был так работать всегда, а сохранение любимых мест должно быть встроенным.
• Всем, кто устал удерживать спринт — вкладка Control вам поможет.

Конфигурация

Файл лежит в config/creativetoolkitplus.json. Перезагрузить в игре можно командой /ctp reload, а открыть экран Configuration — командой /ctp config. Экран в игре — источник истины; JSON-файл — это сохранённая форма.

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

• Всё решает сервер. Каждое применение, каждая точка маршрута, каждое телепортирование проверяются на сервере.
• Работает на выделенных серверах, встроенных серверах и в одиночной игре.
• Модифицированные зачарования и модифицированные предметы поддерживаются через стандартный реестр.
• Пользовательский NBT, пользовательские имена, описание и прочность сохраняются.
• Совместим с другими модами на Fabric — мы не занимаем ни одной ванильной команды, которая не была свободна и раньше (/ec, /wp, /tp-to, /back, /waypoint, /heal, /feed, /enderchest, /echest, /day, /night, /noon, /midnight, /gm, /survival, /creative, /spectator, /adventure, /creativetoolkitplus, /ctp). Если на сервере другой мод регистрирует одну из них, выставь соответствующий переключатель enable… в конфиге на false. Ванильный /gamemode никогда не перекрывается.

Требования

• Minecraft 26.1.x (любой патч — 26.1.0, 26.1.1, 26.1.2, 26.1.3 …)
• Fabric Loader 0.19.0 или новее
• Fabric API
• Java 25 (Minecraft 26.1 и так её требует)

Опционально

• Mod Menu — добавляет кнопку в один клик в списке модов, чтобы открыть экран настроек. Не обязателен; команда /ctp config и назначаемая клавиша открывают тот же экран.

Установка

1. Установи Fabric Loader 0.19+ для любого релиза Minecraft 26.1.x.
2. Положи Fabric API в mods/.
3. Положи creativetoolkitplus-b2.6.3.jar в mods/.
4. Запускай.

При первом запуске создаётся config/creativetoolkitplus.json, который можно править вручную.

Лицензия

MIT.

FAQ

Не будет ли мой хоткей на хотбаре перехватывать клик по наведённому слоту? Перехватываются только right-click (кнопка 1, взять) и shift-click (быстрое перемещение), и только когда на курсоре зачарованная книга (или в руке, если включён enableHandInteraction). Обычный левый клик и ctrl-drag никогда не запускают применение, а shift-click без книги в зоне действия делает обычное ванильное перемещение.

Как хранятся точки маршрута? По одному JSON-файлу на игрока в папке `data/creativetoolkitplus/.json` твоего мира, записывается при каждом изменении точки маршрута. Можно спокойно бэкапить; можно спокойно переносить между мирами.

Почему /back считает мой полёт на Elytra с ракетой телепортом? Не должен — порог 32 блока за тик, а даже максимально разогнанная ракетой Elytra выдаёт около 3.4 блока/тик. Если ты умудряешься его превысить через какой-то другой мод на движение, поставь backHistorySize: 0, чтобы отключить, или enableBack: false для всей функции.

Можно ли переименовать или перекрасить точку маршрута из интерфейса? Да — нажми Edit в строке, чтобы открыть режим редактирования, где можно переименовать (с проверкой прямо на месте), выбрать цвет из сетки 4×4 и нажать Move waypoint to my current position, чтобы обновить координаты. По завершении сохрани.

Работает ли это в выживании? Применение по правому клику по умолчанию только для креатива. Поставь allowSurvival: true (и по желанию consumeBooks: true), чтобы использовать это в выживании. Два меню зачарований — игровые инструменты, им всё равно на твой режим игры. Точки маршрута, /back и утилитарные команды ограничены правами оператора там, где это уместно.

Не сломает ли сохранение уровень зачарования выше 32 767? Скорее всего нет — уровни зачарований хранятся как int — но ванильный код отрисовки и пара модовых хуков рассчитывают на значения размером short. По этой причине мы по умолчанию ограничиваем на 32 767. Переопределяй opMenuMaxLevel на свой страх и риск.

Можно ли использовать это на сервере? Да. Поставь его на сервер; игрокам не обязательно иметь его на клиенте для применения по правому клику (оно серверное) или для чат-команд, но он нужен им на клиенте, чтобы отрисовывать меню зачарований, интерфейс управления точками маршрута, экран настроек в игре и использовать клавиши.

Можно ли отключить то, что мне не нужно? Да. Экран настроек даёт главный переключатель для каждой подсистемы (enableWaypoints, enableBack, enableUtilityCommands, enableGameModeCommands, enableQuickActions, enableHandInteraction, enableHotkeyApply), а /ctp feature позволяет переключать их из чата. Главные переключатели для функций, регистрирующих команды, вступают в силу при следующей перезагрузке мира / сервера; поведенческие переключатели срабатывают сразу.

Будет ли /gm, /survival и т.д. конфликтовать с ванильным /gamemode? Нет — ванильный `/gamemode [] остаётся полностью нетронутым. Пять новых коротких имён (gm, survival, creative, spectator, adventure) добавляются рядом с ним, а не поверх него. Если другой мод займёт одно из этих имён, установи enableGameModeCommands: false(или/ctp feature gamemode off` и перезапусти), чтобы вернуть его.

В чём разница между этой главной страницей и страницами для отдельных версий? Эта страница — всегда актуальное описание мода. Каждая выпущенная версия также получает свою страницу в `builds//MODRINTH.mdс описанием «что нового» для этой версии, плюсCHANGELOG.md` с диффом относительно предыдущей версии.