Skip to content

PlaceholderAPI

PQguanfang edited this page Mar 15, 2026 · 2 revisions

PlaceholderAPI

This feature require server install PREMIUM version of UltimateShop or MythicTotem or MythicPrefixes or MythicChanger to active!

EconomyLimit includes built-in PlaceholderAPI expansion support.
If PlaceholderAPI is installed, the plugin will automatically register its placeholders without requiring a separate expansion download.

These placeholders can be used in:

  • Scoreboards
  • TAB
  • Holograms
  • Chat formats
  • GUI text
  • Any other plugin that supports PlaceholderAPI

Requirements

  • Vault installed
  • PlaceholderAPI installed
  • EconomyLimit installed

If PlaceholderAPI is not installed on the server, these placeholders will not work.

Registration

EconomyLimit automatically checks for PlaceholderAPI when the plugin loads.
If PlaceholderAPI is found, the expansion is registered automatically.

You do not need to run:

/papi ecloud download ...
/papi reload

In most cases, restarting the server or reloading EconomyLimit is enough.

Placeholder List

Bank Balance

%economylimit_bank_balance%
%economylimit_bank%

Returns the player's current virtual bank balance.

Rule Name

%economylimit_rule_<ruleId>_name%

Examples:

%economylimit_rule_daily_name%
%economylimit_rule_weekly_name%

Returns the rule display name.
If your rule uses:

display-name: "{lang:rules.daily.name}"

then this placeholder will return different text depending on the player's selected language.

Earned Amount

%economylimit_rule_<ruleId>_earned%
%economylimit_rule_<ruleId>_progress%
%economylimit_rule_<ruleId>_current%

Example:

%economylimit_rule_daily_earned%

Returns how much the player has earned in the current cycle of that rule.

Rule Limit

%economylimit_rule_<ruleId>_limit%

Example:

%economylimit_rule_daily_limit%

Returns the player's current earning cap for that rule.
If that rule is unlimited for the player, it returns status.unlimited from the language file.

Remaining Earnings

%economylimit_rule_<ruleId>_remaining%

Example:

%economylimit_rule_daily_remaining%

Returns how much the player can still earn in the current cycle of that rule.

Next Reset Time

%economylimit_rule_<ruleId>_next_reset%
%economylimit_rule_<ruleId>_reset%

Examples:

%economylimit_rule_daily_next_reset%
%economylimit_rule_weekly_reset%

Returns the next reset time of that rule.
If the rule does not reset, it returns status.never from the language file.

Rule ID

The <ruleId> in placeholders is the rule node name from your config.yml.

Example:

rules:
  daily:
    display-name: "{lang:rules.daily.name}"

  weekly:
    display-name: "{lang:rules.weekly.name}"

The rule IDs here are:

  • daily
  • weekly

Return Format

  • Money placeholders use the plugin's internal money formatting, such as 1000, 1000.5, or 1000.55
  • Time placeholders use this format:
yyyy-MM-dd HH:mm

Example:

2026-03-15 00:00
  • Unlimited rules return status.unlimited
  • Rules that never reset return status.never

Language-Based Rule Names

If you want players using different languages to see different rule names, configure it like this:

config.yml

rules:
  daily:
    display-name: "{lang:rules.daily.name}"

en_US.yml

rules:
  daily:
    name: "Daily earnings"

zh_CN.yml

rules:
  daily:
    name: "每日收益"

Then:

%economylimit_rule_daily_name%

will return different content depending on the player's language.

Examples

Scoreboard Example

Bank: %economylimit_bank_balance%
Daily earned: %economylimit_rule_daily_earned%
Daily remaining: %economylimit_rule_daily_remaining%
Daily reset: %economylimit_rule_daily_next_reset%

Hologram Example

%player_name%
Bank: %economylimit_bank%
Daily earnings: %economylimit_rule_daily_progress% / %economylimit_rule_daily_limit%

Troubleshooting

If a placeholder does not return anything, check:

  1. Whether PlaceholderAPI is installed
  2. Whether EconomyLimit is enabled correctly
  3. Whether the rule ID matches config.yml exactly
  4. Whether the placeholder name is spelled correctly
  5. Whether the target plugin supports PlaceholderAPI

Full Supported Placeholder Summary

%economylimit_bank_balance%
%economylimit_bank%
%economylimit_rule_<ruleId>_name%
%economylimit_rule_<ruleId>_earned%
%economylimit_rule_<ruleId>_progress%
%economylimit_rule_<ruleId>_current%
%economylimit_rule_<ruleId>_limit%
%economylimit_rule_<ruleId>_remaining%
%economylimit_rule_<ruleId>_next_reset%
%economylimit_rule_<ruleId>_reset%

Clone this wiki locally