AI Maizell Crafting — Unity, Godot и Ren’Py | 8 редкостей

Maizell Crafting System — три движка, одна понятная механика

Бесплатный стартовый комплект исходников для Unity, Godot и Ren’Py. Внутри три отдельных ZIP: скачайте версию для своего движка. Это система улучшения редкости, демонстрация с луками, графика и подробные инструкции на русском и английском.

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

Все восемь ступеней

Серая → голубая → синяя → фиолетовая → золотая → красная → чёрная → чёрная с пульсирующим алым свечением. Последняя ступень не улучшается дальше. Иконки лука показывают редкость; боевая система и урон отдельно не реализованы.

Архив 1. Unity / C#

Maizell_Crafting_Unity_CSharp_v1_0.zip — исходники для интеграции в Unity 2022.3 LTS / Unity 6. Ядро CraftingService.cs независимо от UnityEngine: хранит кошелёк и стеки, проверяет каталог, рассчитывает расход, выполняет одиночный и пакетный крафт.

• UnityCatalogLoader.cs загружает JSON из Resources и преобразует снимки состояния через JsonUtility.
• CraftingDemo.cs — компонент с демонстрационным IMGUI-интерфейсом. Добавьте его на GameObject или создайте сцену через Tools → Maizell → Create Crafting Demo Scene, затем Play.
• CreateDemo.cs отвечает за меню редактора; CoreChecks.cs — за проверки.
• PNG не требуют SVG-плагина; в ArtSource лежат редактируемые SVG.
• 39 проверок C#-ядра скомпилированы и пройдены. Сам Unity Editor в среде подготовки не запускался: загрузку в редактор, UI и свою сборку разработчик проверяет после импорта.

Архив 2. Godot / GDScript

Maizell_Crafting_Godot_GDScript_v1_0.zip — проект, проверенный в Godot 4.5.1 stable. Откройте project.godot и нажмите F5. Дополнительный EditorPlugin не нужен.

• addons/maizell_crafting/crafting_service.gd — отдельный RefCounted-сервис ресурсов и рецептов.
• catalog.json — настройки предметов, редкостей и цен.
• demo/main.gd связывает поля и кнопки с сервисом; main.tscn — стартовая сцена.
• bow_card.gd показывает название, количество, окраску и пульсацию свечения.
• 43 проверки ядра и 8 проверок демо пройдены, интерфейс запущен и осмотрен.
• При экспорте включите *.json в фильтр не-ресурсных файлов, чтобы каталог попал в сборку.

Архив 3. Ren’Py / Python / RPY

Maizell_Crafting_RenPy_Python_v1_0.zip — проект, проверенный в Ren’Py 8.4.1. Для существующей новеллы копируйте только maizell_crafting.rpy и папку maizell_crafting в game. Экран открывается командой call screen maizell_crafting.

• core.py — функциональное Python-ядро: возвращает новое состояние, не меняя старые словари.
• maizell_crafting.rpy — загрузка каталога, функции связи с Ren’Py, default-переменные прогресса, экран и ATL-свечение.
• mc_state хранит сумку и монеты, mc_prices — индивидуальные цены, mc_feedback — сообщение.
• script.rpy и options.rpy относятся только к демо: не заменяйте ими start и настройки своей новеллы.
• 17 Python-тестов и SDK lint пройдены; экран запущен и осмотрен. Сохранение, загрузку и rollback в своей истории проверьте после интеграции.

Что настраивается без переписывания ядра

• money_cost — цена каждого перехода. Все цены по умолчанию 0: экономику определяете вы.
• input_count / output_count — сколько расходовать и сколько выдать.
• from / to — исходная и итоговая редкость; enabled — доступность рецепта.
• items — типы предметов; rarities — названия, цвета, цвет и сила свечения.
• Пакетный крафт — от 1 до 10 000 операций. Весь пакет проходит целиком или не списывает ничего.

Демо начинается со 128 серых луков и 1 000 тестовых монет. При исходном соотношении 2 → 1 этого хватает на один финальный лук за 127 крафтов. Кнопки выдачи ресурсов предназначены для демонстрации, перед выпуском игры уберите их.

Как правильно подключать к своей игре

Загрузить каталог → получить/восстановить реальные ресурсы → показать предварительный расчёт Quote/quote → по действию игрока выполнить Craft/craft → проверить ok → обновить интерфейс и сохранить состояние. Не списывайте валюту и не выдавайте предмет дополнительно вручную: это уже делает ядро.

У систем собственные кошелёк и сумка. При подключении готового инвентаря выберите единый источник состояния. В Unity/Godot на результат подписываются через события/сигналы; в Ren’Py новое состояние присваивается в default-переменную. Анимацию и звук запускайте только после успешного крафта.

Что можно добавить дальше

Мечи, броню, зелья и инструменты можно добавлять через новые типы и рецепты, адаптируя иконки и UI. Звуки, анимацию кузницы и достижения удобно подключать к успешному результату. Характеристики оружия лучше хранить отдельно по типу и редкости.

Возможные расширения, требующие разработки: уникальные экземпляры оружия с UID и прочностью, несколько валют, разные ингредиенты в одном рецепте, шанс провала, серверная экономика, скидки от навыков и автоматический крафт всей цепочки. Эти функции не заявляются как готовые.

Документация внутри каждого архива

README_RU.md — быстрый запуск и примеры API; README_EN.md — краткая английская инструкция; docs/COMPLETE_GUIDE_RU.md — подробная карта файлов и блоков кода, назначение методов, взаимодействие с экономикой, сохранения, типовые ошибки и план расширений; docs/VALIDATION.md — точный объём проверки.

Все три версии используют одинаковый каталог правил, но не общий исполняемый код. Формат прогресса Unity отличается от Godot/Ren’Py. Это исходный комплект для разработчиков, без готовых платформенных сборок, боевой системы, сетевой синхронизации или античита.