Cubatar
Буду благодарен если поставите звёзды на репозиторий,
заранее спасибо :3
заранее спасибо :3
Мощный и быстрый сервис генерации аватаров Minecraft.
ПримерПример (запасной сервер) |
Документация |
English
Cubatar предоставляет простой, но мощный API для получения и рендеринга слоистых 3D-аватаров игроков Minecraft. Сервис обрабатывает различные варианты ввода, включая никнеймы, UUID и URL-адреса скинов в Base64, обеспечивая высококачественный рендеринг с поддержкой внешних слоев.
🌟 Возможности
- Послойный рендеринг — корректное отображение второго слоя (шапки, аксессуары и т.д.)
- Гибкий ввод:
- Никнеймы Minecraft
- UUID
- URL скина в Base64
- Интеграция с Mojang — загрузка скинов через API сессий Mojang
- Высокая производительность:
- Умное кэширование (Caffeine)
- Асинхронная обработка
- Современный стек — Java 21 + Spring Boot
🎨 Галерея






🚀 Документация API
Получить аватар игрока
Код:
GET /v1/avatar/{input}Параметры:
- input — никнейм, UUID или Base64 URL скина
- size — размер изображения (по умолчанию 64)
Пример:
Код:
curl "http://localhost:8080/v1/avatar/Notch?size=128"🛠 Технический стек
- Java 21
- Spring Boot
- Gradle
- Caffeine
📦 Начало работы
Требования:
- JDK 21+
- Docker (опционально)
Локальный запуск:
Код:
git clone https://github.com/Tok1shu/Cubatar.git
cd Cubatar Код:
./gradlew bootRunЗапуск через Docker:
Код:
docker build -t cubatar . Код:
docker run -p 8080:8080 cubatarПриложение будет доступно на порту 8080.