Frequently Asked Questions

I set my Value Provider, but it’s laggy

In most cases, you’d better enable async (Tutorial) so that your provider is run on an asynchronous thread that doesn’t affect your main server thread. However, some providers may not support asynchronous run and require to run on the main thread. In that case, either you have to find one that supports and test it or ask the author of that provider to add support for that.

Some providers may have an online option that determines whether the provider should only be run for online players ( like PlaceholderAPI). If so, you are recommended to enable it to avoid unnecessary computations for offline players.

For those who are using statistic placeholder in the PlaceholderAPI Value Provider, you are recommended to either enable online option or check out the built-in Statistic Provider.

My name isn’t appearing in the Top Holder after I set it up

As Topper only registers players when they join the server, the issue can be solved by just re-joining the server.

The Top Holder doesn’t work

In most cases, there must be a reason why the holder is not working. Here are some common practices we gather from similar cases:

• Check if the configuration is properly set up: There are cases when there is a syntax error in the configuration file or the configuration is not formatted correctly. You should check the file with some validation tools such as YAML Lint.
• Check if the required settings are properly set up: Make sure to check your settings against the wiki. There are cases when users mixed up the settings or forgot to set some required settings, so please read the wiki carefully.
• Check if there is any errors: Make sure to check your logs for any errors related to your Top Holder. If there isn’t one, make sure to enable show-errors in the configuration (Tutorial).

After all, there must be a reason why the holder is not working. Please check thoroughly and provide more details about the issue when you report it in the support channel.

I set my PlaceholderAPI’s placeholder but it is not showing the value in the Top Holder

• Make sure that the placeholder you are using is valid and that the plugin that provides the placeholder is installed and working correctly.
• Try running the command /papi parse me <placeholder> to see if the placeholder is working as expected.
• Check if the placeholder is for online players only. If so, set the online option to true in the configuration.
• Try setting show-errors to true to see if there are any errors when parsing the placeholder. (Tutorial)
• If the placeholder is still not working, ask for help in the plugin’s support channel or forum (remember to enable show-errors (Tutorial) and provide the logs to them for better support).

My placeholder gives a formatted value (e.g., 1,000.00 instead of 1000). Can I use it in the provider?

No, the placeholder provider only supports numerical values (only numbers and decimal separator . (dot) ). You must use a placeholder that returns a raw number without formatting, if possible. If the plugin that provides the placeholder does not have an option to return a raw number, you can try using a different placeholder or ask the plugin developer to add support for raw numbers.

If the value is a simple formatted number, you can try Handling the Formatted Value.

How can I know if a placeholder works with Topper?

Here is a rough list of criteria that a placeholder should have in order to work with Topper:

• The placeholder should only returns raw number
  • That means it should only have digits and one . (dot) as a decimal separator
    • Work: 100, 100.00, 100.123
    • Won’t work: abc, 1,000,000, 100,000.122, 100.000.000, 1 000 000, 10.2M, 1h 30m
• The placeholder should work with both online and offline players
• If the placeholder doesn’t work with offline players, it should return an empty string or the placeholder itself
• If there is any error in the logic of the placeholder, it should return an empty string or the placeholder itself

I want to format the value returned by my placeholder in my leaderboard

First, you should ALWAYS use a placeholder that returns a raw number without formatting, if possible (Check the previous questions for more information).

Then in your query to get the value from the Top Holder, you can apply Value Display to format the value.

In short, use the placeholder that returns a raw number when setting up the Top Holder, then apply Value Display settings when setting up the display of the leaderboard.

I want to shorten the number (e.g. 1000000 to 1M)

The Value Display function can be used to shorten the number. For example, money;value;shorten will shorten the number of the value in the money Top Holder.

How can I display other things rather than Player Name?

Topper doesn’t have the concept of “extra value”, so if you want to do that, you have to make a workaround (mostly by developing or asking a developer to make a plugin that gets the UUID of the player from Topper and does stuff with it).

However, if you use PlaceholderAPI, Topper provides the top_key placeholder to get the UUID of the player in the Holder. You can use that along with the ParseOther expansion to parse your placeholder by the UUId of the player in the Holder.

For example, if you want to display the LuckPerms prefix (%luckperms_prefix%) of the 1st player in the Holder named jump, then the placeholder for that will be

%parseother_unsafe_{topper_jump;top_name;1}_{luckperms_prefix}%

Should I set online to false in PlaceholderAPI Value Provider?

In most cases, you should NOT set online to false to avoid many issues.

The online option behaves as follows:

• true: The plugin will ONLY update values for the players who are online (in the server). The plugin will NOT update values for the players who are offline (not in the server)
  • It DOES NOT mean the plugin will remove the values for the players who are offline (not in the server)
• false: The plugin will try to update values for all players, regardless of whether those players are online (in the server) or offline (not in the server)
  • It DOES NOT mean it is necessary to make it work with offline-mode / cracked servers
  • ONLY set if you are sure your placeholder works for the players who are offline (not in the server)

I am so confused about how to use Topper

Take a deep breath and read the wiki again. You should take it slow and read the wiki carefully as you can miss some important details if you read it too quickly. If you still have trouble, feel free to ask for help in the Discord server. Remember to provide a clear and concise description of your issue, including any relevant error messages or screenshots.