Skip to content

fylhtq7779/HelperBotV2

Repository files navigation

BeamNG Skin Helper Bot

Telegram-бот для создания скинов BeamNG.drive

Telegram Bot BeamNG.drive Python Deploy

Отправь DDS-текстуру, выбери машину - получи готовый мод для установки в игру.


Что делает бот

Бот упрощает создание скинов для BeamNG.drive. Вместо того чтобы вручную собирать структуру мода (jbeam, materials.json, правильные пути), достаточно:

  1. Отправить DDS-файл текстуры (2048x2048)
  2. Ввести название скина
  3. Выбрать машину из списка

Бот автоматически создаст ZIP-архив с правильной структурой, готовый к установке в игру.

Поддерживаемые машины

40+ машин из стандартного набора BeamNG.drive: Autobello Piccolina, Bruckell Bastion, Gavril Barstow, Ibishu 200BX, Hirochi SBR4, Civetta Bolide и другие. Список обновляется автоматически при выходе новых версий игры.

Как устроено

Пользователь отправляет боту DDS-текстуру, вводит название и выбирает машину. Бот берёт шаблоны (jbeam, materials.json) для выбранной машины, подставляет имя скина и путь к текстуре, собирает всё в ZIP-архив с правильной структурой папок и отправляет обратно. Полученный архив можно сразу закинуть в папку модов BeamNG.drive.

Автообновление шаблонов

Шаблоны скинов берутся из мода Skin Helper. GitHub Actions ежедневно проверяет обновления мода и автоматически синхронизирует шаблоны - бот всегда совместим с последней версией игры.

Стек

  • Python 3.12 + python-telegram-bot
  • GitHub Actions - автодеплой при push, ежедневная проверка обновлений шаблонов
  • systemd - управление процессом на сервере

Благодарности

Этот проект основан на моде Skin Helper для BeamNG.drive.

Огромная благодарность автору мода Beamer XD за создание Skin Helper и шаблонов для всех машин, а также @Top Tier Studios за поддержку и развитие мода. Без их работы этот бот не имел бы смысла.

Лицензия

MIT


English version

What the bot does

The bot simplifies skin creation for BeamNG.drive. Instead of manually assembling the mod structure (jbeam, materials.json, correct paths), you just:

  1. Send a DDS texture file (2048x2048)
  2. Enter a skin name
  3. Pick a vehicle from the list

The bot generates a ZIP archive with the correct structure, ready to install in the game.

Supported vehicles

40+ vehicles from the standard BeamNG.drive lineup: Autobello Piccolina, Bruckell Bastion, Gavril Barstow, Ibishu 200BX, Hirochi SBR4, Civetta Bolide, and more. The list updates automatically when new game versions are released.

Auto-updating templates

Skin templates come from the Skin Helper mod. GitHub Actions checks for mod updates daily and syncs templates automatically, so the bot always stays compatible with the latest game version.

Tech stack

  • Python 3.12 + python-telegram-bot
  • GitHub Actions - auto-deploy on push, daily template update checks
  • systemd - process management on the server

Acknowledgements

This project is built on top of the Skin Helper mod for BeamNG.drive.

Huge thanks to Beamer XD for creating Skin Helper and all the vehicle templates, and to @Top Tier Studios for maintaining and developing the mod. This bot wouldn't exist without their work.

License

MIT

About

Telegram bot for creating BeamNG.drive skins. Powered by Skin Helper mod by Beamer XD & @top Tier Studios

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages