{"id":163086,"date":"2026-06-09T19:27:41","date_gmt":"2026-06-09T16:27:41","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/updatedisplayname\/"},"modified":"2026-06-09T19:27:41","modified_gmt":"2026-06-09T16:27:41","slug":"updatedisplayname","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/updatedisplayname\/","title":{"rendered":"UpdateDisplayName"},"content":{"rendered":"

# UpdateDisplayNames
\n## Overview
\nUpdateDisplayNames is a Paper plugin which automatically updates the display name and tablist name of the players to a specified format.
\n## Features
\n– Supports LuckPerms, Vault and PlaceholderAPI
\n– Supports both MiniMessage and legacy color codes in placeholders
\n– Has an API which allows to exclude specific players from the display name updates
\n## How to install
\nTo install this plugin, download the plugin for the correct minecraft version from the releases page and put it into your plugins directory.
\n## Commands
\n| Command | Description | Permission |
\n|–|–|–|
\n| `\/updatedisplayname reload` | Config reload | `updatedisplayname.command` |
\n| `\/updatedisplayname update` | Updates names of all players | `updatedisplayname.command` |
\n| `\/updatedisplayname enable [true|false]` | Enable\/disable the plugin’s functionality | `updatedisplayname.command` |
\n| `\/updatedisplayname playerlist` | Shows the exclude list | `updatedisplayname.command` |
\n## Configuration
\nThe plugin should work out of the box without any configuration needed.
\nBut if you want to change something, here are the config values:
\n| Option | Default | Description |
\n|–|–|–|
\n| `displayname –> enable` | `true` | If the plugin should update the player’s display name. |
\n| `displayname –> format` | `` | The player display name format. |
\n| `tablist –> enable` | `true` | If the plugin should update the player’s tablist name. |
\n| `tablist –> format` | `` | The player tablist name format. |
\n| `update_interval` | `60` | The inverval the names should be updated in seconds. |
\n## Using the API
\n### Import
\nUsing gradle:
\n“`kotlin
\nrepositories {
\n maven(“https:\/\/maven.chaossquad.net\/releases”)
\n}<\/p>\n

dependencies {
\n compileOnly(“net.jandie1505:UpdateDisplayName:1.0-RELEASE”)
\n}
\n“`<\/p>\n

Using maven:
\n“`xml
\n
\n ChaosSquad-Repository-releases<\/id>
\n ChaosSquad Repository<\/name>
\n https:\/\/maven.chaossquad.net\/releases<\/url>
\n<\/repository>
\n“`
\n“`xml
\n
\n net.jandie1505<\/groupId>
\n UpdateDisplayName<\/artifactId>
\n 1.0-RELEASE<\/version>
\n provided<\/scope>
\n<\/dependency>
\n“`<\/p>\n

### Usage
\n“`java
\n\/\/ General features
\npublic void ApiExample() {
\n UDNApi api = UpdateDisplayName.getApi();<\/p>\n

Player player = Bukkit.getPlayer(“playername”)<\/p>\n

boolean updatesEnabled = this.updatesEnabled; \/\/ Get plugin functionality status
\n api.setUpdatesEnabled(false); \/\/ Disable plugin functionality<\/p>\n

api.updatePlayers(); \/\/ Update display names of all players
\n api.updatePlayer(player); \/\/ Update display name of the specified player<\/p>\n

Set excludedPlayers = api.getExcludedPlayers(); \/\/ Get excluded players
\n boolean excluded = api.isPlayerExcluded(player); \/\/ Check if a player is excluded<\/p>\n

DataStorage config = api.getPluginConfig(); \/\/ Get plugin config<\/p>\n

\/\/ Get config values
\n boolean enableDisplaynameUpdate = config.optBoolean(UpdateDisplayname.CONFIG_ENABLE_DISPLAYNAME, false);
\n String displayNameFormat = config.optString(UpdateDisplayName.CONFIG_FORMAT_DISPLAYNAME, null);
\n boolean enableTablistName = config.optString(UpdateDisplayName.CONFIG_ENABLE_TABLIST_NAME, false);
\n String tablistFormat = config.optString(UpdateDisplayName.CONFIG_TABLIST_FORMAT, null);
\n int updateInterval = config.optInt(UpdateDisplayName.CONFIG_UPDATE_INTERVAL, 60);<\/p>\n

\/\/ Set config values
\n config.set(UpdateDisplayName.CONFIG_ENABLE_DISPLAYNAME, true);
\n config.set(UpdateDisplayName.CONFIG_FORMAT_DISPLAYNAME, ““);
\n config.set(UpdateDisplayName.CONFIG_ENABLE_TABLIST_NAME, true);
\n config.set(UpdateDisplayName.CONFIG_TABLIST_FORMAT, ““);
\n config.set(UpdateDisplayName.CONFIG_UPDATE_INTERVAL, 60);
\n}<\/p>\n

\/\/ Event for updated display name
\n@EventHandler
\npublic void onDisplayNameUpdated(DisplayNameUpdatedEvent event) {<\/p>\n

if (event.getPlayer().getName().equals(“forbiddenName”)) {
\n event.setCancelled(true)
\n return;
\n }<\/p>\n

if (event.getUpdatedDisplayName() == null) {
\n Bukkit.broadcast(Component.text(“Display name of ” + event.getPlayer().getName() + ” has been reset”))
\n return;
\n ]<\/p>\n

Bukkit.broadcast(Component.empty()
\n .append(Component.text(“Updated display name of player ” + event.getPlayer().getName() + “: “))
\n .append(event.getUpdatedDisplayName())
\n );<\/p>\n

}<\/p>\n

\/\/ Event for updated tablist name
\n@EventHandler
\npublic void onDisplayNameUpdated(TablistNameUpdatedEvent event) {<\/p>\n

if (event.getPlayer().getName().equals(“PleaseDontGiveMeATablistName”)) {
\n event.setCancelled(true)
\n return;
\n }<\/p>\n

if (event.getUpdatedTablistName() == null) {
\n Bukkit.broadcast(Component.text(“Tablist name of ” + event.getPlayer().getName() + ” has been reset”))
\n return;
\n ]<\/p>\n

Bukkit.broadcast(Component.empty()
\n .append(Component.text(“Updated tablist name of player ” + event.getPlayer().getName() + “: “))
\n .append(event.getUpdatedTablistName())
\n );<\/p>\n

}
\n“`<\/p>\n

### JavaDocs
\nClick here to get to the JavaDocs.<\/p>\n","protected":false},"excerpt":{"rendered":"

Updates the player displaynames and tablist names to a specified format.
\nSupports MiniMessage, Luckperms, Vault, PlaceholderAPI.
\nDeveloper API available.<\/p>\n","protected":false},"featured_media":163087,"template":"","meta":{"_minecraft_slug":"updatedisplayname","_minecraft_project_id":"qgh1tNOY","_minecraft_author":"jandie1505","_minecraft_license":"GPL-3.0-only","_minecraft_downloads":358,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"updatedisplayname.zip","_minecraft_size_bytes":193763,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T11:15:12.125203Z","_minecraft_date_created":"2025-02-04T08:42:20.621450Z","_minecraft_date_modified":"2025-02-01T14:23:40.186591Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/updatedisplayname","_minecraft_icon_attachment_id":163087,"_minecraft_imported_at":"2026-06-09T16:27:41+00:00","_minecraft_import_hash":"a4b618be029f6a0a22c41bb03ca73da4","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,127,867,92],"mod_loader":[132],"minecraft_version":[59,36,60,93,94,101,102,62,37,73,74,38,78,79,80,81],"class_list":["post-163086","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-paper","mod_category-social","mod_category-utility","mod_loader-paper","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8"],"yoast_head":"\nUpdateDisplayName - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/updatedisplayname\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"UpdateDisplayName - Minecraft\" \/>\n<meta property=\"og:description\" content=\"Updates the player displaynames and tablist names to a specified format. Supports MiniMessage, Luckperms, Vault, PlaceholderAPI. Developer API available.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/updatedisplayname\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"3 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/updatedisplayname\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/updatedisplayname\\\/\",\"name\":\"UpdateDisplayName - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/updatedisplayname\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/updatedisplayname\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/updatedisplayname-icon-489cc3bcc5d0d802a8b569a12aca74bf416e1160.png\",\"datePublished\":\"2026-06-09T16:27:41+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/updatedisplayname\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/updatedisplayname\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/updatedisplayname\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/updatedisplayname-icon-489cc3bcc5d0d802a8b569a12aca74bf416e1160.png\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/updatedisplayname-icon-489cc3bcc5d0d802a8b569a12aca74bf416e1160.png\",\"width\":256,\"height\":256},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/updatedisplayname\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"UpdateDisplayName\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"UpdateDisplayName - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/updatedisplayname\/","og_locale":"en_US","og_type":"article","og_title":"UpdateDisplayName - Minecraft","og_description":"Updates the player displaynames and tablist names to a specified format. Supports MiniMessage, Luckperms, Vault, PlaceholderAPI. Developer API available.","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/updatedisplayname\/","og_site_name":"Minecraft","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/updatedisplayname\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/updatedisplayname\/","name":"UpdateDisplayName - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/updatedisplayname\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/updatedisplayname\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/updatedisplayname-icon-489cc3bcc5d0d802a8b569a12aca74bf416e1160.png","datePublished":"2026-06-09T16:27:41+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/updatedisplayname\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/updatedisplayname\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/updatedisplayname\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/updatedisplayname-icon-489cc3bcc5d0d802a8b569a12aca74bf416e1160.png","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/updatedisplayname-icon-489cc3bcc5d0d802a8b569a12aca74bf416e1160.png","width":256,"height":256},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/updatedisplayname\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"UpdateDisplayName"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/163086","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/163087"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=163086"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=163086"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=163086"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=163086"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}