Permissions

Permissions

Most permissions in Magic are to allow access to commands, and (with a few exceptions) should only be given to mods or admins.

In all cases a player needs the base permission for a command (e.g. "Magic.commands.wand") to use any of the sub-commands.

Player Permissions

By default, all players have access to the wand and all spells. This can be limited by negating the following permission nodes:

• -Magic.wand.use : Player may not use a wand
• -Magic.wand.craft : Player may not craft a wand
• -Magic.cast.* : Player may not cast any spells
• Magic.cast.<spellname> : Player can cast a specific spell

By default, players have access to no commands. Magic command permissions follow the format "Magic.commands.<command>.<subcommand>". For example:

• Magic.commands.mskills : Player can use the /mskills skill selector
• Magic.commands.spells : Player can use /spells

Mod and Admin Permissions

You may also wish to limit which items and wands are available to mods with the /wand and mgive command. By default if they have the commands they can use them to spawn any item.

• Magic.commands.mgive : Player may spawn items and wands
• Magic.commands.wand : Player may spawn only wands
• -Magic.create.* : Player may not spawn any items or wands
• Magic.create.wand : Player may spawn the wand "wand"
• Magic.create.battle : Player may spawn the wand "battle"
• Magic.create.stone : Player may spawn stone blocks
• Magic.create.hylian_shield : Player may spawn the hylian_shield item

Bypass Permissions

There are several permissions that ops have by default that will let them bypass restrictions:

• Magic.bypass : The player may bypass most restriction checks.
• Magic.bypass_build : The player may cast spells that are otherwise build-restricted
• Magic.bypass_break : The player may cast spells that are otherwise break-restricted
• Magic.bypass_pvp : The player may cast spells that are otherwise PVP-restricted
• Magic.bypass_restricted : The player may build with restricted materials
• Magic.bypass_hidden : The player may see hidden spells in lists and tab-completion
• Magic.override_bind: : The player may use wands bound to other players
• Magic.bypass : The player may bypass other permission checks
• Magic.wand.override_drop : The player may drop undroppable wands and put them in chests
• Magic.wand.override_locked : The player may reconfigured locked wands
• Magic.wand.use.protected : Player can use a wand with the "protected" flag set, meaning they are invincible
• Magic.wand.use.powered : Player can use a wand with the "powered" flag set, meaning they bypass certain restrictions

Item Spawning Permissions

• Magic.commands.mgive : Player can use /mgive to spawn any item
• Magic.commands.wand : Player can use /wand to spawn wands
• Magic.create. : Player can use /wand or /mgive to get a specific wand. All wands are available by default.
• -Magic.create.* : Negate this permission to use per-item/wand permissions for /wand and /mgive

Wand Modification Permissions

These commands can be used to modify wand items

• Magic.commands.wand.describe : Player can use /wand describe to list information about a wand
• Magic.commands.wand.add : Player can use /wand add to add spells and brushes to wands
• Magic.commands.wand.add.spell. : Player may add a specific spell to a wand. All spells are allowed by default.
• Magic.commands.wand.add.material : Player may add a material to a wand. True by default.
• Magic.commands.wand.bind : Player can bind a wand to themselves
• Magic.commands.wand.unbind : Player can unbind a wand
• Magic.commands.wand.remove : Player can use /wand remove to remove spells and brushes from a wand
• Magic.commands.wand.destroy : Player can use /wand destroy to turn a wand into a normal item
• Magic.commands.wand.delete : Player can use /wand delete to delete a saved wand template
• Magic.commands.wand.enchant : Player can use /wand enchant to upgrade a wand randomly
• Magic.commands.wand.name : Player can use /wand name to rename a wand
• Magic.commands.wand.list : Player can use /wand list to see all wands
• Magic.commands.wand.save : Player can use /wand save to save a wand item to a new config template
• Magic.commands.wand.fill : Player can use /wand fill to add all available spells to a wand
• Magic.commands.wand.configure : Player can use /wand configure to change wand properties
• Magic.commands.wand.upgrade : Player can use /wand upgrade to upgrade wand properties
• Magic.commands.wand.create : Player can use /wand create to change an item into an empty wand
• Magic.commands.wand.duplicate : Player can use /wand duplicate to create a copy of a wand
• Magic.commands.wand.organize : Player can use /wand organize to reorganize their spell inventory
• Magic.commands.wand.restore : Player can use /wand restore to retrieve missing bound wands
• Magic.commands.wand.unlock : Player can use /wand unlock to unlock a locked wand and modify it
• Magic.commands.wand.override : Player can use /wand override to change cast overrides on a wand

Remote Wand Modification

The /wandp command permissions follow the same format as the /wand command. /wandp Works just like /wand but acting as another player. This can be used to make changes to a wand that another player is holding.

• Magic.commands.wandp.* : Player can use /wandp commands on behalf of another player.

Mage Configuration

• Magic.commands.mage.debug : Player can turn on debug information for themselves or another player
• Magic.commands.mage.check : Player can check permissions for spell casting, breaking, building, etc
• Magic.commands.mage.getdata : Player can check mage data or spell casts
• Magic.commands.mage.setdata : Player can modify mage data or spell casts
• Magic.commands.mage.reset : Player can completely reset a mage's data

Item Manipulation

The /mitem command can be used in-game to modify non-wand items

• Magic.commands.mitem.add : Add enchantments, attributes or lore
• Magic.commands.mitem.remove : Remove enchantments, attributes or lore
• Magic.commands.mitem.describe : Show information about an item
• Magic.commands.mitem.duplicate : Create a copy of an item
• Magic.commands.mitem.destroy : Destroy an item
• Magic.commands.mitem.skull : Create a custom skull based on data in a book
• Magic.commands.mitem.save : Save an item as a new template
• Magic.commands.mitem.delete : Delete a saved item
• Magic.commands.mitem.worth : Show the value of an item
• Magic.commands.mitem.type : Change the type of an item
• Magic.commands.mitem.export : Export all items, names and worth a CSV file

Magic Mobs

Magic mob spawning and management commands:

• Magic.commands.mmob spawn : Spawn a custom Magic mob
• Magic.commands.mmob list : List custom mob types
• Magic.commands.clear Clear custom mobs from all loaded worlds

Image Maps

There are specific permissions for the /mmap command

• Magic.commands.mmap load : Load a new image map
• Magic.commands.mmap list : List all loaded image maps
• Magic.commands.mmap give : Give a player an image map
• Magic.commands.mmap import : Import image maps from Pixelator

Command-Line Casting

The /cast command can be used in-game to cast spells. This can be very dangerous as the command allows for overriding spell parameters, this should really only be given to server owners or highly trusted admins.

• Magic.commands.cast : Player can use /cast

Miscellaneous Admin Commands

• Magic.commands.magic.load : Reload spells.yml, wands.yml, config.yml and messages.yml. (And the defaults)
• Magic.commands.magic.[save|clean|search|list| .. etc] : All commands follow the same pnode format.

This list may not be complete, check plugin.yml for a full list of permissions