OgiPlayerStats

OgiPlayerStats — современный и производительный инструмент для создания меню статистики игроков. Плагин поддерживает ванильные показатели Minecraft и данные из сторонних источников через PlaceholderAPI.

OgiPlayerStats предоставляет интуитивно понятное внутриигровое меню для демонстрации характеристик пользователей. В отличие от многих аналогов, проект спроектирован так, чтобы быть полностью конфигурируемым через файл config.yml. Администраторы могут выводить любые данные: от стандартных ванильных показателей (например, PLAYER_KILLS, DIAMONDS_MINED) до пользовательских данных из таких плагинов, как Vault или EssentialsX.

Плагин ориентирован на высокую производительность и универсальность. Он позволяет гибко настраивать внешний вид каждого элемента меню, включая заголовок, размер, предметы, названия, описания (lore) и конкретные слоты.

✨ Основные возможности проекта:

• Полностью бесплатное и открытое ПО без скрытых платежей.
• Гибкая настройка GUI: контроль каждого аспекта отображения статистики.
• Широкая поддержка ванильных статистик, включая данные с подтипами (блоки, сущности).
• Интеграция с PlaceholderAPI для импорта данных из любых совместимых плагинов.
• Динамические скины предметов: использование материала PLAYER_HEAD с параметром skull-owner для отображения голов конкретных игроков.
• Оптимизированная архитектура для минимального влияния на нагрузку сервера.

⚙️ Настройка и добавление данных

Конфигурация осуществляется в файле config.yml. В списке displayed-stats можно добавлять, удалять или изменять любые параметры.

Для отображения стандартной статистики Minecraft используется ключ statistic. Если статистика требует подтипа (например, добыча конкретного блока), необходимо указать дополнительные поля type и sub-type.

```yaml
- slot: 14
  material: "DIAMOND_PICKAXE"
  name: "&bDiamonds Mined"
  lore:
    - "&7Diamond ore blocks broken."
    - ""
    - "&aValue: &f{value}"
  statistic: "MINE_BLOCK"
  type: "BLOCK"
  sub-type: "DIAMOND_ORE"
```

Для интеграции данных из сторонних плагинов используется ключ placeholder. В этом случае значение {value} в описании (lore) будет заменяться результатом соответствующего плейсхолдера.

```yaml
- slot: 13
  material: "GOLD_INGOT"
  name: "&ePlayer Balance"
  lore:
    - "&7Your current balance."
    - ""
    - "&aValue: &f{value}"
  placeholder: "%vault_eco_balance_formatted%"
```

🧩 Интеграция с PlaceholderAPI

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

Пример: объект с name: "&bPlayer Kills" превращается в %ogiplayerstats_player_kills%. Эти плейсхолдеры можно использовать в любых других плагинах, поддерживающих PlaceholderAPI (таблицы, чат, голограммы).

📝 Команды и права доступа

Для полноценного использования функционала рекомендуется установить PlaceholderAPI.