> For the complete documentation index, see [llms.txt](https://siriusatop123s-organization.gitbook.io/sirheadfinder/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://siriusatop123s-organization.gitbook.io/sirheadfinder/readme.md).

# Welcome

***

## Welcome / Добро пожаловать

**English**

Welcome to the **sirHeadsWin** plugin documentation! This guide will help you understand how to install, configure, and use the plugin. You’ll learn about creating categories, assigning heads, collecting progress, and customizing messages in multiple languages.

**Русский**

Добро пожаловать в документацию по плагину **sirHeadsWin**! В этом руководстве вы узнаете, как установить, настроить и использовать плагин. Мы расскажем о создании категорий, назначении голов, сборе прогресса и настройке сообщений на нескольких языках.

***

### What is sirHeadsWin? / Что такое sirHeadsWin?

**English**

sirHeadsWin is a Minecraft plugin that lets you create **head-hunting categories**, where players can search for hidden heads (or blocks) across your world. Once they find all the heads in a category, they get a celebratory message (and possibly a reward). The plugin supports multiple languages, so you can localize all messages for different communities.

**Русский**

**sirHeadsWin** — это плагин для Minecraft, позволяющий создавать **категории с поиском голов**. Игроки могут искать скрытые головы (или блоки) в вашем мире, а после нахождения всех голов в категории получают поздравительное сообщение (и, при желании, награду). Плагин поддерживает несколько языков, так что вы сможете локализовать все сообщения для разных сообществ.

***

### Key Features / Основные особенности

**English**

* **Category System**: Create multiple categories (e.g., "Twilight Heads", "Winter Heads") with unique messages.
* **Multi-Language Support**: Choose from several languages in the config, or add your own translations.
* **Progress Tracking**: Players see how many heads they’ve found and how many remain.
* **Custom Messages & Sounds**: Personalize all texts and set a custom sound (e.g., Ender Dragon roar).
* **Head Protection**: Prevent players from breaking designated heads.

**Русский**

* **Система категорий**: Создавайте несколько категорий (например, «Сумеречные головы», «Зимние головы») с уникальными сообщениями.
* **Мультиязычность**: Выбирайте из нескольких языков в конфиге или добавляйте собственные переводы.
* **Отслеживание прогресса**: Игроки видят, сколько голов уже нашли и сколько осталось.
* **Настраиваемые сообщения и звуки**: Меняйте все тексты и задавайте свой звук (например, рык дракона).
* **Защита голов**: Запрещайте игрокам ломать назначенные головы.

***

### Next Steps / Дальнейшие шаги

**English**

* **Installation**: Learn how to install sirHeadsWin on your server.
* **Configuration**: See how to customize languages, categories, and messages in `config.yml` and `messages_xx.yml`.
* **Usage**: Explore commands like `/sirheadswin start <category>` and `/sirheadswin finish <category>` to set up your hunts.
* **Advanced Tips**: Discover how to manage multiple categories, integrate with other plugins, or add special rewards.

**Русский**

* **Установка**: Узнайте, как установить sirHeadsWin на свой сервер.
* **Конфигурация**: Посмотрите, как настраивать языки, категории и сообщения в файлах `config.yml` и `messages_xx.yml`.
* **Использование**: Изучите команды вроде `/sirheadswin start <category>` и `/sirheadswin finish <category>` для настройки поиска голов.
* **Расширенные советы**: Откройте для себя, как управлять несколькими категориями, интегрировать плагин с другими дополнениями или добавлять специальные награды.

***

**English**

This concludes our **Welcome** page. Click **Next** to continue with Installation instructions!

**Русский**

На этом мы завершаем страницу «Добро пожаловать». Нажмите **Далее**, чтобы перейти к инструкции по установке!