GPFlags is a plugin to allow players to set flags for GriefPrevention claims. Either a single claim or a global flag for all claims. It's similar to WorldGuard, but it's more performant, easier to use, and includes many more useful flags than WorldGuard does. It also doesn't require WorldEdit to run (unlike WorldGuard). Admins can also empower players to self-serve by giving them access to specific flags, which they can then only use on land claims they own.
There are over 80 flags and I frequently add more. A few of the more popular flags are NoMonsterSpawns, EnterMessage, AllowPvP, and NoEnter. If there's a flag you don't see here, contact me through the support Discord and I'll see what I can do.
Click to see all flags
| Flag | Description |
|---|---|
| AllowBlockExplosions | Similar to the GP /claimexplosions command but this one will persist through restarts. |
| AllowPvP | If in the config "PvP Only In PvP-Flagged Claims" is set to true, PvP will be off in the world, and you can then add a flag to a claim to allow PvP in specific claims. There is also an optional message to be sent to players when they enter these claims (can be changed in the config). |
| AllowWitherDamage | Allows withers to deal damage in the claim. Recommended for player usage. |
| BuyAccessTrust | Allows players to buy access trust in the claim. They can use /buyaccesstrust while standing in the claim to buy access trust. The price is determined when setting the flag. |
| BuyContainerTrust | Allows players to buy container trust in the claim. They can use /buycontainertrust while standing in the claim to buy container trust. The price is determined when setting the flag. |
| BuyBuildTrust | Allows players to buy build trust in the claim. They can use /buybuildtrust while standing in the claim to buy build trust. The price is determined when setting the flag. |
| BuySubclaim | Allows players to buy the subclaim. Buying the subclaim will give the buyer all levels of trust and will disable the flag to prevent other players from buying the subclaim after that. |
| ChangeBiome | You can now change the biome in claims. You can also give players permission to set flags, and they can change the biomes in their own claims. When you are using the command to set a biome, it will give you a scrollable list of available biomes. Make sure to type them in exactly. I made the biomes that a player could use permission-based so you can stop players from using certain biomes. Give players the permission gpflags.flag.changebiome. for the biomes they are allowed to use. You need to use the BukkitAPI names for biomes, which can be found here. When a claim is deleted or a ChangeBiome flag is unset, the biome will revert back to its previous state to make sure your world stays looking clean. This will prevent players from running around the world, claiming land, changing the biome, abandoning the claim, and making your world look patchy. Note that removing the flag converts the claim into the biome located just north of the claim which is only sometimes the original claim. |
| CommandBlackList | Blacklist commands. Prevents players from using any commands you list in the flagged area unless they have the gpflags.bypass.commandblacklist permission. Example usage: /SetClaimFlag CommandBlackList sethome;setwarp;kit |
| CommandWhiteList | Whitelist commands. The flag prevents players from using any commands except those you list in the flagged area unless they have the gpflags.bypass.commandwhitelist permission. Example usage: /SetClaimFlag CommandWhiteList tell;me;home |
| EnterCommand | Runs a console command when the player enters this area (Variables: %owner% = Owner of claim in flag, %name% = player in event, %uuid% = uuid of player in event) For multiple commands, separate with a semicolon (;) (make sure to not have spaces after the semicolon). |
| EnterCommand-Owner | Runs a console command when the owner of this claim enters the claim (Variables: %name% = player in event, %uuid% = uuid of player in event) For multiple commands, separate with a semicolon (;) (make sure to not have spaces after the semicolon) |
| EnterCommand-Members | Runs a console command when a member of this claim enters the claim (Variables: %name% = player in event, %uuid% = uuid of player in event) For multiple commands, separate with a semicolon (;) (make sure to not have spaces after the semicolon). |
| EnterPlayerCommand | The same as the EnterCommand flag, except this one will run commands from a player vs from console. (Variables: %owner% = Owner of claim in flag, %name% = player in event, %uuid% = uuid of player in event) For multiple commands, separate with a semicolon (;) (make sure to not have spaces after the semicolon). |
| EnterMessage | Sends a message to the player when they enter this area (Variables: %owner% = Owner of claim in flag, %name% = player in event). |
| ExitCommand | Runs a console command when a player exits this area (Variables: %owner% = Owner of claim in flag, %name% = player in event, %uuid% = uuid of player in event) For multiple commands, separate with a semicolon (;) (make sure to not have spaces after the semicolon). |
| ExitCommand-Owner | Runs a console command when the owner of this claim exits the claim (Variables: %name% = player in event, %uuid% = uuid of player in event) For multiple commands, separate with a semicolon (;) (make sure to not have spaces after the semicolon). |
| ExitCommand-Members | Runs a console command when a member of this claim exits the claim (Variables: %name% = player in event, %uuid% = uuid of player in event) For multiple commands, separate with a semicolon (;) (make sure to not have spaces after the semicolon). |
| ExitPlayerCommand | Same as ExitCommand except this will run the command from player vs from console (Variables: %owner% = Owner of claim in flag, %name% = player in event, %uuid% = uuid of player in event) For multiple commands, separate with a semicolon (;) (make sure to not have spaces after the semicolon). |
| ExitMessage | Sends a message to the player when they leave this area (Variables: %owner% = Owner of claim in flag, %name% = player in event). |
| HealthRegen | Health is regenerated when the player is in this area. |
| InfiniteArrows | Arrows shot into this area will be given back to the player after it makes contact. |
| KeepInventory | A player will keep their inventory if they die in this area. |
| KeepLevel | Prevents players' xp from dropping when they die in this area. |
| KeepLoaded | Will keep the claim loaded. |
| NetherPortalConsoleCommand | Executes console command when entering a Portal. Runs one or more console commands when a player steps through a nether portal in the flagged area. Use %name% or %uuid% placeholders to target the player stepping through the portal, and separate multiple command lines with semicolons (;). If your in-game command entry box is too short for all your commands, consider backing-up your flags.yml file and then modifying it with a text editor to get more command lines in for a single portal, then using /GPFReload to load your edited file. Example usage: /SetClaimFlag NetherPortalConsoleCommand tp %name% 0, 65, 0;xp 10L %name% |
| NetherPortalPlayerCommand | Executes player command when entering a Portal. Causes any players who walk into a nether portal in the area where the flag is applied to automatically run a command line instead of teleporting (it runs as the player, not as a console command). Helpful to give players a /home portal or random wilderness teleport portal, for example. |
| NoAnvilDamage | Prevents anvils from being damaged from being used. This flag is only supported on Paper and forks of Paper. |
| NoBlockForm | Prevents blocks from forming or spreading based on world conditions. Examples: snow forming due to a snow storm, ice forming in a snowy biome like taiga or tundra, obsidian/cobblestone forming due to contact with water, and concrete forming due to mixing of concrete powder and water. |
| NoBlockGravity | Prevents blocks like sand and gravel from falling. |
| NoChorusFruit | Prevents players from teleporting when they eat chorus fruit in this area. |
| NoCombatLoot | Clears drops on entity death. When a mob (except for players) dies in an area with this flag active, no loot will drop. Using this, you can create combat challenges where players can keep their inventories and experience (with other flags above), but prevent players from abusing those flags to farm loot. Player death loot is controlled by the above KeepInventory flag. |
| NoElytra | Prevents players from using elytra. |
| NoEnderPearl | Prevents players from teleporting when they throw an ender pearl in this area. |
| NoEnter | Prevents all players from entering this area. |
| NoEnterPlayer | Blocks specific players from entering this area. |
| NoExpiration | Disables claim expiration. |
| NoExplosionDamage | Disables damage caused by explosions (ie: creepers & tnt). |
| NoFallDamage | Prevents players from taking fall damage in this area. |
| NoFireDamage | Prevent fire from damaging blocks in this area.Requires FireDamage in the GP config to be enabled! |
| NoFireSpread | Prevent fire from spreading in this area. Requires FireSpread in the GP config to be enabled! |
| NoFlight | Prevents players from flying in this area. |
| NoFluidFlow | Prevents fluid from flowing in this area. |
| NoGrowth | Stop plants from growing (crops) and blocks from spreading (podzol, grass, seagrass, kelp) in this area. |
| NoHunger | Prevents hunger loss for all players who enter this area. |
| NoIceForm | Stops ice from forming in this area. |
| NoItemDamage | Prevents players' items from taking durability hits. |
| NoItemDrop | Prevents players from dropping items in this area. |
| NoItemPickup | Prevents players from picking up items in this area. |
| NoLeafDecay | Prevents leaves from decaying in this area. |
| NoLootProtection | Disables loot protection on player death. Disables GriefPrevention's player death loot "anti-theft" feature in the flagged area, allowing any player to pick up the items a player drops when he or she dies in that area. Useful for competitive areas where loot can be a reward, like PvP arenas. |
| NoMcMMODeathPenalty | Disables McMMO death penalty - cancels McMMODeathPenalties when a player dies in a flagged area. |
| NoMcMMOSkills | Prevents mcMMO skill usage (activated skills, secondary skills, disarms, etc) in the flagged area. You might use this to create PvE challenge areas or specialized PvP arenas where mcMMO won't give some players an advantage over others. |
| NoMcMMoXPGain | Disables McMMO experience gaining in the claim. |
| NoMobDamage | Prevents mob damage in this area. This does not affect players, this will only prevent entities from damaging passive mobs. (ex: wolves cant hurt sheep) |
| NoMobSpawns | Prevents ALL mobs from spawning in this area, good or bad! |
| NoMobSpawnsType | Prevents specific types of mobs from spawning in this area. Can support multiple types. Must use Spigot EntityType enums. To add multiple types, separate with a semi-colon ; Example usage: /setclaimflag NoMobSpawnsType creeper;cow;zombie;wandering_trader;phantom Permissions for this flag are per mob type, for example, gpflags.flag.nomobspawnstype.cow. |
| NoMonsters | Prevents all bad mobs from spawning in this area, and will also prevent them from entering the area. If they do, they will be removed. |
| NoMonsterSpawns | Prevents all bad mobs from spawning in this area. If they spawn outside of the area, they will be able to walk in. |
| NoOpenDoors | Prevents players from opening doors/gates/trapdoors in a claim. This flag will follow GP's permissions, meaning an owner and a member with access trust or higher will be able to open doors. Supports parameters (doors, trapdoors, gates), to use multiple parameters, separate with a comma. |
| NoPetDamage | Prevents players from damaging pets in this area |
| NoPlayerDamage | Prevents players from taking any damage in this area |
| NoPlayerDamageByMonster | Prevents players from taking damage from monsters in this area |
| NoSnowForm | Prevents snow from forming in this area |
| NoVehicle | Stops players from placing and using vehicles (boats/minecarts) in claims |
| NoVineGrowth | Stops vines from growing in this area |
| NoWeatherChange | Disables weather change - prevents weather from changing in a world, even by operators using commands. If you change your mind about the weather in a world, you have to first disable the flag, then change the weather, then re-enable the flag. You should use this only with /setserverflag or /setworldflag, because it has no effect on individual land claims or subdivisions. Note: If you lock the weather during a thunderstorm, it will never end. If you lock the weather when there is no thunder, a storm will never come. |
| NotifyEnter | Sends the claim owner a message when a player enters the claim. |
| NotifyExit | Sends the claim owner a message when a player exits the claim. |
| OwnerFly | Allows an owner of a claim to fly within their own claim |
| OwnerMemberFly | Allows owners of the claim and members with access trust or higher to fly within the claim |
| PlayerTime | You can set the time in a claim for a player. When the player enters, their time will be set to one of the 4 options. When they leave the claim, it will reset to match world time. Usage: /setclaimflag playertime |
| PlayerWeather | You can set the weather a player will see when they enter a claim. This is client-side and will not affect the rest of the world. /setclaimflag playerweather . Thunderstorms are not supported. |
| ProtectNamedMobs | This will protect mobs that have a name (ie: using a name tag or via commands). Players with container trust will still be able to harm/kill said mob, but visitors to your claim will not be able to harm them. |
| RaidMemberOnly | Prevent non-members of claims from triggering raids. (This may be a temporary flag if GP decides to put something directly in GP) |
| ReadLecterns | Allows players to read but not manipulate, any lectern with a book on a claim. This flag has bugs that I do not plan to work on. |
| RespawnLocation | Sets spawn location for the claim (Useful for PvP arenas). Overrides the usual respawn rules to respawn the player in a specific location who dies in the flagged area. For example, consider respawning a player at the beginning of a parkour challenge or just outside a pvp arena. You may optionally specify pitch and yaw (facing direction) as well. Example usages: /SetFlag RespawnLocation world 112.5 68 265.5 or /SetFlag RespawnLocation world 112.5 68 265.5 90 45 |
| SpawnReasonWhitelist | Denies all mob spawns unless the spawn reason is whitelisted. |
| SpleefArena | Complex flag to create spleef arenas. SpleefArena - Completely automates a Spleef minigame (players compete to remove blocks out from under each other until someone falls) in the flagged area. Example usage: /SetFlag SpleefArena minecraft:snow_block minecraft:bricks 20. The above example will generate a snow block (minecraft:snow_block) 20 blocks above every bricks block (minecraft:bricks) in the flagged area every time a player dies in the flagged area. It will also allow ONLY snow blocks to be broken by any player even without build permission, and won't drop those blocks as items when they're broken. To set up a spleef arena, first flag the claim or subdivision as shown above. Then dig down underneath where the breakable arena surface (snow block in the above example) will be and use your marker blocks (bricks in the above example) to indicate the shape of your arena, which does NOT have to be flat, rectangular, or single-block thick. The y offset (the last flag parameter) dictates how far down you have to place the marker blocks from where you want the arena surface to generate. To test your settings, use the Vanilla /kill command while standing in the flagged area. Your death will trigger the arena surface to be built per your specifications. |
| TrappedDestination | Sets trapped destination for the claim (Useful for admin claims). Allows players to use GriefPrevention's /trapped command in administrative land claims by specifying where the player will go when he gets "unstuck". Ordinarily, administrative land claims don't allow players to use the command at all. |
| ViewContainers | Allows players to view but not manipulate, any container on a claim. |
See the wiki for all available commands and permissions.
Development builds can be found on Jenkins and in the support Discord.
