Conditional Barriers

ConditionalBarriers

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

По умолчанию блоки барьеров непроходимы для всех. Этот мод меняет это, позволяя тонко настраивать, кто может через них проходить, что идеально подходит для создателей карт, администраторов серверов и разработчиков.

Возможности

• Настраиваемые правила прохода: Определяйте, кто может проходить сквозь барьеры, используя различные критерии (игровой режим, уровень прав, имя игрока, UUID, теги таблицы очков).
• API для разработчиков: Легко регистрируйте собственные условия для управления доступностью барьеров из других модов.
• Внутриигровые команды: Управляйте состоянием мода и перезагружайте конфигурацию без перезапуска сервера.
• Больше никакого удушья: Автоматически предотвращает удушье игроков внутри барьеров, если им разрешено через них проходить.
• Высокая производительность: Реализовано с помощью оптимизированных миксинов для минимального влияния на производительность сервера.

Команды

Мод предоставляет следующие команды (требуется уровень прав 2 или выше):

• /conditionalbarriers on: Включает проверку правил.
• /conditionalbarriers off: Отключает логику мода (все барьеры становятся проходимыми для всех).
• /conditionalbarriers status: Показывает, активен ли мод в данный момент.
• /conditionalbarriers reload: Перезагружает конфигурацию с диска.
• /cb: Короткий псевдоним для /conditionalbarriers.

Конфигурация

Файл конфигурации находится по пути config/conditionalbarriers.json. Он позволяет задать список правил, которые проверяются по порядку.

Пример конфигурации

{
  "defaultPassable": false,
  "rules": [
    {
      "type": "SPECTATOR",
      "action": "ALLOW"
    },
    {
      "type": "CREATIVE",
      "action": "ALLOW"
    },
    {
      "type": "SCOREBOARD_TAG",
      "action": "ALLOW",
      "value": "can_pass_barriers"
    },
    {
      "type": "OPERATOR_LEVEL",
      "action": "ALLOW",
      "operatorLevel": 4
    }
  ]
}

Типы правил

• CREATIVE: Совпадает с игроками в режиме Creative.
• SPECTATOR: Совпадает с игроками в режиме Spectator.
• OPERATOR_LEVEL: Совпадает с игроками с определённым уровнем прав.
• PLAYER_NAME: Совпадает с определённым именем игрока (доступна опция учёта регистра).
• PLAYER_UUID: Совпадает с определённым UUID игрока.
• SCOREBOARD_TAG: Совпадает с игроками с определённым тегом таблицы очков.

Установка и требования

ConditionalBarriers требуется как на клиенте, так и на сервере для корректной работы. Это связано с тем, что физический движок клиента должен знать, когда блок барьера должен быть несплошным, чтобы обеспечить плавное передвижение.

1. Убедитесь, что у вас установлен Fabric Loader на обеих сторонах.
2. Поместите JAR-файл ConditionalBarriers в папку mods как на клиенте, так и на сервере.
3. (Необязательно) Установите Fabric API, если он ещё не установлен.

API для разработчиков

Если вы разработчик модов, вы можете использовать ConditionalBarriersApi для добавления собственной логики.

Добавление API в ваш проект

Чтобы использовать API ConditionalBarriers в своём моде, вы можете добавить его как зависимость через Modrinth или предпочитаемый вами Maven-репозиторий.

Gradle (Modrinth)

1. Добавьте репозиторий Modrinth в ваш build.gradle:

repositories {
    maven {
        name = "Modrinth"
        url = uri("https://api.modrinth.com/maven")
    }
}

2. Добавьте зависимость:

dependencies {
    modImplementation "maven.modrinth:conditional-barriers:<VERSION>"
}

*Примечание: замените `<VERSION>` на нужную вам версию.*

#### fabric.mod.json

Добавьте мод в раздел `depends`, чтобы он точно был при запуске:

```json
"depends": {
    "conditionalbarriers": ">=1.0.0"
}

Регистрация своего условия

ConditionalBarriersApi.registerCondition(new Identifier("mymod", "special_access"), context -> {
    if (someCustomLogic(context.player())) {
        return BarrierDecision.ALLOW; // Пропустить игрока
    }
    return BarrierDecision.PASS; // Пусть решают другие правила
});

Ручные переопределения

Можно также принудительно разрешить конкретному игроку проходить (или запретить) независимо от остальных правил:

ConditionalBarriersApi.setPlayerOverride(player, PlayerBarrierOverride.ALLOW);

Установка и требования

1. Убедитесь, что у вас установлен Fabric Loader.
2. Закиньте JAR-файл ConditionalBarriers в папку mods.
3. (Необязательно) Установите Fabric API, если его ещё нет.

Лицензия

Этот проект распространяется на условиях, указанных в файле LICENSE.txt.