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 ... | Enabled by default | Filterable | Punishable |
|---|---|---|---|---|
| afk | idling players by kicking them after a configured time | no | no | no |
| bed | sleeping | no | no | yes |
| bow | shooting bows | yes | no | yes |
| breakblock | breaking blocks | yes | yes | yes |
| brew | brewing | no | no | yes |
| button | pushing buttons | no | no | yes |
| cake | eating cakes | no | no | yes |
| changesign | changing signs | yes | no | yes |
| chat | chatting | no | no | yes |
| chest | accessing chests | yes | no | yes |
| command | using specific commands | yes | yes | yes |
| damage | getting damaged | no | yes | no |
| dispenser | accessing dispensers | no | no | yes |
| door | opening or closing doors (including fence gates) | yes | no | yes |
| drop | dropping specific items | no | yes | yes |
| enchant | accessing enchantment tables | no | no | yes |
| fight | damaging other players | yes | no | yes |
| fish | fishing | no | no | yes |
| furnace | accessing furnaces | no | no | yes |
| hunger | starvation | yes | no | no |
| item | using specific items | no | yes | yes |
| jukebox | using jukeboxes | no | no | yes |
| lavabucket | using lava buckets | yes | no | yes |
| lever | using levers | no | no | yes |
| milking | milking cows | no | no | yes |
| monster | getting targeted by mosters | yes | no | yes |
| move | moving too far | yes | no | yes |
| noteblock | using noteblocks | no | no | yes |
| pickup | picking up specific items | no | yes | yes |
| placeblock | placing blocks | yes | yes | yes |
| pressureplate | triggering pressure plates | no | no | yes |
| repeater | changing the repeater delays | no | no | yes |
| shear | shearing animals | no | no | yes |
| sneak | sneaking (hiding the name above his head) | no | no | yes |
| spam | spam | yes | no | yes |
| swear | swearing | yes | no | yes |
| tame | taming animals | no | no | yes |
| vehicle | using vehicles (entering, placing, destroying, pushing) | no | no | yes |
| waterbucket | using water buckets | yes | no | yes |
| workbench | accessing workbenches | no | no | 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, positivlist)
- blacklist: only the listed entries will be prevented (aliases: 1, black, negativlist)
- 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 automaticly 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 | none |
| 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 fkae lightning on the player | damage: the damage to deal |
| message | Makes the player send an awkward message | message: the message to send |
| poison | Poisons the player | duration: the effect durection in seconds |
| 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 badword to the swear prevention |
| disable <prevention> [-t] | disables a prevention |
| enable <prevention> [-t] | enables a prevention |
| reset | resets all configurations |
Installation
AntiGuest 3 needs at least Bukkit 1.1-R5!
Steps
- Just put the AntiGuest into your plugins folder
- If you're upgrading from an older version you might remove you config to get a fresh one
- restart/reload your server
- The configuration file will be generated/updated as soon as the plugin gets enabled
Permissions
| Permission node | Description |
|---|---|
| antiguest.* | Allows the player to do everything |
| antiguest.commands.* | Allows the player to run all commands |
| antiguest.commands.<command> | Allows the player to run the specific command |
| antiguest.preventions.* | Allows the player to pass all preventions |
| antiguest.preventions.<prevention> | Allows the player to pass the specific prevention |
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 freetime, so keep me interessted 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)
Facts
- Date created
- Sep 25, 2011
- Category
- Last update
- May 07, 2012
- Development stage
- Release
- Language
- deDE
- enUS
- License
- GNU General Public License version 3 (GPLv3)
- Curse link
- AntiGuest
- Downloads
- 6,261
- Recent files
- R: AntiGuest v3.3.0 [1.2.5-R1.2] for CB 1.2.5-R1.2 May 07, 2012
- R: AntiGuest v3.2.0 [1.2.5-R1.0] for CB 1.2.5-R1.0 Apr 21, 2012
- R: AntiGuest v3.1.0 [1.2.4-R1.0] for CB 1.2.4-R1.0 Apr 02, 2012
- R: AntiGuest v3.0.3 [1.1-R4] for CB 1.1-R4 Mar 10, 2012
- R: AntiGuest v3.0.2 [1.1-R6] for CB 1.1-R4 Mar 04, 2012
Authors
-
- Manager
- Author
-
- Tester
-
- Contributor
- Reply
- #219
QuickWango May 11, 2012 at 16:27 UTC - 0 likes@instinxx: Go
yeah you're welcome, just join my IRC channel on EsperNet: #cubeisland-dev (webchat in the description)
AntiGuest - Announcer - HideMe - ApiBukkit - AdminBukkit - PlayerSignature - gmChat - ItemRepair
Cube Island
Follow me on Github
- Reply
- #218
instinxx May 11, 2012 at 16:21 UTC - 0 likesGreat! Thanks QuickWango. I can BetaTest if needed.
- Reply
- #217
QuickWango May 11, 2012 at 15:04 UTC - 0 likes@ryanwagner: Go
I'll check that
- Reply
- #216
ryanwagner May 11, 2012 at 13:41 UTC - 0 likes<<reply 699935>>
@QuickWango:
Here is my drop entry: (3, 4, 50, and 87 are not droppable)
drop:
enable: true
message: '&4Use Secure Trading or Disposal Signs!'
mode: whitelist
list:
- 3
- 4
- 50
- 87
- Reply
- #215
QuickWango May 11, 2012 at 13:15 UTC - 1 like@instinxx: Go
That's a great idea! i'll definitly implement that in the next version if it is possible
- Reply
- #214
instinxx May 11, 2012 at 12:01 UTC - 0 likesHi all. I am looking to use a plugin like this to achieve a Gray-list, but curious if there is a possibility to add a feature to limit Gray-listed players to X number of slots, or to have the server drop a gray-listed visitor for a white-listed player? For smaller servers I wouldn't want to lose player slots due to an influx of visitors. Is there any possibility for something like that?
- Reply
- #213
QuickWango May 10, 2012 at 21:48 UTC - 0 likes@ryanwagner: Go
the filtering is explained right under the preventions table
- Reply
- #212
ryanwagner May 10, 2012 at 19:58 UTC - 0 likesFor the drop filter it defaults to type: blacklist
i took a guess and assumed that it also supported type: whitelist
however, that does not appear to be working. How do I set it so only defined items are droppable?
- Reply
- #211
QuickWango May 09, 2012 at 21:58 UTC - 0 likes@DukeVyner: Go
yep they're fully configurable on a per-prevention basis.
every prevention that allows punishing has its own punishments-section.
- Reply
- #210
DukeVyner May 09, 2012 at 20:53 UTC - 0 likesIs it possible to display a different message for each punishment?