Softer: Новая страница: «'''PermissionsEX (PEX)''' - плагин для Bukkit, который позволяет легко разграничивать полномочия игр…»

2013-02-03T18:09:24Z

Новая страница: «'''PermissionsEX (PEX)''' - плагин для Bukkit, который позволяет легко разграничивать полномочия игр…»

Новая страница

'''PermissionsEX (PEX)''' - плагин для [[Bukkit]], который позволяет легко разграничивать полномочия игроков на сервере. Имеет встроенные дополнения [https://github.com/PEXPlugins/PermissionsEx/wiki/Modifyworld Modifyworld], которое дает возможность определять что игроки могут или не могут изменять в игровом мире, а также [[PermissionsEX/Chat Manager|ChatManager]] с помощью которого можно разделить чат на локальный и глобальный, раскрасить ники игроков и добавить к ним префиксы и суффиксы.

== Установка ==
# Скачать последнюю версию плагина: '''[http://dev.bukkit.org/server-mods/permissionsex ссылка]'''
# Поместить '''PermissionsEX.jar, Modifyworld.jar, ChatManager.jar''' в папку '''plugins/''' на сервере.
# Перезапустить сервер.

== Использование ==
Для распределения прав игрокам нужно отредактировать файл permissions.yml по адресу plugins/PermissionsEx. Это можно сделать с помощью любого текстового редактора, но для удобности рекомендуется использовать [http://notepad-plus-plus.org Notepad++] 
Открыв его мы увидим: 
groups:
default:
default: true
permissions:
- modifyworld.*
Значение этих строк следующее: 
'''groups:''' - указывает, что ниже будут идти группы и их права. 
'''default:''' - название группы, куда попадают все только что зашедшие на сервер игроки, если они не прописаны в других группах. Вы можете менять это название на какое захотите. 
'''default:''' true - параметр, который задаёт группу, как группу по-умолчанию. То есть, все права этой группы будет иметь любой игрок, для которого не определены другие группы и/или исключения. 
'''permissions:''' - все, что идёт ниже, это и есть сами "права" для группы, сюда нужно прописывать permissions от различных плагинов установленных на вашем сервере. Значение ''null'' означает, что у группы/игрока нет никаких прав. 
'''- modifyworld.*''' - возможность "модифицировать" мир. Если Вы не намерены конкретно определять, что игроки могут или не могут изменять в игровом мире, то это право лучше оставить как есть, а если намеренны, то смотрите в [https://github.com/PEXPlugins/PermissionsEx/wiki/Modifyworld Modifyworld]. 

Рассмотрим как мы можем отредактировать данный файл: 
groups:
default:
default: true
permissions:
- modifyworld.*
Admins:
default: false
inheritance:
- default
permissions:
- '*'
users:
BigBoss:
group:
- Admins
options:
rank: '1'
permissions:

Здесь мы добавили новую группу '''Admins''', а также права для отдельного игрока '''BigBoss:'''. 
'''default:''' false - означает, что данная группа '''не является''' группой по-умолчанию. 
'''inheritance:''' - параметр, с помощью которого можно установить наследственность прав определённой группы, в данном случае - это группа '''default'''. Это значит, что Вам не придётся еще раз прописывать права группы '''default''' для группы '''Admins'''. 
Звездочка ('*') означает, что у группы/игрока есть абсолютно все права на все плагины, установленные на сервере. 
'''user:''' - означает, что ниже идут права отдельных игроков. 
'''BigBoss:''' - имя игрока для которого настраиваются отдельные права. 
'''group: Admins''' - указывает на то, что игрок входит в группу '''Admins''' 
'''rank:''' - [[PermissionsEX/Ранг|ранг]] игрока. 

Если Вы хотите раскрасить ники игроков и добавить к ним префиксы и суффиксы то нужно включить и настроить в permissions.yml [[PermissionsEX/Chat Manager|Chat Manager]].

'''Важно!''' В YAML нужно чётко соблюдать последовательность, один лишний пробел - и параметр работать не будет. Поэтому для проверки permissions.yml рекомендуется использовать [http://yaml-online-parser.appspot.com этот] сайт. Там в левое окошко нужно вставить ваш код из permissions.yml, и если в правом окне не выдаст ошибок, то код написан правильно и он будет работать, если будут ошибки, то оно выдаст номер забракованной строки.

== Команды и права ==
С помощью следующих команд вы можете управлять PEX прямо через консоль или игровой чат, не редактируя файл permissions.yml
*Добавление префиксов и суффиксов будет работать только если включен [[PermissionsEX/Chat Manager|Chat Manager]].
*Значение параметров: <такой> параметр обязателен для указания; [такой] параметр - опциональный.
*Параметр [world] позволяет локализировать действие команды в определенном мире.
*Там где упоминается единственное/множественное можно перечислять параметры через запятую.

=== Служебные ===
{| class="wikitable" width="100%" border="1"
|-
! width="30%" | Команда
! width="30%" | Permission
! width="40%" | Описание
|-
|/pex || permissions.manage ||| Показывает помощь по PEX
|-
|/pex toggle debug || permissions.manage ||| Вкл./откл. режим отладки (создает много отладочной информации в server.log)
|-
|/pex user <user> check <permission> || permissions.manage.<user> ||| Проверить право <permission> игрока <user>
|-
|/pex reload || permissions.manage.reload ||| Перезагружает плагин
|-
|/pex config <node> [value] || permissions.manage.config ||| Выводит значение <node> из конфигурации PEX. Дополнительно можно ввести [value] чтобы задать новое значения для параметра.
|-
|/pex backend || permissions.manage.backend ||| Вывести используемые на данный момент бэкенды.
|-
|/pex backend <backend> || permissions.manage.backend ||| Change the permissions backend on-the-fly (Use with caution!) Note that this will only change the backend on-the-fly, it will not save the change in the config file, nor will it convert anything. This is for testing only.)
|-
|/pex hierarchy || permissions.manage.users ||| Показывает полную иерархию игроков/групп
|-
|/pex dump <backend> <filename> || permissions.manage.dump ||| Создает дамп пользователей и групп в выбранный формат <backend> в файл <filename>
|}

=== Управление правами игроков ===
{| class="wikitable" width="100%" border="1"
|-
! width="30%" | Команда
! width="30%" | Permission
! width="40%" | Описание
|-
|/pex users || permissions.manage.users ||| Показывает список всех записанных пользователей.
|-
|/pex user <user> [world] || permissions.manage.users ||| Показывает права игрока <user>
|-
|/pex user <user> prefix [newprefix] [world] || permissions.manage.users.prefix.<user> ||| Установить игроку <user> префикс [newprefix]
|-
|/pex user <user> suffix [newsuffix] [world] || permissions.manage.users.suffix.<user> ||| Установить игроку <user> суффикс [newsuffix]
|-
|/pex user <user> delete || permissions.manage.users.<user> ||| Удалить игрока <user> из бэкенда, используемого на данный момент.
|-
|/pex user <user> add <permission> [world] || permissions.manage.users.permissions.<user> ||| Дать право <permission> игроку <user>
|-
|/pex user <user> remove <permission> [world] || permissions.manage.users.permissions.<user> ||| Забрать право <permission> у игрока <user>
|-
|/pex user <user> timed add <permission> [lifetime] [world] || permissions.manage.users.permissions.timed.<user> ||| Дать временное право <permission> игроку <user> на время [lifetime] (в сек.)
|-
|/pex user <user> timed remove <permission> || permissions.manage.users.permissions.timed.<user> ||| Забрать у игрока <user> временное право <permission>
|-
|/pex user <user> set <option> <value> [world] || permissions.manage.users.permissions.<user> ||| Выставить опцию <option> на значение <value>. Выставите значение на "" (две двойные скобки) если вы хотите убрать опцию <option>
|}

=== Управление правами групп игроков ===
{| class="wikitable" width="100%" border="1"
|-
! width="30%" | Команда
! width="30%" | Permission
! width="40%" | Описание
|-
|/pex user <user> group list [world] || permissions.manage.membership.<user> ||| Показать список групп в которых состоит игрок <user>
|-
|/pex user <user> group add <group> [world] [lifetime] || permissions.manage.membership.<user> ||| Добавить игрока <user> в группу <group>
|-
|/pex user <user> group set <group> [world] || permissions.manage.membership.<user> ||| Установить группу <group> для игрока <user> (удалит его из остальных групп)
|-
|/pex user <user> group remove <group> [world] || permissions.manage.membership.<user> ||| Удалить игрока <user> из группы <group>
|}

=== Управление правами групп ===
{| class="wikitable" width="100%" border="1"
|-
! width="30%" | Команда
! width="30%" | Permission
! width="40%" | Описание
|-
|/pex groups || permissions.manage.groups.list ||| Показать все зарегистрированные группы
|-
|/pex default group [world] || permissions.manage.groups.inheritance ||| Показать группу по-умолчанию
|-
|/pex set default group <group> [world] || permissions.manage.groups.inheritance ||| Установить группу <group>, как группу по-умолчанию
|-
|/pex group <group> prefix [newprefix] [world] || permissions.manage.groups.prefix.<group> ||| Установить группе <group> префикс [newprefix]
|-
|/pex group <group> suffix [newsuffix] [world] || permissions.manage.groups.suffix.<group> ||| Установить группе <group> суффикс [newsuffix]
|-
|/pex group <group> create [parents] || permissions.manage.groups.create.<group> ||| Создать группу <group> и если нужно установить для нее родительскую группу/группы [parents]
|-
|/pex group <group> delete || permissions.manage.groups.remove.<group> ||| Удалить группу <group>
|-
|/pex group <group> parents [world] || permissions.manage.groups.inheritance.<group> ||| Список родительских групп для группы <group>
|-
|/pex group <group> parents set <parents> [world]|| permissions.manage.groups.inheritance.<group> ||| Установить группе <group> родительскую группу/группы <parents>
|-
|/pex group <group> || permissions.manage.groups.permissions.<group> ||| Показать все права группы <group>
|-
|/pex group <group> add <permission> [world] || permissions.manage.groups.permissions.<group> ||| Дать право <permission> группе <group>
|-
|/pex group <group> remove <permission> [world] || permissions.manage.groups.permissions.<group> ||| Забрать право <permission> у группы <group>
|-
|/pex group <group> timed add <permission> [lifetime] [world] || permissions.manage.groups.permissions.timed.<group> ||| Дать временное право <permission> группе <group> на время [lifetime] (в сек.)
|-
|/pex group <group> timed remove <permission> [world] || permissions.manage.groups.permissions.timed.<group> ||| Забрать временное право <permission> у группы <group>
|-
|/pex group <group> set <option> <value> [world] || permissions.manage.groups.permissions.<group> ||| Выставить опцию <option> значение <value> для <group>. Выставите значение на "" (две двойные кавычки) если вы хотите убрать опцию <option>
|-
|/pex group <group> weight [value] || permissions.manage.groups.weight.<group> ||| Показать/установить вес группы
|}

=== Управление игроками в группах ===
{| class="wikitable" width="100%" border="1"
|-
! width="30%" | Команда
! width="30%" | Permission
! width="40%" | Описание
|-
|/pex group <group> users || permissions.manage.memebership.<group> ||| Показать всех игроков в группе <group>
|-
|/pex group <group> user add <user> [world] || permissions.manage.memebership.<group> ||| Добавить игрока/игроков <user> в группу <group>
|-
|/pex group <group> user remove <user> [world] || permissions.manage.memebership.<group> ||| Удалить игрока/игроков из группы <group>
|-
|/pex promote <user> <ladder> || permissions.user.promote.<ladder> ||| Повысить игрока <user> в высшую группу <ladder>
|-
|/pex demote <user> <ladder> || permissions.user.demote.<ladder> ||| Понизить игрока <user> в низшую группу <ladder>
|-
|}

=== Управление наследственностью миров ===
{| class="wikitable" width="100%" border="1"
|-
! width="30%" | Команда
! width="30%" | Permission
! width="40%" | Описание
|-
|/pex worlds || permissions.manage.worlds ||| Показать загруженные миры
|-
|/pex world <world> || permissions.manage.worlds ||| Показать информацию о наследственности мира <world>
|-
|/pex world <world> inherit <parentWorlds> || permissions.manage.worlds.inheritance ||| Установить родительский мир/миры <parentWorlds> для мира <world>
|}

== Ссылки ==
[http://dev.bukkit.org/server-mods/permissionsex/ PermissionsEX на BukkitDev] 
[https://github.com/PEXPlugins/PermissionsEx/wiki PermissionsEX в викиeng] 

[[Категория:Bukkit]]

PermissionsEX - История изменений

Softer: Новая страница: «'''PermissionsEX (PEX)''' - плагин для Bukkit, который позволяет легко разграничивать полномочия игр…»