SMP Nametags

SMP Nametags is a next-generation player nametag and tablist manager for Minecraft 1.20.5+ and 1.21+ servers. Built using native TextDisplay entities, it provides true RGB gradients, multi-line nametag layouts, clan tags, health bars, and tablist sorting without relying on outdated scoreboard team name hacks.

Supported Platforms

• Minecraft Version: 1.20.5 through 1.21+
• Server Engines: Paper, Purpur, Folia
• Dependencies: PlaceholderAPI, Vault (recommended for permissions)

Core Features

• TextDisplay Entities: Mounts native client-rendered display entities for smooth, high-precision overhead nametags.
• Multi-Line Nametags: Display player titles, faction tags, and health bars simultaneously above player heads.
• Permission Group Priority: Assign priority weights to LuckPerms rank groups to resolve prefix and suffix conflicts automatically.
• Sneak & Invisibility Handling: Automatically hides or fades nametags when players crouch, enter stealth, or drink Invisibility potions.
• Folia Regional Entity Safety: Handles entity mount packets asynchronously without blocking regional server ticks.

Commands and Permissions

Command	Purpose	Permission
/smpnametags	Base nametag info and toggle command	smpnametags.use
/smpnametags reload	Reload configuration and group templates	smpnametags.admin

Key Permissions

• smpnametags.use: Allows viewing personal and other player nametags.
• smpnametags.admin: Access to reload and administration tools.
• smpnametags.see-invisible: Allows server staff to view nametags through walls or when players are sneaking/invisible.

Configuration Reference

The configuration file is located at plugins/SMP-Nametags/config.yml:

# =====================================================
#             SMP Nametags Configuration
# =====================================================

# Global TextDisplay visual settings
display:
  billboard: CENTER
  text-alignment: CENTER
  see-through: false
  shadow: true
  background-color: "#00000000" # Transparent background
  vertical-offset: 0.35

# Ranked permission groups (evaluated highest priority first)
groups:
  owner:
    priority: 100
    permission: "group.owner"
    lines:
      - "<gradient:#FF0080:#7928CA><bold>[OWNER]</bold></gradient>"
      - "<white>%player_name%"
      - "<red>[Health] %player_health%/%player_max_health%"

  admin:
    priority: 80
    permission: "group.admin"
    lines:
      - "<gradient:#FF4B2B:#FF416C><bold>[ADMIN]</bold></gradient>"
      - "<white>%player_name%"

  default:
    priority: 0
    permission: "group.default"
    lines:
      - "<gray>%player_name%"