Skip to content

nikitaberg28/Border

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 

Repository files navigation


English

What it does

Enforces a configurable world border on PocketMine-MP and the NetherGames fork. Supports per-world regions, three enforcement modes, multilingual messages, chat / title / actionbar toggles, sound effects, and hot-reload via /border reload.

Commands

Command Description Permission
/border reload Reload config and lang files border.reload

Permissions

Permission Description Default
border.bypass Ignore all borders op
border.reload Use /border reload op

Enforcement modes

Mode Behaviour
damage Movement beyond the boundary is blocked. Player takes damage every N ticks until they back off.
freeze Movement beyond the boundary is silently cancelled. No damage, no knockback.
kick Player is thrown back toward the center of the region with configurable force.

Configuration

# en / ru / custom
lang: en

# damage | freeze | kick
mode: kick

# per-world borders. key = world folder name.
worlds:
  world:
    enabled: true
    min_x: -1000
    max_x: 1000
    min_z: -1000
    max_z: 1000
  world_nether:
    enabled: false
    min_x: -1000
    max_x: 1000
    min_z: -1000
    max_z: 1000
  world_the_end:
    enabled: false
    min_x: -1000
    max_x: 1000
    min_z: -1000
    max_z: 1000

# "damage" mode settings
damage:
  amount: 1.0     # HP per hit (1.0 = half heart)
  interval: 10    # ticks between hits (20 ticks = 1 second)

# "kick" mode settings
kick:
  strength: 2.0   # horizontal push force
  vertical: 1.0   # upward push force

messages:
  chat:
    enabled: true
  title:
    enabled: false
    fade_in: 10
    stay: 40
    fade_out: 10
  actionbar:
    enabled: true
  cooldown: 40    # ticks between repeated messages per player

sound:
  enabled: true
  # available: BellRingSound, BowShootSound, BurpSound, ChorusFlowerGrowSound,
  # EndermanTeleportSound, ExplodeSound, FireworkExplosionSound, FireworkLargeExplosionSound,
  # FireworkLaunchSound, FizzSound, FlintSteelSound, GhastShootSound, GhastSound,
  # IgniteSound, LaunchSound, PopSound, PotionSplashSound, ThrowSound, TotemUseSound,
  # XpCollectSound
  name: BellRingSound

Custom language

Set lang: custom, then edit plugins/Border/lang/custom.json:

{
  "border_chat": "§cYou have reached the world border!",
  "border_title_title": "§4WorldBorder",
  "border_title_subtitle": "§cYou cannot go further!",
  "border_actionbar": "§cWorld border §7({x}, {z})",
  "config_reloaded": "§aConfig and language files reloaded",
  "no_permission": "§cNo permission",
  "only_in_game": "§cIn-game only",
  "invalid_mode": "§cUnknown mode §e{mode}§c, falling back to §ekick§c",
  "invalid_sound": "§cSound §e{sound}§c not found, sound disabled"
}

Placeholders: {x} {z} {mode} {sound}


Русский

Подробнее

Плагин на ограничение границ мира для PocketMine-MP и форка NetherGames. Поддерживает настройку по мирам, три режима работы, мультиязычность, переключение сообщений, звуки и горячую перезагрузку через /border reload

Команды

Команда Описание Права
/border reload Перезагрузить конфиг и языковые файлы border.reload

Права

Право Описание По умолчанию
border.bypass Игнорировать все границы op
border.reload Использовать /border reload op

Режимы работы

Режим Поведение
damage Движение за границу блокируется. Игрок получает урон каждые N тиков, пока не отойдёт.
freeze Движение за границу молча отменяется. Никакого урона и отброса.
kick Игрока отбрасывает вектором в сторону центра области с настраиваемой силой.

Конфигурация

# en / ru / custom
lang: ru

# damage | freeze | kick
mode: kick

# Границы по мирам. Ключ = папка мира.
worlds:
  world:
    enabled: true
    min_x: -3500
    max_x: 3500
    min_z: -3500
    max_z: 3500
  world_nether:
    enabled: false
    min_x: -1000
    max_x: 1000
    min_z: -1000
    max_z: 1000

# Настройки режима "damage"
damage:
  amount: 1.0     # урон в HP (1.0 = пол сердца)
  interval: 10    # интервал между ударами в тиках (20 = 1 секунда)

# Настройки режима "kick"
kick:
  strength: 2.0   # сила горизонтального отброса
  vertical: 1.0   # сила подброса вверх

messages:
  chat:
    enabled: true
  title:
    enabled: false
    fade_in: 10
    stay: 40
    fade_out: 10
  actionbar:
    enabled: true
  cooldown: 40    # тиков между повторными сообщениями одному игроку

sound:
  enabled: true
  # available: EndermanTeleportSound, BellRingSound, BowShootSound, BurpSound,
  # ChorusFlowerGrowSound, ExplodeSound, FireworkExplosionSound, FireworkLargeExplosionSound,
  # FireworkLaunchSound, FizzSound, FlintSteelSound, GhastShootSound, GhastSound, IgniteSound,
  # LaunchSound, PopSound, PotionSplashSound, ThrowSound, TotemUseSound,
  # XpCollectSound
  name: FizzSound

Свой язык

Установи lang: custom, затем редактируй plugins/Border/lang/custom.json:

{
  "border_chat": "§cВы достигли границы мира!",
  "border_title_title": "§4Граница мира",
  "border_title_subtitle": "§cДальше пути нет!",
  "border_actionbar": "§cВы у границы мира §7({x}, {z})",
  "config_reloaded": "§aКонфиг и языковые файлы перезагружены",
  "no_permission": "§cНет прав",
  "only_in_game": "§cТолько в игре",
  "invalid_mode": "§cНеизвестный режим §e{mode}§c, используется §ekick§c",
  "invalid_sound": "§cЗвук §e{sound}§c не найден, звук отключён"
}

Плейсхолдеры: {x} {z} {mode} {sound}

About

World size limit plugin for PocketMine-MP

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages