PerfRankNPC's - Rotating rank NPC boards v1.2.6

Rank NPC leaderboards with skins, holograms, periods, and MySQL network mode
Bug fixes:
• Empty message keys in messages.yml no longer send blank chat lines
Bug fixes:
• Rank NPC hologram text now positions correctly on Folia servers
Bug fixes:
• Rank NPCs for offline leaderboard players now show the correct Mojang skin instead of Steve/Alex
• Rank holograms stay readable when you stand behind skin NPCs

Improvements:
• Hologram text can follow viewers (configurable billboard behavior)
• SkinsRestorer is optional and off by default for online-mode servers

Code:
# plugins/PerfRankNPCs/config.yml — merge (config-version: 21):

display:
  npc:
    skinsrestorer-integration: false
    async-profile-skin-lookup: true
    sessionserver-skin-fallback: true
    mojang-username-skin-lookup: true
    mojang-username-skin-lookup-disabled: false
    skin-fetch-delay-ms: 800
    skin-fetch-retry-pause-ms: 5000
    skin-retry-delays-seconds:
      - 5
      - 20
    fancy-skin-refresh-delays-seconds:
      - 3
      - 8
      - 15
  hologram:
    billboard: center
    always-face-viewer: true
    see-through: true

config-version: 21
Bug fixes:
• Rank NPC skin refreshes no longer freeze the server when FancyNpcs cannot resolve a player skin
• Leaderboard NPCs on FancyNpcs/Citizens now use cached textures instead of blocking Mojang username lookups

Improvements:
• SkinsRestorer lookups now use the leaderboard player name for better matches on premium servers
• Added display.npc.mojang-username-skin-lookup (default false) to opt back into username-based skin fetching

Code:
# plugins/PerfRankNPCs/config.yml — auto-added on reload (config-version 16):
display:
  npc:
    mojang-username-skin-lookup: false
Bug fixes:
• Skin NPCs on FancyNPCs 2.4+ no longer show the default Alex skin for cracked or Bedrock player names
• SkinsRestorer skins now apply correctly on offline-mode servers when the ranked name is not a Mojang account
Bug fixes:
• Rank leaderboard holograms and display entities no longer spam errors on Folia servers
Bug fixes:
• Empty rank slots now show a default NPC instead of leaving the podium spot blank

Improvements:
• Optional display.empty.skin-name sets a Mojang username for the empty-slot NPC skin

Code:
# plugins/PerfRankNPCs/config.yml — merge under display.empty:
    skin-name: ""
Bug fixes:
• Skins now display correctly for offline players via a persistent skin cache and Mojang fallback
• No more Mojang rate-limit spam from FancyNpcs / Citizens skin lookups
Buy a license now
$9.99
EULA
Standard EULA
Use on any projects you own with attribution
Support
Standard
Includes:
Download the resource
Access new updates
Support from the creator
Support duration
Lifetime
Share and earn
Refer this resource and earn a 20% commission.
498 Views
3 Purchases
5 Downloads
May 7, 2026 Published
Jun 12, 2026 Updated
5.00 star(s)
Average rating (1)
341.5 KB File size
Open source
  1. No
DRM-free
  1. Yes
Unobfuscated
  1. No
Type
  1. Gameplay
  1. Reward
  1. Fun
Game mode
  1. Survival
  1. Donut-like
  1. Hardcore
Supported software
  1. Paper
  1. Folia
Supported versions
  1. 26.1
  1. 1.21.11
  1. 1.21.8
  1. 1.21.5
  1. 1.21.4
  1. 1.21.2
  1. 1.21
Supported languages
  1. English
Creator
Owner
Recommended for you
Mines plugin with GUI, Vault/PlayerPoints/ExcellentEconomy, tax, ban system
5.00 star(s) 4 ratings
11 purchases
tags plugin with Shop GUI, categories, vouchers
5.00 star(s) 1 ratings
11 purchases
High performance RTP, RTPQueue and RTPZone plugin. Folia-ready.
5.00 star(s) 6 ratings
9 purchases
Playtime-based level system with rewards (money, XP, crates). GUI, PlaceholderAPI, Folia support.
5.00 star(s) 3 ratings
8 purchases
item signing plugin. Add custom lore with hex colors, MC color codes, and MiniMessage formatting.
Not yet rated
0 purchases
Share and earn
Refer this resource and earn a 20% commission.
498 Views
3 Purchases
5 Downloads
May 7, 2026 Published
Jun 12, 2026 Updated
5.00 star(s)
Average rating (1)
341.5 KB File size
Open source
  1. No
DRM-free
  1. Yes
Unobfuscated
  1. No
Type
  1. Gameplay
  1. Reward
  1. Fun
Game mode
  1. Survival
  1. Donut-like
  1. Hardcore
Supported software
  1. Paper
  1. Folia
Supported versions
  1. 26.1
  1. 1.21.11
  1. 1.21.8
  1. 1.21.5
  1. 1.21.4
  1. 1.21.2
  1. 1.21
Supported languages
  1. English
Creator
Owner
Recommended for you
Mines plugin with GUI, Vault/PlayerPoints/ExcellentEconomy, tax, ban system
5.00 star(s) 4 ratings
11 purchases
tags plugin with Shop GUI, categories, vouchers
5.00 star(s) 1 ratings
11 purchases
High performance RTP, RTPQueue and RTPZone plugin. Folia-ready.
5.00 star(s) 6 ratings
9 purchases
Playtime-based level system with rewards (money, XP, crates). GUI, PlaceholderAPI, Folia support.
5.00 star(s) 3 ratings
8 purchases
item signing plugin. Add custom lore with hex colors, MC color codes, and MiniMessage formatting.
Not yet rated
0 purchases
Top