
TaterLib
TaterLib - кроссплатформенная библиотека для разработки плагинов и модов Minecraft. Позволяет писать код, работающий на Bukkit, Fabric, Forge, Sponge и других API, с одним JAR-файлом для разных версий игры.
TaterLib
TaterLib - это библиотека, которая решает одну из главных головных болей разработчиков плагинов и модов для Майнкрафт. Вместо того чтобы писать один и тот же код под Bukkit, Fabric, Forge, Sponge и Velocity отдельно, ты просто используешь TaterLib и получаешь готовую абстракцию. Один JAR-файл работает на куче разных версий Minecraft - от b1.7.3 до 1.20.4.
Зачем это нужно
Допустим, у тебя есть плагин, который ты хочешь портировать с Bukkit на Fabric или Forge. Обычно это означает переписывание всех ивентов, команд и взаимодействий с миром под каждую платформу. С TaterLib ты пишешь код один раз, используя общий API, и он работает везде. По факту, это экономит кучу времени.
Правда, стоит учитывать, что некоторые абстракции могут быть ещё не реализованы до конца. Если чего-то не хватает - можно открыть issue на GitHub или сразу запилить PR с реализацией. Авторы проекта открыты к контрибуциям.
Как использовать
Есть два пути:
- Подключить общий API и самому допиливать недостающие фичи под каждую платформу
- Если чего-то не хватает - создать PR с реализацией, чтобы улучшить TaterLib для всех
Подключение в Gradle
repositories {
maven {
name = 'NeuralNexus'
url = 'https://maven.neuralnexus.dev/releases'
}
}
dependencies {
compileOnly('dev.neuralnexus:taterlib-api:<version>')
}
Ещё есть репозиторий со снапшотами: https://maven.neuralnexus.dev/repository/snapshots
Совместимость
TaterLib поддерживает: Bukkit, BungeeCord, Fabric, Forge, Sponge и Velocity.
Важные моменты:
- На Fabric нет поддержки для 1.13
- Ниже 1.7.10 Fabric и Forge не работают
| Тип сервера | Версии | Имя JAR-файла |
|---|---|---|
| 1.20.x | 1.20-1.20.4 | TaterLib-1.20.x-<version>.jar |
| 1.19.4 | 1.19.4 | TaterLib-1.19.4-<version>.jar |
| 1.19.2 | 1.19.2 | TaterLib-1.19.2-<version>.jar |
| 1.19 | 1.19 | TaterLib-1.19-<version>.jar |
| 1.18.2 | 1.18.2 | TaterLib-1.18.2-<version>.jar |
| 1.18 | 1.18 | TaterLib-1.18-<version>.jar |
| 1.17 | 1.17-1.17.1 | TaterLib-1.17-<version>.jar |
| 1.16 | 1.16-1.16.5 | TaterLib-1.16-<version>.jar |
| 1.15 | 1.15-1.15.2 | TaterLib-1.15-<version>.jar |
| 1.14 | 1.14-1.14.3 | TaterLib-1.14-<version>.jar |
| 1.13 | 1.13-1.13.2 | TaterLib-1.13-<version>.jar |
| 1.12 | 1.12-1.12.2 | TaterLib-1.12-<version>.jar |
| 1.11 | 1.11-1.11.2 | TaterLib-1.11-<version>.jar |
| 1.10 | 1.10-1.10.2 | TaterLib-1.10-<version>.jar |
| 1.9 | 1.9-1.9.4 | TaterLib-1.9-<version>.jar |
| 1.8 | 1.8-1.8.8 | TaterLib-1.8-<version>.jar |
| 1.7 | 1.7-1.7.10 | TaterLib-1.7.10-<version>.jar |
| 1.6.4 | 1.6.4 | TaterLib-1.6.4-<version>.jar |
| 1.2.5 | 1.2.5 | TaterLib-1.2.5-<version>.jar |
| b1.7.3 | b1.7.3 | TaterLib-b1.7.3-<version>.jar |
Зависимости
Обязательные:
- Fabric API - нужен для Fabric
- Legacy Fabric API - для Fabric на версиях 1.12.2 и ниже
Опционально:
- LuckPerms - для поддержки прав, префиксов и суффиксов
Команды и права
| Команда | Право | Описание |
|---|---|---|
/taterlib version | taterlib.command.version | Показать версию TaterLib |
/taterlib reload | taterlib.command.reload | Перезагрузить конфиг TaterLib |
/taterlib dump | taterlib.command.dump | Вывести информацию о TaterLib |
/taterlib fulldump | taterlib.command.fulldump | Полный дамп информации о TaterLib |
Проекты на TaterLib
Некоторые плагины и моды, которые уже используют эту библиотеку:
- BadSpawns
- BeeNameGenerator
- TaterComms
- TaterUtils
Если хочешь добавить свой проект в список - просто открой PR.
Метрики
Поддерживаются Bukkit, BungeeCord, Sponge и Velocity.
Скачать TaterLib можно прямо здесь. Если ты разрабатываешь что-то для нескольких платформ - эта библиотека реально сэкономит тебе кучу времени.
