Goals related placeholders

Go back to Placeholders index

Placeholders

Placeholder	Description	Details
%PTM_goal_count%	Displays the number of completed goals for the current player
%PTM_goal_count_<nickname>%	Displays the number of completed goals for a specific player
%PTM_goal_completed_<goalName>%	Displays whether the current player has completed the specified goal	Returns true or false. <goalName> is case-sensitive and must exactly match the goal's filename (without .yml)
%PTM_goal_completed_<goalName>_<nickname>%	Displays whether a specific player has completed the specified goal	Returns true or false. <goalName> is case-sensitive and must exactly match the goal's filename (without .yml)

---

Error messages

Error messages are disabled by default. To enable them, set enable-errors to true under the placeholders field in config.yaml.

---

"Error: couldn't get goal count"

Cause: The plugin failed to retrieve the current online player's completed goals list. This is usually caused by the player's session being null at evaluation time, or GoalsManager failing to initialize on server startup.

Steps to check:

• This should not occur for a player who is actively online. If it persists, check for session management errors in the server logs and contact me on discord..

---

"Error: couldn't get goal status"

Cause: The plugin could not check goal completion status for the current online player when using the self-form %PTM_goal_completed_<goalName>% — typically due to a null session. This error is not returned for the <nickname> form, which uses Loading... or Player not found in db instead.

Steps to check:

• Confirm the <goalName> value is exactly the filename of the goal file, without the .yml extension, with matching case (e.g. daily_login, not Daily_Login).
• Verify the goal .yml file exists in the goals data folder.

---

"Error: Player not found in db"

Cause: No record matching the provided nickname exists in the database. Returned by %PTM_goal_count_<nickname>% and the nickname form of %PTM_goal_completed_<goalName>_<nickname>%.

Steps to check:

• Double-check the spelling and casing of the nickname — it must match exactly as stored.
• Confirm the player has joined the server at least once. Players who have never connected have no database record.

---

"Loading..."

Cause: The plugin found the player's UUID but their data has not yet been fully loaded from the database. This is a transient state that occurs briefly after a player joins. Returned by %PTM_goal_count_<nickname>% and the nickname form of %PTM_goal_completed_<goalName>_<nickname>%.

Steps to check:

• This resolves automatically within a second or two. No action required under normal conditions.
• If the message persists, check for database connection issues or thread pool exhaustion in the server logs.