PlaceholderAPI

Overview

minePlots integrates with PlaceholderAPI to provide plot-related placeholders that can be used in scoreboards, tab lists, holograms, and any other plugin that supports PlaceholderAPI.

Requirements

• PlaceholderAPI

PlaceholderAPI is an optional dependency — the plugin works without it, but placeholders will not be available.

Player Placeholders

These placeholders return data about the player regardless of their current location.

Placeholder	Description	Example Output
%minePlots_plotsLimit%	Player’s maximum plot count	4
%minePlots_numberOfPlots%	Number of plots the player owns	2
%minePlots_serverPlotCount%	Total number of plots on the server	156

Plot Placeholders

These placeholders return data about the plot the player is currently standing on. If the player is not on a plot, the fallback value is returned.

Placeholder	Description	Example Output
%minePlots_name%	Plot name	My Base
%minePlots_owner%	Plot owner name	Steve
%minePlots_size%	Plot dimensions	21x21
%minePlots_members%	Number of members	3
%minePlots_maxMembers%	Maximum member slots	10
%minePlots_onlineMembers%	Online member count	1
%minePlots_isMember%	Is the player a member	true
%minePlots_isOwner%	Is the player the owner	false
%minePlots_isClosed%	Is the plot closed	false
%minePlots_rating%	Average plot rating	4.5
%minePlots_expireAt%	Expiration date	15.02.2026 14:30:00
%minePlots_expireInMillis%	Milliseconds until expiration	86400000
%minePlots_membersList%	Comma-separated member names	Alex, Steve
%minePlots_ranking%	Plot ranking points	1250

Ranking Placeholders

These placeholders display data from the plot ranking leaderboard. Replace <position> with the ranking position (starting from 0).

Placeholder	Description	Example Output
%minePlots_top_points_name_<position>%	Plot name at ranking position	Best Base
%minePlots_top_points_points_<position>%	Points at ranking position	5000

Example

%minePlots_top_points_name_0%    → Name of the #1 ranked plot
%minePlots_top_points_points_0%  → Points of the #1 ranked plot
%minePlots_top_points_name_1%    → Name of the #2 ranked plot
%minePlots_top_points_points_1%  → Points of the #2 ranked plot

Fallback Value

If the player is not standing on a plot or their data is unavailable, placeholders return the fallback value configured in messages.yml:

data-not-available-placeholder: "None"

Usage Examples

Scoreboard

Plot: %minePlots_name%
Owner: %minePlots_owner%
Members: %minePlots_members%/%minePlots_maxMembers%

Tab List

Plots: %minePlots_numberOfPlots%/%minePlots_plotsLimit%

Hologram

#1 %minePlots_top_points_name_0% - %minePlots_top_points_points_0% points
#2 %minePlots_top_points_name_1% - %minePlots_top_points_points_1% points
#3 %minePlots_top_points_name_2% - %minePlots_top_points_points_2% points