Progress Expansion

Progress Expansion

A PlaceholderAPI expansion that allows you to display progress related placeholders in a fancy bar. You can customize what symbols are shown, the text when it is completed and what the maximum value is and More!

Placeholders

%progress_bar_{placeholder}%

{placeholder} (Required field)
Requires: A placeholder that returns a number OR a letter (A-Z). Available placeholders
Example: %progress_bar_{server_online}%

c:
Requires: TEXT
Default (Config option): &a■ ( completed)
Example: %progress_bar_{server_online}_c:&a|%

Sets the symbol/text that is used for already completed progress.

p:
Requires: TEXT
Default (Config option): &e■ ( in_progress)
Example: %progress_bar_{server_online}_p:&e|%

Sets the symbol/text that is used for the current progress (Where it currently is).

r:
Requires: TEXT
Default (Config option): &7■ ( remaining)
Example: %progress_bar_{server_online}_r:&7|%

Sets the symbol/text that is used for the remaining progress.

l:
Requires: NUMBER
Default (Config option): 10 ( length)
Example: %progress_bar_{server_online}_l:5%

Sets the maximum length of the progress bar. This also affects the progress itself. For example will a length of 5 show 2/5 as completed while 10 would show 5/10 if the progress is currently 50%.

m:
Requires: NUMBER
Default (Config option): 100 ( maximum_value)
Example: %progress_bar_{server_online}_m:10%

Sets the maximum value (Goal) of the progress. This affects the progress itself. For example will 20 show progress 2/10 done while it not even shows 1/10 done with 100 when the current progress is 5.

fullbar:
Requires: TEXT
Default (Config option): &aCompleted ( full)
Example: %progress_bar_{server_online}_fullbar:&aDone!%

Sets the text that is shown when progress is 100% (reached the set maximum value).

%progress_percentage_{placeholder}%

{placeholder} (Required field)
Requires: A placeholder that retuns a number OR a letter (A-Z). Available placeholders
Example: %progress_percentage_{server_online}%

The number that the percentage will be based on. For letters, it will be so a = 1, z = 26

m:
Requires: NUMBER
Default (Config option): 100 ( maximum_value)
Example: %progress_percentage_{server_online}_m:100%

Sets the maximum value (Goal) of the percentage. This affects the percentage itself.

d:
Requires: NUMBER
Default (Config option): 2 ( decimal)
Example: %progress_percentage_{server_online}_d:0%

Sets the amount of decimals that will be shown. For example, with d:3 if the percentage is 50 it will return 50.000

Download

You download it automatically using PAPI download commands:
/papi ecloud download Progress
/papi reload

Or you can download it manually from here and put it in the expansions folder (Path: /plugins/PlaceholderAPI/expansions/)

Something went wrong with it? Open a new issue in GitHub and we will figure it out!

Feel free to leave a review about this expansion.
Review section isn't for support.