{"id":20892947,"url":"https://github.com/carmjos/userprefix","last_synced_at":"2025-12-25T08:37:10.179Z","repository":{"id":41124337,"uuid":"398879626","full_name":"CarmJos/UserPrefix","owner":"CarmJos","description":"一个简单、高效且实时更新的用户前缀插件，基于Spigot、LuckPerms实现。","archived":false,"fork":false,"pushed_at":"2025-05-12T10:16:30.000Z","size":2657,"stargazers_count":49,"open_issues_count":3,"forks_count":11,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-05-12T11:29:00.564Z","etag":null,"topics":["enchantments","luckperms","minecraft-plugin","minecraft-server","prefix","spigot-plugin"],"latest_commit_sha":null,"homepage":"https://carmjos.github.io/UserPrefix","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/CarmJos.png","metadata":{"files":{"readme":"README-en.md","changelog":null,"contributing":null,"funding":null,"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,"zenodo":null}},"created_at":"2021-08-22T19:12:00.000Z","updated_at":"2025-05-12T10:15:14.000Z","dependencies_parsed_at":"2023-09-28T10:10:11.414Z","dependency_job_id":"ad91f441-e241-4cf8-968a-fb45419ea272","html_url":"https://github.com/CarmJos/UserPrefix","commit_stats":null,"previous_names":[],"tags_count":39,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CarmJos%2FUserPrefix","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CarmJos%2FUserPrefix/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CarmJos%2FUserPrefix/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/CarmJos%2FUserPrefix/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/CarmJos","download_url":"https://codeload.github.com/CarmJos/UserPrefix/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253833312,"owners_count":21971397,"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":["enchantments","luckperms","minecraft-plugin","minecraft-server","prefix","spigot-plugin"],"created_at":"2024-11-18T10:14:20.707Z","updated_at":"2025-12-25T08:37:10.169Z","avatar_url":"https://github.com/CarmJos.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"![BANNER](.documentation/images/banner.png)\n\nREADME LANGUAGES [ [中文](README.md) | [**English**](README-en.md)  ]\n\n# UserPrefix Plugin\n\n[![CodeFactor](https://www.codefactor.io/repository/github/carmjos/userprefix/badge?s=b76fec1f64726b5f19989aace6adb5f85fdab840)](https://www.codefactor.io/repository/github/carmjos/userprefix)\n![CodeSize](https://img.shields.io/github/languages/code-size/CarmJos/UserPrefix)\n[![License](https://img.shields.io/github/license/CarmJos/UserPrefix)](https://opensource.org/licenses/GPL-3.0)\n[![Java CI with Maven](https://github.com/CarmJos/UserPrefix/actions/workflows/maven.yml/badge.svg?branch=master)](https://github.com/CarmJos/UserPrefix/actions/workflows/maven.yml)\n![Support](https://img.shields.io/badge/Minecraft-Java%201.8--Latest-yellow)\n![](https://visitor-badge.glitch.me/badge?page_id=userprefix.readme)\n\nLightweight, efficient, and real-time user prefix system.\n\nThis plugin is implemented based on Spigot ,**Theoretically** support ALL MineCraft Versions.\n\nThe development of this plugin is based on Chinese which purpose is to help Chinese developers learn Bukkit plugin\ndevelopment.\n\n\u003e This plugin has been published on [SpigotMC](https://www.spigotmc.org/resources/userprefix.96277/) .\n\n## Examples\n\n![example](.documentation/images/using-example.png)\n\n## Dependencies\n\n- **[Necessary]** Plugin developed based on [Spigot-API](https://hub.spigotmc.org/stash/projects/SPIGOT)\n  and [BukkitAPI](http://bukkit.org/).\n- **[Necessary]** Plugin data storage base on  [LuckPerms](https://www.spigotmc.org/resources/luckperms.28140/).\n- **[Recommend]** Placeholders based on [PlaceholderAPI](https://www.spigotmc.org/resources/6245/) .\n\nFor development dependencies, please see  [Dependencies](https://github.com/CarmJos/UserPrefix/network/dependencies) .\n\n## Features\n\n- **Theoretically** support ALL MineCraft Versions.\n- Reloading the configuration will automatically refresh the prefix of all players.\n- Real-time judgment and feedback to the player when permissions are changed.\n- Configurable sounds and messages.\n- The prefix icon can be configured as \"Selected\", \"Has Permission\" and “No Permission”.\n- TabList is automatically sorted according to the weight of the prefix (if there is a conflict, it can be turned off)\n- The prefix display on the player name (can be turned off if there has any conflict)\n- Simple Chat Format Placeholder support. (Not Recommended)\n- GUI with automatic sorting and page turning!\n- Support PlaceholderAPI variables!\n- Support [Hex Color](https://www.hexcolortool.com/)! (Version 1.16 and above)  `\u0026(#Color)`\n    - Example: LightSlateBlue `\u0026(#8470FF)` 、 DarkSlateBlue `\u0026(#483D8B)`\n- Support Gradient Color! (Version 1.16 and above)  `\u0026\u003c#Color1\u003eMessage\u0026\u003c#Color2\u003e`\n    - Example: `\u0026\u003c#8470FF\u003eHello World!\u0026\u003c#483D8B\u003e`\n\n## Notice\n\n### 1. Version support issues\n\nThis plugin theoretically supports all versions.\n\nIf the icon does not load, the sound cannot be played, etc., please check whether the type of the item and sound in the\nconfiguration file exists in the current version.\n\nTake the SOUND as an example. The sound that the villager said \"OK\" is \"`VILLAGER_YES`\" in the lower version, but it\nbecomes \"`ENTITY_VILLAGER_YES`\" in the higher version.\n\n### 2. Scoreboard exception problem\n\nThe display of the prefix on the head and the sorting of the TabList both use the scoreboard API.\n\nPlease turn of the `functions.on-name-prefix` in the configuration if there is a conflict.\n\n## Commands\n\nThis plugin's Commands are based on Chinese!\n**May support multi-language in the future.**\n\n```text\n/UserPrefix or /prefix #Open prefix GUI\n/UserPrefixAdmin # View Admin Command Help\n/UserPrefixAdmin reload # Reload Config\n/UserPrefixAdmin list # List all configured prefixes.\n```\n\n## Placeholders (PlaceholderAPI)\n\nAfter installed the [PlaceholderAPI](https://github.com/PlaceholderAPI/PlaceholderAPI) , you can\ntype `/papi info UserPrefix` to see all the placeholders.\n\n```text\n# %UserPrefix_prefix% \n- Get the content of the current prefix\n# %UserPrefix_weight% \n- Get the weight of the current prefix.\n# %UserPrefix_identifier% \n- Get the identifier of the current prefix.\n# %UserPrefix_name% \n- Get the name of the current prefix.\n# %UserPrefix_has_\u003cIdentifier\u003e% \n- Determine whether the player has a certain prefix(true/false)\n```\n\n## Configuration files\n\n### Plugin Configuration ([`config.yml`]() .\n\nWill be generated on the first boot up.\n\n### Messages Configuration ([`messages.yml`]())\n\nWill be generated on the first boot up.\n\n### Prefixes Configuration ([`prefixes/*.yml`](src/main/resources/en_US/example-prefix.yml))\n\nAll prefixes are separate configuration files, stored in the `\u003cData Folder\u003e/prefixes/` for easy management.\n\nSome symbols in file name may affect reading, please avoid using them.\n\n## Support and Donation\n\nThis project is support by the  [YourCraft(你的世界)](https://www.ycraft.cn) .\n![TeamLogo](.documentation/images/team-logo.png)\n\n## Open source agreement\n\nThe source code of this project uses  [GNU General Public License v3.0](https://opensource.org/licenses/GPL-3.0)\nLicense.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcarmjos%2Fuserprefix","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcarmjos%2Fuserprefix","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcarmjos%2Fuserprefix/lists"}