Frequently Asked Questions
Frequently asked questions about SamsRank
Answers to the most common questions.
Licensing
How do I get a license key?
Register on ranktags.samscreations.eu, then join our Discord and open a ticket.
What happens if the license server is down?
If the server is unreachable or rate-limited, SamsRank stays enabled and retries in the background before disabling itself, so tags don't break during short outages.
My license failed after moving servers.
Licenses are tied to a limited number of IPs. Open a ticket on Discord for an IP reset. See License Troubleshooting.
Tags & Effects
My tag shows as a box / [] / nothing.
The player doesn't have the current resource pack. Run /samsrank reload (on ItemsAdder, wait for /iazip to finish), then have the player rejoin. /samsrank report lists any rank that is missing its character (under Missing glyphs).
The effect doesn't animate.
- Check
effects.enabledistrue. - Make sure the pack was regenerated after updating SamsRank and the player rejoined.
- On 26.3, your ItemsAdder / Nexo build must support 26.3 too.
- Using BetterHud? Keep
integrations.betterhud: true- see BetterHud.
TAB / chat says "Legacy formatting codes have been detected".
Your plugin reads placeholders as MiniMessage. Set placeholders.output-format: minimessage - see Placeholders.
Can Bedrock players see the tags?
Yes - with Geyser, automatically. They see the static tag (effects are Java-only). See Bedrock (Geyser).
In-Game Editor
The UI is too big or too small.
Tune ui.rendering.hud-scale-divisor in config.yml. A smaller number makes the UI bigger. The default suits around 80-90 FOV.
How do I close the UI?
Press F (swap hands). Q goes back a screen. Both can be rebound under ui.keybinds.
Can staff look at ranks without changing them?
Yes - give them samsrank.edit.view instead of samsrank.edit.
Conversion & Platforms
ItemsAdder or Nexo - which should I use?
Both are fully supported. If you already use one for custom items, stick with it. With both installed, platform.preferred chooses which one handles the ranks.
Why are my PNGs deleted after conversion?
auto_delete.enabled is true by default so ranks aren't converted twice. Set it to false to keep the source images.