Showcase

Отображает иконки предметов в сообщениях чата для опубликованных предметов.

Зачем ресурспак? Будучи серверным модом, мы используем систему кастомных шрифтов Minecraft для отрисовки иконок.

Настройка:

1. Сгенерируйте ресурспак на IconifyCraft
2. Разместите пак на веб-сервере
3. Включите в config/showcase/config.yml: itemIcons.enabled = true

4. Добавьте в server.properties:

   resource-pack=<your-hosted-pack-url>
   resource-pack-sha1=<pack-sha1-hash>
   require-resource-pack=true

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

itemIcons:
  enabled: false                    # Enable/disable icons
  fontNamespace: "iconifycraft"     # Resource pack namespace
  includeInItemNames: true          # Show icons in item names

⚠Внимание: экспериментальная функция. Текущая поддержка отображения блоков, включая сундуки и эндер-сундуки, неполная.

⌨️ Команды

💡 Подробный справочник команд с примерами и правами

Команды игрока

/showcase <type> [player] [duration] [description]

Типы: item, inventory, hotbar, enderchest, container, merchant, stats

Форматы длительности: 30s, 5m, 1h, 1h30m или секунды числом (например, 300)

Другие команды:

• `/showcase cancel ` — отменить свою публикацию
• `/showcase-view ` — просмотреть опубликованное содержимое

Команды администратора

/admin-showcase <type> <player> [receiver] [duration] [description]
/showcase-manage <action> [args]

Действия: reload, list [page], cancel <id|player>

Ключевые слова в чате

Игроки могут вводить ключевые слова в квадратных скобках для быстрого обмена содержимым:

Ключевые слова по умолчанию (настраиваются в config.yml):

• [item] или [i] — поделиться предметом в руке
• [inventory] или [inv] — поделиться инвентарём
• [hotbar] или [hb] — поделиться хотбаром
• [ender_chest] или [ec] — поделиться эндер-сундуком
• [stats] или [stat] — поделиться статистикой

Пример: Check out my [item]! → автоматически заменяется на кликабельную ссылку

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

🔗 Полная документация API — руководства по интеграции и примеры

Интеграция с PlaceholdersAPI

Базовый обмен:

%showcase:item%        - Share held item
%showcase:inventory%   - Share inventory
%showcase:hotbar%      - Share hotbar
%showcase:ender_chest% - Share ender chest
%showcase:stats%       - Share statistics

Основная статистика:

%showcase:shares_count% - Number of active shares
%showcase:total_views%  - Total views received
%showcase:can_share_item% - Permission check (true/false)
%showcase:has_admin_perms% - Admin check (true/false)

📚 **[Посмотреть все плейсхолдеры](https://showcase-fabric.vercel.app/docs/developers/placeholderapi)**

## ⚙️ Конфигурация

> ⚙️ **[Справочник по конфигурации](https://showcase-fabric.vercel.app/docs/configuration/config-file)** — полное руководство по настройкам

Основной файл конфигурации: `config/showcase/config.yml` (формат YAML)

**Ключевые настройки**:
- Кулдауны и права на публикацию
- Ключевые слова и триггеры в чате
- Параметры отслеживания статистики
- Оптимизация производительности
- Поддержка нескольких языков

📖 **[Посмотреть пример конфига](https://showcase-fabric.vercel.app/docs/configuration/config-file)** | 🔐 **[Настройка прав](https://showcase-fabric.vercel.app/docs/configuration/permissions)**

## 📚 Документация и ресурсы

- **[Полная документация](https://showcase-fabric.vercel.app)** — подробное описание всех возможностей
- **[Начало работы](https://showcase-fabric.vercel.app/docs/getting-started/installation)** — руководство по установке и настройке
- **[Справочник команд](https://showcase-fabric.vercel.app/docs/commands/player-commands)** — все команды с примерами
- **[Руководство по конфигурации](https://showcase-fabric.vercel.app/docs/configuration/config-file)** — настройки и кастомизация
- **[API для разработчиков](https://showcase-fabric.vercel.app/docs/developers/api-overview)** — интеграция с PlaceholderAPI
- **[FAQ и решение проблем](https://showcase-fabric.vercel.app/docs/support/faq)** — частые вопросы и решения

## 📝 Лицензия

[MIT](./LICENSE)