WorldGuard Custom Flags


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.


If you have a problem with WorldGuard Custom Flags or any of my plugins using it read this, please.


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 €).


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:

  1. after dropping the jar-file into your "plugins" folder start the server one time
  2. you can ignore the error message this will produce
  3. stop the server
  4. now go to "plugins/WGCustomFlags" and edit "config.yml"
  5. simply change the "save-handler" property to "flat" to force flat file saving
  6. 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:
    mysql -u root -p database < worldflags.sql
    Of course you will have to replace "root" with your database user. After the command you have to enter the password.


  • /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


  • 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.

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of UnwrittenPaper UnwrittenPaper Oct 26, 2014 at 01:42 UTC - 0 likes

    This plugin is amazing!

    It works perfectly for my 1.7.10 server (! Read More Here, here, here, or here.

  • Avatar of Kiratsu Kiratsu Oct 18, 2014 at 19:31 UTC - 0 likes

    I have a small problem, I created about 7-8 StateFlags, the first two of them works fine, but the others are not in the flag list and when I try to set them on a region, the plugin tells me that the flag does not exist. But the console tells me that all the flags are properly created. Any idea ? Is there a max amount of flags for World Guard ?

    Bug corrected when upgraded WG to 5.9

    Last edited Oct 18, 2014 by Kiratsu
  • Avatar of Dillzzzzz Dillzzzzz Oct 16, 2014 at 11:16 UTC - 0 likes

    I was wondering if there's a way to make it so people are barely visible. This would be used SO much as it's useful for spawns.

    Havoc OP PvP Banner

  • Avatar of Sinnerkills Sinnerkills Oct 12, 2014 at 06:24 UTC - 0 likes

    This plugin isn't working for me, is it because I'm 1.7.10? If so does anyone else know a way to allow flying in Regions and some worlds?

    I'm just trying to learn!

  • Avatar of der_mewin der_mewin Sep 09, 2014 at 18:18 UTC - 0 likes

    @TheOnlyRealTGS: Go

    As far as I know there is still no stable WG 6 build, where did you read that? :O

    Edit: I just created a beta build to support WG 6, but its not stable and I dont know if saving the flags to database works. You can get it here: .

    Additionally it does not look like the WorldGuard team did add the possibilty to add custom flags yet, so you will probably still need this plugin in the future.

    Last edited Sep 09, 2014 by der_mewin: typo

    Oh long johnson! Oooh long joohnsoon!!
    Wow, that is so complex and trippy and cool.
    Biggie Smalls, Biggie Smalls, Biggie Smalls!
    Vengeance is mine! You are all ants, and I am your destroyer!! Ha-ha.

  • Avatar of TheOnlyRealTGS TheOnlyRealTGS Sep 09, 2014 at 15:27 UTC - 1 like

    WorldGuard 6 is out! Is this still needed?

    Owner of MC-Simple Gaming! Hope to see you there :)
    Need a free BuyCraft alternative? Try MinecraftMarket! | Need a great Spleef plugin? Try HeavySpleef!

  • Avatar of binxycraft binxycraft Aug 29, 2014 at 09:56 UTC - 0 likes

    Yes, I have it working with latest spigot.

  • Avatar of DeadIntermediate DeadIntermediate Aug 10, 2014 at 06:25 UTC - 0 likes

    Compatible with spigot?

  • Avatar of GuilhermeTonello GuilhermeTonello Jul 29, 2014 at 00:08 UTC - 0 likes

    Can you add to add a permission for a region?

    Hello, I like cake's and you?
    Olá, eu gosto de bolos e você?

  • Avatar of allochtonenking allochtonenking Jul 23, 2014 at 19:25 UTC - 0 likes

    helppppppppppppp how to set a effect in a region helppp plssssss

Whats your favourite WorldGuard Custom Flags plugin?

  1. Choice:

  1. Results
  2. 5 comments


Date created
Oct 10, 2012
Last update
Apr 04, 2014
Development stage
GNU General Public License version 3 (GPLv3)
Curse link
WorldGuard Custom Flags
Recent files



Required dependency