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. Перезапустите сервер или выполните /reload.
4. Настройте конфигурационный файл plugins/BorderAchieve/config.yml.
5. Настройте языковые файлы в plugins/BorderAchieve/language/ (ru.yml / en.yml).
6. (Опционально) Установите PlaceholderAPI для использования плейсхолдеров.

🛠 Команды

📊 PlaceholderAPI

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

• %borderachieve_count% — количество достижений игрока
• %borderachieve_rank% — место в топе
• %borderachieve_total% — общее количество выполненных достижений на сервере
• %borderachieve_locked_<мир>% — true, если мир заблокирован для игрока; false, если открыт

Info:

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

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 or run /reload.
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

📊 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

Info:

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

📝 Автор | Author

lesha_1

📃 Лицензия | License

MIT License. See the LICENSE file for details.