Skip to content

Commit e5c6d14

Browse files
committed
Merge remote-tracking branch 'origin/master'
2 parents ecc2d24 + 7bea5cd commit e5c6d14

File tree

2 files changed

+15
-5
lines changed

2 files changed

+15
-5
lines changed

README.md

Lines changed: 13 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
# ProtectionPerms
22
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.
33

4-
## Permssions
5-
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:
4+
## Permissions
5+
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 (unless the inversion flag is set as described below). Currently, permissions come in three flavors:
66

77
### Block Permissions
88
#### Primary Interaction
@@ -73,11 +73,21 @@ At this time, ProtectionPerms is completely based off permissions. Without a gi
7373
* `protectionperms.item.fuel.<itemID>` - Player can use `itemID` as fuel in a furance.
7474
* Example: `protectionperms.item.fuel.minecraft:coal`
7575

76-
#### A Note on BlockStates
76+
### A Note on BlockStates
7777
Whenever a permission requires a blockID you can optionally include `BlockState` information. For example if I wanted to give the player permission to break Andesite but not regular stone I could give them the permission `protectionperms.block.break.minecraft:stone[variant=andesite]`. Giving the player the `protectionperms.block.break.minecraft:stone` permission still allows them to break all variants of stone as normal.
7878

7979
### Conflicts
8080
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. :wink:
8181

82+
### Inverting Permissions
83+
As of ProtectionPerms v1.2.0 a config file will be generated at `~/config/ProtectionPerms.conf`, the default configuration is shown below:
84+
```
85+
# Whether permissions nodes should be inverted
86+
# If inverted granting a permission will DENY an action
87+
invert=false
88+
```
89+
90+
If `invert` is set to `true`, the functionality of the permisison nodes will be reversed such that granting a permission node will **deny** the player from completing the action it describes.
91+
8292
## Support Me
8393
I will **never** charge money for the use of my plugins, however they do require a significant amount of work to maintain and update. If you'd like to show your support and buy me a cup of tea sometime (I don't drink that horrid coffee stuff :P) you can do so [here](https://www.paypal.me/zerthick)
Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,3 @@
11
# Whether permissions nodes should be inverted
2-
# If inverted granting a permssion will DENY an action
3-
invert = false
2+
# If inverted granting a permission will DENY an action
3+
invert = false

0 commit comments

Comments
 (0)