Logo
BorderAchieve
PluginMIT

BorderAchieve

A simple Minecraft plugin that implements "Achievements increase worldborder size + top achievements"

27
Downloads
1
Followers
2 weeks ago
Updated
📦
3
Versions
adventuregame-mechanicsutilitypaper
Download Latestv0.3.0-SNAPSHOTView on Modrinth

📖About BorderAchieve

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:

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:

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

дс мд гд сн

Плагин для 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:

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 <world> [player] borderachieve.admin Unlock world permanently or grant temp access to a player
/borderlock <world> 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_<world>% – true if world is locked for the player, false if open
  • %borderachieve_locked_display_<world>% – returns a string like world_nether: true/false

Info:

Info:3

⚙ Configuration

Main settings in config.yml:

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

📃 Лицензия | License

MIT License. See the LICENSE file for details.