{"id":26669291,"url":"https://github.com/eclipseisoffline/customname","last_synced_at":"2026-01-08T13:13:44.503Z","repository":{"id":222030585,"uuid":"756057139","full_name":"eclipseisoffline/customname","owner":"eclipseisoffline","description":"This mod adds a /name command to Minecraft, which players can use to set a prefix, suffix, or nickname.","archived":false,"fork":false,"pushed_at":"2024-06-13T16:38:21.000Z","size":153,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-06-13T19:30:07.749Z","etag":null,"topics":["minecraft","minecraft-mod"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/eclipseisoffline.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"lfx_crowdfunding":null,"buy_me_a_coffee":"eclipseisoffline","custom":null}},"created_at":"2024-02-11T21:06:34.000Z","updated_at":"2024-06-13T16:38:23.000Z","dependencies_parsed_at":"2024-02-11T22:29:17.610Z","dependency_job_id":"325475c4-27ca-4b3c-8cda-17d2befe3437","html_url":"https://github.com/eclipseisoffline/customname","commit_stats":null,"previous_names":["eclipseisoffline/customname"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eclipseisoffline%2Fcustomname","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eclipseisoffline%2Fcustomname/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eclipseisoffline%2Fcustomname/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eclipseisoffline%2Fcustomname/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/eclipseisoffline","download_url":"https://codeload.github.com/eclipseisoffline/customname/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245550537,"owners_count":20633872,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["minecraft","minecraft-mod"],"created_at":"2025-03-25T21:48:12.481Z","updated_at":"2026-01-08T13:13:44.489Z","avatar_url":"https://github.com/eclipseisoffline.png","language":"Java","funding_links":["https://buymeacoffee.com/eclipseisoffline"],"categories":[],"sub_categories":[],"readme":"# Custom Names\n\n[![Modrinth Version](https://img.shields.io/modrinth/v/saIlazMs?logo=modrinth\u0026color=008800)](https://modrinth.com/mod/fabric-custom-names)\n[![Modrinth Game Versions](https://img.shields.io/modrinth/game-versions/saIlazMs?logo=modrinth\u0026color=008800)](https://modrinth.com/mod/fabric-custom-names)\n[![Modrinth Downloads](https://img.shields.io/modrinth/dt/saIlazMs?logo=modrinth\u0026color=008800)](https://modrinth.com/mod/fabric-custom-names)\n[![Discord Badge](https://img.shields.io/badge/chat-discord-%235865f2)](https://discord.gg/CNNkyWRkqm)\n[![Github Badge](https://img.shields.io/badge/github-customname-white?logo=github)](https://github.com/eclipseisoffline/customname)\n![GitHub License](https://img.shields.io/github/license/eclipseisoffline/customname)\n\nThis mod adds a `/name`, a `/itemname` and a `/itemlore` command to Minecraft, which players can use to set a prefix, suffix, or nickname,\nor give their items colourful names and lore. Mostly designed to be used in small, private servers, although through the\nuse of name groups you can also limit which players can use which prefixes/suffixes/nicknames.\n\nSupports prefixes/suffixes set with LuckPerms as well! \n\nFeel free to report any bugs, or suggest new features, at the issue tracker.\n\n## License\n\nThis mod is licensed under GNU LGPLv3.\n\n## Donating\n\nIf you like this mod, consider [donating](https://buymeacoffee.com/eclipseisoffline).\n\n## Discord\n\nFor support and/or any questions you may have, feel free to join [my discord](https://discord.gg/CNNkyWRkqm).\n\n## Version support\n\n| Minecraft Version | Status       |\n|-------------------|--------------|\n| 1.21.11           | ✅ Current    |\n| 1.21.9+10         | ✔️ Available |\n| 1.21.6+7+8        | ✔️ Available |\n| 1.21.5            | ✔️ Available |\n| 1.21.4            | ✔️ Available |\n| 1.21.2+3          | ✔️ Available |\n| 1.21+1            | ✅ Current    |\n| 1.20.5+6          | ✔️ Available |\n| 1.20.4            | ✔️ Available |\n| 1.20.1            | ✔️ Available |\n| 1.19.4            | ✔️ Available |\n| 1.19.2            | ✔️ Available |\n\nI try to keep support up for the latest major and latest minor release of Minecraft. Updates to newer Minecraft\nversions may be delayed from time to time, as I do not always have the time to immediately update my mods.\n\nUnsupported versions are still available to download, but they won't receive new features or bugfixes.\n\n## Usage\n\nMod builds can be found on the releases page, as well as on [Modrinth](https://modrinth.com/mod/fabric-custom-names).\n\nThis mod is oriented at Fabric Minecraft servers, but works on the client as well. This mod requires the Fabric API.\n\nThe `/name` command can be used as follows:\n\n- `/name prefix` - sets a prefix for your name, or when no prefix is given, clears your prefix.\n  - Requires operator or the `customname.prefix` permission.\n- `/name suffix` - sets a suffix for your name, or when no suffix is given, clears your suffix.\n  - Requires operator or the `customname.suffix` permission.\n- `/name nickname` - sets a nickname that will appear instead of your IGN, or when no nickname is given, clears your nickname.\n  - Requires operator or the `customname.nick` permission.\n- `/name other \u003cprefix|suffix|nickname\u003e \u003cplayer\u003e`\n  - Same syntax as their respective `/name \u003cprefix|suffix|nickname\u003e` commands, but to set another player's prefix/suffix/nickname. Requires operator or the `customname.other` permission on top of the respective `customname.\u003cnametype\u003e` permission.\n\nWhen hovering over a player's name with advanced tooltips enabled, their real name will show up.\n\nThe `/itemname` command can be used to rename the item you're currently holding. Requires operator or the `customname.itemname` permission.\n\nSimilarly, the `/itemlore` can be used to set the lore of an item you're holding. Requires operator or the `customname.itemlore` permission.\n`\\n` can be used to create new lines, `\\\\` can be used to escape a backslash.\n\nSimilar to the `/name` commands, running these commands without arguments resets the item name/lore of the item you're holding.\n\nMinecraft's [formatting codes](https://minecraft.wiki/w/Formatting_codes) can be used to format your prefix, suffix, nickname, or your item names/lores.\nInstead of the `§` character, use `\u0026` (to use `\u0026` in an (item)name, type `\u0026\u0026`).\nAlongside Minecraft's default formatting codes, the `\u0026#\u003chex code\u003e` format can be used as well.\n\nUseful tools to easily create formatted names are available [here](http://mcnick.surge.sh/) and [here](https://nickgen.netlify.app/).\nUsage of formatting codes in names can be disabled in the config file.\n\nAlongside the `/name` command, this mod also supports reading prefixes and suffixes from the LuckPerms mod.\n\n## Config file\n\nThe mod's configuration file is present in `{root config directory}/eclipsescustomname.json`.\nBy default, the configuration file looks like this:\n\n```json\n{\n  \"enable_formatting\": true,\n  \"require_permissions\": true,\n  \"blacklisted_names\": [],\n  \"max_name_length\": 16,\n  \"operators_bypass_restrictions\": false,\n  \"display_above_player\": false,\n  \"name_groups\": {\n    \"prefix\": {},\n    \"nickname\": {},\n    \"suffix\": {}\n  }\n}\n```\n\n- `enable_formatting` can be used to disable the use of Minecraft formatting codes in names.\n- `require_permissions` can be used to disable the permission requirement. When set to `false`, the `/name`, `/itemname` and `/itemlore` commands are available to everyone.\n- `blacklisted_names` is a list of regexes that are blacklisted. When a prefix, suffix or nickname matches one of these regexes, they won't be able to be used.\n- `max_name_length` controls how long a player prefix/nickname/suffix can be, which can be 32 at most.\n- `operators_bypass_restrictions` can be used to disable name restrictions for operators. When this is enabled, operators and people with the permission `customname.bypass_restrictions` can use spaces in nicknames, bypass the max length restriction, and more.\n- `display_above_player` controls whether the player's custom name should display above their head in game. This is currently not compatible with hiding name tags using teams.\n- `name_groups` can be used to create name groups for each name type. Name groups consist of a list of names, which follow the same format used in name commands. You can assign players to one or more name groups by giving them permissions to the respective groups. They will then be able to use names listed in those groups.\n\nFor example, consider this name groups config:\n\n```json\n\"name_groups\": {\n  \"prefix\": {\n    \"vip\": [\n      \"\u0026f\u0026l[\u00267VIP\u0026f\u0026l]\",\n      \"\u0026f\u0026l[\u00269VIP\u0026f\u0026l]\",\n      \"\u0026f\u0026l[\u0026aVIP\u0026f\u0026l]\",\n      \"\u0026f\u0026l[\u0026bVIP\u0026f\u0026l]\",\n      \"\u0026f\u0026l[\u0026cVIP\u0026f\u0026l]\",\n    ],\n    \"legendary\": [\n      \"\u0026f\u0026l[\u00267Legendary\u0026f\u0026l]\",\n      \"\u0026f\u0026l[\u00269Legendary\u0026f\u0026l]\",\n      \"\u0026f\u0026l[\u0026aLegendary\u0026f\u0026l]\",\n      \"\u0026f\u0026l[\u0026bLegendary\u0026f\u0026l]\",\n      \"\u0026f\u0026l[\u0026cLegendary\u0026f\u0026l]\",\n    ]\n  },\n  \"nickname\": {},\n  \"suffix\": {}\n}\n```\n\nYou can then give players the `customname.group.prefix.vip` permission to allow them to use prefixes from the `vip` group,\nand the `customname.group.prefix.legendary` permission to allow them to use prefixes from the `legendary` group. Players\nwill see these prefixes suggested when entering the `/name prefix` command, and, when running `/name prefix` without any\narguments, a chat menu will allow them to select a prefix.\n\nNote that granting players the `customname.prefix` permission will still allow them to use any prefix. Everything said above\nalso applies to nicknames and suffixes.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feclipseisoffline%2Fcustomname","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Feclipseisoffline%2Fcustomname","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feclipseisoffline%2Fcustomname/lists"}