Туториал Полный туториал по PermissionsEX

PermissionsEX - Этот плагин позволяет легко разграничить права игроков на вашем сервере. Является самым популярным на данный момент средством управления разрешениями.Плагин можно скачать здесь (Последняя версия).В пакете находится три плагина:
ChatManager - менеджер чата (Префиксы, цвет).
Modifyworld - модификация мира (Альтернатива: EssentialsAntiBuild).
и, собственно, сам «PermissionsEx.jar».
Кладём «PermissionsEx.jar» в папку «plugins» вашего сервера. Запускаем сервер. Ждем минуты 2 (Для создания настроек плагина) и останавливаем.
Смотрим в папку «plugins». Должна создастся новая папка «PermissionsEx».
Внутри папки находятся два файла:
config.yml - конфигурация плагина.
permissions.yml - собственно список разрешений.

Начнём с «config.yml». Открываем его любым текстовым редактором.
Настоятельно рекомендую Notepad++
Можете этот раздел про конфиг пропустить, потому что по умолчанию и так всё работает, как положено.
Внутри конфига видим:

Код:

permissions:
  backend: file
  backends:
    file:
      file: permissions.yml
  superperms: {}

backend - метод хранения (file или sql).
backends - содержание зависит от секции «backend»
Для «backend: file»:

Код:

backends:
    file:
      file: permissions.yml

«file: permissions.yml» - название файла. Можно также указать здесь путь относительно самой папки плагина.
Например: file: ../../permissions.yml
В этом случае будет использоваться «permissions.yml», который лежит в корне сервера. Соответственно, из папки «plugins/PermissionsEx» файл «permissions.yml» можно удалить.

Для «backend: sql» вариантов секции «backends» два: mysql или sqlite.
Вариант «mysql»:

Код:

backends:
  sql:
    driver: mysql
    uri: mysql://localhost/БАЗА_ДАННЫХ
    user: ИМЯ_ПОЛЬЗОВАТЕЛЯ_БАЗЫ_ДАННЫХ
    password: ПАРОЛЬ_БАЗЫ_ДАННЫХ

Для варианта «mysql» есть ещё одна фича - алиасы. Проще говоря, можно изменить имена таблиц в базе данных.
Выглядит вот так:

Код:

backends:
  sql:
    driver: mysql
    uri: mysql://localhost/БАЗА_ДАННЫХ
    user: ИМЯ_ПОЛЬЗОВАТЕЛЯ_БАЗЫ_ДАННЫХ
    password: ПАРОЛЬ_БАЗЫ_ДАННЫХ
    aliases:
      permissions: pex_permissions
      permissions_inheritance: pex_inheritance
      permissions_entity: pex_entity

Для варианта «sqlite» секция «backends» выглядит вот так:

Код:

permissions:
  backend: sql
  backends:
    sql:
      driver: sqlite
      uri: sqlite:БАЗА_ДАННЫХ

Файл БАЗА_ДАННЫХ будет создан в КОРНЕ сервера. Рекомендую добавить расширение «.db», чтобы не путаться (на работе плагина никак не сказывается).
Поля «user» и «password» можно не указывать. Их наличие также ничем не мешает.

По методам хранения всё.

Есть ещё дополнительные параметры:

allowOps: true|false - Для ОПов доступны все разрешения, если установлено в «true».
createUserRecords: true|false - Создавать или нет запись для каждого игрока. Имейте в виду, если поставить «true», то (если у вас сервер с высоким онлайном) файл разрешений или база данных раздуется до неприличных размеров. Лучше не включайте эту опцию, если нет на это крайней необходимости.
Все опции конфига здесь.

Теперь рассмотрим собственно «permissions.yml» (предполагаем, что метод хранения «file»).
Опять же открываем его текстовым редактором.
Внутри вот такая штука (предполагаем, что плагин только что установили):

Код:

groups:
  default:
    default: true
    permissions:
    - modifyworld.*

Рассмотрим поподробнее...

groups: - Указывает, что сейчас будут перечисляться группы. Группа - это набор разрешений, если попроще.
default:- Название группы. По умолчанию - «default». Можно изменить на «User», например. Имейте в виду, что при использовании названий групп учитывается регистр. То есть «User» не то же самое, что «user».
default:true|false - «true» означает, что эта группа используется по умолчанию, то есть в неё будут попадать все игроки, для которых не определены иные группы разрешений, например новички или разжалованные игроки. У вас должна быть хотя бы одна группа со значением «true» - ни больше, ни меньше.
permissions: - собственно список разрешений.

Начнём кодить...

Меняем название группы на «User» (ну я так вижу), а также «- modifyworld.*» на «- essentials.build.*» (разрешение плагина «EssentialsAntiBuild»).
Результат:

Код:

groups:
  User:
    default: true
    permissions:
    - essentials.build.*

Уже можно попытаться запустить сервер. Игроки смогут ломать и ставить блоки.

Ещё модифицируем... Предполагаем, что пакет «Essentials» установлен. То есть «Essentials.jar», «EssentialsAntiBuild.jar» и «EssentialsSpawn.jar» (про их настройку поговорим потом).
Добавим возможность
телепорта на спавн - «- essentials.spawn»,
устанавливать точки дом - «- essentials.sethome» и «- essentials.sethome.multiple.default»,
удалять точку дома - «- essentials.delhome»,
получить кит старт - «- essentials.kit» и «- essentials.kits.start»,
а также получить приветствие при входе на сервер - «- essentials.motd».
Результат:

Код:

groups:
  User:
    default: true
    permissions:
    - essentials.build.*
    - essentials.spawn
    - essentials.sethome
    - essentials.sethome.multiple.default
    - essentials.delhome
    - essentials.kit
    - essentials.kits.start
    - essentials.motd

Теперь надо кое-что запретить...

Запретим яйца призыва:

(Данное действие так-же можно провести с помощью LokiBlocker)
взаимодейстие - «- -essentials.build.interact.383:*»
и запретим их подбирать - «- -essentials.build.pickup.383:*»
Также запретим бедрок (он же админиум):
ставить - «- -essentials.build.place.7:*»,
ломать - «- -essentials.build.break.7:*»
и подбирать - «- -essentials.build.pickup.7:*»
Результат:

Код:

groups:
  User:
    default: true
    permissions:
    - -essentials.build.interact.383:*
    - -essentials.build.pickup.383:*
    - -essentials.build.place.7:*
    - -essentials.build.break.7:*
    - -essentials.build.pickup.7:*
    - essentials.build.*
    - essentials.spawn
    - essentials.sethome
    - essentials.sethome.multiple.default
    - essentials.delhome
    - essentials.kit
    - essentials.kits.start
    - essentials.motd

Как можно заметить, для запрета нужно поставить перед разрешением знак «-»
Обращаю ваше внимание, что важен порядок записи разрешений. Сначала частные разрешения, потом общие. То есть, посмотрите на «- essentials.build.*». Это разрешение стоит после запретов. Также следует поступить в случае, если нужно разрешить только отдельные вещи. Например, плагин CraftBook требует явного запрета IC (по крайней мере, в ранних версиях - сейчас не знаю), поэтому для него разрешения будут выглядеть так:

Код:

groups:
  User:
    default: true
    permissions:
    - -essentials.build.interact.383:*
    - -essentials.build.pickup.383:*
    - -essentials.build.place.7:*
    - -essentials.build.break.7:*
    - -essentials.build.pickup.7:*
    - essentials.build.*
    - essentials.spawn
    - essentials.sethome
    - essentials.sethome.multiple.default
    - essentials.delhome
    - essentials.kit
    - essentials.kits.start
    - essentials.motd
    - craftbook.mech.bridge
    - craftbook.mech.bridge.use
    - craftbook.mech.cook
    - craftbook.mech.door
    - craftbook.mech.door.use
    - craftbook.mech.elevator
    - craftbook.mech.elevator.use
    - craftbook.mech.gate
    - craftbook.mech.gate.use
    - craftbook.mech.hiddenswitch
    - craftbook.mech.hiddenswitch.use
    - craftbook.mech.light-switch
    - craftbook.mech.teleporter.use
    - craftbook.mech.chair.use
    - -craftbook.*

То есть, мы разрешили только то, что хотим. Все остальные вещи запрещены. Удобно, чтобы не копаться в куче разрешений или запретов.

Теперь нужно добавить дополнительные группы. Установим плагин «Ultrabans» (здесь его установка тоже рассматриваться не будет) и создадим группу для модеров.
Добавим
кик - «- ultraban.kick»,
предупреждение - «- ultraban.warn»,
проверку на бан по нику - «- ultraban.checkban»,
проверку на бан по IP - «- ultraban.checkip»,
мут - «- essentials.mute»,
возможность телепорта - «- essentials.tp», «- essentials.tp.others», «- essentials.tphere»
и полёт - «- essentials.fly».
Что получилось:

Код:

groups:
  User:
    default: true
    permissions:
    - -essentials.build.interact.383:*
    - -essentials.build.pickup.383:*
    - -essentials.build.place.7:*
    - -essentials.build.break.7:*
    - -essentials.build.pickup.7:*
    - essentials.build.*
    - essentials.spawn
    - essentials.sethome
    - essentials.sethome.multiple.default
    - essentials.delhome
    - essentials.kit
    - essentials.kits.start
    - essentials.motd
  Moder:
    default: false
    inheritance:
    - User
    permissions:
    - ultraban.kick
    - ultraban.warn
    - ultraban.checkban
    - ultraban.checkip
    - essentials.mute
    - essentials.tp
    - essentials.tp.others
    - essentials.tphere
    - essentials.fly

Как уже видно, добавлена группа «Moder». Обратите внимание, что строка «default:» установлена в «false». Не забывайте про неё. Также добавлена строка «inheritance:». Она означает, от каких групп будут наследоваться разрешения. В данном случае у группы «Moder», кроме явно прописанных разрешений, также есть разрешения от группы «User». Наследование может быть от нескольких групп, Например, вот так:

Код:

inheritance:
- User
- Group1
- Group2

Также эта строка может и вовсе отсутствовать.

 

Теперь создадим группу для админов. Им разрешим все

Код:

groups:
  User:
    default: true
    permissions:
    - -essentials.build.interact.383:*
    - -essentials.build.pickup.383:*
    - -essentials.build.place.7:*
    - -essentials.build.break.7:*
    - -essentials.build.pickup.7:*
    - essentials.build.*
    - essentials.spawn
    - essentials.sethome
    - essentials.sethome.multiple.default
    - essentials.delhome
    - essentials.kit
    - essentials.kits.start
    - essentials.motd
  Moder:
    default: false
    inheritance:
    - User
    permissions:
    - ultraban.kick
    - ultraban.warn
    - ultraban.checkban
    - ultraban.checkip
    - essentials.mute
    - essentials.tp
    - essentials.tp.others
    - essentials.tphere
    - essentials.fly
  Admin:
    default: false
    permissions:
    - '*'

Это самый простой вариант. Но есть некоторые грабли. Например, плагин «SetPankPex» в таком варианте для админа недоступен. Поэтому переделаем разрешения для каждого плагина отдельно:

Код:

groups:
  User:
    default: true
    permissions:
    - -essentials.build.interact.383:*
    - -essentials.build.pickup.383:*
    - -essentials.build.place.7:*
    - -essentials.build.break.7:*
    - -essentials.build.pickup.7:*
    - essentials.build.*
    - essentials.spawn
    - essentials.sethome
    - essentials.sethome.multiple.default
    - essentials.delhome
    - essentials.kit
    - essentials.kits.start
    - essentials.motd
  Moder:
    default: false
    inheritance:
    - User
    permissions:
    - ultraban.kick
    - ultraban.warn
    - ultraban.checkban
    - ultraban.checkip
    - essentials.mute
    - essentials.tp
    - essentials.tp.others
    - essentials.tphere
    - essentials.fly
  Admin:
    default: false
    permissions:
    - essentials.*
    - ultraban.*
    - permissions.*

Как-то так...

Теперь надо обозначить игроков в чате - кто есть кто. Сделаем это с помощью префиксов:

Код:

groups:
  User:
    default: true
    prefix: '[User]'
    permissions:
    - -essentials.build.interact.383:*
    - -essentials.build.pickup.383:*
    - -essentials.build.place.7:*
    - -essentials.build.break.7:*
    - -essentials.build.pickup.7:*
    - essentials.build.*
    - essentials.spawn
    - essentials.sethome
    - essentials.sethome.multiple.default
    - essentials.delhome
    - essentials.kit
    - essentials.kits.start
    - essentials.motd
  Moder:
    default: false
    prefix: '[Moder]'
    inheritance:
    - User
    permissions:
    - ultraban.kick
    - ultraban.warn
    - ultraban.checkban
    - ultraban.checkip
    - essentials.mute
    - essentials.tp
    - essentials.tp.others
    - essentials.tphere
    - essentials.fly
  Admin:
    default: false
    prefix: '[Admin]'
    permissions:
    - essentials.*
    - ultraban.*
    - permissions.*

Добавлен параметр «prefix». Этот параметр содержит что-то, что будет размещено перед ником игрока. То есть результат вот такой:
[User]Petya

Есть ещё параметр «suffix». Он размещает инфу после ника игрока:
[User]Petyasuffix

Вариант с суффиксом:

Код:

groups:
  User:
    default: true
    prefix: '[User]'
    suffix: '<просто игрок>'
    permissions:
    - -essentials.build.interact.383:*
    - -essentials.build.pickup.383:*
    - -essentials.build.place.7:*
    - -essentials.build.break.7:*
    - -essentials.build.pickup.7:*
    - essentials.build.*
    - essentials.spawn
    - essentials.sethome
    - essentials.sethome.multiple.default
    - essentials.delhome
    - essentials.kit
    - essentials.kits.start
    - essentials.motd
  Moder:
    default: false
    prefix: '[Moder]'
    suffix: '<просто модер>'
    inheritance:
    - User
    permissions:
    - ultraban.kick
    - ultraban.warn
    - ultraban.checkban
    - ultraban.checkip
    - essentials.mute
    - essentials.tp
    - essentials.tp.others
    - essentials.tphere
    - essentials.fly
  Admin:
    default: false
    prefix: '[Admin]'
    suffix: '<босс>'
    permissions:
    - essentials.*
    - ultraban.*
    - permissions.*

Результат в чате:
[User]Petya<просто игрок>

Обращаю ваше внимание: если у вас в «permissions.yml» есть русский текст, файл должен быть в кодировке UTF-8!

Также в префиксах и суффиксах можно использовать цветовые коды (стандартные для Minecraft)

Код:

&4 Red
&c Rose
&6 Gold
&e Yellow
&2 Green
&a Lightgreen
&b Lightblue
&3 Cyan
&1 Navy
&9 Blue
&d Lightpurple
&5 Purple
&f White
&7 Lightgray
&8 Gray
&0 Black

Пример (только для группы «User», остальные по аналогии):

Код:

groups:
  User:
    default: true
    prefix: '&d[User]'
    permissions:
    ...

[DOUBLEPOST=1374402194,1374402118][/DOUBLEPOST]Теперь в чате префикс [User] будет цветом «Lightpurple». И ник тоже. Переделаем ник в «Gold»:

Код:

groups:
  User:
    default: true
    prefix: '&d[User]&6'
    permissions:
    ...

Теперь vasya имеет золотой ник и пишет этим же цветом. Изменим ему цвет текста. Для этого используем suffix. Ничего не будем в него писать, а просто вставим туда цветовой код:

Код:

groups:
  User:
    default: true
    prefix: '&d[User]&6'
    suffix: '&9'
    permissions:
    ...

Теперь он пишет синим. Можно еще скобочки отдельным цветом зафигачить. Будет не чат, а новогодняя ёлка:

Код:

groups:
  User:
    default: true
    prefix: '&e[&dUser&e]&6'
    suffix: '&9'
    permissions:
    ...

С красотой закончили вроде. Теперь нужно рассмотреть, как раздавать права.

Первый способ:
Набрать их консоли (или из чата, если вы ОП или есть разрешение для команды «/pex»):
/pex user НИК group set ГРУППА
Обращаю ваше внимание, что ГРУППА должна быть написана так же, как и в «permissions.yml» - с соблюдением регистра. Иначе игрок будет включен в несуществующую группу, и, скорее всего, вообще ничего не сможет сделать - даже пожаловаться в чат на такую незадачу. Регистр ника игрока не имеет значения. Сам ник тоже необязательно должен существовать.

После этой команды откройте опять файл «permissions.yml» (это для наглядности). Вы увидите, что появилась новая секция «users:», в которой теперь записан ник игрока, для которого набиралась команда. Например, команда выглядела так «/pex user vasya group set Admin». Содержимое файла будет выглядеть вот так:

Код:

groups:
  User:
    default: true
    prefix: '[User]'
    permissions:
    - -essentials.build.interact.383:*
    - -essentials.build.pickup.383:*
    - -essentials.build.place.7:*
    - -essentials.build.break.7:*
    - -essentials.build.pickup.7:*
    - essentials.build.*
    - essentials.spawn
    - essentials.sethome
    - essentials.sethome.multiple.default
    - essentials.delhome
    - essentials.kit
    - essentials.kits.start
    - essentials.motd
  Moder:
    default: false
    prefix: '[Moder]'
    inheritance:
    - User
    permissions:
    - ultraban.kick
    - ultraban.warn
    - ultraban.checkban
    - ultraban.checkip
    - essentials.mute
    - essentials.tp
    - essentials.tp.others
    - essentials.tphere
    - essentials.fly
  Admin:
    default: false
    prefix: '[Admin]'
    permissions:
    - essentials.*
    - ultraban.*
    - permissions.*
users:
  vasya:
    group:
    - Admin

Команду можно и не набирать, а сразу вписать игрока в «permissions.yml». Если вы делаете это на работающем сервере, то после изменения «permissions.yml» наберите команду «/pex reload». Эта команда перечитает обновлённые разрешения.
Также в секцию «users:» можно дописывать разрешения и префиксы, точно так же, как и в секции «groups:». Например, мы хотим, чтобы vasya был админом, но не мог никому давать дополнительные права. В этом случае нужно написать вот так:

Код:

groups:
  User:
    default: true
    prefix: '[User]'
    permissions:
    - -essentials.build.interact.383:*
    - -essentials.build.pickup.383:*
    - -essentials.build.place.7:*
    - -essentials.build.break.7:*
    - -essentials.build.pickup.7:*
    - essentials.build.*
    - essentials.spawn
    - essentials.sethome
    - essentials.sethome.multiple.default
    - essentials.delhome
    - essentials.kit
    - essentials.kits.start
    - essentials.motd
  Moder:
    default: false
    prefix: '[Moder]'
    inheritance:
    - User
    permissions:
    - ultraban.kick
    - ultraban.warn
    - ultraban.checkban
    - ultraban.checkip
    - essentials.mute
    - essentials.tp
    - essentials.tp.others
    - essentials.tphere
    - essentials.fly
  Admin:
    default: false
    prefix: '[Admin]'
    permissions:
    - essentials.*
    - ultraban.*
    - permissions.*
users:
  vasya:
    group:
    - Admin
    permissions:
    - -permissions.*

Что-бы перевести уже существующий файл «permissions.yml» в таблицу базы данных вы должны поменять в файле «config.yml» backend: file (Если так и стоит, то не меняйте)
И пишите в чат или в консоль команду /pex dump sql permissions
Затем идете в папку PermissionsEX и ищите там файл permissions, ставите ему расширение sql
И заливаете в вашу базу данных!
Также можно изменить префикс индивидуально для каждого игрока. Аналогично тому методу что описан где-то сверху


Стоит заметить, что для изменения разрешений, групп или чего-то ещё необязательно редактировать «permissions.yml». Абсолютно все функции доступны с помощью команд этого плагина (допишу попозже).

 

Резерв #1

 

В общем то супер, но по-моему уже было...

 

Отлично. ))

 

А MySQL???

 

Далеко не полный. Нет описания разделения прав по мирам. Как дать одни права одному миру, и как дать другому - совсем другие.

 

Угу, мне вот, как программисту, очень интересно узнать струкуру базы данных PEX в MySQL.

 

очень благодарен за эту статью , вы одной статьёй дали ответ на все мои вопросы )) Спасибо вам огромное !!!

 

Зачем ты старые темы поднимаешь ?
Есть же более новые, хорошо документированые, вот хотя бы одна из них

 

Стоит отметить, что данная тема, в которой мы сейчас находимся, более понятна (лично для меня - вполне) и тут больше материала, сравнивая размеры тем.

 

Это простой пересказ той же википедии на свой лад, с парочкой примеров из которые итак там описаны, есть всего пару отсуплений которые не описаны в вики, за это плюшка ТС.

 

Других я не нашел , только эту , поэтому хочу поблагодарить автора за эту статью . Я не поднимаю тему , просто напросто благодарность . И та новая статья которую вы порекомендовали , не так хорошо объясняет как эта , поэтому на мой взгляд , статья этого автора получше .

 

Я говорю, что настраивать по примерам это всё примитивно и не как не увеличивает ваши знания, больше опыта вы получите если будите изучать вики отдельного плагина (можно и на русском, но советую на оф. вики смотреть) и настраивать его таким образом.

 

Я смотрел эту статью не для того что б настроить permission.yml , а для того что б узнать как заблокировать какую-то возможность , этим мне статья и помогла .[DOUBLEPOST=1403880993,1403869492][/DOUBLEPOST]как запретить какой либо предмет , в permission.yml , вроде всё правильно сделал, по примеру (но все равно нихрена на работает) , вот что я писал :
- -essentials.build.interact.257:* , вот этот запрет должен был подействовать на кирку . Прошу ответить мне что я не так делаю .

 

в этом то и проблема поднятия старых тем, ответа от автора обычно не поступает