UnlimitedNameTags

Custom stacked nametags for Paper servers: text, item, and block display rows with placeholders, animations, visibility rules, and a developer API.

• Paper 1.21.4+ or a compatible Paper fork such as Purpur or Folia.
• PacketEvents installed on the server.
• Spigot and other non-Paper servers are not supported.

• Multiple stacked displayGroups per player.
• TEXT rows with structured lines and optional per-line when conditions.
• ITEM and BLOCK rows with configurable material, scale, offset, billboard, glow, and animations.
• PlaceholderAPI, MiniPlaceholders, vanish integrations, Geyser support notes, and hook support for common cosmetic plugins.
• Config migration through configVersion and SettingsYamlMigrator.

1. Put PacketEvents and UnlimitedNametags.jar in plugins/.
2. Restart the server.
3. Edit plugins/UnlimitedNameTags/settings.yml.

./gradlew :paper:shadowJar

On Windows:

gradlew.bat :paper:shadowJar

The server jar is written to target/UnlimitedNametags.jar.

Use the artifact that matches the API surface you need:

dependencies {
    compileOnly("io.github.alexdev03:unlimitednametags-api-paper:2.0.0")
    // compileOnly("io.github.alexdev03:unlimitednametags-api:2.0.0")
}

• api-paper: Paper/Bukkit types, UNTPaperAPI, Player overloads, Formatter.
• api: UUID and Adventure-only interfaces.
• common: shared config and value types used by the API.

Publishing notes are in MAVEN_CENTRAL_PUBLISHING.md. Breaking changes are tracked in CHANGELOG.md.

displayGroups:
  - lines:
      - text: "%luckperms_prefix%%player_name%"
      - text: "&a%player_ping%ms"
        when: "%player_ping% < 70"
    scale: 1.0
    yOffset: 1.0

Use Discord for questions and support.