View source for Minecraft:Permission level

'''Permission level''' is used to describe the permissions a player or a command executor has.

For example, {{in|bedrock}}, {{cmd|setmaxplayers}} can't be executed in a command block, because this command requires the executor to have a permission level of 3, while command blocks have a permission level of only 2.

== Description ==
Levels are incremental, meaning level ''n'' allows anything that any level less than ''n'' allows.

=== ''Java Edition'' ===
{{IN|java}}, the permission levels may allow players to configure certain game settings:

'''Level 0 &ndash; Operator'''
* The player can enable the [[Minecraft:TPS graph]] in the debug screen.
* The player can see [[Minecraft:command block output‌]] in chat, if the game rule is enabled.
* The player can see command output from other operators and the server console if <code>[[Minecraft:Server.properties#broadcast-console-to-ops|broadcast-console-to-ops]]</code> is enabled.

'''Level 1 &ndash; Moderator'''
* The player can bypass [[Minecraft:spawn protection]].

'''Level 2 &ndash; Gamemaster'''
* More [[Minecraft:command]]s are available.
* The player can use [[Minecraft:command block]]s.
* The player can copy the server-side NBT data of an entity or a block entity when pressing the {{key|F3+I}} [[Minecraft:debug hotkey]], and copy the client-side NBT data when pressing {{key|shift+F3+I}}.
* The player can use {{key|F3+F4}} ([[Minecraft:game mode switcher]]) and {{key|F3+N}} debug hotkey (toggle between [[Minecraft:Spectator]] and the previous [[Minecraft:game mode]]).
* The player can change or lock [[Minecraft:difficulty]] in [[Minecraft:Options]] screen. Note that the player in a singleplayer world or the owner of a LAN world can change or lock difficulty without a permission level of 2.
* With "Operator Items Tab" [[Minecraft:option]] turned on, the player can find operator items and an "Operator Utilities" tab in the [[Minecraft:creative inventory]]. 
* [[Minecraft:Target selector]]s can be used in commands like {{cmd|tell}} and [[Minecraft:raw JSON text]]s.

'''Level 3 &ndash; Admin'''
* Commands related to multiplayer management are available.

'''Level 4 &ndash; Owner'''
* All commands are available, including commands related to server management.

=== ''Bedrock Edition'' ===
{{IN|bedrock}}, permission levels mostly dictate which commands a [[Minecraft:player]] may use. In different levels, certain commands are available, and a level inherits commands from levels less than it.

The permission levels and their available commands are:{{note|The first names and commands are from [https://learn.microsoft.com/en-us/minecraft/creator/commands/commands the official documentation]. The second names are from the debug information of [[Minecraft:Bedrock Dedicated Server]].}}

'''Level 0 &ndash; Any / Normal'''

All commands available to non-privileged players:
* {{cmd|help}}
* {{cmd|list}}
* {{cmd|me}}
* {{cmd|tell}}

'''Level 1 &ndash; Game Directors / Operator'''

Mostly commands that affect gameplay and entities:
{{Collapse|title='''List of commands'''|content=
* {{cmd|aimassist}}
* {{cmd|camera}}
* {{cmd|camerashake}}
* {{cmd|clear}}
* {{cmd|clearspawnpoint}}
* {{cmd|clone}}
* {{cmd|controlscheme}}
* {{cmd|damage}}
* {{cmd|daylock}}
* {{cmd|dialogue}}
* {{cmd|difficulty}}
* {{cmd|effect}}
* {{cmd|enchant}}
* {{cmd|event}}
* {{cmd|execute}}
* {{cmd|fill}}
* {{cmd|fog}}
* {{cmd|function}}
* {{cmd|gamemode}}
* {{cmd|gamerule}}
* {{cmd|gametest}}
* {{cmd|give}}
* {{cmd|hud}}
* {{cmd|inputpermission}}
* {{cmd|kick}}
* {{cmd|kill}}
* {{cmd|locate}}
* {{cmd|loot}}
* {{cmd|mobevent}}
* {{cmd|music}}
* {{cmd|particle}}
* {{cmd|playanimation}}
* {{cmd|playsound}}
* {{cmd|project}}
* {{cmd|recipe}}
* {{cmd|reload}}
* {{cmd|replaceitem}}
* {{cmd|ride}}
* {{cmd|say}}
* {{cmd|schedule}}
* {{cmd|scoreboard}}
* {{cmd|script}}
* {{cmd|scriptevent}}
* {{cmd|setblock}}
* {{cmd|setworldspawn}}
* {{cmd|spawnpoint}}
* {{cmd|spreadplayers}}
* {{cmd|stopsound}}
* {{cmd|structure}}
* {{cmd|summon}}
* {{cmd|tag}}
* {{cmd|teleport}}
* {{cmd|tellraw}}
* {{cmd|testfor}}
* {{cmd|testforblock}}
* {{cmd|testforblocks}}
* {{cmd|tickingarea}}
* {{cmd|time}}
* {{cmd|title}}
* {{cmd|titleraw}}
* {{cmd|toggledownfall}}
* {{cmd|weather}}
* {{cmd|xp}}
}}

'''Level 2 &ndash; Admin / Host'''

Server [[Minecraft:operator]] commands:
* {{cmd|deop}}
* {{cmd|op}}
* {{cmd|place}}
* {{cmd|wsserver}}

'''Level 3 &ndash; Host / Automation'''

Server host commands: 

* {{cmd|setmaxplayers}}

'''Level 4 &ndash; Owner / Admin'''

Server administrator commands:
* {{cmd|allowlist}}
* {{cmd|changesetting}}
* {{cmd|permission}}
* {{cmd|reloadconfig}}
* {{cmd|save}}
* {{cmd|sendshowstoreoffer}}
* {{cmd|stop}}
* {{cmd|transfer}}

{{notelist}}

== Player Permissions ==
{{Exclusive|Bedrock|section=1}}
[[File:Ore UI - Game Menu - Player Permissions Screen Menu (Bedrock).png|380px|thumb|The Player Permissions menu {{in|be}}.]]
<!-- Used for [[Minecraft:Tutorial:Menu_screen/Bedrock_Edition#Player_Permissions]] transclusion --> <section begin="player-permissions"/>
Player permissions dictate what the player can and cannot do in a multiplayer game. For example, actions such as building, [[Minecraft:mining]], attacking mobs or players can be disabled or restricted by each of their own permissions. They can be configured individually or by preset roles on a separate [[Minecraft:Tutorial:Menu_screen/Bedrock_Edition#Player_Permissions|screen]] accessible in the [[Minecraft:pause menu]].

There are four roles which can set specific permissions for players:
* '''Operator''', which enables all permissions, including operator commands, world settings, teleportation, and all of member permissions.
* '''Member''', which enables mining, building, world and entities interactions.
* '''Visitor''', which only lets players view or observe the world only, with none of the permissions enabled.
* '''Custom''', which enables specific permissions set by operators. Following permissions can be applied for custom role:

{| class="wikitable"
|+
!Option
!Description
!Default
|-
|Build
|Allows the player to place blocks and entities in the world.
|[[File:Ore UI - Toggle ON Button (Bedrock).png|link=|55px]]
|-
|Mine
|Allows the player to break blocks in the world.
|[[File:Ore UI - Toggle ON Button (Bedrock).png|link=|55px]]
|-
|Use doors and switches
|Allows the player to use [[Minecraft:door]]s, [[Minecraft:lever]]s, and [[Minecraft:button]]s.
|[[File:Ore UI - Toggle ON Button (Bedrock).png|link=|55px]]
|-
|Open containers
|Allows the player to open the GUI of [[Minecraft:containers]] ([[Minecraft:chest]]s, [[Minecraft:hopper]]s, [[Minecraft:crafter]]s, etc).
|[[File:Ore UI - Toggle ON Button (Bedrock).png|link=|55px]]
|-
|Attack Players
|Allows the player to deal damage to [[Minecraft:player]]s.
|[[File:Ore UI - Toggle ON Button (Bedrock).png|link=|55px]]
|-
|Attack Mobs
|Allows the player to deal damage to [[Minecraft:mob]]s.
|[[File:Ore UI - Toggle ON Button (Bedrock).png|link=|55px]]
|-
|Operator Commands
|Allows the player to execute operator [[Minecraft:commands]]. Also sets the player's permission level depending on the environment, see below.
|'''Member:''' [[File:Ore UI - Toggle OFF Button (Bedrock).png|link=|55px]]
'''Operator:'''
[[File:Ore UI - Toggle ON Button (Bedrock).png|link=|55px]]
|-
|Teleport
|Allows the player to use the {{cmd|tp}} command.
|'''Member:''' [[File:Ore UI - Toggle OFF Button (Bedrock).png|link=|55px]]
'''Operator:'''
[[File:Ore UI - Toggle ON Button (Bedrock).png|link=|55px]]
|}
The owner of the world can change any player permissions, regardless of its own permissions. Other players can't change any player permissions unless if they are [[Minecraft:operator]]s, but they can still view them for themselves and other joined players.

Player permissions differ from [[Minecraft:permission level]], the latter enables and restricts specific commands, requiring different level for each command. Additionally, the "Operator Commands" permission if enabled sets the player's permission level to 3 in singleplayer or [[Minecraft:LAN]] world. In [[Minecraft:Bedrock Dedicated Server]], it sets the permission level to 1.<section end="player-permissions"/>

== Situations ==
=== ''Java Edition'' ===
* For a function:
** When [[Minecraft:Function_(Java_Edition)#Loading and Parsing|parsing]] a [[Minecraft:Function_(Java_Edition)|function]] (including macro line parsing), the permission level defaults to 2 (but it can be changed in [[Minecraft:server.properties]]).
** When calling a [[Minecraft:Function_(Java_Edition)|function]], see [[Minecraft:command context]] for details.
* For a player:
** If the player is an operator in a dedicated server, their permission level can be specified in the [[Minecraft:ops.json format|ops.json]] file. and its default value is specified in [[Minecraft:server.properties]].
** If the player is the owner or another operator in a [[Minecraft:Realms|Realm]], their permission level is 2.
*** Unless the Realm is playing a ''minigame'': then the owner's permission level is 0, and no one else can be operators.<ref>https://atlas.minecraft.net/guidelines</ref>
** If the player is in a singleplayer world, and [[Minecraft:cheats]] were enabled when creating the world, their permission level is 4.
** If the player is the owner of a LAN world, and [[Minecraft:cheats]] were enabled when creating the world, their permission level is 4.
** All players in a [[Minecraft:Cheats|command-allowed]] LAN world have a permission level of 4.
** Otherwise, the player's permission level is 0.
* For other command executors, see [[Minecraft:command context]] for details.
* For raw JSON text resolution executors, see [[Minecraft:command context]] for details.

=== ''Bedrock Edition'' ===
* For a function:
** When [[Minecraft:Function_(Bedrock_Edition)#Loading and Parsing|parsing]] a [[Minecraft:Function (Bedrock_Edition)|function]], the permission level is 1.
** When calling a [[Minecraft:Function_(Bedrock_Edition)|function]], see [[Minecraft:command context]] for details.
* For a player:
** In a [[Minecraft:BDS|dedicated server]], if the player's '''"Operator Commands"''' option is enabled in the "Player Permission" screen, their permission level is 1.
** In a singleplayer world or a LAN world, if the player's '''"Operator Commands"''' option is enabled in the "Player Permission" screen, permission level is 3.
** Otherwise, the player's permission level is 0.
* For other command executors, see [[Minecraft:command context]] for details.

== History ==
{{expand section}}
{{Incomplete section|release versions, Old PE / BE versions}}

=== ''Java Edition'' ===
{{HistoryTable
|{{HistoryLine|java}}
|{{HistoryLine||1.14.4|dev=Pre-Release 4|Added the <code>function-permission-level</code> option that controls what permission level [[Minecraft:Function (Java Edition)|functions]] have.}}
}}

=== ''Bedrock Edition'' ===
{{HistoryTable
|{{HistoryLine|bedrock}}
|{{HistoryLine||1.21.70|dev=Preview 1.21.70.22|[[File:New UI - Player Permissions Screen Menu (Bedrock Preview 1.21.70.22).png|53px]] Player Permissions screen in [[Minecraft:Pause menu]] screen has been updated to match [[Minecraft:Ore UI]], available in [[Minecraft:Minecraft Preview|preview]] only.}}
|{{HistoryLine|||dev=release|Player Permissions screen in [[Minecraft:Pause menu]] screen is released to the public and no longer in [[Minecraft:Minecraft Preview|preview]] only.}}
}}

== Issues ==
{{issue list|permission}}

== Gallery ==
=== ''Bedrock Edition'' ===
<gallery>
Ore UI - Game Menu - Player Permissions Screen Menu (Bedrock).png|The "Player Permissions" screen.
Ore UI - Game Menu - Player Permissions (Other Player) Screen Menu (Bedrock).png|The "Player Permissions" screen from other players.
Ore UI - Multiplayer Game Menu - Player Permissions Locked Screen Menu (Bedrock).png|The "Player Permissions" screen when all options are locked, in a server.
</gallery>

=== ''Minecraft Education''===
<gallery>
Pause menu - Player permissions screen menu (Education).png|The "Player Permissions" screen.
</gallery>

== See also ==
* [[Minecraft:Commands]] are mainly what dictated by permission level.
* [[Minecraft:Server.properties]] has a related property for setting operators' permission level.
* [[Minecraft:Commands/op]] sets player's operator status, granting or revoking them of operator permissions.
* [[Minecraft:Commands/permission]] sets player's specific permission level.
* [[Minecraft:Ore UI]], the {{BE}} UI refresh.

== References ==
<references />

== Navigation ==
{{Navbox commands}}

[[Category:Server]]

[[Minecraft:ja:権限レベル]]
[[Minecraft:pt:Nível de permissão]]
[[Minecraft:ru:Уровень доступа]]
[[Minecraft:uk:Рівень дозволу]]
[[Minecraft:zh:权限等级]]