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 Kixot14 Kixot14 Sep 30, 2016 at 18:41 UTC - 0 likes

    @sgdc3: Go

    WG 6.1.3 (build 1685) not sees the fly flag!

    Unknown flag specified... Works only if i set this flag by hand in config of WG regions.

    With WG 6.1.2 no problem

    Last edited Sep 30, 2016 by Kixot14
  • Avatar of Freack100 Freack100 Aug 08, 2016 at 11:47 UTC - 0 likes

    @sgdc3: Go

    I uploaded your .jar to my maven repository too. I hope this helps someone ^^

    Just add "" as a repo.

  • Avatar of hackscomicon hackscomicon Aug 07, 2016 at 13:16 UTC - 1 like

    @sgdc3: Go

    I thank you!!! THANKS DUUUUDE!

  • Avatar of sgdc3 sgdc3 Aug 06, 2016 at 10:15 UTC - 2 likes

    I found version 1.9.1 for MC 1.10 on the author's github profile, if you want to download the compiled jar i've added it to my build server:

  • Avatar of hackscomicon hackscomicon Jul 24, 2016 at 09:07 UTC - 1 like

    We need update. is he still alive?

  • Avatar of Kixot14 Kixot14 Jul 24, 2016 at 00:00 UTC - 0 likes

    Is the author of this plugin still alive ?? We need update!!!

    Last edited Aug 05, 2016 by Kixot14
  • Avatar of cicatrice74 cicatrice74 Jul 05, 2016 at 18:44 UTC - 1 like

    Why aren't you updating this ? Please update to latest Spigot this resouce or at least update to latest wg custom flag auto support. But say something or maybe you should delet the resuorce at all if you are not going to update anymore

  • Avatar of Layania Layania Jun 30, 2016 at 07:44 UTC - 1 like

    Yes, the plugin need an update to last worldguard.
    We need to use old worldguard version in 1.10 or flags are unknow.

  • Avatar of mibby2 mibby2 Jun 18, 2016 at 09:44 UTC - 0 likes

    Please update the custom flag modules to support hooking into WG6's custom flag API directly. Instabreak flag for example broke entirely. :(

  • Avatar of cicatrice74 cicatrice74 Jun 17, 2016 at 15:37 UTC - 0 likes

    is there any way to have this updated? please developer respond...i need this

Whats your favourite WorldGuard Custom Flags plugin?

  1. Choice:

  1. Results
  2. 7 comments


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



Required dependency