WorldGuard Custom Flags
Description
About WorldGuard Custom Flags
WorldGuard Custom Flags allows modders to create, set and get custom flags on WorldGuard regions. As a user you just need to download this if a plugin requires it, it does not do anything on its own.
If you have problems with any WorldGuard Custom Flags plugin post it at the forum.
This is also the right place to post your WorldGuard Custom Flags plugins or suggestions for plugins.
From now on I will ignore (and delete) any issue reported in the comments section.
It automatically uses the same database as WorldGuard (if specified), but you need to create the table manually using an included sql-file.
WorldGuard Custom Flags is also available on github. If you want a version for any other Java version than 7 you will have to compile it yourself.
Click here for some useful plugins using WorldGuard Custom Flags or here for a list of all flags added by my/BangL's plugins.
Problems?
If you have a problem with WorldGuard Custom Flags or any of my plugins using it read this, please.
Donate
If you want to support me with a donation you can click the donate button on the top right corner (above the search box) or here (or here if you want to donate in €).
Setup
To setup WorldGuard Custom Flags you just have to drag and drop the jar-file into your "plugins" folder. If you use a database for WorldGuard you have two possibilities:
Force WG Custom Flags to use a flat file
If you do not want WG Custom Flags to use the database you have to follow these steps:
- after dropping the jar-file into your "plugins" folder start the server one time
- you can ignore the error message this will produce
- stop the server
- now go to "plugins/WGCustomFlags" and edit "config.yml"
- simply change the "save-handler" property to "flat" to force flat file saving
- if you start the server again the plugin will use the flat file
Setup the database
If you want WG Custom Flags to use the WorldGuard database you simply have to import the sql-file into your database.
- if you are using MySQL and PhpMyAdmin you can simply use the PhpMyAdmin web interface to import the file
- if you use MySQL, but no PhpMyAdmin you have to upload the file to your server and execute:
Of course you will have to replace "root" with your database user. After the command you have to enter the password.
mysql -u root -p database < worldflags.sql
Commands
- /flags [-d|-i <flag>]
- /flags lists all custom flags
- /flags -d lists all flags (including the default ones)
- /flags -i <flag> displays information about a flag
Permissions
- wgcustomflags.flags
- default: allowed for ops
- limits the usage of the /flags command
The future / WorldGuard 6
In a future update of WorldGuard the plugin will support custom flags by default. When this gets released I will update this plugin a last time to be used as a bridge for any other WorldGuard Custom Flags plugin that has not been updated at that moment. All my plugins will be updated to use the WorldGuard API instead and this project will be abandoned after some time, but I hope I will get more than 50,000 downloads till then :-) .
Developer information
WG Custom Flags supports the following flag types:
- BooleanFlag
- CommandStringFlag
- DoubleFlag
- EntityTypeFlag
- EnumFlag
- IntegerFlag
- LocationFlag (better use CustomLocationFlag, it does not produce error messages if WorldGuard uses a database as this does)
- SetFlag (better use CustomSetFlag)
- StateFlag
- StringFlag
- VectorFlag (better use CustomVectorFlag)
Click here for more information on developing.
Is there a command to apply a flag to the entire world? If so what is it?
der_mewin, any ETA on the planned Permissions Flag?
@Lyoko_Firelyte
Ok somehow missed that will have a play with that that thanks, but is there a inverse ie specifying what mob to allow spawning, reason is im running some custom non-bukkit mods under mcpc-plus and it would be easier to specify which mobs are safe for some areas as there's not as many and its safer :) its not creepers its the add on mobs they are not really recognized properly under bukkit plugins ( creeperheal takes care of the creepers fine , as does preciousstones ) mob-spawning: deny worked but is to much :) now to try and identify the mob names , fun Dang no go, because bukkit does not recognize the mob name, something to do with mcpc-plus (forge) i gather.
@ohjays
That is in default worldguard...
/rg flag <region> deny-spawn cow,chicken,etc...
For damage:
/rg flag <region> mob-damage deny or /rg flag <region> creeper-explosion deny
Etc.
@xlii1356
I am working on one ;)
Is there a custom flag to control weather? Like a region where it's always raining, or never rains? I know by default there's one for snow, but i can't seem to find one for rain
Is there a custom flag to stop mobs from causing damage to the envirenment , ie any blocks im running mcpc-plus and have added mo'creatures and some of them i do not want tearing u the place except away from the city :) ??
Had a play with the mob-spawning flag and that works to remove mobs, but unfortunately all of them and farms no longer breed :) is there a way to specify say mobs that may still spawn, ie sheep, chickens and such
Isn't there really ANY flag that denies the placement of blocks only? WG only has "build" which includes placement and breaking of blocks. Why not a simple place flag?
@mclightcraftproduction
You can use Explosion flags for this :)
So with this Plugin it is possible to disable the command for example. /tp in Region a AND subcommands like ./skill Skill1 but allow ./skill Skill2 ?
It would be great if someone could make a wither-explosion allow/deny flag could make!
@saxons12
As neither the WG Custom Flag plugin nor WGPlayerDamageFlags are affected by the WorldGuard configuration there is no problem if you disable it.
Do I have to have the option "use-player-move-event: true" in the WG config for this plugin to work? Or can I disable it?
I'm only using WGPlayerDamageFlags + This plugin.
Thanks!
@amunro
Sorry, my fault. The file is inside a zip folder, but I just uploaded the jar file for 1.5.1. You can download 1.5 or wait for me to update it again ;).
I don't get it, where the hell do I download worldflags.sql from? You haven't even commited it to github :S
@mclightcraftproduction
Maybe you should take a look on Player Damage Flags. ;)
Maybe could someone make a flag where you can disable falling damage?
@UltramarineXIII
WG has that flag built in iirc
http://dev.bukkit.org/server-mods/worldguard-custom-flags/forum/problems/bugs/50723-wg-save-massive-lag/
Please fix the lag issue while saving data. It is causing massive lag on my server!