![](\"https:\/\/raw.githubusercontent.com\/senseiwells\/CustomNameTags\/1.20.2\/src\/main\/resources\/assets\/nametag\/icon.png\"){kind=icon}
CustomNameTags<\/p>\n# CustomNameTags<\/p>\n
This mod provides you with a way to customize your player’s
\nname tags completely server-side with no need for any client mods.<\/p>\n
<\/p>\n
## Commands<\/p>\n
You are able to do some basic actions from within the game with the `\/nametag`
\ncommand, this requires permission level 2 or if you are using a permissions mod
\nyou can have the permission `”customnametags.command.nametag”`.<\/p>\n
#### `\/nametag create #### `\/nametag delete #### `\/nametag reload` ## Configuration<\/p>\n This mod allows a high level of customization, from the text being All of this is configured using a json located in `config\/CustomNameTags\/config.json`. “`json ### Creating a Nametag<\/p>\n In the config json, there will be an array which contains all the nametags Let’s have a look at what makes up a nametag:<\/p>\n #### `”id”` #### `”update_interval”` #### `”literal”` For example `”%player:displayname”` which will insert the display name of the current player. #### `”visible_radius”`, `”hidden_radius”`<\/p>\n These two settings specify a range where the nametag will be visible to other players.<\/p>\n Set these to a negative value to disable them.<\/p>\n For example, if you only wanted players in range from a 5.3 to 10.7 block radius to see each others nametags, #### `”observee_predicate”` For example, in the example, above only operators are given the `”example:admin_name”` This uses the predicate api; #### `”observer_predicate”` This uses the predicate api; # Caveats<\/p>\n There are some limitations of CustomNameTags, while for almost all the cases – When players press F1 to hide their HUD player custom nametags will remain visible. This mod provides you with a way to customize your player’s name tags completely server-side with no need for any client mods.<\/p>\n","protected":false},"featured_media":53178,"template":"","meta":{"_minecraft_slug":"customnametags","_minecraft_project_id":"TizFPouK","_minecraft_author":"senseiwells","_minecraft_license":"MIT","_minecraft_downloads":15186,"_minecraft_follows":53,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"customnametags.zip","_minecraft_size_bytes":27427903,"_minecraft_version_count":31,"_minecraft_updated_at":"2026-05-15T21:14:05.629117Z","_minecraft_date_created":"2023-12-01T04:23:33.247440Z","_minecraft_date_modified":"2026-04-03T22:55:21.305867Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/customnametags","_minecraft_icon_attachment_id":53178,"_minecraft_imported_at":"2026-06-02T22:58:43+00:00","_minecraft_import_hash":"1ab3476837113ae0be63062d8b7ae04c","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[97,126,867,92],"mod_loader":[99],"minecraft_version":[59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-53177","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-fabric","mod_category-management","mod_category-social","mod_category-utility","mod_loader-fabric","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-10","minecraft_version-1-21-11","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","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\nThis creates a nametag with a given identifier and text, this supports the
\nplaceholder api.<\/p>\n
\nThis deletes a given nametag with identifier.<\/p>\n
\nThis reloads the config file.<\/p>\n
\ndisplayed, whether it is being displayed and who it can be displayed to.<\/p>\n
\nThe above image used the following configuration:<\/p>\n
\n{
\n “nametags”: [
\n {
\n “id”: “example:admin_name”,
\n “update_interval”: -1,
\n “literal”: “[Admin]
\n “observee_predicate”: {
\n “type”: “operator”,
\n “operator”: 4
\n }
\n },
\n {
\n “id”: “example:name”,
\n “update_interval”: -1,
\n “literal”: “[Player] %player:displayname_visual%”,
\n “observee_predicate”: {
\n “type”: “negate”,
\n “value”: {
\n “type”: “operator”,
\n “operator”: 4
\n }
\n }
\n },
\n {
\n “id”: “example:held_item”,
\n “update_interval”: 1,
\n “literal”: “Holding:
\n “observee_predicate”: {
\n “type”: “negate”,
\n “value”: {
\n “type”: “entity”,
\n “value”: {
\n “equipment”: {
\n “mainhand”: {
\n “items”: [
\n “minecraft:air”
\n ]
\n }
\n }
\n }
\n }
\n }
\n },
\n {
\n “id”: “example:data”,
\n “update_interval”: 1,
\n “literal”: “%player:health%\u2665 %player:hunger%\ud83c\udf56 %player:statistic minecraft:killed minecraft:player%\u2694 %player:statistic minecraft:deaths%uD83DuDC80”
\n }
\n ]
\n}
\n“`<\/p>\n
\nthat will be displayed for your players. Each nametag is its own object.<\/p>\n
\nThis is the identifier unique to your nametag, and follows this convention:
\n`”namespace:name”`.<\/p>\n
\nThis is the interval at which the nametag will be updated, in ticks.
\nSet to -1 if your nametag doesn’t need to be updated.<\/p>\n
\nThis is the text that will be displayed on your nametag. This supports
\nthe placeholder api,
\nwhich means you can add contextual data. <\/p>\n
\nFor all the details reference the placeholder api.<\/p>\n
\nyou can set:
\n“`json5
\n{
\n \/\/ …
\n “hidden_radius”: 5.3,
\n “visible_radius”: 10.7,
\n \/\/ …
\n}
\n“`<\/p>\n
\nThis is optional and doesn’t need to be defined, but if defined will allow
\nyou to decide which players will have this given nametag. <\/p>\n
\nnametag and only non-operators are given the `”example:name”` nametag.<\/p>\n
\nyou can view the documentation for more details about what predicates you
\ncan define.<\/p>\n
\nThis is optional and doesn’t need to be defined, but if defined will determine
\nwhether an observing player will be able to see this nametag.<\/p>\n
\nyou can view the documentation for more details about what predicates you
\ncan define.<\/p>\n
\nthe nametags will behave as expected, there are inconsistencies with the
\ncustom nametags.<\/p>\n
\n– If the player is part of a team, their normal nametag will render.
\n – This can be solved by hiding all nametags for the given team:
\n – `\/team modify