Просмотр исходного текста страницы WorldBorder - Ограничение размеров мира

'''WorldBorder''' - плагин для Bukkit, который позволяет легко ограничивать границы мира на игровом сервере. Данный плагин превосходит по функциональности BorderGuard и rBorder, при этом обладает отличной производительностью и создан с целью минимального влияния на работу сервера.

== Возможности ==
* Вы можете установить отдельные границы для каждого из миров.
* Для каждого мира вы можете определить форму границ: квадратную (большая производительность) и круглую (больше нагрузка на сервер, но более приятная округлая форма карты).
* Границы миров задаются непосредственно из игровой консоли, при этом не обязательно находиться в нужном мире или стоять на координате центра границ.
* Информация о границах автоматически сохраняется в файл при установке или изменении границ.
* Если игрок пересекает границу карты на средстве передвижения, он останавливается и телепортируется внутрь границ.
* При телепортации внутрь границ, игрок при необходимости перемещается на безопасную вертикальную позицию (т.е. не будет перемещён в толщу камня).
* Поддерживает плагины GroupManager и Permissions.

[[File:File1.jpg|frame|Рисунок 1. Сообщение достижения границы мира.|none]]
[[File:File2.gif|frame|Рисунок 2. Границы.|none]][[File:File3.gif|frame|Рисунок 2. Границы.|none]]<br />

== Установка ==
* Через Панель управления Myarena.ru, достаточно только нажать на кнопку '''установить''' рядом с плагином.
* Установка плагина через FTP.
# Скачать последнюю версию плагина: '''http://dev.bukkit.org/bukkit-plugins/worldborder/'''
# Поместить '''WorldBorder.jar''' в папку '''plugins/''' на сервере.
# Перезапустить сервер.

== Использование ==
Для настройки прав доступа нужно отредактировать файл permissions.yml по адресу plugins/PermissionsEx. Это можно сделать с помощью любого текстового редактора, но для удобности рекомендуется использовать [http://notepad-plus-plus.org Notepad++]<br />
Открыв его и опускаемся до '''admins''':<br />
 groups:
  default:
    default: true
    permissions:
    - modifyworld.*
  admins: 
    default: false 
    inheritance: 
    - default
    permissions: 
    - '*'

Ниже '''permissions''' вам следует прописать права доступа для администраторов, '''worldborder.*'''.
Пример:

 groups:
  default:
    default: true
    permissions:
    - modifyworld.*
  admins: 
    default: false 
    inheritance: 
    - default
    permissions: 
    - worldborder.*

== Команды и права ==

С помощью следующих команд вы можете управлять WorldBorder через консоль или игровой чат.
* '''/wb''' [необязательный параметр] <требуемый параметр>
* '''/wb''' - Посмотреть список доступных команд плагина.
* '''/wb set <радиус>''' - Установить границы мира в заданном радиусе с центром на вас.
* '''/wb [название_мира] set <радиус> <x> <z>''' - Установить границы указанного мира в заданном радиусе с центром в координатах X и Z.
* '''/wb [название_мира] radius <радиус>''' - Изменить радиус границы для указанного мира, при этом мир уже должен иметь установленные границы. Координаты центра при этом не меняются.
* '''/wb [название_мира] clear''' - Удалить границу для указанного мира.
* '''/wb clear all''' - Удалить границы всех имеющихся миров.
* '''/wb list''' - Показать информацию о границах во всех мирах.
* '''/wb shape square''' - Установить для всех миров тип границы "квадрат" (по умолчанию).
* '''/wb shape round''' - Установить для всех миров тип границы "круг".
* '''/wb knockback <расстояние>''' - Расстояние (в блоках) на которое будет отталкивать игрока при пересечении границы.
* '''/wb wshape [название_мира] <square|round>''' - Переопределить тип границы исключительно для указанного мира (square - квадрат, round - круг). Граница мира должна быть задана, координаты центра при этом не меняются.
* '''/wb getmsg''' - Показать сообщение, выводимое игроку при пересечении границы.
* '''/wb setmsg <сообщение>''' - Установить сообщение при пересечении границы.
* '''/wb delay <значение>''' - Количество серверных "тиков" между проверками пересечения границы. По умолчанию 4 тика (~200мс); каждый тик примерно равен 50 мс. (1 сек = 1000мс = 20 тиков).
* '''/wb reload''' - Перезагрузка файла конфигурации.
* '''/wb debug <on|off>''' - Включение или выключение режима отладки.
* '''/wb [мир] fill <частота> <отступ>''' - сгенерировать все недостающие куски карты в пределах границ мира. Стандартное значение частоты - 20, отступа - 176.
* '''/wb [мир] trim <частота> <отступ>''' - обрезать куски карты, расположенные за пределами границ карты. Стандартное значение частоты - 5000, отступа - 192.

=== Заметки ===
# '''/wb''' и '''/wborder''' - взаимозаменяемые команды и могут использоваться по желанию или в случаях, когда одна из команд занята другим плагином. В серверной консоли, конечно же, команда пишется без /.
# Если вы не находитесь в нужном мире, вы должны указывать его в командах, иначе границы установятся для текущего мира. В серверной консоли указание мира необходимо всегда.
# '''<радиус>''' и '''<значение>''' должны быть целыми числами, <x>, <z> и <расстояние> могут быть десятичной дробью (хотя вряд ли это нужно).
# Радиус границы - это расстояние от центра до края границы в каждом направлении, т.е. радиус 300 покроет область 600х600.

=== Примеры ===
* '''/wb set 1000''' - Устанавливает границу радиусом 1000 блоков с центром в вашем текущем местоположении.
* '''/wb netherworld set 250 -12.5 47.3''' - Устанавливает границу в мире "netherworld" радиусом 250 с центром в координатах -12.5 (X) и 47.3 (Z).
* '''/wb shape round''' - Устанавливает форму границы "круг" для всех миров.
* '''/wb wshape round''' - Устанавливает форму границы "круг" для текущего мира (того, в котором вы находитесь), не оказывая влияния на остальные миры.

=== Служебные ===
{| class="wikitable" width="100%" border="1"
|-
! width="20%" | Команда
! width="15%" | Permission 
! width="65%" | Описание
|-
|/wb || worldborder.help ||| Список доступных команд плагина.
|-
|/wb set <радиус> <br /> /wb [название_мира] set <радиус> <x> <z> || worldborder.set ||| Установить границы указанного мира в заданном радиусе с центром в координатах X и Z.
|-
|/wb [название_мира] radius <радиус> || worldborder.radius ||| Изменить радиус границы для указанного мира, при этом мир уже должен иметь установленные границы. Координаты центра при этом не меняются.
|-
|/wb [название_мира] clear <br /> /wb clear all  || worldborder.clear ||| Удаление границ.
|-
|/wb list || worldborder.list ||| Показать информацию о границах во всех мирах.
|-
|/wb shape square <br /> /wb shape round || worldborder.shape ||| Установить для всех миров тип границы квадрат или круг.
|-
|/wb knockback <расстояние> || worldborder.knockback ||| Расстояние (в блоках) на которое будет отталкиватся игрок при пересечении границы.
|-         
|/wb wshape [название_мира] <square или round> || worldborder.wshape ||| Переопределить тип границы исключительно для указанного мира (square - квадрат, round - круг). Граница мира должна быть задана, координаты центра при этом не меняются.
|-
|/pex dump <backend> <filename> || permissions.manage.dump ||| Создает дамп пользователей и групп в выбранный формат <backend> в файл <filename>
|-         
|/wb getmsg || worldborder.getmsg ||| Показать сообщение, выводимое игроку при пересечении границы.
|-         
|/wb setmsg <сообщение> || worldborder.setmsg ||| Установить сообщение при пересечении границы.
|-         
|/wb delay <значение> || worldborder.delay ||| Количество серверных "тиков" между проверками пересечения границы. По умолчанию 4 тика (~200мс); каждый тик примерно равен 50 мс. (1 сек = 1000мс = 20 тиков).
|-         
|/wb reload || worldborder.reload ||| Перезагрузка файла конфигурации.
|-         
|/wb debug <on или off> || worldborder.debug ||| Включение или выключение режима отладки.
|-
|}

== Дополнительная информация ==

Границы нельзя задать сразу для всех миров, вы должны отдельно задать границы для каждого мира в котором вы хотите их установить, для этого не обязательно находится непосредственно в нужном мире нём. Также вы можете задать границы для несуществующих миров - в данном случае вы увидите предупреждение, но параметры границ будут сохранены и применяться, если такой мир будет создан в будущем.<br />
При использовании плагина Permissions вы можете указать разрешение worldborder.* игроку или группе, что даст полный доступ ко всем командам. Если Permissions не используется, доступ к командам имеют игроки, перечисленные в op.txt.<br />
Любое изменение конфигурации при использовании внутриигровых команд автоматически сохраняется в файл настроек. Т.к. все настраиваемые параметры доступны из игровой (или серверной) консоли, вам совершенно не обязательно возиться с файлом настроек плагина (config.yml) в редакторе.<br />
Форма границы мира по умолчанию - "квадрат". С такой установкой плагин практически не оказывает влияния на быстродействие сервера, т.к. выполняет очень мало вычислений. "Круг" - более требовательная к вычислительным ресурсам установка, однако тоже не сильно нагружающая сервер из-за очень хорошо проработанного алгоритма.<br />