Offline Player Cache

Что представляет собой этот мод?

Offline Player Cache (OPC) представляет собой API-мод для Minecraft, созданный на основе фреймворка Fabric. Его основная задача — обеспечить возможность кэширования данных игроков на сервере в то время, когда они находятся в офлайн-режиме. Это открывает доступ другим модам к информации об отсутствующих игроках. Изначально разработка велась для создания глобальных и постоянных таблиц лидеров на серверах Minecraft, которые включали бы как активных, так и неактивных участников.

Основные возможности

Моды могут регистрировать функции, которые принимают данные игрока и возвращают определенные значения или объекты. Эти данные ограничены только тем, что указано в ключе для чтения/записи NBT-данных. Когда игрок отключается от сервера, все зарегистрированные функции запускаются, и соответствующие данные сохраняются в кэше до момента отключения. Эта информация записывается в данные уровня сервера и может быть доступна в любое время. При повторном подключении того же игрока его кэшированные данные удаляются, и при вызове функции значения возвращаются на основе текущего состояния онлайн-игрока.

Доступные команды

• /opc get uuid|name <uuid|name> <key> — возвращает значение для указанного UUID или имени игрока. Если игрок онлайн, показывает текущее значение; если офлайн — кэшированное; в остальных случаях возвращает null. Если значение является числом и команда выполняется из командного блока, выходной сигнал редстоуна равен абсолютному модулю 16.

• /opc remove uuid|name <uuid|name> <key> — если указанный игрок офлайн, удаляет его кэшированное значение по заданному ключу; если игрок онлайн, команда не выполняет действий.

• /opc remove uuid|name <uuid|name> — если указанный игрок офлайн, удаляет все его кэшированные данные; если игрок онлайн, команда не выполняет действий.

Важные особенности

Этот API-мод самостоятельно не регистрирует никаких кэшируемых значений, не сохраняет данные игроков и по умолчанию не выполняет никаких действий.

Для использования API в вашем моде добавьте следующие настройки в файл сборки Gradle:

repositories {
    maven {
        name = "Modrinth"
        url = "https://api.modrinth.com/maven"
        content {
            includeGroup "maven.modrinth"
        }
    }
}

dependencies {
    modImplementation "maven.modrinth:offline-player-cache:<version>"
    include "maven.modrinth:offline-player-cache:<version>"
}