Bukkit

Permissions

[Last updated for General 4.2]

The /give command

For the /give command, you can define groups of items that have a name and control access to those groups individually; each group has its own permissions node.

• general.give – Grants basic access to the /give command
• general.give.unlimited – Grants full access to the /give command
• general.give.infinite – The ability to use /give to obtain infinite stacks (by specifying -1 as the amount).
• general.give.mass – The ability to use /give to obtain large amounts of items in a single command; also grants access to the /items command.
• general.give.group.<groupname> – The ability to use /give to obtain items in the specified group.
• general.give.item.<itemname> – The ability to use /give to obtain the specified item.
• general.give.groupless – The ability to use /give to obtain items that are not in a group.
• general.give.groups – Gives access to all item groups, but not to items that are in no group.
• general.give.any – This node overrides the item groups and is equivalent to giving all groups, plus groupless.

Other inventory commands

• general.gamemode – Gives full access to the /mode command.
• general.gamemode.view – The ability to see what game mode a player is in.
• general.gamemode.set – The ability to set your own game mode.
• general.gamemode.other – The ability to set anyone's game mode.
• general.gamemode.force.survival – If a player has this permission in a world, their gamemode is changed to survival when they teleport to the world.
• general.gamemode.force.creative – If a player has this permission in a world, their gamemode is changed to creative when they teleport to the world.
• general.clear – The ability to clear your inventory.
• general.clear.other – The ability to clear someone else's inventory.
• general.take – The ability to remove stuff from your inventory.
• general.take.other – The ability to take from someone else's inventory.
• general.take.mass – Gives access to the /masstake command.
• general.kit – The ability to see obtain all kits.
• general.kit.<kitname> – The ability to obtain the specified kit.
• general.kit.<kitname>.instant – The ability to bypass delays on the specified kit.
• general.kit-now – The ability to bypass delays on all kits; people with this permission will not have a cooldown period.

The /teleport and /setspawn commands

Teleportation permissions are divided into two parts. One specifies the types destinations you are allowed to teleport to. The other controls who you are allowed to teleport.

The general form of a teleport permission is general.teleport[.<target>][.into.<world>][.to.<destination>][.instant]. If any of the optional portions (apart from .instant) are omitted, it's equivalent to giving the individual permissions for each possibility, so for example general.teleport.into.world will give permission to teleport anything to any place in world, while general.teleport.self will give permission to teleport yourself anywhere in any world.

The setspawn command is much the same: general.setspawn[.<target>][.into.<world>][.to.<destination>]. Here, the world is the one you're allowed to set the spawn of.

Valid targets are:

• self – The ability to teleport yourself.
• other – The ability to teleport other people.
• mob – The ability to teleport mobs. Not used for /setspawn.
• world – Not used for teleport; used for /setspawn only, where it means set the world's spawn rather than a player's spawn.

The types of destinations are described below.

• world – The spawn location of a named world.
• player – The location of another player.
• coords – Specific, absolute coordinates.
• home – The home of a player (usually either spawn location or the last bed they slept in).
• spawn – The spawn location of the world a player is currently in.
• target – The location a player is currently targeting.
• compass – The location to which a player's compass is pointing.

Other teleport permissions:

• general.teleport.all – Gives full teleport permissions, including the ability to bypass warmup. (In the next version it won't give warmup bypassing.
• general.teleport.basic – Gives the ability to teleport yourself to a basic set of destinations taken from config.yml.
• general.teleport.mass – The ability to teleport more than a single entity with one command.

The /mobspawn command

You can control access to mobs by attitude or individually.

• general.mobspawn.all – Allow access to all mobs.
• general.mobspawn.neutral – Allow access to neutral mobs (wolves and pig zombies).
• general.mobspawn.neutral.basic – Allows access to just the basic variant of neutral mobs (eg no spawning tamed or angry wolves).
• general.mobspawn.neutral.angry – Allows access to the angry variant of neutral mobs (but not to other variants!)
• general.mobspawn.enemy – Allow access to hostile mobs.
• general.mobspawn.enemy.basic – Allows access to just the basic variant of enemy mobs (eg no spawning powered creepers).
• general.mobspawn.friendly – Allow access to friendly mobs.
• general.mobspawn.friendly.basic – Allows access to just the basic variant of friendly mobs (eg no spawning saddled pigs or coloured sheep).
• general.mobspawn.<mob> – Allow full access to all variants of a specific mob.
• general.mobspawn.<mob>.<variant> – Allow access to just a specific variant of a specific mob. If you give permissions this way, you'll need to make sure you explicitly give access to the regular variant unless you want it to be blocked.
• general.mobspawn.sheep.natural – Gives permissions to spawn any colour of sheep that naturally spawns, which includes black, grey, silver, white, brown, and pink.

Supported variants for mobs:

Creepers

"regular" or "powered"

Endermen

"nothing", or a block name

Pigs

"regular" or "saddled"

Pig Zombies

"regular" or "angry"

Sheep

"sheared", or a colour name

Slimes

"tiny", "small", "medium", "large", "huge", or "colossal"

Wolves

"wild", "angry", or "tamed"

All other mobs

"regular" only

Note: As of 4.1, you the permissions for mobs that can be spawned as baby have the word "baby" or "adult" just before the data, eg general.mobspawn.baby.saddled. These are a single unit; in this example, neither general.mobspawn.baby nor general.mobspawn.saddled imply general.mobspawn.baby.saddled. This might be fixed eventually.

Time and weather

• general.time – Full access to /time.
• general.time.view – To view the current time.
• general.time.set – To set the time.
• general.time.instant – To bypass the cooldown period.

• general.weather – Full access to /weather.
• general.weather.view – To see with the weather.
• general.weather.set – To tamper with the weather.
• general.weather.zap – To summon lightning.
• general.weather.thunder – To summon or banish thunder.
• general.weather.(set|zap|thunder).instant – To bypass the cooldown period.
• general.weather.instant – Combination of the above three.

Other permissions

• general – Gives all General permissions except for administrative permissions, which includes anything starting with general.admin plus general.bypass and permissions for /op, /deop, /kick, /ban, and /pardon.
• general.away – To set an away message
• general.worldinfo – To view info about a world, such as the spawn location or the seed
• general.basic – Equivalent to general.time, general.playerlist, general.who, general.away, general.getpos, and general.tell
• general.admin – Gives all General permissions, with no exceptions.
• general.playerlist – To view the list of online players.
• general.who – To view information on a player other than yourself
• general.who.ip – To view the IP address of players other than yourself
• general.getpos – To view your location; this also controls access to /compass and /where
• general.getpos.other – To get the location of someone else
• general.tell – To whisper to other players
• general.iteminfo – To see info about the item in your hand, such as its durability level.
• general.iteminfo.other – To see info about the item in someone else's hand.
• general.heal – To heal yourself (and possibly restore hunger)
• general.hurt – To heal negative values; bypassed if you're doing it to yourself
• general.op – Gives permission to grant players op status
• general.deop – Gives permission to revoke op status on players
• general.ban – Gives permission to ban players and IPs
• general.pardon – Gives permission to pardon (unban) players and IPs
• general.kick – Gives permission to kick players off the server (note, the ban command also kicks players)
• general.stop – Gives permission to stop the server
• general.stop.now – Gives permission to stop the server without specifying a delay
• general.config – Various administrative functions that deal with the config, most of which have their own sub-permission; this covers most of the permissions beginning with general.admin: general.admin.reload, general.admin.item, general.admin.save, general.admin.kit, general.admin.economy, general.admin.set, general.admin.genlang.
• general.bypass – Gives permission to bypass all cooldown/warmup restrictions as well as economy. Equivalent to the following permimssions: general.no-money, general.kit-now, general.teleport.instant, general.time.instant, general.weather.instant.
• general.no-money – Gives permission to bypass economy settings, meaning that the player will never have to pay for running any General command.
• general.invisible-info – Gives permission to see info on invisible players.

Full List

The full list of permissions depends on things like how many worlds you have; if you want a full list of all permissions the plugin uses, you can add the line "export-permissions: true" to your config.yml, then either start your server or reload it with /reload (/general reload will not work for this purpose). Once you've done that, remove the line and open the allpermissions.txt file in the General folder; it wil contain a list of all existing permissions.