ProNouns - 专业代词插件

ProNouns 是一款面向 LGBTQ+ 友好服务器的插件，旨在让玩家能够便捷地设置自己的代词。无需再繁琐地调整权限组、修改昵称，也不必担心小众代词集无法被识别！

💡重要通知

ProNouns v2.x（当前版本）将不再接收任何更新。插件正在重写中，新版本位于 lucyydotp/pronouns3。如有任何反馈，请前往新仓库提交。在此期间，您仍可通过 Discord 获得支持。

🎮功能特色

• 玩家可独立设置自己的代词。
• 支持设置多个代词集。
• 支持 PlaceholderAPI，可编写能识别代词的自动化消息！
• 支持玩家自定义代词集。
• 支持 MySQL，适用于 BungeeCord 网络服。
• 界面美观，全面支持 RGB 颜色代码。
• 预置大量新代词（Neopronouns），数据来自 ProNouns Cloud。

🔧指令列表

• /pronouns - 显示插件所有可用指令。
• /pronouns set - 设置你的代词。若使用多个代词集，请将“首选”集放在最前面（在配置了自动化消息时会优先使用），其余代词集用空格分隔。例如：/pronouns set she they
• /pronouns clear - 清除你的代词设置。
• /pronouns show - 显示你或其他玩家的代词。
• /pronouns list - 列出所有预定义的代词集。（如果你的代词不在此列表中，仍然可以使用，请参阅下方的“自定义代词”部分。）
• /pronouns preview - 在句子中预览你的代词效果。
• /pronouns setother - 设置其他玩家的代词。（需要权限 pronouns.admin）
• /pronouns clearother - 清除其他玩家的代词。（需要权限 pronouns.admin）
• /pronouns cloud - 管理本地的 ProNouns Cloud 数据库副本。（需要权限 pronouns.admin）
• /pronouns reload - 重载配置文件。（需要权限 pronouns.admin）

✨预定义代词

使用这些代词集时，你无需输入全部 6 种形式，只需使用下列每组中的第一个词即可：

• he (对应：he/him/he's/his/his/himself)
• she (对应：she/her/she's/her/hers/herself)
• they (对应：they/them/they're/their/theirs/themself)
• any (特殊代词，在占位符中使用 they/them，但显示为“Any”)

✨自定义代词

你的代词不在 /pronouns list 列表中？没问题！设置自定义代词非常简单。格式如下：

/pronouns set 主格/宾格/进行式/所有格形容词/所有格代词/反身代词

以下是一些示例，以防你对语言学术语不熟悉

• /pronouns set he/him/he's/his/his/himself
• /pronouns set she/her/she's/her/hers/herself
• /pronouns set they/them/they're/their/theirs/themself

✨过滤机制

为防止滥用，插件配备了一个基于正则表达式的基础过滤器。默认会检测词语“apache”和“helicopter”。此过滤器可以禁用，也可以通过配置文件添加自定义规则。拥有 pronouns.bypass 权限的玩家不受此过滤器影响。

✨PlaceholderAPI 支持

ProNouns 提供了一系列 PAPI 占位符，让你可以在消息中使用代词！无需安装 eCloud 扩展，此功能已内置在插件中。

基础占位符

• %pronouns_pronouns% - 代词，以“主格/宾格”格式显示，例如 She/Her
• %pronouns_subjective% - 主格代词
• %pronouns_objective% - 宾格代词
• %pronouns_progressive% - 进行式代词
• %pronouns_possessiveadj% - 所有格形容词
• %pronouns_possessivepro% - 所有格代词
• %pronouns_reflexive% - 反身代词
• %pronouns_all% - 全部 6 种代词形式

格式修饰符

所有占位符都支持在名称末尾添加以下修饰符来控制大小写：

• upper - 大写（例如 SHE）
• lower - 小写（例如 she）
• capital - 首字母大写，其余小写（例如 She）

使用示例（使用 she/her 代词集）

• %pronouns_subjective_upper% - 显示为 SHE
• %pronoun_possessivepro_capital% - 显示为 Hers

⭐数据收集

本插件使用 bStats 收集匿名遥测数据。所有收集的数据均可在此查看：https://bstats.org/plugin/bukkit/ProNouns/9519。

⭐开发者 API

插件提供开发者 API。更多信息请查阅相关文档。

❓支持与文档

• 支持 Discord 服务器：https://discord.lucypoulton.net
• 更全面的文档：https://docs.lucypoulton.net/pronouns

💡简介

Pronouns 是一款为 Minecraft 服务器设计的插件，允许玩家设置并显示自己的代词。它支持跨服同步，并提供了丰富的自定义选项，让服务器能够打造包容、尊重的社区环境。

🎮功能特性

• 玩家设置：允许玩家使用命令设置自己的代词。
• 跨服同步：通过 MySQL 或 SQLite 数据库，在所有子服间同步玩家的代词设置。
• 灵活显示：

- 可在聊天、Tab 列表、玩家列表、计分板、名签等多种位置显示代词。

- 支持自定义显示格式。

• 管理工具：提供管理员命令，用于管理玩家的代词设置。
• API 支持：为其他插件开发者提供 API，以便集成代词信息。
• 多语言：内置多种语言支持。

🔧命令与权限

玩家命令

• /pronouns - 查看插件信息。
• /pronouns set <pronouns> - 设置你的代词。

- 权限：`pronouns.set`

• /pronouns clear - 清除你设置的代词。

- 权限：`pronouns.set`

• /pronouns preview - 预览你的代词在聊天中的显示效果。

- 权限：`pronouns.preview`

管理员命令

• /pronouns admin set <player> <pronouns> - 为指定玩家设置代词。

- 权限：`pronouns.admin.set`

• /pronouns admin clear <player> - 清除指定玩家的代词设置。

- 权限：`pronouns.admin.clear`

• /pronouns admin reload - 重载插件配置。

- 权限：`pronouns.admin.reload`

✨安装与配置

要求

• 服务器软件：Paper、Folia 或其衍生版本（如 Purpur）。
• Java 版本：Java 17 或更高版本。
• 数据库（可选）：如需跨服同步，需要 MySQL 或 MariaDB。

安装步骤

• 将 Pronouns.jar 文件放入服务器的 plugins 文件夹。
• 启动或重启服务器以生成配置文件。
• 根据需求编辑 plugins/Pronouns/config.yml 文件。
• 如需跨服同步，请在配置文件中设置数据库连接信息。

配置要点

• 显示位置：在配置文件中启用或禁用聊天、Tab 列表等位置的代词显示。
• 格式自定义：可以修改代词显示的文本颜色、样式和前后缀。
• 数据库：设置 storage.method 为 mysql 并填写连接信息以实现跨服同步。

❓常见问题

• 问：支持哪些 Minecraft 版本？

- 答：插件支持 Minecraft 1.17 及更高版本。

• 问：如何让代词在聊天中显示？

- 答：在配置文件中将 `chat.enabled` 设置为 `true`，并调整 `chat.format` 以符合你的喜好。

• 问：玩家可以设置任意文本作为代词吗？

- 答：是的，默认情况下玩家可以设置任何文本。管理员可以通过配置或权限插件来限制可用的选项。

• 问：如何获取其他插件的支持？

- 答：Pronouns 提供了 API。开发者可以在其项目中添加 `net.lucypoulton:pronouns-api` 依赖来使用。

⭐更多信息

如需详细的配置选项说明、API 使用方法或更新日志，请访问官方文档网站：

https://docs.lucypoulton.net/pronouns