Player Events

Player Events — это серверный мод для Fabric, который позволяет настраивать автоматическое выполнение команд и отправку сообщений при различных действиях игроков. Мод работает исключительно на стороне сервера и не требует установки на клиентах.

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

Мод реагирует на различные события, связанные с игроками:

• Смерть игрока — выполнение действий при гибели
• Первое подключение — специальные приветствия для новичков
• Обычное подключение — стандартные приветствия
• Убийство сущности — реакции на уничтожение мобов
• Убийство игрока — сообщения о PvP-столкновениях
• Отключение от сервера — прощальные сообщения
• Пользовательские команды — создание собственных триггеров

Настройка конфигурации

Все настройки хранятся в файле config/player_events.json. Вот пример конфигурации:

{
  "death": {
    "actions": [
      "${player} только что умер!"
    ],
    "broadcast_to_everyone": true,
    "pick_message_randomly": false
  },
  "first_join": {
    "actions": [
      "Добро пожаловать на сервер ${player}! Не забудьте прочитать правила"
    ],
    "broadcast_to_everyone": false,
    "pick_message_randomly": false
  },
  "join": {
    "actions": [
      "Приветствуем ${player}",
      "/say Здравствуй ${player}"
    ],
    "broadcast_to_everyone": true,
    "pick_message_randomly": false
  }
}

Переменные и токены

В сообщениях можно использовать специальные токены, которые автоматически заменяются на соответствующие значения:

• ${player} — имя игрока, вызвавшего событие
• ${killedEntity} — убитая сущность
• ${killedPlayer} — убитый игрок

Также доступны дополнительные свойства через точку:

• display — отображаемое имя (как в списке игроков)
• uuid — уникальный идентификатор
• x, y, z — координаты игрока

Дополнительные функции

С версии 2.2.0 доступны новые возможности:

• Поддержка датапаков через теги функций #player_events:<событие>
• Случайный выбор сообщений из списка
• Поддержка цветовых кодов форматирования

Команды управления

• /pe reload или /player_events reload — перезагрузка конфигурации
• /pe test <событие> — тестирование конкретного события
• /pe test * — тестирование всех событий

События версии 2.2.0

• death — смерть игрока
• first_join — первое подключение
• join — обычное подключение
• kill_entity — убийство сущности
• kill_player — убийство игрока
• leave — отключение от сервера
• custom_commands — пользовательские команды

Решение проблем

«Некорректный синтаксис JSON» — проверьте двойные кавычки в командах и экранируйте их с помощью \".

«Некорректная escape-последовательность» — добавьте дополнительную обратную косую черту перед специальными символами.

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

Мод предоставляет API для интеграции с другими модами. Чтобы добавить зависимость, используйте:

repositories {
    maven {
        url 'https://maven.bymartrixx.me'

    }
}

dependencies {
    modImplementation "me.bymartrixx.player-events:api:2.1.3"
}

Пример использования событий:

public class FooMod implements DedicatedServerModInitializer {
    public void onInitializeServer() {
        PlayerDeathCallback.EVENT.register((player, source) -> {
            // Ваш код здесь
        });

        PlayerKillEntityCallback.EVENT.register((player, killedEntity) -> {
            // Ваш код здесь
        });
    }
}