Flags

Flags Logo

Flags is an interface plugin designed to bridge the gap between cuboid and other land management plugins and other plugins that would need to access them.

Based on similar concepts of Vault, Flags provides a single unified object or "Area" for developers to have basic access to the information it holds without the need to know which plugin created it. This allows developers to implement per-area features one time and have them work automatically with all the supported land management plugins.

Though it has grown far beyond it's original purpose, Flags gets it's name from it's ability to allow plugins to create "flags" or switches that change the behavior of the game or plugin in specific areas. Flags will automatically maintain the users choices and customizations, and the plugins that created the flags merely have to handle their behavior. Don't let the name fool you, plugins can use the API for hooking into areas without actually creating flags at all.

UUID Notice
Flags v2.0.0 (currently in testing) is mostly UUID compliant. Features pertaining to land ownership are dependent on individual area plugins being updated. Flags will work if they have been updated or not, but systems that have been updated are more reliable. For more information on Flags' migration to UUID, and a list of plugins that have updated, please read this topic.

If you wish to assist in testing, please read Testing Information and Upgrade Instructions

Commands Configuration Permissions Area Plugins Frequently Asked Questions Developer API

Features

  • Multiple land area plugin support
  • Modular flags allow you to choose only what you want.
  • Developer API allows anyone to create flag plugins or interface with areas.
  • Flags can be set for areas, the wilderness, or new area defaults.
  • Trust lists allow you to choose players that can bypass flag effects in each area.
  • Customizable player messages allow you to personalize all player flags per area.
  • Customizable flag bundles allow you to set multiple flags in a single command.
  • Multi-world support allows you to treat each world as a different area, including the wilderness and defaults.
  • YAML and MySQL data storage options for flexible servers
  • Vault economy support for purchasing flags and messages

Supported Area Plugins (optional)

Flags currently supports Factions, Factoid, Grief Prevention, InfinitePlots, PlotMe, PreciousStones, Residence, and WorldGuard. Flags also has an internal system it uses if no other system is detected. For more details on compatibility and feature sets, please visit the Area Plugins page.

Plug-ins and Modules

Included Modules

Included with Flags is a set of optional flag modules available that operate with just Bukkit. To install them, place the modules you want to use in your plugins folder, along with Flags.jar.

ModuleDescription
Block ModuleAdds flags based on block control.
Border Patrol ModuleAdds flags based on players moving into or out of an area.
Core ModuleAdds general flags that don't fit with any of the other included modules.
Creature Spawn ModuleAdds flags for stopping creatures from spawning.
Damage ModuleAdds flags for stopping types of player damage.
Player ModuleAdds flags based on player actions.
Vehicle ModuleAdds flags based on boats, minecarts, and horses.

External Plugins and Modules

Below is a list of known plugins and modules not included with Flags that add their own flags. If you have developed a plugin with Flags support or a module and want it listed here, add a post to the developer forum!

PluginDescriptionFlags
BlockNotifNotifies moderators when players break certain blocks, logs it, and prevents it from occurring.None. Flags is used to report the name or ID of the area defined by the system your using.
FancyShopCreates chest shops that trade in physical currencies.Flags that allow shops to be restricted to specific areas.
FlyNCreativeAllows server operators to set areas where creative mode and flight are enabled while maintaining inventories for those areas.Flags to select Flight and/or Creative mode.
HardcoreClaimsGrief Prevention extension that deletes claims and restores the land when a player dies.Flags for choosing which claims get deleted and what areas players must die in to cause a deletion.
PetStoreManage ownership of tameable animals.Flags for choosing where animals can be left for sale, give away, or released.
RocketTeleportPlugin that adds a new flare to warping/teleporting.Flags for choosing where players can create rockets and landing zones.

Flag Usage

NEW: Tutorial: Understanding Area, Wilderness, and Default

To set flags for an area, simply stand inside the area that you would like to set a flag for and issue the command /flag <action> <location> <flag> [value]. For more detailed information, consult the Commands page. Setting a default flag allows you to choose the behavior for all areas in the world that have not had a value previously set. Setting a wilderness flag allows you to choose the behavior for unclaimed areas.

The following examples can be used for the flag or bundle command and can be used with area, default, or wilderness. This is not an exhaustive list.

CommandEffect
/flag get area PvpRetrieves the value of the flag
/flag set wilderness NotifyExit trueExplicitly set the value of the flag.
/flag set default SpawnMobToggle the current value of the flag.
/flag helpDisplay a list of available flags

Tools

Flags has the ability to use item based tools for some functionality. The items are configurable in config.yml. Below is a list of the tools available.

ToolDefaultFunction
FlagQueryFeatherRight click in an area to view the flags currently set. Performs the same function as /flag get area or /flag get wilderness.
SectorGold HoeIf Sectors are enabled, use this tool to create a sector by right clicking to set the corners. Create subdivisions in the same manner inside an existing sector.

Bundles

Bundles allow you to group flags together so you can set them with a single command. New bundles can be added by command or by the server operator editing the bundle.yml file. Bundles maintain their own permissions system, they do not require a flag permission even if the flag is in the bundle. Below is a list of default bundles which serve as examples and can be edited or removed. These bundles will only function if their respective modules are installed.

IMPORTANT: When adding new bundles by editing the file directly, the name should ALWAYS be lower case. Flag names are not case sensitive, and using or adding bundles with commands in-game are not case sensitive. You may use in-line YAML list format if you wish.

BundleFlags
BuildCreatureBuildGolem, BuildSnowman, BuildWither
JailAllowEntry, AllowLeave, AllowTpIn, AllowTpOut
NotifyNotifyExit, NotifyEnter
SpawnMonsterSpawnInvasion, SpawnJockey, SpawnLightning, SpawnMob, Spawner, SpawnChunk, SpawnOther
DamageDamageBlockExplode, DamageContact, DamageDrown, DamageFall, DamageBlockFall, DamageFire, DamageBurn, DamageLava, DamageLightning, DamageMagic, DamageMelting, DamagePoison, DamageStarve, DamageSuffocate, DamageSuicide, DamageThorns, DamageVoid, DamageWither, DamageOther

Updater

Flags contains an automated updater feature that can check for updates and notify the console and players with permission when one is available. For more information on configuring or disabling the updater, click see the Configuration page.

Metrics

Flags reports non-identifying information about your server to MCStats.org. For more information on what is reported and how to disabled it if you would like to, please see the Questions page. To view the full set of data, click the graph below.

Metrics Graph

Discussion Forum

In order to provide more centralized and effective means of feedback and support for my growing list of plugins, a Discussion Forum has been provided. You don't even need a new account to use it! Please understand that I may not directly respond to comments on this page and I will not respond to plugin questions in the form of PM's. By posting on the forums you help others find answers to the same questions, and I don't have time to continually repeat the same answers if you want new features added! This forum is exclusively for plugins by Alshain01 and discussion of their use and development. For other concerns, please consult the Bukkit Forums.

https://www.paypalobjects.com/en_US/i/btn/btn_donateCC_LG.gif

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of Alshain01 Alshain01 Jul 22, 2014 at 14:26 UTC - 0 likes

    Development for 2.0 is for the most part at a stand still. Not because anything is wrong but because I am apparently faster than the addons I depend on. I was waiting to see if a few of the hold outs would release at least a beta version for 2.0 but if that doesn't happen soon, I may move the current version to beta. It definitely is not forgotten, but I am working on other projects at the moment for Kerbal Space Program.

    Take4Spam, it does work with GP but you have to make sure your running the right version of GP with the right version of Flags. The current versions support the beta versions of GP because it was getting so far behind I felt like I had no other choice. Some of the older versions of Flags actually had support for both 7.7 and 7.8 but that became difficult to maintain. Any other concerns I would have to have more information on the problem.

    Please remember that as mentioned in the paragraph above, I don't check these comments very often. They simply aren't suited to supporting a project like this. If you need a more timely response from me you should either 1. Submit a ticket (preferably if your certain it's a problem) or 2. Click the Forum link at the top of the page. I check the forums and tickets very frequently.

  • Avatar of GodsDead GodsDead Jul 19, 2014 at 14:48 UTC - 0 likes

    Hows development going? Im staying off 2.0 for the moment.

  • Avatar of Take4Spam Take4Spam Jul 13, 2014 at 16:19 UTC - 0 likes

    don't work with GP :(

  • Avatar of DelukesGaming DelukesGaming Jun 26, 2014 at 17:30 UTC - 0 likes

    Is there any flags for using buttons or doors?

  • Avatar of snakemansos snakemansos Jun 04, 2014 at 21:10 UTC - 0 likes

    Nice plugin! can you add flags for using buckets? Lava bucket - Water Bucket and bucket filling?

    Last edited Jun 04, 2014 by snakemansos
  • Avatar of GodsDead GodsDead Jun 04, 2014 at 18:28 UTC - 0 likes

    @Alshain01: Go

    Alright, Ill hold off for a bit. I keep getting users seeing /flags in their /help pages and running commands, they don't have permissions to run them, but how can I stop players from seeing the flags/flag entries in help?

  • Avatar of Alshain01 Alshain01 May 29, 2014 at 15:28 UTC - 1 like

    @GodsDead: Go

    Feature wise (the stuff the end user notices), there is little or no change at all. 10% of the changes are to support UUID's for trust list. 90% is an API overhaul, the API has been consolidated to allow developers to find what they want a little easier and it also support better expansion. This of course breaks plugins, hence the major revision number change. However, I wouldn't put it on a live server at this time as I haven't done much testing on it yet and in some cases I may change my mind and provide no upgrade path like I did with Alpha 1 to Alpha 2, 1.4.1 will work fine until Mojang allows user name changes. Right now 2.0.0 is kind of waiting on the dependencies to catch up a little more on UUID changes.

  • Avatar of GodsDead GodsDead May 23, 2014 at 12:07 UTC - 0 likes

    Hey Alshain01!

    Do you have a changelog from 1.4.1 to 2.0.0? So I can see what's new :) I updated to 1.7.9 yesterday, Is it worth updating to 2.0.0? Or waiting for now?

  • Avatar of Alshain01 Alshain01 Feb 11, 2014 at 23:09 UTC - 0 likes

    @killje: Go

    I think I found another way around this issue. The long and the short of it is, something changed in the API since I developed that (I think it was 1.5.2 originally). I already uploaded a change that's waiting on approval so it's not going to be in 1.3.1, but the next patch should have it.

  • Avatar of mblanchet75 mblanchet75 Feb 09, 2014 at 18:33 UTC - 0 likes

    The plugin BlockNotif is now using the plugin Flags for Land/Region/Residence/etc report! ;-)

    BFAK:90805780,923cc814f28bf2056852e7db6c92c11cc840a535a8793e34fd8a184565eb3107

What is your favorite flag module?

  1. Choice:

  1. Results
  2. 0 comments

Facts

Date created
Sep 04, 2013
Categories
Last update
May 03, 2014
Development stage
Release
Language
  • enUS
License
Creative Commons Attribution-NonCommercial 3.0
Curse link
Flags
Downloads
5,935
Recent files

Authors