OtterLib

Простая библиотека для Minecraft, созданная в основном для упрощения разработки моих модов, но использовать её может любой!

Поддерживаемые загрузчики: Fabric, Spigot и Paper

Используйте в своих проектах! 👍️

Хотите использовать OtterLib в своём проекте? Добавьте её как зависимость в файл build.gradle:

repositories {
    maven {
        name "oth3rMavenSnapshots"
        url "https://maven.oth3r.one/snapshots"
    }
}

Подключение для каждого загрузчика, где ${project.otterlib_version} — текущая версия OtterLib для загрузчика (например, 0.2.0.0+1.21.6, 0.2.0.0+1.20-1.21.6)

// fabric
modImplementation "one.oth3r:otterlib:${project.otterlib_version}-fabric"
// spigot
implementation "one.oth3r:otterlib:${project.otterlib_version}-spigot"
// paper
implementation "one.oth3r:otterlib:${project.otterlib_version}-paper"

Загляните в maven-репозиторий, чтобы узнать больше подробностей о библиотеке, включая последние версии.

Возможности

💬 Простой конструктор чата

пример использования:

player.sendMessage(new CTxT("Hello").color(Color.BLUE).bold(true).strikethrough(true)
    .append(new CTxT("World!!!!!!!!!").rainbow(new Rainbow(true)).underline(true).italic(true)).b());

пример в игре:

📜 Собственный читатель языковых файлов

OtterLib предоставляет собственный читатель языковых файлов, который позволяет легко организовать серверную локализацию на всех поддерживаемых загрузчиках. Также поддерживается дополнительное расположение локалей для удобной замены игроками.

🗃️ Надёжное сохранение и загрузка файлов

Добавляет интерфейс, позволяющий легко создавать конфигурационные файлы с поддержкой сохранения, загрузки и простого обновления версий.

обновление старой записи из json до новой версии:

@Override
public void update(JsonElement jsonElement) {
    JsonObject file = jsonElement.getAsJsonObject();
    if (file.get("version").getAsDouble() == 1.0) {
        this.version = 1.1;
        this.test = file.get("test-bool").getAsBoolean();
    }
}

⚙️ Собственный экран конфигурации

OtterLib предлагает собственный экран конфигурации, который можно настроить для редактирования нескольких конфигурационных файлов, ссылок на соцсети или даже открытия разных экранов.

создание экрана:

client.setScreen(new ConfigScreen(client.currentScreen, Text.of("test"),
    new CustomImage(Identifier.of(FabricTest.MOD_ID, "textures/gui/banner.png"),240, 60),
    // the list of buttons to be displayed in the middle
    List.of(
            SimpleButton.Templates.fileEditor(new CTxT("Test File"), FabricTest.testFile, new CustomImage(Identifier.of(FabricTest.MOD_ID, "button/server_button"),246,26)).build(),
            SimpleButton.Templates.fileEditor(new CTxT("Test File No Image"), FabricTest.testFile).build(),
            SimpleButton.Templates.wiki(new CTxT("Help")).openLink("https://oth3r.one").size(30,30).build(),
            SimpleButton.Templates.wiki(new CTxT("Help")).openLink("https://oth3r.one").size(30,30).build(),
            SimpleButton.Templates.warning(new CTxT("Help")).openLink("https://oth3r.one").size(150,15).hideText(false).build()
    ),
    // the bottom buttons can be customized!
    List.of(
            new SimpleButton.Builder(new CTxT("Donate"))
                    .miniIcon(new CustomImage(Identifier.of(Assets.ID, "icon/donate"),15,15)).build(),
            SimpleButton.Templates.donate(new CTxT("Donate")).openLink(URI.create("https://ko-fi.com/oth3r")).build(),
            SimpleButton.Templates.done(new CTxT("Done")).build(),
            SimpleButton.Templates.wiki(new CTxT("Wiki")).openLink("https://oth3r.one").build()
    )));

*главный экран конфигурации в игре*:

![главный экран конфигурации](https://www.oth3r.one/assets/mods/otterlib/config_main_demo.png)

*редактор файлов в игре*: (редактор отдельных записей запланирован, это просто простой заполнитель)

![экран конфигурации файла](https://www.oth3r.one/assets/mods/otterlib/config_file_demo.png)