Permissions
Permissions Support
Overview
ScrollingMenuSign supports all superperms-supporting plugins, including PermissionsBukkit, GroupManager, bPermissions and PermissionsEx.
The default permissions configuration (this applies if you're not using a permissions plugin, or haven't given any scrollingmenusign.X permission nodes to the player) allows basic menu usage for all players, and full plugin admin rights (creation/deletion etc. of menu & views) for op-level players.
The Easy Way
The easiest approach is to grant players one of the following parent permission nodes, each of which grant a set of low-level permissions:
Node | What's allowed | Usable view types |
---|---|---|
scrollingmenusign.guest | Scrolling and executing menu entries, permission elevated commands cannot be used | Sign, Redstone |
scrollingmenusign.user | As above and permission elevated commands can be used (if no permission nodes are granted, this is the default level of access) | Sign, Redstone |
scrollingmenusign.poweruser | As above, plus /sms list , /sms show , and /sms getcfg can be used | All |
scrollingmenusign.limited_admin | Allows creation of menus and views (see below for list of restrictions) | All |
scrollingmenusign.admin | Complete control of the plugin (if no permission nodes are granted, op-level players have this level of access) | All |
If you want to prevent all menu usage, the easiest way is to give the negated scrollingmenusign.user permission node.
The scrollingmenusign.limited_admin permission node gives control of most plugin functionality, with the exception of:
- May not modify menus or views owned by someone else
- May not change the plugin configuration with
/sms setcfg ...
- May not add menu items with commands that use costs or permission elevation (see Command Parser)
- May not create redstone control signs
Map views, Inventory views and Spout views are restricted from guest and basic users by default since they can be used anywhere, potentially giving users a lot of power. Sign views and Redstone views views are fixed at specific locations in the world.
The Harder Way
If you want more fine-grained control over who gets what nodes or your permissions plugin doesn't handle superperms parent nodes properly, you will need to grant (or remove) low-level nodes individually.
Regular players have the following nodes by default:
- scrollingmenusign.scroll
- scrollingmenusign.execute
- scrollingmenusign.execute.elevated
- scrollingmenusign.use.sign
- scrollingmenusign.use.redstone
- scrollingmenusign.use.map.framed
Regular players do not have the following nodes by default. You may wish to grant one or more of:
- scrollingmenusign.use.map (if you want to allow players to use map views)
- scrollingmenusign.use.spout (if you want to allow players to use spout views)
- scrollingmenusign.use.inventory (if you want to allow players to use inventory views)
Admin-level players should get all of the nodes listed below.
Low-level Nodes
Command Nodes
The following lower level permission nodes correspond directly to /sms <command>
. The Default setting for each node applies if you're not using a permissions plugin, and/or you haven't given any specific scrollingmenusign
permission nodes to a player (including the parent nodes listed in The Easy Way section above).
Node | Command | Default |
---|---|---|
scrollingmenusign.commands.create | /sms create | op |
scrollingmenusign.commands.sync | /sms sync | op |
scrollingmenusign.commands.break | /sms break | op |
scrollingmenusign.commands.delete | /sms delete | op |
scrollingmenusign.commands.undelete | /sms undelete | op |
scrollingmenusign.commands.add | /sms add | op |
scrollingmenusign.commands.remove | /sms remove | op |
scrollingmenusign.commands.edit | /sms edit | op |
scrollingmenusign.commands.list | /sms list | player |
scrollingmenusign.commands.menu | /sms menu | player |
scrollingmenusign.commands.save | /sms save | op |
scrollingmenusign.commands.reload | /sms reload | op |
scrollingmenusign.commands.getcfg | /sms getcfg | player |
scrollingmenusign.commands.setcfg | /sms setcfg | op |
scrollingmenusign.commands.macro | /sms macro | op |
scrollingmenusign.commands.uses | /sms uses | op |
scrollingmenusign.commands.give | /sms give | op |
scrollingmenusign.commands.view | /sms view | op |
Other Nodes
Node | Description | Default |
---|---|---|
scrollingmenusign.scroll | allow views to be scrolled | player |
scrollingmenusign.execute | allow menu commands to be executed | player |
scrollingmenusign.execute.elevated | allow permission-elevated commands to be executed | player |
scrollingmenusign.use.sign | for doing anything related to sign views | player |
scrollingmenusign.use.multisign | for doing anything related to multisign views | player |
scrollingmenusign.use.map | for doing anything related to map views | op |
scrollingmenusign.use.inventory | for doing anything related to inventory views | op |
scrollingmenusign.use.spout | for doing anything related to spout views | op |
scrollingmenusign.use.redstone | for doing anything related to redstone views | player |
scrollingmenusign.maps.from.sign | allow users to create map views from sign views by hitting a sign view with a blank map | op |
scrollingmenusign.maps.to.sign | allow users to create sign views from map views by hitting a blank sign with a map view | op |
scrollingmenusign.create.elevated | for adding menu items with permission-elevated commands | op |
scrollingmenusign.create.cost | for adding menu items with costed commands | op |
scrollingmenusign.access.any | ignore view and menu access control settings | op |
scrollingmenusign.edit.any | allows modification and destruction of menus & views belonging to other players | op |
scrollingmenusign.create.switch | allows creation of redstone output switches | op |
scrollingmenusign.create.redstonecontrol | allows creation of redstone control signs | op |
Comments