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 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
  • Avatar of WhosHenry WhosHenry May 05, 2015 at 12:57 UTC - 0 likes

    Posted a bug in the forums about the Region Effects and Fly Flag.

  • Avatar of Headpipe Headpipe May 03, 2015 at 23:07 UTC - 0 likes

    Latest Dev Build is working fine with 1.8.3. Migrated from yaml to mysql this week and custom flags aren't working anymore. They are still in the mysql table but they don't work.

    Imported the custom flags mysql file (thought that would be not neccessary anymore with wg6) in my database and now it's working fine.


  • Avatar of NoHoPeLess NoHoPeLess Apr 25, 2015 at 04:44 UTC - 0 likes

    @xion87: Go

    Yes the falldamage flag dont work with 1.8.3+ i think this flag would be never work... sad...


    Please dear developer, please update this :)

    BalayaCraft! Der etwas andere Server!

    BalayaCraft! Server-IP: | BalayaCraft-Website | Facebook | Twitter | Youtube |

  • Avatar of iversen0 iversen0 Apr 09, 2015 at 18:30 UTC - 0 likes


    [13:29:50 ERROR]: Could not pass event PlayerMoveEvent to WorldGuard v6.0.0-beta-05.1569- with custom flags plugin.
    >       at$1.execute( ~[spigot.jar:git-Spigot-d0d1d87-bc03b6f]
    >       at org.bukkit.plugin.RegisteredListener.callEvent( ~[spigot.jar:git-Spigot-d0d1d87-bc03b6f]
    >       at org.bukkit.plugin.SimplePluginManager.fireEvent( [spigot.jar:git-Spigot-d0d1d87-bc03b6f]
    >       at org.bukkit.plugin.SimplePluginManager.callEvent( [spigot.jar:git-Spigot-d0d1d87-bc03b6f]
    >       at net.minecraft.server.v1_8_R1.PlayerConnection.a( [spigot.jar:git-Spigot-d0d1d87-bc03b6f]
    >       at net.minecraft.server.v1_8_R1.PacketPlayInFlying.a(SourceFile:126) [spigot.jar:git-Spigot-d0d1d87-bc03b6f]
    >       at net.minecraft.server.v1_8_R1.PacketPlayInPosition.a(SourceFile:57) [spigot.jar:git-Spigot-d0d1d87-bc03b6f]
    >       at [spigot.jar:git-Spigot-d0d1d87-bc03b6f]
    >       at java.util.concurrent.Executors$ [?:1.7.0_65]
    >       at [?:1.7.0_65]
    >       at net.minecraft.server.v1_8_R1.MinecraftServer.z( [spigot.jar:git-Spigot-d0d1d87-bc03b6f]
    >       at net.minecraft.server.v1_8_R1.DedicatedServer.z( [spigot.jar:git-Spigot-d0d1d87-bc03b6f]
    >       at net.minecraft.server.v1_8_R1.MinecraftServer.y( [spigot.jar:git-Spigot-d0d1d87-bc03b6f]
    >       at [spigot.jar:git-Spigot-d0d1d87-bc03b6f]
    >       at [?:1.7.0_65]
    Caused by: java.lang.IncompatibleClassChangeError: Found interface, but class was expected
    >       at com.mewin.WGRegionEvents.WGRegionEventsListener.updateRegions( ~[?:?]
    >       at com.mewin.WGRegionEvents.WGRegionEventsListener.onPlayerMove( ~[?:?]
    >       at sun.reflect.GeneratedMethodAccessor116.invoke(Unknown Source) ~[?:?]
    >       at sun.reflect.DelegatingMethodAccessorImpl.invoke( ~[?:1.7.0_65]
    >       at java.lang.reflect.Method.invoke( ~[?:1.7.0_65]
    >       at$1.execute( ~[spigot.jar:git-Spigot-d0d1d87-bc03b6f]
    >       ... 14 more

    Dev build

  • Avatar of xion87 xion87 Mar 25, 2015 at 16:53 UTC - 1 like

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

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