BorderAchieve

Minecraft 版本： 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11

平台： paper

标签： adventure game-mechanics utility

BorderAchieve / BorderAchieve

• Version: 0.3.0-SNAPSHOT and higher
• Data packs все работает/all works

Tested The server: mistii.ru online 6-10 on version 1.21.11

Плагин для Paper 1.21+, связывающий достижения (advancements) с динамическим расширением границ миров, глобальной блокировкой измерений и персональной блокировкой миров для отдельных игроков.

A Paper 1.21+ plugin that links advancements to dynamic world border expansion, global dimension locking, and per-player world locking.

---

РУССКАЯ ВЕРСИЯ

? Описание

BorderAchieve превращает получение достижений в механику, влияющую на мир сервера, и даёт гибкие инструменты контроля доступа к мирам:

• Расширение границ — за каждое новое достижение граница в выбранных мирах увеличивается на заданное количество блоков. В Незере расширение автоматически делится на 8.
• Глобальная блокировка миров — телепортация в определённые миры (например, Ад, Энд) запрещена, пока общее количество выполненных достижений на сервере не достигнет порога. После разблокировки мир открывается навсегда с общим оповещением.
• Персональная блокировка — администратор может запретить конкретному игроку доступ в любой мир. При попытке входа игрок получит отказ, а при респавне в запрещённом мире будет автоматически перенаправлен в первый доступный мир согласно настраиваемому порядку.
• Топ игроков — интерактивное GUI-меню со списком лучших игроков по числу достижений.
• Визуальные и звуковые эффекты — настраиваемые Title, Subtitle и звук при расширении границы.
• PlaceholderAPI — поддержка плейсхолдеров для интеграции с другими плагинами (табло, голограммы и т.п.).
• Гибкая настройка — режимы расширения (плавный/отложенный), время, выбор миров, индивидуальные пороги глобальной блокировки для каждого измерения, порядок респавна.

? Установка

1. Скачайте файл плагина.
2. Поместите BorderAchieve.jar в папку plugins/.
3. Перезапустите сервер.
4. Настройте конфигурационный файл plugins/BorderAchieve/config.yml.
5. Настройте языковые файлы в plugins/BorderAchieve/language/ (ru.yml / en.yml).
6. (Опционально) Установите PlaceholderAPI для использования плейсхолдеров.

? Команды

Основная команда: /border

Команда	Право	Описание
/border top	borderachieve.player	Открыть GUI топ достижений
/border reload	borderachieve.admin	Перезагрузить конфиг и языковые файлы
/border lock <world> [player]	borderachieve.admin	Персонально запретить мир для игрока
/border unlock <world> [player]	borderachieve.admin	Разблокировать мир глобально или для игрока
/border list <игрок>	borderachieve.admin	Показать список персонально запрещённых миров игрока
/border lockstatus	borderachieve.admin	Показать статус всех глобальных и персональных блокировок
/border debug	borderachieve.admin	Вывести отладочную информацию
/border help	borderachieve.player	Справка по командам

Ярлыки (алиасы): /bordertop, /topborder, /borderreload, /borderunlock, /borderlock, /borderlockstatus, /borderdebug, /borderachieve

? PlaceholderAPI

Если PlaceholderAPI установлен, доступны следующие плейсхолдеры:

• %borderachieve_count% — количество достижений игрока
• %borderachieve_rank% — место в топе
• %borderachieve_total% — общее количество выполненных достижений на сервере
• %borderachieve_lock_player% — список всех персонально запрещённых миров игрока
• %borderachieve_lock_<world>% — true, если мир персонально запрещён для игрока
• %borderachieve_locked_display_<world>% — строка вида мир: true/false
• %borderachieve_global_locked_<world>% — true, если мир глобально заблокирован по достижениям
• %borderachieve_global_locked_display_<world>% — строка вида мир: true/false для глобальной блокировки

Info:

Info:3 ## ⚙ Конфигурация Основные настройки в `config.yml`: ```yaml language: ru settings: enable_border_expansion: true expand_amount: 15.0 border_change_mode: "smooth" border_move_speed: "200t" set_initial_border_on_first_start: true initial_border_size: 35.0 apply_to_all_worlds: false allowed_worlds: - world - world_nether - world_the_end notify_only_player: true effects: sound: "entity.ender_dragon.growl" sound_volume: 0.8 sound_pitch: 1.0 title: true subtitle: true gui: slots: [10,11,12,13,14,15,16,19,20,21,22,23,24,25,28,29,30,31,32,33,34,37,38,39,40,41,42,43] world_locking: enabled: true apply_to_all_worlds_for_locking: false default_required: 73 worlds: world_nether: required_achievements: 150 world_the_end: required_achievements: 650 show_deny_title: true respawn_worlds: - "world" - "world_nether" - "world_the_end" debug: false ``` Подробное описание всех параметров находится в `documentation.yml` (создаётся автоматически). ## ? Рекомендации по блокировке миров **Глобальная блокировка (по достижениям):** - **Ад**: `150–200` (откроется не сразу, после накопления стартовых достижений) - **Энд**: `400–650` (серьёзное испытание, откроется позже) Проверяйте прогресс командой `/border lockstatus`. ## ? Языки Поддерживаются русский (`ru`) и английский (`en`). Выберите нужный в `config.yml` параметром `language`. Языковые файлы находятся в папке `plugins/BorderAchieve/language/`. ## ? Отладка Включите `debug: true` в конфигурации, чтобы получать подробные логи в консоль. ## ? Сброс настроек Удалите файл `config.yml` и перезапустите сервер — плагин создаст новый с настройками по умолчанию.

---

ENGLISH VERSION

? Description

BorderAchieve turns earning advancements into a world‑affecting mechanic and provides flexible world access control:

• Border expansion – every new achievement expands the border in selected worlds by a configurable amount. In the Nether the expansion is automatically divided by 8.
• Global world locking – teleportation to specific worlds (e.g. Nether, End) is blocked until the server‑wide total of completed achievements reaches a threshold. Once unlocked, the world stays open forever with a broadcast.
• Personal locking – admins can forbid specific players from accessing any world. Attempted teleportation is blocked, and respawning in a forbidden world redirects the player to the first available world according to a configurable order.
• Leaderboard – an interactive GUI ranking players by their completed achievements.
• Visual & sound effects – customizable Title, Subtitle, and sound when the border expands.
• PlaceholderAPI – placeholders for integration with other plugins (scoreboards, holograms, etc.).
• Flexible configuration – expansion mode (smooth/delayed), time, world selection, per‑world locking thresholds, respawn order.

? Installation

1. Download the plugin file.
2. Place BorderAchieve.jar into the plugins/ folder.
3. Restart the server.
4. Configure plugins/BorderAchieve/config.yml.
5. Adjust language files in plugins/BorderAchieve/language/ (ru.yml / en.yml).
6. (Optional) Install PlaceholderAPI to use placeholders.

? Commands

Main command: /border

Command	Permission	Description
/border top	borderachieve.player	Open achievement leaderboard GUI
/border reload	borderachieve.admin	Reload config & language files
/border lock <world> [player]	borderachieve.admin	Personally lock a world for a player
/border unlock <world> [player]	borderachieve.admin	Unlock world globally or for a player
/border list <player>	borderachieve.admin	List player's personally locked worlds
/border lockstatus	borderachieve.admin	View all global and personal lock statuses
/border debug	borderachieve.admin	Show debug info
/border help	borderachieve.player	Show command help

Aliases: /bordertop, /topborder, /borderreload, /borderunlock, /borderlock, /borderlockstatus, /borderdebug, /borderachieve

? PlaceholderAPI

If PlaceholderAPI is installed, the following placeholders are available:

• %borderachieve_count% – player's achievement count
• %borderachieve_rank% – player's rank in leaderboard
• %borderachieve_total% – total completed achievements on server
• %borderachieve_lock_player% – list of worlds personally locked for the player
• %borderachieve_lock_<world>% – true if world is personally locked for the player
• %borderachieve_locked_display_<world>% – string like world: true/false
• %borderachieve_global_locked_<world>% – true if world is globally locked by achievements
• %borderachieve_global_locked_display_<world>% – string like world: true/false for global locking

Info:

Info:3 ## ⚙ Configuration Main settings in `config.yml`: ```yaml language: en settings: enable_border_expansion: true expand_amount: 15.0 border_change_mode: "smooth" border_move_speed: "200t" set_initial_border_on_first_start: true initial_border_size: 35.0 apply_to_all_worlds: false allowed_worlds: - world - world_nether - world_the_end notify_only_player: true effects: sound: "entity.ender_dragon.growl" sound_volume: 0.8 sound_pitch: 1.0 title: true subtitle: true gui: slots: [10,11,12,13,14,15,16,19,20,21,22,23,24,25,28,29,30,31,32,33,34,37,38,39,40,41,42,43] world_locking: enabled: true apply_to_all_worlds_for_locking: false default_required: 73 worlds: world_nether: required_achievements: 150 world_the_end: required_achievements: 650 show_deny_title: true respawn_worlds: - "world" - "world_nether" - "world_the_end" debug: false ``` For a full description of every parameter, see the automatically created `documentation.yml`. ## ? Locking Recommendations **Global locking (by achievements):** - **Nether**: `150–200` (won't unlock instantly, after initial advancements accumulate) - **End**: `400–650` (a real challenge, unlocks much later) Check progress with `/border lockstatus`. ## ? Languages Russian (`ru`) and English (`en`) are supported. Set the `language` option in `config.yml`. Language files are located in `plugins/BorderAchieve/language/`. ## ? Debugging Enable `debug: true` in the config to receive detailed console logs. ## ? Resetting to Defaults Delete `config.yml` and restart the server — the plugin will generate a fresh default configuration.

? Автор | Author

lesha_1

? Лицензия | License

MIT License. See the LICENSE file for details.

0.1.8/0.2.0-SNAPSHOT # BorderAchieve / BorderAchieve | [](https://discord.com/invite/B5aZNengyp) | [](https://modrinth.com/user/lesha_1) | [](https://github.com/lesha231456) | [](https://ru.namemc.com/profile/lesha_1.1) | |---------------------|:---------------------:|:---------------------:|---------------------:| Плагин для Paper 1.21+, связывающий достижения (advancements) с динамическим расширением границ миров и блокировкой измерений. A Paper 1.21+ plugin that links advancements to dynamic world border expansion and dimension locking. --- РУССКАЯ ВЕРСИЯ --- ## ? Описание **BorderAchieve** превращает получение достижений в механику, влияющую на мир сервера: - **Расширение границ** — за каждое новое достижение граница в выбранных мирах увеличивается на заданное количество блоков. В Незере расширение автоматически делится на 8. - **Блокировка миров** — телепортация в определённые миры (например, Ад, Энд) запрещена, пока общее количество выполненных достижений на сервере не достигнет порога. После разблокировки мир открывается навсегда с общим оповещением. - **Топ игроков** — интерактивное GUI-меню со списком лучших игроков по числу достижений. - **Визуальные и звуковые эффекты** — настраиваемые Title, Subtitle и звук при расширении границы. - **PlaceholderAPI** — поддержка плейсхолдеров для интеграции с другими плагинами (табло, голограммы и т.п.). - **Гибкая настройка** — режимы расширения (плавный/отложенный), время, выбор миров, индивидуальные пороги блокировки для каждого измерения. ## ? Установка 1. Скачайте файл плагина. 2. Поместите `BorderAchieve.jar` в папку `plugins/`. 3. Перезапустите сервер. 4. Настройте конфигурационный файл `plugins/BorderAchieve/config.yml`. 5. Настройте языковые файлы в `plugins/BorderAchieve/language/` (ru.yml / en.yml). 6. (Опционально) Установите PlaceholderAPI для использования плейсхолдеров. ## ? Команды | Команда | Право | Описание | |----------|--------|------------| | `/topborder` (или `/bordertop`) | – | Открыть GUI топ достижений | | `/borderreload` | `borderachieve.admin` | Перезагрузить конфиг и языковые файлы | | `/borderunlock [игрок]` | `borderachieve.admin` | Разблокировать мир навсегда или выдать временный пропуск игроку | | `/borderlock ` | `borderachieve.admin` | Повторно заблокировать ранее разблокированный мир | | `/borderlockstatus` | `borderachieve.admin` | Посмотреть статус блокировки миров | | `/borderdebug` | `borderachieve.admin` | Показать отладочную информацию | | `/borderachieve` | – | Справка по плагину | ## ? PlaceholderAPI Если PlaceholderAPI установлен, доступны следующие плейсхолдеры: - `%borderachieve_count%` — количество достижений игрока - `%borderachieve_rank%` — место в топе - `%borderachieve_total%` — общее количество выполненных достижений на сервере - `%borderachieve_locked_%` — `true`, если мир заблокирован для игрока; `false`, если открыт - `%borderachieve_locked_display_%` — отображает строку вида `мир: true/false` (например, `world_nether: true`) # Info: Info:3 ## ⚙ Конфигурация Основные настройки в `config.yml`: ```yaml language: ru settings: enable_border_expansion: true expand_amount: 15.0 border_change_mode: "smooth" border_move_speed: "200t" set_initial_border_on_first_start: true initial_border_size: 35.0 apply_to_all_worlds: false allowed_worlds: - world - world_nether - world_the_end notify_only_player: true effects: sound: "entity.ender_dragon.growl" sound_volume: 0.8 sound_pitch: 1.0 title: true subtitle: true gui: slots: [10,11,12,13,14,15,16,19,20,21,22,23,24,25,28,29,30,31,32,33,34,37,38,39,40,41,42,43] world_locking: enabled: true default_required: 150 worlds: world_nether: required_achievements: 150 world_the_end: required_achievements: 400 show_deny_title: true debug: false ``` Подробное описание всех параметров находится в `documentation.yml` (создаётся автоматически). ## ? Рекомендации по блокировке миров Для 10–15 активных игроков рекомендуемые пороги: - **Ад**: `150–200` (откроется не сразу, после накопления стартовых достижений) - **Энд**: `400–500` (серьёзное испытание, откроется позже) Проверяйте прогресс командой `/borderlockstatus`. ## ? Языки Поддерживаются русский (`ru`) и английский (`en`). Выберите нужный в `config.yml` параметром `language`. Языковые файлы находятся в папке `plugins/BorderAchieve/language/`. ## ? Отладка Включите `debug: true` в конфигурации, чтобы получать подробные логи в консоль. ## ? Сброс настроек Удалите файл `config.yml` и перезапустите сервер — плагин создаст новый с настройками по умолчанию. --- ENGLISH VERSION --- ## ? Description **BorderAchieve** turns earning advancements into a world‑affecting mechanic: - **Border expansion** – every new achievement expands the border in selected worlds by a configurable amount. In the Nether the expansion is automatically divided by 8. - **World locking** – teleportation to specific worlds (e.g. Nether, End) is blocked until the server‑wide total of completed achievements reaches a threshold. Once unlocked, the world stays open forever with a broadcast. - **Leaderboard** – an interactive GUI ranking players by their completed achievements. - **Visual & sound effects** – customizable Title, Subtitle, and sound when the border expands. - **PlaceholderAPI** – placeholders for integration with other plugins (scoreboards, holograms, etc.). - **Flexible configuration** – expansion mode (smooth/delayed), time, world selection, per‑world locking thresholds. ## ? Installation 1. Download the plugin file. 2. Place `BorderAchieve.jar` into the `plugins/` folder. 3. Restart the server. 4. Configure `plugins/BorderAchieve/config.yml`. 5. Adjust language files in `plugins/BorderAchieve/language/` (ru.yml / en.yml). 6. (Optional) Install PlaceholderAPI to use placeholders. ## ? Commands | Command | Permission | Description | |----------|------------|--------------| | `/topborder` (or `/bordertop`) | – | Open achievement leaderboard GUI | | `/borderreload` | `borderachieve.admin` | Reload config & language files | | `/borderunlock [player]` | `borderachieve.admin` | Unlock world permanently or grant temp access to a player | | `/borderlock ` | `borderachieve.admin` | Re-lock a previously unlocked world | | `/borderlockstatus` | `borderachieve.admin` | View world locking status | | `/borderdebug` | `borderachieve.admin` | Show debug info | | `/borderachieve` | – | Plugin help | ## ? PlaceholderAPI If PlaceholderAPI is installed, the following placeholders are available: - `%borderachieve_count%` – player’s achievement count - `%borderachieve_rank%` – player’s rank - `%borderachieve_total%` – total completed advancements on the server - `%borderachieve_locked_%` – `true` if world is locked for the player, `false` if open - `%borderachieve_locked_display_%` – returns a string like `world_nether: true/false` # Info: Info:3 ## ⚙ Configuration Main settings in `config.yml`: ```yaml language: en settings: enable_border_expansion: true expand_amount: 15.0 border_change_mode: "smooth" border_move_speed: "200t" set_initial_border_on_first_start: true initial_border_size: 35.0 apply_to_all_worlds: false allowed_worlds: - world - world_nether - world_the_end notify_only_player: true effects: sound: "entity.ender_dragon.growl" sound_volume: 0.8 sound_pitch: 1.0 title: true subtitle: true gui: slots: [10,11,12,13,14,15,16,19,20,21,22,23,24,25,28,29,30,31,32,33,34,37,38,39,40,41,42,43] world_locking: enabled: true default_required: 150 worlds: world_nether: required_achievements: 150 world_the_end: required_achievements: 400 show_deny_title: true debug: false ``` For a full description of every parameter, see the automatically created `documentation.yml`. ## ? Locking Recommendations For 10–15 active players, recommended thresholds: - **Nether**: `150–200` (won't unlock instantly, after initial advancements accumulate) - **End**: `400–500` (a real challenge, unlocks much later) Check progress with `/borderlockstatus`. ## ? Languages Russian (`ru`) and English (`en`) are supported. Set the `language` option in `config.yml`. Language files are located in `plugins/BorderAchieve/language/`. ## ? Debugging Enable `debug: true` in the config to receive detailed console logs. ## ? Resetting to Defaults Delete `config.yml` and restart the server — the plugin will generate a fresh default configuration. ## ? Автор | Author [lesha_1](https://ru.namemc.com/profile/lesha_1) ## ? Лицензия | License MIT License. See the [LICENSE](https://github.com/lesha231456/BorderAchievePlugin/blob/main/LICENSE) file for details.