##ProtectionPerms - Player Protection and Control
#About:
ProtectionPerms is a simple player protection and control plugin inspired by plugins like ModifyWorld or NoItem. It’s aim is to provide an easy, permissions-based way of preventing players from performing certain actions on your server, such as breaking blocks, damaging entities, or using items.
#Downloads:
You can grab the latest build off of GitHub here!
#Github Repository:
You can view the GitHub repository of ProtectionPerms here!
##Permssions:
At this time, ProtectionPerms is completely based off permissions. Without a given permission, players will not be able to perform the action the permission specifies. Currently, permissions come in three flavors:
###Block Permissions:
-
protectionperms.block.interact.<blockID>.primary
- Player can primary interact (left-click) onblockID
.- Example:
protectionperms.block.interact.minecraft:stone.primary
- Example:
-
protectionperms.block.interact.<blockID>.secondary
- Player can secondary interact (right-click) onblockID
.- Example:
protectionperms.block.interact.minecraft:dirt.secondary
- Example:
-
protectionperms.block.break.<blockID>
- Player can breakblockID
.- Example:
protectionperms.block.break.minecraft:stone
- Example:
-
protectionperms.block.place.<blockID>
- Player can placeblockID
.- Example:
protectionperms.block.place.minecraft:stone
- Example:
###Entity Permissions:
-
protectionperms.entity.interact.<entityID>.primary
- Player can primary interact (left-click) onenityName
.- Example:
protectionperms.entity.interact.minecraft:zombie.primary
- Example:
-
protectionperms.entity.interact.<entityID>.secondary
- Player can secondary interact (right-click) onenityName
.- Example:
protectionperms.entity.interact.minecraft:pig.secondary
- Example:
-
protectionperms.entity.tame.<entityID>
- Player can tameenityName
.- Example:
protectionperms.entity.tame.minecraft:wolf
- Example:
-
protectionperms.entity.breed.<entityID>
- Player can breedenityName
.- Example:
protectionperms.entity.breed.minecraft:cow
- Example:
-
protectionperms.entity.mount.<entityID>
- Player can mountenityName
.- Example:
protectionperms.entity.mount.minecraft:entityhorse
- Example:
-
protectionperms.entity.damage.<entityID>.deal
- Player can deal damage toenityName
.- Example:
protectionperms.entity.damage.minecraft:skeleton.deal
- Example:
###Item Permissions:
-
protectionperms.item.use.<itemID>.on.self
- Player can use (right-click) withitemID
on themselves (Example: eating bread).- Example:
protectionperms.item.use.minecraft:bread.on.self
- Example:
-
protectionperms.item.use.<itemID>.on.<ID>.primary
- Player can primary use (left-click) withitemID
on the block or entityID
.- Example:
protectionperms.item.use.minecraft:diamond_sword.on.minecraft:zombie
- Example:
-
protectionperms.item.use.<itemID>.on.<ID>.secondary
- Player can secondary use (right-click) withitemID
on the block or entityID
.- Example:
protectionperms.item.use.minecraft:iron_hoe.on.minecraft:grass
- Example:
-
protectionperms.item.drop.<itemID>
- Player can dropitemID
on the ground.- Example:
protectionperms.item.drop.minecraft:diamond_sworld
- Example:
When creating your permission nodes you may run into situations where you have conflicting permissions. For instance, you may not be able to place a block even though you have the place permission because you don’t have the corresponding use permission for the block as an item, in this case pay attention to the message ProtectionPerms gives you when you try to execute an action, it should point you toward the permission node you need.
#Suggestions:
ProtecitonPerms is still under heavy development and I am completely open to suggestions as to how it should function. As the implementation continues to become fleshed out I intend to add more permission nodes, most notably with items when the Inventory API is released, but do let me know if you can think of any more!