# PlotSquared PlaceholderAPI Expansion<\/p>\n
A lightweight and efficient PlaceholderAPI expansion for PlotSquared that provides real-time plot ownership detection and flag checking. This expansion allows server administrators and plugin developers to check whether a player is currently standing on their own plot and query plot flags, enabling dynamic content, conditional permissions, and enhanced gameplay mechanics.<\/p>\n
## \ud83c\udfaf What Does This Expansion Do?<\/p>\n
This expansion adds powerful placeholders that return true or false based on plot ownership and flag status. This is particularly useful for:<\/p>\n
– **Conditional Menus**: Show different menu items based on plot ownership or flags
\n– **Dynamic Permissions**: Grant special permissions only when players are on their own plots
\n– **Custom Scoreboards**: Display plot ownership and flag status in real-time
\n– **Chat Formatting**: Add special prefixes or badges for plot owners
\n– **Action Bars & Boss Bars**: Show ownership and flag notifications
\n– **Conditional Commands**: Execute commands only when players are on their plots or when specific flags are set
\n– **Economy Systems**: Charge different prices based on plot location and flags
\n– **Protection Systems**: Add extra security layers based on plot flags
\n– **PvP Zones**: Create dynamic PvP areas based on plot flags
\n– **Flight Control**: Manage flight permissions based on plot flags<\/p>\n
## Example GIF<\/p>\n
## \ud83d\udcdd Available Placeholders<\/p>\n
| Placeholder | Description | Return Value | Use Case | **Important Note**: The ownership placeholder specifically checks for plot ownership. Players who are only trusted or added as members will receive `false`.<\/p>\n ### Flag Examples<\/p>\n – `%plotowner_on_own_plot_pvp%` – Returns `true` if the PVP flag is set on the current plot ## \u2728 Key Features<\/p>\n – **Lightweight**: Minimal performance impact on your server ## \ud83d\udccb Requirements<\/p>\n – **Minecraft Server**: 1.21.x (Paper or Spigot) ## \ud83d\udd27 Installation Guide<\/p>\n ### Step 1: Download ### Step 2: Install **Important**: Do NOT place this in the main plugins folder. This is an expansion, not a standalone plugin.<\/p>\n ### Step 3: Reload ### Step 4: Verify Installation ### Step 5: Test ## \ud83d\udcd6 Usage Examples<\/p>\n ### Example 1: DeluxeMenus – Conditional Items “`yaml ### Example 2: FeatherBoard – Dynamic Scoreboard “`yaml ### Example 3: ConditionalEvents – Flag-Based Events “`yaml ## \ud83d\udd0d How It Works<\/p>\n The expansion uses the official PlotSquared API to: This process is highly optimized and causes minimal performance impact, even with hundreds of players online.<\/p>\n ## \ud83d\udee0\ufe0f Building from Source<\/p>\n If you want to compile the expansion yourself:<\/p>\n ### Prerequisites ### Build Steps # Build with Gradle # Or use the Gradle wrapper The compiled JAR will be located in `build\/libs\/Expansion-PlotOwner-1.0.1.jar`<\/p>\n ## \ud83e\udd1d Integration with Other Plugins<\/p>\n This expansion works seamlessly with any plugin that supports PlaceholderAPI, including:<\/p>\n – **Menu Plugins**: DeluxeMenus, ChestCommands, TrMenu ## \u2753 Frequently Asked Questions<\/p>\n **Q: Why does it show “false” when I’m trusted on a plot?** **Q: Does this work with merged plots?** **Q: Can I use this for road detection?** **Q: What’s the performance impact?** **Q: Why is the identifier “plotowner” and not “plotsquared”?** **Q: What happens if I delete the expansion and reload?** **Q: Can I check any PlotSquared flag?** **Q: What if a flag doesn’t exist or isn’t set?** ## \ud83d\udc1b Troubleshooting<\/p>\n ### Expansion not loading ### Placeholder shows nothing ### Always shows “false” ### Expansion still registered after deletion ## \ud83d\udc64 Author<\/p>\n **AlphaBlock4k**<\/p>\n ## \ud83c\udf1f Support<\/p>\n If you find this expansion useful, please consider: ## \ud83d\udcca Version History<\/p>\n ### v1.0.1 ### v1.0.0 —<\/p>\n Made with \u2764\ufe0f for the Minecraft community<\/p>\n","protected":false},"excerpt":{"rendered":" A simple PlaceholderAPI expansion for PlotSquared that checks if a player is standing on their own plot.<\/p>\n","protected":false},"featured_media":123032,"template":"","meta":{"_minecraft_slug":"plotsquared-placeholderexpansion","_minecraft_project_id":"DlDFHT9j","_minecraft_author":"alphablock4k","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":675,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"plotsquared-placeholderexpansion.zip","_minecraft_size_bytes":4454,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-16T09:43:09.644668Z","_minecraft_date_created":"2025-10-05T20:48:29.777578Z","_minecraft_date_modified":"2025-10-09T09:00:14.204140Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/plotsquared-placeholderexpansion","_minecraft_icon_attachment_id":123032,"_minecraft_imported_at":"2026-06-07T05:39:11+00:00","_minecraft_import_hash":"5292b16d8425b3dabd6d910d11c480d7","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[89,126,127,128,129,92],"mod_loader":[132,133,134],"minecraft_version":[40,38,78,79,80,81,82],"class_list":["post-123031","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21-10","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n|————|————-|————–|———-|
\n| `%plotowner_on_own_plot%` | Checks if the player is standing on their own plot as the owner | `true` or `false` | Perfect for conditional logic in any plugin that supports PlaceholderAPI |
\n| `%plotowner_on_own_plot_
\n– `%plotowner_on_own_plot_fly%` – Returns `true` if the FLY flag is set on the current plot
\n– `%plotowner_on_own_plot_use%` – Returns `true` if the USE flag is set on the current plot
\n– `%plotowner_on_own_plot_explosion%` – Returns `true` if the EXPLOSION flag is set on the current plot<\/p>\n
\n– **Real-time Detection**: Instant updates when players move between plots
\n– **PlotSquared Integration**: Uses official PlotSquared API for reliable detection
\n– **Flag Support**: Check any PlotSquared flag on the current plot
\n– **Easy to Use**: Simple true\/false output works with any plugin
\n– **No Configuration**: Works out of the box after installation
\n– **Proper Lifecycle**: Correctly unregisters when removed and reloaded
\n– **Error Handling**: Gracefully handles edge cases and errors<\/p>\n
\n– **Java Version**: Java 21 or higher
\n– **Required Plugins**:
\n – PlaceholderAPI (Latest version)
\n – PlotSquared (Version 7.x)<\/p>\n
\nDownload the latest release JAR file<\/p>\n
\nPlace the downloaded JAR file into your server’s PlaceholderAPI expansions folder:
\n“`
\nplugins\/PlaceholderAPI\/expansions\/
\n“`<\/p>\n
\nRun the following command in your server console or in-game:
\n“`
\n\/papi reload
\n“`<\/p>\n
\nCheck if the expansion loaded successfully:
\n“`
\n\/papi list
\n“`
\nYou should see `plotowner` in the list of loaded expansions.<\/p>\n
\nTest the placeholders while standing on your plot:
\n“`
\n\/papi parse me %plotowner_on_own_plot%
\n\/papi parse me %plotowner_on_own_plot_pvp%
\n“`
\nYou should see `true` if you’re on your own plot, or `false` if you’re not.<\/p>\n
\nShow a special item only when players are on their own plot:<\/p>\n
\nplot_settings_item:
\n material: COMPARATOR
\n slot: 13
\n display_name: “&6&lPlot Settings”
\n lore:
\n – “&7Click to configure your plot”
\n – “&7Status: &a%plotowner_on_own_plot%”
\n view_requirement:
\n requirements:
\n must_be_on_plot:
\n type: string equals
\n input: “%plotowner_on_own_plot%”
\n output: “true”
\n left_click_commands:
\n – “[player] plot flag”
\n“`<\/p>\n
\nDisplay plot ownership and flag status on your scoreboard:<\/p>\n
\nboard:
\n title:
\n text:
\n – “&6&lMy Server”
\n lines:
\n line1:
\n text: “&7\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501”
\n line2:
\n text: “&ePlot Owner: &f%plotowner_on_own_plot%”
\n line3:
\n text: “&ePVP Enabled: &f%plotowner_on_own_plot_pvp%”
\n line4:
\n text: “&eFlight: &f%plotowner_on_own_plot_fly%”
\n line5:
\n text: “&eLocation: &f%player_world%”
\n line6:
\n text: “&7\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501”
\n“`<\/p>\n
\nExecute commands based on plot flags:<\/p>\n
\npvp_zone_enter:
\n type: player_move
\n conditions:
\n – “%plotowner_on_own_plot_pvp% == true”
\n actions:
\n default:
\n – “message: &c&lYou entered a PVP zone!”
\n – “sound: ENTITY_ENDER_DRAGON_GROWL”
\n“`<\/p>\n
\n1. Convert the Bukkit player to a PlotSquared player object
\n2. Get the plot at the player’s current location
\n3. Check if the plot exists
\n4. For ownership: Verify if the player’s UUID matches the plot owner’s UUID
\n5. For flags: Check if the specified flag is set on the plot
\n6. Return `true` or `false` accordingly<\/p>\n
\n– Java 21 JDK
\n– Gradle (or use the included wrapper)<\/p>\n
\n“`bash
\n# Clone the repository
\ngit clone https:\/\/github.com\/AlphaBlock4k\/PlotSquared-PlaceholderExpansion.git
\ncd PlotSquared-PlaceholderExpansion<\/p>\n
\ngradle clean build<\/p>\n
\n.\/gradlew clean build # Linux\/Mac
\ngradlew.bat clean build # Windows
\n“`<\/p>\n
\n– **Scoreboard Plugins**: FeatherBoard, AnimatedScoreboard
\n– **Chat Plugins**: ChatControl, VentureChat, EssentialsChat
\n– **Permission Plugins**: LuckPerms (with ConditionalPerms)
\n– **Event Plugins**: ConditionalEvents, ExecutableEvents
\n– **Hologram Plugins**: HolographicDisplays, DecentHolograms
\n– **NPC Plugins**: Citizens, ZNPCs
\n– **Combat Plugins**: CombatLogX, DeluxeCombat
\n– And many more!<\/p>\n
\nA: This expansion specifically checks for plot ownership. Only the plot owner will receive `true`. Trusted members and added players will receive `false`.<\/p>\n
\nA: Yes! If you own a merged plot and stand anywhere on it, the placeholder will return `true`.<\/p>\n
\nA: Yes! If the placeholder returns `false` and the player is in a plot world, they’re either on a road or on someone else’s plot.<\/p>\n
\nA: Minimal. The expansion uses efficient PlotSquared API calls and includes error handling to prevent lag.<\/p>\n
\nA: PlaceholderAPI already has a built-in expansion with the identifier “plotsquared”. To avoid conflicts, this expansion uses “plotowner”.<\/p>\n
\nA: The expansion will be properly unregistered and removed from memory. This was fixed in version 1.0.1.<\/p>\n
\nA: Yes! You can check any flag that PlotSquared supports. Just use `%plotowner_on_own_plot_
\nA: The placeholder will return `false` if the flag doesn’t exist or isn’t set on the plot.<\/p>\n
\n– Ensure PlotSquared is installed and running
\n– Check that the JAR is in `plugins\/PlaceholderAPI\/expansions\/`
\n– Run `\/papi reload`
\n– Check console for error messages<\/p>\n
\n– Verify the expansion is loaded: `\/papi list`
\n– Test the placeholder: `\/papi parse me %plotowner_on_own_plot%`
\n– Ensure you’re using the correct identifier: `plotowner` not `plotsquared`<\/p>\n
\n– Confirm you are the plot owner (not just trusted)
\n– Check with `\/plot info` to verify ownership
\n– Ensure you’re standing within plot boundaries
\n– For flags: Verify the flag is actually set with `\/plot flag list`<\/p>\n
\n– Make sure you’re using version 1.0.1 or higher
\n– Delete the JAR file from `plugins\/PlaceholderAPI\/expansions\/`
\n– Run `\/papi reload`
\n– Verify with `\/papi list` that it’s no longer listed<\/p>\n
\n– \u2b50 Starring this repository
\n– \ud83d\udc1b Reporting bugs in the Issues section
\n– \ud83d\udca1 Suggesting new features
\n– \ud83d\udce2 Sharing with other server owners<\/p>\n
\n– Added flag checking placeholder: `%plotowner_on_own_plot_
\n– Fixed expansion persisting after deletion and reload
\n– Improved lifecycle management<\/p>\n
\n– Initial release
\n– Basic plot ownership detection
\n– PlotSquared 7.x support
\n– Minecraft 1.21.x compatibility<\/p>\n