WorldGuard Custom Flags


WorldGuard 6 users: download the latest beta build of my plugins here.

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 xion87 xion87 Mar 25, 2015 at 16:53 UTC - 0 likes

    falling damage flag don't work anymore, falling damage flag is missing, no flag added

  • Avatar of VoxaDub VoxaDub Mar 25, 2015 at 08:39 UTC - 0 likes

    Is this going to be updated to 1.8 anytime soon?

  • Avatar of resitancedude resitancedude Mar 13, 2015 at 23:01 UTC - 0 likes

    @der_mewin: Go

    Can you add this ? - If you have a certain item ( suport lore and cutom name ) you can enter the region, but if you don't have it, you can't enter ?

  • Avatar of TheOnlyRealTGS TheOnlyRealTGS Mar 09, 2015 at 20:47 UTC - 0 likes

    Could you update this to 1.8.3?

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

  • Avatar of NathanWolf NathanWolf Feb 23, 2015 at 20:01 UTC - 0 likes

    Would it be at all possible to make it so custom flags don't disappear if the plugin that registers them fails to load?

    I've had all my flags vanish a few times, like when disabling a plugin for testing. It can be a real pain to fix!

    Thanks for this awesome plugin, I am using several of your variants (custom spawn location, keep in, commands) as well as have integrated support into my own plugin for custom lists- it just works awesomely, except for this one little nitpick.


  • Avatar of der_mewin der_mewin Jan 07, 2015 at 22:29 UTC - 1 like

    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 rasnyderiii rasnyderiii Jan 07, 2015 at 22:07 UTC - 0 likes

    I find all updates but Project WGCustomFlags on the Jenkins? play games | change lives
  • Avatar of TheOnlyRealTGS TheOnlyRealTGS Jan 06, 2015 at 16:57 UTC - 0 likes

    @RealityIntern: Go

    Yeah, it seems that some flags breaks the plugin on WG 6 + Spigot 1.8

  • Avatar of RealityIntern RealityIntern Dec 31, 2014 at 10:23 UTC - 0 likes

    This works fine on 1.8 as far as I can tell. My guess is that you're using WG6 without a WGCustomFlags compatible build from der_mewin's build site that was posted in the comments below, or you're using a flags plugin that hasn't been updated for WG6. Blockrestrictor, instabreak and effects get event errors, whereas chat flags works fine.

    - PseudoKnight

    Last edited Dec 31, 2014 by RealityIntern


Whats your favourite WorldGuard Custom Flags plugin?

  1. Choice:

  1. Results
  2. 6 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