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 May 7, 2012Hi I've just replaced the .jar file with the latest one and getting this
The older version was working fine, i did customize some translations in config.yml Now i see a new folder "preventions" with 40 .yml files am I missing something? thanks
-
View User Profile
-
Send Message
Posted May 6, 2012@Jamesst20
It would be nice if you did that. :)
Just post a link in my IRC channel and I'll put it in later today.
-
View User Profile
-
Send Message
Posted May 6, 2012Did you finish the fr.ini? :P
-
View User Profile
-
Send Message
Posted May 6, 2012so 3.3 is getting tested. It's finally looking good for a release tomorrow :)
-
View User Profile
-
Send Message
Posted May 6, 2012@CarpenterBee
more like shooting the player in the air, slap, kill/kick/ban, starvation, poison, fire, a fake explosion on the player, a fake lightning strike on the player and stuff like that
:) If you have suggestions just post them
some limitations for punishment:
- no world changes (like building a wall around the player)
- no or minimalistic configuration required (they should be as simple as possible)
- no collateral damage (explosions that may damage other players)
- no plugin dependencies (like jailing a player with a jail plugin)
-
View User Profile
-
Send Message
Posted May 5, 2012@QuickWango
So you fixed the issues with the break/place preventions and added a new feature? Punishments? Like jail? :D.
-
View User Profile
-
Send Message
Posted May 5, 2012@ASWeiler
Read my "Edit2*" on my post. I already figured all of that out. And yes, I read everything. But it still doesn't work for me.
-
View User Profile
-
Send Message
Posted May 5, 2012@CarpenterBee
No you are supposed to NOT give the default group that permission. You only give that permission to a group you WANT to be able to do those. Did you read what I said on bPermissions?
-
View User Profile
-
Send Message
Posted May 5, 2012@QuickWango
Wait, don't I just have to give this permission: - antiguest.preventions.breakblock to my default group? and they won't be able to break?
Edit* Oh, so there's an issue with the permissions? So even though I gave my default group the permissions: - antiguest.preventions.breakblock and - antiguest.preventions.placeblock my default group can still build and break? And you said you've fixed this issue?
Edit2* Oops, my bad. It just came to my understanding that those permissions allow people to break/place blocks. I will go into the game and enable the feature that blocks that. And remove those permissions from my default group. Sorry. And I can't wait for the update!
-
View User Profile
-
Send Message
Posted May 5, 2012@CarpenterBee
read my last comments
-
View User Profile
-
Send Message
Posted May 5, 2012Ok, I downloaded AntiGuest, and gave this permission: antiguest.* to EVERY group EXCEPT for my default group, yet my default group can still build? Please help D:
-
View User Profile
-
Send Message
Posted May 5, 2012No bug reports in the comments please!
there is a github issue tracker for a reason!
-
View User Profile
-
Send Message
Posted May 5, 2012So the bugs are fixed, but I'll finish the new feature before I release it: punishments
-
View User Profile
-
Send Message
Posted May 3, 2012@QuickWango
The block-breaking issue i got was with 3.1! o_O
-
View User Profile
-
Send Message
Posted May 3, 2012@reedesler
you're still using 1.1-R4? I won't support it anymore.
@Flenix1
that has actually nothing to do with guests, but if you create an issue on AntiGuest's github repo, I may implement it.
@ everybody reporting the break-/placeblock problem: reporting it once is enough, I know it and will fix it. use 3.1 till then
-
View User Profile
-
Send Message
Posted May 3, 2012Just a small suggestion:
The ability to kill animals, maybe set per-animal. Want only my farmers killing their livestock ;)
-
View User Profile
-
Send Message
Posted May 2, 2012My guests can still break blocks but can't use doors. Need some help here!
-
View User Profile
-
Send Message
Posted Apr 30, 2012v3.0.3 says it supports 1.1-R4, but in the console it shuts itself down saying I need 1.1-R5
Please help, I have been looking for this type of plugin for ages and I'm disappointed that it doesn't work.
-
View User Profile
-
Send Message
Posted Apr 30, 2012@WoodenAxeServer
Same here with 3.1 (3.2 is broken), but only placing of blocks is prevented :S
-
View User Profile
-
Send Message
Posted Apr 26, 2012placeblock and breakblock preventions are not working. this seems like a fairly critical bug seeing as that's the primary purpose of this plugin.