config-workshop

Config Workshop

Безопасный редактор конфигов для Minecraft с поиском, нативно работающий с Forge. Config Workshop превращает спецификации конфигов, зарегистрированные через Minecraft Forge, в понятные экраны редактирования прямо в игре. Просматривайте конфиги с одной панели, ищите по их настройкам, изучайте правила, объявленные каждым модом, и сохраняйте корректные изменения без ручного редактирования TOML-файлов.

Уведомление об альфе: этот релиз поддерживает загруженные файлы ForgeConfigSpec типов CLIENT и COMMON. Конфиги SERVER видны, но намеренно заблокированы до появления безопасной синхронизации с сервером, авторизованной оператором.

Возможности

• Единая панель конфигов с поиском для поддерживаемых установленных модов на Forge
• Автоматическая интеграция кнопки Config в экран Mods в Forge
• Уважение к кастомным экранам: если мод уже предоставляет свой экран конфига, Config Workshop оставляет управление ему
• Глубокий поиск по названию настройки, полному пути, комментарию, типу и текущему значению
• Полезные метаданные, включая значения по умолчанию, объявленные диапазоны, комментарии и требования перезапуска
• Строгая валидация по типу и правилам, объявленным владеющим модом
• Безопасное сохранение с резервной копией .configworkshop.bak рядом с файлом перед каждой записью
• Откат при ошибке, чтобы неудачное сохранение не оставляло значение в памяти изменённым незаметно
• Поддержка булевых значений, чисел, строк, перечислений и скалярных списков
• Без зависимостей от модов во время выполнения
• Без произвольного сканирования каталога конфигов

Зачем использовать Config Workshop?

Config Workshop намеренно сосредоточен на стандартной системе конфигов Forge. Модам не нужно переходить на заменяющую библиотеку конфигов, а редактор не угадывает содержимое неизвестных файлов. Он работает на основе метаданных зарегистрированных ForgeConfigSpec, поэтому типы, правила валидации, значения по умолчанию, комментарии и флаги перезапуска остаются видимыми и осмысленными. Такой подход делает работу предсказуемой:

• Некорректный ввод отклоняется до сохранения.
• Существующие кастомные экраны конфигов сохраняются.
• Неподдерживаемые кастомные реализации IConfigSpec аккуратно игнорируются.
• Резервные копии и ошибки сохранения остаются видимыми, а не скрываются.

Поддерживаемые версии

Minecraft	Forge	Java	Статус
26.2	65.1.0	25	Альфа
1.21.11	61.1.0	21	Альфа

Устанавливайте JAR, соответствующий вашей точной версии Minecraft. Не используйте файл для 26.2 на 1.21.11 и файл для 1.21.11 на 26.2.

Установка

1. Установите соответствующую версию Minecraft Forge.
2. Скачайте JAR Config Workshop для вашей версии Minecraft.
3. Поместите JAR в папку mods вашего инстанса.
4. Запустите Minecraft и откройте Mods → Config Workshop → Config. Дополнительная библиотека модов не требуется.

Использование на клиенте и сервере

Сейчас Config Workshop — клиентский мод. Выделенным серверам не нужно его устанавливать. Редактирование конфигов на удалённом сервере не входит в эту альфу, поэтому конфигурационные файлы, принадлежащие серверу, отображаются как заблокированные.

Текущие ограничения альфы

• Удалённое редактирование конфигов SERVER не реализовано.
• Кастомные спецификации конфигов, не использующие ForgeConfigSpec, не редактируются.
• Скалярные списки редактируются через строку с разделителями-запятыми.
• Интерфейс сейчас включает только английские переводы.
• Широкое тестирование совместимости в реальных условиях и GUI ещё продолжается. Пожалуйста, сообщайте об ошибках, указывая версию Minecraft, версию Forge, затронутый мод, шаги воспроизведения и соответствующий latest.log.

Лицензия и атрибуция

Config Workshop реализован независимо и выпущен под лицензией MIT. Его исходный код и визуальный стиль оригинальны. Проект создавался с опорой на публичное поведение и документацию Forge Config Screens, Configured и публичные API конфигурации Minecraft Forge. Никакие чужие арты, брендинг, ID модов или встроенные классы модов не включены. Config Workshop — неофициальный проект сообщества. Он не связан с Mojang, Microsoft, Minecraft Forge, Forge Config Screens, Configured, OneConfig, CurseForge или Modrinth и не одобрен ими.