[ADMN/DEV] PermissionsEx (PEX) v1.19.2 - Tomorrow is Today! [1.2.5-R2.0]

Version: 1.19.2

PLEASE USE BUKKIT-DEV FORUM FOR DISCUSSION/HELP
http://dev.bukkit.org/server-mods/permissionsex/
THANKS IN ADVANCE.

PermissionsEx (PEX) is a new permissions plugin, based on Permissions ideas and supports all of its features. But PEX is more! It offers different backends, powerful ingame management, fine grained restrictions for world modification.



Current features

1. Bukkit Permissions (SuperPerms) compatible.
2. Several backend support. Currently bundled backends is File (YAML) and SQL (MySQL, SQLite). Also it's possible to add your own.
3. YAML backend, with new, fully rethinked, config schema. Now all user, groups and their permissions are stored in one file - permission.yml. BTW file name is adjustable too.
4. SQL backend, most delicious. Currently MySQL and SQLite supported, but other DB (like Postgre) are possible too. PEX deploys the DB scheme (tables and initial data) automatically. This means, that you only need to provide data on how to connect to the db, everything else PEX will handle by itself.
5. Flexible architecture and API - you can change a lot programmatically.
6. Compatibility layer with TheYeti's Permissions (2.7.4) (as a separate part of the plugin). In most cases plugins, which use Permissions, will alsowork with PEX also.
7. Rich chat/console command interface. You can do almost everything ingame. Command list below.
8. Modifyworld - Embedded restrictions mechanism (we call it "modifyworld"), which provides the possibility to control players abilities, such as destroying/placing blocks, riding carts/boats or even getting spotted by mobs and much more. Disabled by default.
9. Multigroup inheritance. User, as well as Group, can be member of several groups. And inherit their permissions, options and prefix/suffix.
10. Permissions based upon Regular Expressions. This mean you can use regular expressions. Example: modifyworld.blocks.(destroy|place).(3|12) - this permission allow place or destroy only sand (12) or dirt (3) blocks. There is still limitation on dot usage in your regexps - dots are escaped by default.
11. Multiworld permissions. Just don't specify world and permission would work in any world.
12. Multiworld inheritance. You can inherit different groups in different worlds.
13. Easy migration from Permissions 2.x. Converter for both YAML and SQL are embedded into PermissionsCompat. Just use simple instruction.
14. Perfomance friendly. Low-level caching helps alot when you have 100+ online users
15. Promotional/Demotional system. You can assign ranks to groups and promote/demote users to higher/lower ranked group.
16. World-inheritance - permissions/option of one world can be inherited by another world.
17. Timed Permissions - you can give user permission only for some amount of time.
18. Chat Manager - small chat plugin, bundled with PEX. With prefixes/suffiex and colors. Check wiki for more details.

• Q: How to make permission for certain world?
• A: There is optional [world] parameter at the end of corresponding commands.
  Example: /pex user t3hk0d3 add "permission.node" Nether
• Q: How to make my prefixes being displayed in chat?
• A: You need Chat Plugin to do that. There is several plugins to do that: iChat, HeroChat.
  Since PEX 1.13 have own chat plugin called ChatManager and bundled with PEX .
  Look corresponding wiki section for details.

Code:

users:
    t3hk0d3:
        group: default
        permissions:
        - permissions.*
        worlds:
            world:
                permissions:
                - farming.food
                group:
                - peasant
                prefix: '&3[LOWLIFE]&f'
            nether:
                permissions:
                - pwn.noobs
                group:
                - devil
                prefix: '&5[DEVIL MUHAHA]&f'
groups:
    default:
        default: true
        permissions:
        - -modifyworld.blocks.place.tnt
        - modifyworld.*
    admins:
        inheritance:
        - default
        permissions:
        - '*'
        options:
            test.test: '100500'
        worlds:
            nether:
                permissions:
                - nocheat.fly
                prefix: '&7[ADMIN FROM HELL]'
    testers:
        inheritance:
        - admins
        options:
            test.test: '9000'
worlds:
    nether:
        inheritance:
        - world

CHECK YOUR permissions.yml HERE BEFORE POSTING "OMG MY PERMISSIONS WONT WORK"

Documentation
Wiki

Basic setup tutorial (Thanks to @lycano)

Nice tutorial made by Bennetman


Download
Stable version

Development version (mostly stable) - always lastest dev build.

Sources
https://github.com/PEXPlugins

Builds
http://webbukkit.org:8080/

Maven Repository
http://repo.tehkode.ru/browse/ru.tehkode

IRC
Join us on #permissionsex, irc.esper.net. Feel free to ask any related questions.

Tools !NEW!
Pex Auto-Setup Tool - MySQL and FlatFile !


Changelog

v.1.19.2
New modifyworld permissions
Some bugfixes
v.1.19.1
Bugfix release
v1.19
Bukkit R6 compatible.
Several bugfixes!
Permissions now case-insensetive.
v1.18
Users logging and cleanup feature.
Non-inheriting nodes feature.
Several Bugfixes.
PermissionsCompat is finally remove from default bundle.
v1.17
User/group specific management permissions (permissions.manage.group.Admin)
Fixed some superperms compatibility issues
Fixed several bugs
v1.16
SuperPerms compatbility bridge were rewritten - no lags anymore and now with debug output (now you can view superperms checks).
Numerous of bugs were fixed (Thanks you guys for reporting them)
Modifyworld were improved (modifyworld.item.use)
v1.15
Compatiblity for 1317+
Fixed perfomance issues with SuperPerms (if you still experience they try to disable "raw-permissions" in config.yml)
Fixed issue with prefix inheritance
v1.14
Improved Options mechanism.
Auto saving new users feature, disabled by default.
SuperPerms bridge improved - more permissions supported by wildcards.
File backend dumping now fully functional. SQL dumping is still bogus (do not dump world-specific inheritance and prefixes), will be fixed soon.
Many bugfixes and minor improvements.
v1.13
Superperms (BukkitPerms) support
Multiworld inheritance and prefixes/suffixes
Groups weighting
ChatManager, chat plugin which bundled with PEX.
Modifyworld now separate plugin, but still bundled with PEX.
API changed slightly, CustomEvents (PermissionsEntityEvent, PermissionsSystemEvent) introduced.
Many lesser improvements and tons of bugfixes.
v1.12
API get slightly improved
Ranking ladders.
User/group name case-insensetivity.
World-inheritance.
Timed permissions.
Modifyworld rules are get improved.
Tons of minor improvements and bugfixes.
v1.11
Many bugfixes and improvements.
MySQL connection stability improved - reconnection mechanism.
v1.10
Promotional/Demotional system.
Perfomance improvement, with new low-level caching system (thx @Joy)
Modifyworld improved.
Many lesser improvements and bugfixes.
v1.06
New p2compat backend, for easy migration from Permissions 2.x to PEX.
v1.05
Users/Groups dumping (pex dump <backend> <file>).
New commands pex promote/demote. Actually this is just aliases for "pex user group set/remove"
Few bugfixes.
v1.04
Players now can be informed about changes (has been added to group, changed permission/option). Disabled by default - set "permissions.informplayers.changes" to "true"
Config node "permissions.verbose", which responsible for player informing about modifyworld restrictions has been renamed to "permissions.infromplayers.modifyworld".
Autocomplete has been improved.
New command "pex config <node> [value]". This command help to manipulate configuration file (config.yml) from console/chat interface.
Many bugfixes.
v1.03
Autocomplete for users (taken from registred users and online users) and groups names.
New command for user removing (pex user <user> delete)
Fixed several nasty bugs. Thanks for bugreports!
v1.02
Compatibility layer loading order issue fixed. Now most of plugins should work.
Tested with new CB 803 build.
v1.01
Regular expression permissions support.
Newer permissions now added above (bugfix).
Several bugfixes.
v1.00
Initial public release.