# QUESTIONS/WARN!!!!!

***

### Frequently Asked Questions / Часто задаваемые вопросы

#### English

**Q1: How do I change the language of the plugin?**\
A: Open the `config.yml` file and set the `language` option to one of the supported codes (e.g., `en`, `ru`, `fr`, `es`, `it`, `de`, `tr`, `cs`). The plugin will then load the corresponding `messages_xx.yml` file and display all texts in that language.

**Q2: My progress messages (like “\[1/7] X more to find”) are still in Russian. How can I fix that?**\
A: Ensure that you have the correct language file in your plugin folder (e.g., `messages_en.yml` for English) and that the `language` option in `config.yml` is set to the desired language code. All progress texts are loaded from the language file using the key `messages.found-progress`.

**Q3: Can I add rewards for players when they collect all heads?**\
A: Currently, rewards are not implemented. We are open to feedback from the community. If there is sufficient demand, future updates may include integration with reward plugins or economy systems.

**Q4: What are placeholders and how do they work?**\
A: Placeholders are tokens like `{category}`, `{player}`, `{message}`, `{command}`, `{found}`, `{total}`, and `{remain}` that get dynamically replaced with the actual values at runtime. For example, when a player collects all heads in a category, `{player}` is replaced with their username and `{category}` with the category name.

**Q5: Is it possible to integrate sirHeadsWin with other plugins?**\
A: Yes! The plugin is designed with a modular structure, making it easy to extend. In future updates, we might add custom events (e.g., `PlayerCollectedAllHeadsEvent`) that other plugins can listen to for additional integration, such as giving rewards, launching fireworks, or triggering custom commands.

**Q6: What if I encounter errors or unexpected behavior?**\
A: Please refer to the Troubleshooting section in the documentation. Ensure that your configuration files are correctly formatted and that you are running a supported version of the server. If issues persist, feel free to reach out with detailed error messages for further assistance.

***

#### Русский

**Вопрос 1: Как поменять язык плагина?**\
Ответ: Откройте файл `config.yml` и установите параметр `language` в один из поддерживаемых кодов (например, `en`, `ru`, `fr`, `es`, `it`, `de`, `tr`, `cs`). Плагин загрузит соответствующий файл `messages_xx.yml` и все тексты отобразятся на выбранном языке.

**Вопрос 2: Сообщения о прогрессе (например, «\[1/7] Осталось найти 6») всё ещё на русском. Что делать?**\
Ответ: Убедитесь, что в папке плагина присутствует нужный языковой файл (например, `messages_en.yml` для английского) и что параметр `language` в `config.yml` установлен на нужный код. Все сообщения, включая прогресс, загружаются по ключу `messages.found-progress` из выбранного файла.

**Вопрос 3: Можно ли добавить награды игрокам при сборе всех голов?**\
Ответ: Пока что награды не реализованы. Мы открыты для обратной связи, и если плагин получит достаточный отклик от сообщества, в будущих обновлениях может быть добавлена интеграция с плагинами экономики или выдача предметов в качестве наград.

**Вопрос 4: Что такое плейсхолдеры и как они работают?**\
Ответ: Плейсхолдеры – это специальные токены, такие как `{category}`, `{player}`, `{message}`, `{command}`, `{found}`, `{total}` и `{remain}`, которые автоматически заменяются на реальные значения во время работы плагина. Например, при сборе всех голов `{player}` заменяется на имя игрока, а `{category}` – на название категории.

**Вопрос 5: Можно ли интегрировать sirHeadsWin с другими плагинами?**\
Ответ: Да! Плагин построен модульно, что облегчает его расширение и интеграцию. В будущих обновлениях мы можем добавить собственные события (например, `PlayerCollectedAllHeadsEvent`), на которые смогут подписываться другие плагины для, например, выдачи наград или запуска специальных эффектов.

**Вопрос 6: Что делать, если возникают ошибки или плагин работает не так, как ожидалось?**\
Ответ: Ознакомьтесь с разделом «Решение проблем» в документации. Убедитесь, что конфигурационные файлы корректны, и что вы используете поддерживаемую версию сервера. Если проблемы сохраняются, предоставьте подробные сообщения об ошибках для получения дальнейшей помощи.

***


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://siriusatop123s-organization.gitbook.io/sirheadfinder/info/questions-warn.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
