AntiGuest
AntiGuest
Description
AntiGuest prevents players from doing specific things like building and fighting, which can be used to grief.
Every prevention has its own configurable message which will be printed to the player. This message supports color codes (&0, &1, ..., &e, &f, &k)
How does this work?
AntiGuest uses permissions to determine whether a player is allowed to do a specific action. So you should (not necessarily needed, but recommended) install a permission manager like bPermissions or GroupManager along with AntiGuest. Usually you only want to prevent your guests from doing things like breaking and placing blocks (griefing), so you should not give your guests' group the permission to do so. However your accepted players should by able to do these actions. That can be achieved by adding the permission "antiguest.preventions.*" or a action specific permission to the player or his group.
As you might see, this system allows more than just "guests can nothing, members everything". You could for example stagger the permissions like "guests can nothing but chat; trails can chat, place and break blocks; members can everything" and even more complex setups, it's completely up to you.
Watch out! Tips for common mistakes
- All preventions are disabled by default since version 3.0 (3.2 changes that, see the table below)
- All preventions have their own configuration file since 3.1, since 3.2 the old configurations will be converted
- The permissions are all lowercase, check that before you report AntiGuest not working
Preventions
| Name | Prevents from ... | On by default | Filterable | Punishable | Loggable |
|---|---|---|---|---|---|
| ad | posting server addresses (also enables link, see below) | yes | no | yes | yes |
| afk | idling players by kicking them after a configured time | no | no | no | yes |
| anvil | using anvils | no | no | yes | yes |
| beacon | opening beacon inventories | yes | no | yes | yes |
| bed | sleeping | no | no | yes | yes |
| bow | shooting bows | yes | no | yes | yes |
| breakblock | breaking blocks | yes | yes | yes | yes |
| brew | brewing | no | no | yes | yes |
| button | pushing buttons | no | no | yes | yes |
| cake | eating cakes | no | no | yes | yes |
| caps | writing all-caps messages | no | no | yes | yes |
| changesign | changing signs | yes | no | yes | yes |
| chat | chatting | no | no | yes | yes |
| chest | accessing chests | yes | no | yes | yes |
| command | using specific commands | no | yes | yes | yes |
| damage | getting damaged | no | yes | no | no |
| dispenser | accessing dispensers | yes | no | yes | yes |
| door | opening or closing doors (including fence gates) | yes | yes | yes | yes |
| dropper | opening dropper inventories | yes | no | yes | yes |
| drop | dropping specific items | no | yes | yes | yes |
| enchant | accessing enchantment tables | no | no | yes | yes |
| fight | damaging other players | yes | no | yes | yes |
| fish | fishing | no | no | yes | yes |
| furnace | accessing furnaces | no | no | yes | yes |
| guestlimit | getting too many guests | no | no | no | no |
| hopper | opening hopper inventories | yes | no | yes | yes |
| horse | interacting with horses/mules/donkeys | no | no | yes | yes |
| hotbar | changing the selected hotbar slot | no | no | yes | yes |
| hunger | starvation | yes | no | no | no |
| itemframe | changing item frames | yes | no | yes | yes |
| item | using specific items | no | yes | yes | yes |
| jukebox | using jukeboxes | no | no | yes | yes |
| lavabucket | using lava buckets | yes | no | yes | yes |
| lead | using a leash | no | no | yes | yes |
| lever | using levers | no | no | yes | yes |
| link | posting clickable links | yes | no | yes | yes |
| milking | milking cows | no | no | yes | yes |
| monster | getting targeted by monsters | yes | yes | yes | no |
| move | moving too far | yes | no | yes | no |
| noteblock | using note blocks | no | no | yes | yes |
| pickup | picking up specific items | no | yes | no | no |
| placeblock | placing blocks | yes | yes | yes | yes |
| pressureplate | triggering pressure plates | no | no | yes | yes |
| repeater | changing the repeater delays | no | no | yes | yes |
| shear | shearing animals | no | no | yes | yes |
| sneak | sneaking (hiding the name above his head) | no | no | yes | yes |
| spam | spam | yes | no | yes | yes |
| spawnegg | using spawn eggs | no | yes | yes | yes |
| swear | swearing | yes | no | yes | yes |
| tame | taming animals | no | no | yes | yes |
| trading | trading with villagers | no | no | yes | yes |
| trample | trampling crops | no | no | yes | yes |
| tripwire | triggering trip wires | yes | no | yes | yes |
| vehicle | using vehicles (entering, placing, destroying, pushing) | no | no | yes | yes |
| waterbucket | using water buckets | yes | no | yes | yes |
| workbench | accessing workbenches | no | no | yes | yes |
Filtering
How does filtering work?
Filtered prevention allow you to filter the action which will be prevented.
For example the command preventions which can either prevent the usage of all commands or just a specific set of commands based on a whitelist or blacklist
Filter configuration
- mode:
- none: everything will be prevented (aliases: -1, nolist, all)
- whitelist: the listed entries are NOT prevented (aliases: 0, white)
- blacklist: only the listed entries will be prevented (aliases: 1, black)
- list:
- the list of entries. this might be commands, item names or anything else depending on what the prevention does
- this list will be ignored if the mode is set to none
Punishments
Since version 3.3, AntiGuest allows to automatically punish players. These punishments are configurable per prevention.
You can specify multiple punishments per violation, you can look at the default punishment values in the configs
| Punishment | Description | Configuration |
|---|---|---|
| ban | Bans the player | reason: the ban reason |
| burn | Sets the player on fire | duration: the burn duration in seconds |
| dropitem | Drops the held item | pickupDelay: the pickup delay in seconds |
| explosion | Creates a fake explosion and damages | damage: the damage to deal |
| kick | Kicks the player | reason: the kick reason |
| kill | Kills the player | none |
| lightning | Strikes a fake lightning on the player | damage: the damage to deal |
| message | Makes the player send an awkward message | message: the message to send |
| potion | Poisons the player | duration: effect duration, effect: type |
| rocket | Shoots the player in the air | height: the number of blocks |
| slap | Slaps the player | damage: the damage to deal |
| starvation | Lets the player starve | none |
No configuration is specified as {}
Commands
General syntax: /antiguest <command> or /ag <command>
| Command | Description |
|---|---|
| help | prints a help text |
| can [player] <preventionname> | checks whether the player (or another player) passes a prevention |
| list [-a] | lists the active or all registered preventions |
| reload [prevention] | reloads the plugin |
| setmessage <prevention> <message> | sets the message of a prevention |
| language [language] | shows or sets the language |
| badword <word> | adds a bad word to the swear prevention |
disable <prevention|*> [-t] | disables a specific prevention or all at once |
enable <prevention|*> [-t] | enables a specific prevention or all at once |
| reset | resets all configurations |
Installation
AntiGuest 3 needs at least Bukkit 1.1-R5!
Steps
- Just put the AntiGuest Jar-File into your plugins folder
- If you're upgrading from an older version you might remove your config to get a fresh one
- restart/reload your server
- The configuration files will be generated/updated as soon as the plugin gets enabled
Permissions
| Permission node | Description | Default |
|---|---|---|
| antiguest,violation-notification | The player will receive violation notifications | not assigned |
| antiguest.* | Allows the player to do everything | operators |
| antiguest.commands.* | Allows the player to run all commands | operators |
| antiguest.commands.<command> | Allows the player to run the specific command | operators |
| antiguest.preventions.* | Allows the player to pass all preventions | operators |
| antiguest.preventions.<prevention> | Allows the player to pass the specific prevention | operators |
Base configuration
| Entry | Default value | Description |
|---|---|---|
| debug | false | Enables or disables debug output |
| language | system value | Sets the language of all texts |
| punishments | true | Globally disables or enables punishing |
| log-violations | false | Globally enables violation logging |
| prevent-npc | false | Enables the preventions for NPCs |
Developer Notice
Plugin developed by Quick_Wango - Cube Island
- You want new features?
- You want the plugin to be always up to date?
- You want good support?
I'm doing this for literally nothing in my free time, so keep me interested in my plugins and help pay my bills by simply donating a few bucks.
Thanks in advance!
Talk to the developers (#cubeisland-dev on EsperNet)
Comments
-
pschichtel Owner
-
_ForgeUser7112135 Tester
-
_ForgeUser8779886 Maintainer
-
View User Profile
-
Send Message
Posted Mar 2, 2012Is there options to choose what specific items cannot be broken... like there is with what items can be used. It would be nice to allow guests to place and breaks blocks but not things like redstone or signs for example. I dont see a * next to breakblock so I'm asking or requesting feature.
Edit... Also is there a way to block throwing the bottle of enchanting? It can still be thrown if you are not aimed at a block.
-
View User Profile
-
Send Message
Posted Mar 2, 2012I'm really desperate here.
I'm still on RB-R4 (R5 was unstable or broken) because of some plugins i use that aren't updated yet. I saw your Alpha build for R4 but whatever permission node i enter in bPermissions yml, it doesn't seem to apply the changes (server not running when making changes and everything is lowercase).
The only changes that work are AntiGuest config.yml changes (e.g. setting values to true). Everything else i do is simply ignored :S
Thanks for your continuous effort in updating your plugins ;)
-
View User Profile
-
Send Message
Posted Mar 1, 2012AntiGuest 3.0 released!
Download and changelog:
http://dev.bukkit.org/server-mods/antiguest/files/6-anti-guest-v3-0-0-1-1-r6/
Bukkit 1.1-R5 or higher needed!
-
View User Profile
-
Send Message
Posted Mar 1, 2012the permissions get now dynamicly registered so problems like these won't happen again.
3.0 will be released today!
-
View User Profile
-
Send Message
Posted Mar 1, 2012@Hvarr
plugin.yml (found inside the jar)
-
View User Profile
-
Send Message
Posted Feb 29, 2012@QuickWango
I like this plugin but i somehow can't disable pvp damage for guests. Mobs won't attack/do damage but players can :S
-
View User Profile
-
Send Message
Posted Feb 28, 2012The 3.0 release will be delayed 1-2 days, sorry guys
-
View User Profile
-
Send Message
Posted Feb 28, 2012@Wu_Zhao
This plugin is designed to work with permissions and nothing else. I won't ever change this. I you want it different then just fork the project on github and change what ever you want.
I can't see the problem with simply installing one of all the permission managers. Most of them a REALLY easy to use and at the same time very powerful.
-
View User Profile
-
Send Message
Posted Feb 28, 2012Just wondering, would it be hard/almost impossible to implant my idé for those who want this to be a standalone mod ? (An "Ignore users" list) Thats my request for this mod anyway.. Or would it be a simple thing? Then why not, having the options to use another permissions mod or not seems good to me atleast =P
-
View User Profile
-
Send Message
Posted Feb 28, 2012@Fafane67
I'll rename the prevention
-
View User Profile
-
Send Message
Posted Feb 27, 2012PvP preventions also prevents players from fighting mobs....a little bit more challenge.
-
View User Profile
-
Send Message
Posted Feb 26, 2012How would I make them able to do everything they weren't allowed to do?
-
View User Profile
-
Send Message
Posted Feb 26, 2012latest 3.0 readme: http://dev.bukkit.org/server-mods/antiguest/pages/3-0-readme/
values for the damage filter list: https://github.com/Bukkit/Bukkit/blob/master/src/main/java/org/bukkit/event/entity/EntityDamageEvent.java#L78
-
View User Profile
-
Send Message
Posted Feb 26, 2012The tests where really successfully and if nothing too bad happens tomorrow i'll definitly release the new version :)
-
View User Profile
-
Send Message
Posted Feb 26, 2012@Wu_Zhao
no other plugins can prevent all the actions my plugin can prevent. (at the moment)
antiguest was designed from hte beginning on to use permissions to decide whether to allow or not allow the player to do something. I have always tried to keep it as simple as possible for the server admins and I don't see where this is in any way more complicated than any other plugin.
-
View User Profile
-
Send Message
Posted Feb 26, 2012I'm an idiot.. got it :)
-
View User Profile
-
Send Message
Posted Feb 26, 2012Just wondering, aren't the bPermissions able to do this already? (same as this mod) If so, then why should you use this mod if i must install bPermissions? Sounds like cake on a cake.
When i found this mod it was because i diden't want to install "too advanced" mods like bPermissions, PEX or other permission plugins, just one simple one..
Why cant you just add the ability to add "ignore users" to the config file, a separate file or something? Pls make the mod simple to use.
-
View User Profile
-
Send Message
Posted Feb 26, 2012@Wu_Zhao
I expanded the description for version 3 which should make it clearer for beginners.
Without a permission manager like GroupManager or bPermissions there is only one thing you can do: op all the players which should be able pass the preventions. This is possible because the permission default to OP.
-
View User Profile
-
Send Message
Posted Feb 26, 2012@ACallander
have you enabled the preventions? with version 3 all preventions are disabled by default
-
View User Profile
-
Send Message
Posted Feb 26, 2012Just wondering "what is a guest" and what determins who is a regular player ? Would be nice to have this in your mod description too.
Perhaps even a video tutorial for install and showing the mod in action etc.
.
UPDATE:
-Some text removed here-
So how do i add me and my friends as a "regular" so this mod dosen't affect regular players? (only guests) (And i dont use any permissions mod, only this one, do i need another permissions mod to use this mod?)
With other words: How and where do i add all trusted player names so those can build, destroy etc and not be affected by this mod?