Prefixed Playerlist 从其配置文件或 PermissionsEx 获取前缀(颜色、文本或彩色文本),并将其显示在记分板/玩家列表(游戏中按 TAB 键调用)中。你不需要任何额外的插件(PermissionsEx 为可选)。
功能特性
- 为服务器管理员(OP)定义前缀
- 可以区分不同游戏模式下的玩家
- 提供重载配置、重载玩家列表以及获取插件信息的命令
- 如果你希望为所有名称添加前缀,可设置一个默认前缀
- 该插件利用 Bukkit Permissions 系统
- 支持 PermissionsEx 前缀
命令
每个命令都可以以 /ppl 或 /playerlist 开头。你可以使用原生命令 /help PrefixedPlayerlist 以获得便利。
- /ppl 或 /ppl help 引导你查看 /help PrefixedPlayerlist
- /ppl version 显示关于该插件的基本信息
- /ppl reload 软重载插件配置(不重新读取插件 jar 文件)
- /ppl checkupdate 手动检查更新
- /ppl refresh 刷新玩家列表
权限
请注意,以 prefixedplayerlist.prefix.* 开头的权限不多,它们仅用于分配前缀,无其他用途。这些权限在其他地方有说明——请查看 示例设置。
- prefixedplayerlist.* 赋予对 PrefixedPlayerlist 所有命令的完全控制权
- prefixedplayerlist.reload 允许你重载插件(/ppl reload)
- prefixedplayerlist.checkupdate 允许你手动检查新版本(/ppl checkupdate)
- prefixedplayerlist.refresh 允许你刷新玩家列表(/ppl refresh)
前缀叠加规则
- 如果你使用 PrefixedPlayerlist 配置文件来定义前缀
- prefixCreative + prefixOp + prefixDefault + prefixCustom + 玩家名称
- 当你使用 PermissionsEx 来定义前缀时
- 前缀Creative + 前缀Op + 前缀Default + PEX前缀 + 玩家名称
其他说明
重要注意事项和信息:
- 请注意,玩家名称的最大长度为 16 个字符。这是客户端的限制。
- 每种颜色占用 2 个字符(见下文)。
- PPL 会在每个名称末尾插入一种颜色(两个字符),以保持延迟指示颜色的不变。
- 当玩家名称过长时,它会被截断为 13 个字符,并在末尾添加 …(省略号符号)(同时重置延迟指示的颜色)。
- 插件将前缀的长度限制为 10 个字符,
- 尽管最好保持前缀的总长度(包括 op、游戏模式等)在 4 个字符以下。你不想看到 MyNicePrefix:A…(其中 A 是玩家名称唯一可见的部分)
- 你可以使用控制字符 §(段落符)或 &(和号)来定义颜色。
- 颜色由控制字符以及从 0 到 9 的数字或字母 a-f 定义。此控制序列之后的文本会受到影响。
- 每位玩家只能拥有一个自定义前缀。优先级以配置文件中首先定义的组为准。因此,建议从管理员的前缀开始,然后是版主,接着是其他特殊玩家组,以此类推。
- 原因?您的管理员可能会继承版主的“前缀权限”,而您希望他显示的是管理员前缀,而非版主前缀。
- 如果您决定不使用某些预定义的前缀(如游戏模式、OP),您可以将撇号留空或直接删除整个定义
- 当您使用 op 或 deop 某人时,更改仅在重新登录(或插件重载)后生效,不会立即应用。
- 现在有一个用于刷新表格的命令,只需使用 /ppl refresh
- 插件每次启用时都会检查是否最新版本。此时会记录您的服务器 IP 和插件版本。这只是为了让我大致了解用户数量。
- 您可以在配置中将 options.checkVersion 设置为 false 来禁用此功能
- 您可以使用 /ppl checkupdate 手动检查更新
- 我非常欢迎反馈,请随时留下评论! :)
已知问题
目前没有任何已知的问题。
待办事项与功能请求
- 基于自定义且易于格式化的字符串构建插件
- 在列表中增加隐藏功能
- 添加更多命令(如隐藏、更改名称等)
- 允许为延迟指示器着色
用不同颜色标记自己 无法实现,等待官方模组 API
Prefixed Playerlist takes prefixes (colors, text or colored text) from its config or PermissionsEx and displays them in the scoreboard / player list (invoked by TAB ingame). You don't need any additional plugins (PEX is optional).
Default Config | Example Setup | Change Log
Features
- Define prefix for server OPs
- Players in different game modes can be distinguished
- There are commands to reload configuration, reload the playerlist and get information about the plugin
- There is a default prefix if you want to prefix all names
- The plugin takes advance of Bukkit Permissions
- PermissionsEx prefix support
Commands
Every command can start with /ppl or /playerlist. You can use native command /help PrefixedPlayerlist for your own convenience.
- /ppl or /ppl help points you to look at /help PrefixedPlayerlist
- /ppl version shows basic information about the plugin
- /ppl reload softly reloads plugin configuration (without re-reading plugin jar file)
- /ppl checkupdate manually checks for updates
- /ppl refresh refreshes the player table
Permissions
Note that there are not-that-much permissions starting with prefixedplayerlist.prefix.* that are used to assign prefixes and nothing else. They are explained elsewhere - take a look at example setup.
- prefixedplayerlist.* Gives full control over all commands of PrefixedPlayerlist
- prefixedplayerlist.reload Allows you to reload the plugin (/ppl reload)
- prefixedplayerlist.checkupdate Allows you to check for new versions manually (/ppl checkupdate)
- prefixedplayerlist.refresh Allows you to refresh the player list (/ppl refresh)
How prefixes stack
- If you use PrefixedPlayerlist config to define prefixes
- prefixCreative + prefixOp + prefixDefault + prefixCustom + PlayerName
- When you use PermissionsEx to define prefixes
- prefixCreative + prefixOp + prefixDefault + PEXprefix + PlayerName
Additional notes
Important notes and information:
- Keep in mind that max. length of player name is 16 characters. This is a client-side limit.
- Each color takes 2 characters (see below).
- PPL inserts one color (two characters) at the end of each name to keep ping color unchanged
- When playername is too long, it gets stripped to 13 characters, and … (triple-dot glyph, ellipsis) is added at the end (along with the color reset for ping).
- The length of a prefix is limited to 10 characters by the plugin,
- although it is wise to keep the overall length of prefix (count with op, gamemode, etc.) under 4 characters. You don't want to see MyNicePrefix:A… (with A being the only part of players name visible)
- You can define colors using the control characters § (paragraph), or & (and).
- Colors are defined by the control character and number from 0 to 9 or letter a-f. The text following this control sequence is affected.
- You can use formatting characters if you want (things like bold, underline, etc. See MP wiki page for details)
- Every player may have only one custom prefix. Priority has the group first defined in the config. Therefore it is a great idea to start with prefix for administrator, then moderator, then some special player groups, etc.
- Why? Your admin will probably inherit the "prefix permission" of moderators, and you want to have him prefix of admin, not mod.
- If you decide not to use some of the predefined prefixes (gamemodes, op), you can either leave the apostrophes blank or remove the whole definition
- When you op or deop someone, the change can be seen only after relog (or after plugin reload), not immediately.
- There is now a refresh command for the table, just use /ppl refresh
- Plugin checks if it is up to date every time it is enabled. Your server IP and plugin version are logged at that time. It's just for me to keep approximate number of users.
- This can be disabled in config by setting options.checkVersion to false
- You can check for updates manually using /ppl checkupdate
- I really appreciate feedback, so feel free to leave a comment! :)
Known Bugs
There are no known bugs at the moment.
Todo & Feature Requests
- Base the plugin around custom, easily formattable strings
- Add hiding in the list
- Add more commands (to hide, change the name, etc.)
- Allow coloring the ping
Mark self with different color impossible, waiting for official mod API
评论 0
登录后参与评分
还没有评论,来抢沙发吧