Image Emojis: Emojis in chat

**ImageEmojis** 是一个 **Paper (1.19.4+)** 插件，允许你在你的服务器上添加**自定义表情符号**。
**[重要]** 表情符号的最大分辨率为 **256x256px**！表情符号应存储为 **'.png'** 格式。 如果你有任何问题/bug，可以在 [这里](https://github.com/MrQuackDuck/ImageEmojis/issues) 提交。 ### 👀 截图
### 💻 命令 - `/emojis list` — 打开一个包含所有当前添加的表情符号的书籍。 - `/emojis update` — 从服务器获取最新版本的表情符号资源包。 意图在管理员更新了表情符号并重新加载插件时使用。 _(或者，你也可以重新加入游戏，而不用使用此命令)_。 - `/emojis reload` — 重新加载插件。 根据 `./plugins/ImageEmojis/emojis/` 目录生成资源包。 别名: `/ie`, `/imageemojis`. ### 🔞 权限 - `imageemojis.admin` _(默认情况下为 **操作员**)_ — 允许使用 `/emojis reload`。 - `imageemojis.use` _(**true** 默认)_ — 允许使用表情符号以及 `/emojis` 命令。 - `imageemojis.update` _(**true** 默认)_ — 允许使用 `/emojis update`。 - `imageemojis.list` _(**true** 默认)_ — 允许使用 `/emojis list`。 ### 🌠 主要特点 - **自动资源包生成** — 插件启动或重新加载时，会生成资源包。 你需要做的唯一事情是将你的服务器 IP 地址提供在配置中，并打开主机机器上的 TCP 端口 _(**5000** 默认)_。 - **聊天建议** - 当玩家在聊天中输入消息时，表情符号建议。 你可以选择四种建议模式： - `NONE` - 禁用聊天建议。 - `TEMPLATES` _(默认设置)_ - 在输入时建议表情符号模板（例如，**\:clueless:**）。 - `ACTUAL` - 在输入时建议实际的表情符号（它们的 UTF-8 符号）。 (例如，)。 - `BOTH` - 结合“TEMPLATES”和“ACTUAL”模式。 - 能够 **合并** 表情符号与你的 **服务器资源包**：你可以将 `mergeWithServerResourcePack` 字段设置为 `true` 在 `config.yml` 中，并将你的资源包放入 `../ImageEmojis/` 目录中，文件名为 `serverResourcePack.zip` _(文件名也可以配置)_。 - **告示牌替换** — 你可以启用/禁用在告示牌上替换表情符号模板。 - **铁砧替换** — 你可以启用/禁用在铁砧中重命名物品时替换表情符号模板。 - **命令替换** — 你可以启用/禁用在发送命令时替换表情符号模板。 默认情况下，插件会自动预处理玩家发送的所有命令，并将表情符号模板更改为实际的表情符号。 - **Discord 集成** - 如果你安装并设置了 **[DiscordSRV](https://modrinth.com/plugin/discordsrv)** 插件，表情符号模板将被翻译成适当的 UTF-8 表情符号，并且 UTF-8 符号将被预处理为在 Discord 上正确显示为表情符号。 这将适用于游戏和 Discord 服务器上名称相同的表情符号。 ### 📄 默认配置 **[警告]** **不要忘记** 将你的 **公共 IP** 放入 `serverIp` 字段。
你还应该 **打开你的机器上的 TCP 端口**，以便插件能够工作。 *端口 **5000** 默认*。
**否则，一切都不会工作。** ```yaml # 你的服务器公共 IP 地址在这里。 serverIp: "127.0.0.1" # 资源包将托管在该端口上。 插件启动时，将在该端口上启动 HTTP 服务器。 # 它应该在机器上打开，以便玩家可以下载资源包。 webServerPort: 5000 # 资源包执行策略： # NONE - 在加入时，资源包不会加载。 此选项适用于玩家更喜欢手动下载资源包的服务器。 # OPTIONAL - 玩家可以选择是否在加入时加载资源包。 # REQUIRED - 强制玩家使用资源包进行游戏。 enforcementPolicy: "OPTIONAL" # 是否在铁砧中替换表情符号？ (例如，在重命名物品时) replaceInAnvils: true # 是否在告示牌中替换表情符号？ (例如，在编辑它们之后) replaceOnSigns: true # 是否在发送命令时替换表情符号？ (例如，在 "/msg" 或 "/say" 命令中) replaceInCommands: true # 当玩家没有 "imageemojis.use" 权限时会发生什么： # ERASE_EMOJIS - 从负载中擦除所有表情符号并继续。 # CANCEL_EVENT - 完全取消事件（例如，阻止发送消息）。 noPermAction: inChat: "ERASE_EMOJIS" inAnvils: "ERASE_EMOJIS" onSigns: "ERASE_EMOJIS" inCommands: "ERASE_EMOJIS" # 是否向玩家显示“没有足够的权限”消息。 # 只有当选择了 "CANCEL_EVENT" 操作时才会显示。 noPermMessage: false # 是否在将光标悬停在聊天中的表情符号符号上时显示表情符号名称。 # 如果你使用 Spigot 原生聊天格式化程序，例如 "VaultChatFormatter" 或 "LPC"，则此功能可能无法正常工作，因为它们与 Paper 组件不兼容。 # 如果你正在寻找一个不会破坏消息的简单聊天格式化程序，你可能需要考虑使用我开发的： https://github.com/MrQuackDuck/PlainChatFormatter emojiHoverEnabled: true emojiHoverColor: "#AAAAAA" # 聊天建议模式（在输入聊天消息并按下键盘上的 Tab 键时）： # NONE - 没有建议。 # TEMPLATES - 建议模板（例如：":sob:"）。 # ACTUAL - 建议实际表情符号（例如：“😭”）。 # BOTH - 结合“TEMPLATES”和“ACTUAL”模式。 suggestionMode: "TEMPLATES" # 表情符号模板格式（例如，你可能需要替换冒号或完全删除它们）。 templateFormat: "::" # 插件是否应该将 "emojis.zip" 资源包与服务器资源包合并？ # 如果 "true"，你应该将你的资源包放在 "/plugins/ImageEmojis/" 目录中。 # 输出将生成在 "emojis.zip" 档案中。 mergeWithServerResourcePack: false # 合并 "emojis.zip" 文件的服务器资源包名称。 mergeServerResourcePackName: "serverResourcePack.zip" # 当你使用 ~500 个表情符号时，你可能会看到一些表情符号重叠（因为哈希函数受到限制在一定的范围内）。 # 如果你计划在你的服务器上使用大量的表情符号，你可以将此值设置为 "true"。 # 重要提示：更改此值将重置所有现有的表情符号代码。 这意味着： # - 之前在告示牌和物品名称上写过的表情符号会显示为无效符号； # - 范围将从 2000 增加到 6400 个可用的表情符号 Unicode 符号。 extendedUnicodeRange: false messages: "resource-pack-description": "&nImage Emojis" "only-players": "&c只有玩家可以使用此命令！" "info-content": "&#F4CA16[ImageEmojis] &#B3BEC4当前有 &#D8E5EC&n%s&r&#B3BEC4 个表情符号！ \n &#D8E5EC&n/emojis list&r&#B3BEC4 - 查看表情符号列表。 \n &#D8E5EC&n/emojis update&r&#B3BEC4 - 如果更新了表情符号，则在当前游戏会话期间获取资源包的最新版本。 "resource-pack-up-to-date": "&#F4CA16[ImageEmojis] &#B3BEC4资源包已更新！" "reloaded": "&#F4CA16[ImageEmojis] &#B3BEC4已重新加载！" "not-enough-permissions": "&#F4CA16[ImageEmojis] &#B3BEC4没有足够的权限。" "command-not-found": "&#F4CA16[ImageEmojis] &c抱歉！该命令不存在，或者你没有足够的权限。" "command-disabled": "&#F4CA16[ImageEmojis] &#B3BEC4该命令在此服务器上已禁用。" "an-error-occurred": "&#F4CA16[ImageEmojis] &c重新加载时发生错误！请查看控制台日志以获取详细信息。" ``` ### 🚀 安装指南 **[重要]** 开始之前，请确保插件的版本与你的服务器版本 **兼容**。 1. 从 发布 选项卡下载插件的最新版本。 1. 将下载的 `.jar` 文件放入你的服务器的 `./plugins` 文件夹中。 2. 重新启动你的服务器或输入 `reload` 命令。 3. 转到 `./plugins/ImageEmojis` 目录并打开 `config.yml`。 4. 确保将你的服务器的公共 IP 地址放入 `serverIp` 字段中。 5. 打开主机上的 TCP 端口 _(**5000** 默认)_，与 `config.yml` 中 `webServerPort` 字段相同。 6. 运行 `/emojis reload` 命令。 **[注意]** 如果你之前启用了它，请在 `server.properties` 中禁用你的资源包。 **恭喜！** 现在你已经准备好使用该插件了。 将你的表情符号放入 `../ImageEmojis/emojis/` 目录中，重新加载插件，并在你的客户端上输入 `/emojis update` 命令 _(或者只是重新加入游戏)_！