🚜 FS25 Claude Skill — AI-ассистент для разработки модов

«Первый полноценный Claude Skill, созданный специально для разработки модов Farming Simulator 25.»
Прокачайте рабочий процесс моддинга FS25 с помощью AI, который действительно знает API, паттерны и подводные камни.

🎩 Познакомьтесь с экспертами

Используя этот скилл, вы работаете не с обычным AI, а со специализированной командой:

Claude (Senior Software Engineer): 🎩 Отвечает за технические требования, песочницу Lua 5.1 и высокопроизводительные паттерны. Гарантирует, что ваш код не обрушит Giants Engine.
Samantha (Project Manager): 🚀 Следит за ходом проекта мода, управляет структурой репозитория и соблюдением лучших стандартов сообщества.

📖 Что это такое?

Это Claude Skill — модульный самодостаточный пакет знаний, превращающий Claude в эксперта по разработке FS25. Заменяет «галлюцинации AI» проверенными на практике фактами.

База знаний в цифрах

Ресурс	Содержимое	Охват
LUADOC	1 661 страница документации	11 102+ функций — загружается в реальном времени через WebFetch
Source	267 Lua-файлов Giants	Внутренняя реализация движка — загружается через WebFetch
Паттерны	30+ проверенных шаблонов	GUI, события, сохранение/загрузка, транспорт, HUD, определение полей
Ловушки	20+ критических «краш-трапов»	`os.time()`, `DialogElement`, `goto`, накопление хуков, `mouseEvent`

🎬 Быстрая демонстрация

Спросите Claude (или меня!) что угодно о моддинге FS25:

🎩 «Claude, мне нужно безопасное для мультиплеера событие, синхронизирующее переменную damageLevel.»
🚀 «Samantha, какова правильная структура директорий для мода специализации транспортного средства?»
🚜 «Как создать кастомный диалог Да/Нет, который корректно работает в FS25?»
🌾 «На каком поле сейчас стоит игрок и как надёжно это определить?»

🔧 Технические требования («Истина в последней инстанции»)

Скилл обеспечивает строгое соблюдение особенностей среды FS25:

Песочница Lua 5.1: запрещены os.time(), goto, table.pack().
Начало координат снизу слева: координаты GUI (0,0) находятся в нижнем левом углу, а не в верхнем левом.
Безопасность менеджеров: всегда проверяйте g_financeManager, g_server и g_client на nil.
Базовые классы: используйте MessageDialog, а НЕ DialogElement (вызывает краш с белым прямоугольником).
Очистка хуков: всегда восстанавливайте хуки appendedFunction при выгрузке мода — они накапливаются при перезагрузке сохранения.

📦 Установка и настройка

1. Скачайте

Загрузите последний файл .skill со страницы Releases.

2. Расположение

Поместите файл fs25-modding-skill.skill в папку скиллов Claude:

Windows: %APPDATA%\Claude\skills\
Mac/Linux: ~/.claude/skills/
На уровне проекта: положите в корень проекта мода

3. Активация

Перезапустите сессию Claude. Скилл активируется автоматически при упоминании «FS25», «Farming Simulator», вставке Lua-кода мода или обращении к API Giants Engine.

📚 Подробнее об источниках знаний

Скилл опирается на труды самых активных участников сообщества:

1. FS25 Community LUADOC

Предоставлено @umbraprior. Полное покрытие API от движка до скриптов.

1 661 страница · 11 102+ задокументированных функций
Как работает: скилл индексирует все пути локально; Claude использует WebFetch для получения полной документации по запросу — локальная установка не требуется.
Репозиторий: umbraprior/FS25-Community-LUADOC

2. FS25 Lua Scripting (архив исходников)

Предоставлено @Dukefarming. Реальный исходный код Giants (dataS) для справки.

267 Lua-файлов — понять, как Giants реализует вещи внутри
Как работает: та же схема WebFetch по запросу, что и для LUADOC.
Репозиторий: Dukefarming/FS25-lua-scripting

3. FS25 AI Coding Reference (паттерны)

Предоставлено @XelaNull (FS25_UsedPlus). Проверенные паттерны, валидированные на продакшн-моде из 83 файлов с 30+ кастомными диалогами.

Встроено непосредственно в скилл — работает офлайн, загрузка не нужна.
Репозиторий: XelaNull/FS25_UsedPlus/FS25_AI_Coding_Reference

🗺️ Дорожная карта и сообщество

Мы строим это вместе. Присоединяйтесь!

v1.0.0 — Первый релиз с полной трёхсторонней интеграцией знаний
v1.1.0 — Живые запросы через WebFetch (LUADOC + исходники, локальные файлы не нужны), паттерн определения полей, 3 новые ловушки, корректные атрибуции
v1.2.0 — Помощники валидации схемы modDesc.xml
v1.3.0 — Индексация топ-20 модов сообщества как источников паттернов
v2.0.0 — Специализированные суб-скиллы (например, «Эксперт по GUI», «Архитектор транспорта»)

Участие в разработке

Нашли новую ловушку? Знаете паттерн лучше нашего? 🎩 Claude и 🚀 Samantha рады pull request'ам! Смотрите CONTRIBUTING.md.

📄 Лицензия

Licensed under MIT. Встроенная документация сообщества сохраняет оригинальные лицензии соответствующих авторов. Подробности — в LICENSE.

Сделано с 🚜 для сообщества моддеров FS25

Senior Engineer: Claude · Project Manager: Samantha

fs25-claude-skill

Установка

README