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 zathrus_writer zathrus_writer Jan 23, 2016 at 19:46 UTC - 0 likes

    A new kid on the block - auto-refill flag for WorldGuard regions:

  • Avatar of Florian28600 Florian28600 Jan 14, 2016 at 09:33 UTC - 0 likes

    Hello No speak english, i am French

    There is a problem with the new version 6.1 with WorldGuard and Worldguard Spawn Point Flag I am forced to version 5.9 for the plugins works

  • Avatar of ratg97 ratg97 Jan 02, 2016 at 15:40 UTC - 0 likes

    custom messages please for block commands

  • Avatar of Jordan106 Jordan106 Nov 15, 2015 at 04:27 UTC - 0 likes

    Help please the /flag Thing doesnt work here is a video of me showing you

  • Avatar of KrommeOpa KrommeOpa Oct 23, 2015 at 14:51 UTC - 0 likes

    @crckdns: Go

    Can't you do that with PermissionsEx?

  • Avatar of ChillerKraft ChillerKraft Aug 23, 2015 at 07:06 UTC - 0 likes

    FIRST;P ty4^d8!

  • Avatar of crckdns crckdns Jul 14, 2015 at 19:38 UTC - 0 likes

    From what I understand.. this whole plugin and the subplugins depending on it... are no further active and working?

    damn, I need really bad a ability to forbid any blockbreaking with only few whitelisted blocks :/

  • Avatar of ChillerKraft ChillerKraft Jun 24, 2015 at 09:13 UTC - 0 likes

    @Keyman1986: Go

    correct. it's sending a message to the player that they aren't allowed to do that, but still letting it happen. please help

    it's not necessarily something that needs to be fixed btw keyman, it's possible that there's a way to fix this problem that doesn't involve updating the plugin. either way, please help us fix this dillema so we can continue using wgregionevents

    oh by the way, it's only when wg region events is installed onto the server when this problem occurs. it doesn't occur with just wgcustomflags by itself

    Last edited Jun 24, 2015 by ChillerKraft
  • Avatar of Keyman1986 Keyman1986 Jun 23, 2015 at 21:59 UTC - 0 likes

    This plugin is causing our enderpearl flag to not be denied! Please patch thanks!

  • Avatar of Layania Layania May 06, 2015 at 08:49 UTC - 0 likes

    Thanks to this wonderfull plugin :)

    Last edited May 06, 2015 by Layania

Whats your favourite WorldGuard Custom Flags plugin?

  1. Choice:

  1. Results
  2. 7 comments


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



Required dependency