Guide how to use

Usage (Commands Guide)

English

Below is a quick reference for the main commands in sirHeadsWin. All of them require the permission sirheadswin.use (default: op).

1. /sirheadswin start <category...>

   • Purpose: Begins setup (draft mode) for a new or existing category (e.g., "Twilight Heads").

   • How it works:

     1. The plugin clears draftHeads and heads for that category in config.yml.

     2. You can now use /sirheadswin set to assign blocks/heads.

   • Example:

     /sirheadswin start SummerHeads

     (Allows spaces, e.g. Summer Heads with Spaces.)

2. /sirheadswin set <message...>

   • Purpose: Prepares the plugin so that the next right-click you do will assign a block to the category you started.

   • How it works:

     1. The plugin stores (adminUUID -> {category, message}).

     2. When you right-click any block/head, that block is saved as a “draftHead” with the specified message.

   • Example:

     /sirheadswin set "Found a hidden head!"

     Next right-click on a block will assign that block with the message "Found a hidden head!".

3. /sirheadswin finish <category...>

   • Purpose: Activates all blocks in draftHeads → heads for the specified category.

   • How it works:

     1. The plugin moves everything from draftHeads to heads.

     2. Players can now collect these heads/blocks.

   • Example:

     /sirheadswin finish SummerHeads

Additional Notes

• Long Category Names: You can include spaces in <category...> (e.g. "/sirheadswin start Magical Heads").

• Multi-Categories: You can repeat the process for different categories (e.g. SummerHeads, WinterHeads, etc.).

• Progress: Once heads are active, players find them by right-clicking. The plugin tracks how many have been found vs. total.

• Protection: If a block is in heads, players cannot break it.

• Localization: All messages (including these commands’ feedback) will appear in the language you set in config.yml.

---

Русский

Ниже приведён краткий справочник по основным командам sirHeadsWin. Все они требуют права sirheadswin.use (по умолчанию только у оператора).

1. /sirheadswin start <category...>

   • Назначение: Запускает режим настройки (draft mode) для новой или уже существующей категории (например, «Сумеречные головы»).

   • Как работает:

     1. Плагин очищает draftHeads и heads для данной категории в config.yml.

     2. Теперь вы можете использовать /sirheadswin set, чтобы назначать блоки/головы.

   • Пример:

     /sirheadswin start SummerHeads

     (Поддерживаются пробелы, например Summer Heads with Spaces.)

2. /sirheadswin set <message...>

   • Назначение: Готовит плагин к тому, что следующий клик правой кнопкой по блоку назначит его к текущей категории.

   • Как работает:

     1. Плагин запоминает (adminUUID -> {category, message}).

     2. При правом клике по блоку/голове этот блок сохраняется как «draftHead» с указанным сообщением.

   • Пример:

     /sirheadswin set "Нашли спрятанную голову!"

     Следующий клик по блоку назначит сообщение «Нашли спрятанную голову!».

3. /sirheadswin finish <category...>

   • Назначение: Активирует все блоки в draftHeads → heads для указанной категории.

   • Как работает:

     1. Плагин переносит всё из draftHeads в heads.

     2. Игроки теперь могут собирать эти головы/блоки.

   • Пример:

     /sirheadswin finish SummerHeads

Дополнительные заметки

• Длинные названия категорий: Вы можете включать пробелы в <category...> (например, "/sirheadswin start Волшебные головы").

• Несколько категорий: Повторите процесс для разных категорий (например, SummerHeads, WinterHeads и т.д.).

• Прогресс: Когда головы активированы, игроки находят их правым кликом. Плагин показывает, сколько уже найдено и сколько осталось.

• Защита: Если блок находится в heads, игроки не смогут его ломать.

• Локализация: Все сообщения (включая отклики команд) выводятся на языке, выбранном в config.yml.