SimpleProxyChat

模组

· 作者 beanbeanjuice

[Bungee Chat Sync + Velocity Chat Sync] 一款简单的插件,支持跨服务器的全局通信与消息传递,兼容 PlaceholderAPI、LuckPerms、LiteBans、AdvancedBan、NetworkManager 和 Discord。

0 本站下载 0 关注 更新于 3 周前

最新 1.0.4 · 26.3 · NeoForge

一键开服(送7天)

SimpleProxyChat Logo

这是一个 Bungeecord 聊天同步、Velocity 聊天同步以及代理聊天同步插件。它是一个简单的插件,用于实现全局跨服务器的通信和消息传递,并支持 PlaceholderAPI、LuckPerms、LiteBans、AdvancedBan、NetworkManager 以及 Discord。

支持的 Minecraft 版本

平台 支持的版本
Velocity (代理) 取决于你的 Velocity 安装版本;如需兼容旧版本请搭配 ViaVersion
BungeeCord/Waterfall (代理) 取决于你的代理端安装版本;如需兼容旧版本请搭配 ViaVersion
Spigot/Paper/Bukkit (辅助插件) 1.21.11 – 26.3
Fabric (辅助模组) 26.1+
NeoForge (辅助模组) 26.1.2+

installation

独立部署(仅代理端,无需辅助插件)

这是最简单的设置方式,对于标准的 BungeeCord/Velocity 网络中的跨服务器聊天,你只需要这样做。

  1. 将插件 jar 文件放入 BungeeCord/Waterfall/Velocity 代理端的 plugins 文件夹中。
  2. 重启代理端。它应该开箱即用!

在独立模式下,代理端会在消息传输过程中拦截聊天内容。如果你希望聊天消息仅在后端插件(例如每个服务器上的 LiteBans)处理完毕后再进行转发,或者你需要 PlaceholderAPI 支持,亦或是需要针对 Fabric/NeoForge 服务器的后端特定钩子,请安装下方的辅助插件。

搭配辅助插件使用

辅助插件可在此下载 here。

辅助插件运行在每个后端服务器上,并在后端插件处理完消息后通过 TCP 将聊天内容转发给代理端。这也是启用 PlaceholderAPI 支持的关键(仅限 Spigot/Paper/Bukkit)。

代理端设置(在安装任何辅助插件之前必须完成):

  1. 按照上述独立部署部分的方法,在 BungeeCord/Waterfall/Velocity 上安装代理端插件(确保存在 ProxyChat/config.yml 文件)。
  2. 编辑 ProxyChat/config.yml 并设置:
    • use-websocket: true
    • websocket-port (默认 8766) - 任意空闲 TCP 端口;此值必须在每个辅助插件中保持一致。
    • websocket-secret (默认 "changeme") - 将其更改为强密码;此值必须在每个辅助插件中保持一致。
  3. 重启代理端(或执行 /spc-reload)。

然后,在每个后端服务器上安装匹配的辅助构建版。配置键在所有三个平台上都是相同的;只有文件位置和默认密钥略有不同。

Spigot/Paper/Bukkit

  1. 下载辅助插件。它与 Velocity/Bungeecord 的主插件相同。
  2. 将其放入服务器的 plugins 文件夹中,并启动服务器一次以生成 plugins/SimpleProxyChatHelper/config.yml。
  3. 编辑生成的配置文件以指向你的代理端:
    proxy-host: "localhost"       # 代理端运行的主机地址
    proxy-port: 8766              # 必须与代理端配置中的 websocket-port 匹配
    proxy-secret: "changeme"      # 必须与代理端配置中的 websocket-secret 匹配
    server-name: "survival"       # 必须与 velocity.toml / BungeeCord 的 config.yml 中该服务器的名称匹配
    
  4. (可选)在服务器上安装 PlaceholderAPI 以便在 Minecraft 聊天消息中进行占位符解析。
  5. 重启服务器。

Fabric

  1. 获取与你服务器版本匹配的 Fabric 辅助模组。
  2. 将模组 jar 文件放入服务器的 mods 文件夹中,并启动服务器一次以生成 config/simpleproxychathelper.yml。
  3. 使用与上述 Spigot 示例相同的键编辑生成的文件(proxy-host、proxy-port、proxy-secret、server-name)。
  4. 重启服务器。

NeoForge

  1. 获取与你服务器版本匹配的 NeoForge 辅助模组。
  2. 将模组 jar 文件放入服务器的 mods 文件夹中,并启动服务器一次以生成 config/simpleproxychathelper.yml。
  3. 使用与上述 Spigot 示例相同的键编辑生成的文件(proxy-host、proxy-port、proxy-secret、server-name)。
  4. 重启服务器。

要实现 PlaceholderAPI 支持,必须安装辅助插件,且占位符只能在 Minecraft 聊天消息中使用。它们目前无法用于加入/离开消息。PlaceholderAPI 仅在 Spigot/Paper/Bukkit 辅助插件上可用(Fabric/NeoForge 没有等效功能)。

使用 Discord

  1. 前往 discord.com/developers 并选择 New Application(新建应用)。你可以选择 任何 你喜欢的名称。
  2. 进入 OAuth2 部分。
  3. 进入 OAuth2 URL Generator(OAuth2 URL 生成器)并添加 bot 作用域。
  4. 在 bot permissions(机器人权限)下选择:
    • Manage Channels(管理频道,必需:常规权限)
    • Send Messages(发送消息,必需:文本权限)
    • Manage Messages(管理消息,必需:文本权限)
    • Read Message History(读取消息历史,必需:文本权限)
    • + 其他你想添加的权限...
  5. 复制底部的 Generated URL(生成的 URL)。
  6. 将生成的 URL 粘贴到网页浏览器中。
  7. 邀请机器人加入你的服务器。
  8. 返回 discord.com/developers。
  9. 选择你的机器人。
  10. 点击 bot。
  11. 点击 Reset Token(重置令牌)并将令牌复制到安全的地方。
  12. 向下滚动到 Privileged Gateway Intents(特权网关意图)。
  13. 选择 SERVER MEMBER INTENT(服务器成员意图)和 MESSAGE CONTENT INTENT(消息内容意图)。
  14. 将插件放入 BungeeCord/Velocity 的 plugins 文件夹中。
  15. 完全 启动一次你的服务器,然后停止它。会 出现错误,这是正常的。
  16. 在生成的 ProxyChat/config.yml 文件中,粘贴你的 Bot Token(机器人令牌)并选择你要接收消息的目标频道。
  17. 重启你的代理!

功能

  • 全局网络聊天
  • LuckPerms 支持
  • LiteBans 支持
  • AdvancedBan 支持
  • NetworkManager 支持
  • Discord 支持
  • Velocity/Waterfall/BungeeCord 支持
  • 彩色聊天
  • 跨服务器通信
  • PlaceholderAPI 支持
  • ...以及更多!

配置

config.yml

# ==========================================================
#                       信息
#                 支持 HEX 颜色值
#  示例: <#FFFFFF>Some text</#FFFFFF> this is a message!
#         支持 Mini-Message/Legacy 颜色代码
# ==========================================================

# 如果你将使用 Discord,请设为 true。此设置下重载命令无效。
use-discord: false

# Discord 机器人令牌(如果 use_discord = false 则忽略)。
BOT-TOKEN: "TOKEN_HERE"

# 发送 Discord 消息的目标频道 ID(如果 use_discord = false 则忽略)。
CHANNEL-ID: "GLOBAL_CHANNEL_ID"

bot-activity:
   # 有效类型: ONLINE, DO_NOT_DISTURB, IDLE, INVISIBLE
   status: ONLINE
   # 有效类型: PLAYING, STREAMING, LISTENING, WATCHING, COMPETING, CUSTOM_STATUS
   type: "CUSTOM_STATUS"
   # 有效的占位符为 %online% 和/或 %max-players%(每 5 分钟更新一次)
   text: "%online%/%max-players% - SimpleProxyChat by beanbeanjuice"

# 检查服务器在线/离线状态的间隔秒数。
# 数值过小可能导致错误。请注意。
server-update-interval: 3

# 如果你想更改默认别名,请使用此项。
# 它必须与你在 bungee/velocity 配置中的名称相同。
# 只需将其设置为 disabled: disabled 即可禁用。
aliases:
   ServerInConfigExample: ServerAliasExample
   hub: Hub1
   smp: smp1

# 是否使用权限系统。
# 某些权限(标记为 ➕)即使此项为 false 也始终生效。
# simpleproxychat.read.chat - 读取聊天消息。
# simpleproxychat.read.join - 读取加入消息。
# simpleproxychat.read.leave - 读取离开消息。
# simpleproxychat.read.fake - 读取假加入/离开消息。玩家还必须拥有真实的加入/离开权限。
# simpleproxychat.read.switch - 读取切换服务器消息。
# simpleproxychat.read.update - 读取更新消息。 ➕
# simpleproxychat.toggle.chat - 为单个服务器切换代理聊天。 ➕
# simpleproxychat.toggle.chat.all - 为所有服务器切换代理聊天。 ➕
# simpleproxychat.reload - 重载配置。 ➕
# simpleproxychat.ban - 从代理封禁玩家。 ➕
# simpleproxychat.unban - 从代理解封玩家。 ➕
# simpleproxychat.whisper - 向代理上的另一名玩家私语。 ➕
# simpleproxychat.broadcast - 向服务器上的所有人广播消息。 ➕
use-permissions: false

# 只有以该字符开头的消息才会通过插件发送。
# 设置为 '' 以禁用。
# 示例:如果设置为 '$',那么当玩家发送 $hello 时,它将通过代理发送。
proxy-message-prefix: ''

# 是否在代理启动时发送连接到代理的服务器的状态。
# 这仅用于 Discord 消息。
use-initial-server-status: true

# 是否在隐身/显形时发送假的加入/离开消息。
use-fake-messages: true

# 格式: https://docs.oracle.com/javase/8/docs/api/java/time/format/DateTimeFormatter.html
# 时区: https://www.joda.org/joda-time/timezones.html
timestamp:
   format: "hh:mm a"
   timezone: "America/Los_Angeles"

# 如果你将通过 TCP WebSocket 使用辅助插件,请设为 true。
# 启用后,代理将不会直接拦截 PlayerChatEvent。
# 相反,聊天将在后端处理之后由辅助插件转发
# (允许 LiteBans 等插件在消息到达代理之前取消消息)。
use-websocket: false
websocket-port: 8766
websocket-secret: "changeme"

update-notifications: true

# 强烈建议使用更强大的全代理封禁系统,如 LiteBans 或 AdvancedBan。
# 但是,如果你更喜欢轻量级、简单的封禁系统,可以在这里启用它。
# 使用此功能需要完全重启代理。
use-simple-proxy-chat-banning-system: false

# 当玩家切换服务器时,这将存储并重发最后几条聊天消息。
# 这是因为有时 Velocity/Bungee 在切换时不保留之前的消息。
# 如果你在重载之前更改了格式,它将保留旧的格式。
send-previous-messages-on-switch:
   enabled: false
   amount: 15

# 这些配置更改需要重启才能生效。
commands:
   reload-aliases:
      - "spcreload"
   chat-toggle-aliases:
      - "chattoggle"
   ban-aliases:
      - "spcban"
   unban-aliases:
      - "spcunban"
   whisper-aliases:
      - "spc-msg"
   reply-aliases:
      - "spc-r"
   broadcast-aliases:
      - "spc-bc"
      - "broadcast"

# 禁用服务器发送/接收代理消息。
disabled-servers:
   - example1

# 如果您不希望在全服接收切换消息,请将其禁用。
proxy-switch: true

# 请勿修改此部分
file-version: 18

messages.yml

# ==========================================================
#                       信息说明
#                 支持 HEX 颜色值
# 示例: <#FFFFFF>Some text</#FFFFFF> this is a message!
#         支持 Mini-Message / 传统颜色代码
# ==========================================================

# 插件前缀。可在任何位置使用 %plugin-prefix%。
plugin-prefix: "&8[<bold><rainbow>SimpleProxyChat&r&8]"

# Minecraft 相关设置
minecraft:
   join:
      enabled: true
      message: "&e%player% &ahas joined the network. (%server%)"
   leave:
      enabled: true
      message: "&e%player% &chas left the network. (%server%)"
   chat:
      enabled: true
      message: "&8[&3%server%&8] &e%player% &9» &7%message%"
      vanished: "&cYou cannot send proxy messages while vanished. Your message must end with a '&e/&c' to speak."
   switch:
      enabled: true
      default: "&e%player% &7moved from &c%from% &7to &a%to%&7."
      no-from: "&e%player% &7moved &7to &a%to%&7."
   whisper:
      send: "&8[&dyou&8] &f⇒ &8[&d%receiver%&8] &9» &e%message%"
      receive: "&8[&d%sender%&8] &f⇒ &8[&dyou&8] &9» &e%message%"
      error: "&c/spc-whisper (user) (message)"
   discord:
      enabled: true
      message: "**%server%** %player% » %message%"
      embed:
         use: false
         title: "[%server%] %player%"
         message: "%message%"
         color: "#FFC0CB"
         use-timestamp: true
   command:
      no-permission: "%plugin-prefix% &cSorry, you do not have permission to run this command."
      unknown: "%plugin-prefix% &cUnknown command."
      must-be-player: "%plugin-prefix% &cYou must be a player to run this command."
      reload: "%plugin-prefix% &aThe plugin has been successfully reloaded!"
      chat-lock:
         usage: "%plugin-prefix% &cCorrect usage is &a/spc-chat all lock/unlock &c or &a/spc-chat lock/unlock"
         single:
            locked: "%plugin-prefix% &6%server% &cwill no longer send proxy chat messages."
            unlocked: "%plugin-prefix% &6%server% &awill now send proxy chat messages."
         all:
            locked: "%plugin-prefix% &cAll servers will no longer send proxy chat messages."
            unlocked: "%plugin-prefix% &aAll servers will now send proxy chat messages."
      proxy-ban:
         usage: "%plugin-prefix% &c/(un)ban (player)"
         banned: "%plugin-prefix% &c%player% &7has been banned."
         unbanned: "%plugin-prefix% &c%player% &7has been unbanned."
         login-message: "&cYou have been banned from the proxy."
      broadcast:
         usage: "%plugin-prefix% &c/spc-broadcast (message)"
         message: "%plugin-prefix% &8[&a&lBROADCAST&r&8] &6%message%"

# Discord 相关设置
discord:
   join:
      enabled: true
      message: "%player% has joined the network. (%server%)"
      use-timestamp: true
      # 与 use-timestamp 不兼容。
      use-embed: true
   leave:
      enabled: true
      message: "%player% has left the network. (%server%)"
      use-timestamp: true
      # 与 use-timestamp 不兼容。
      use-embed: true
   switch:
      enabled: true
      message: "%player% has switched from %from% to %to%."
      use-timestamp: true
      # 与 use-timestamp 不兼容。
      use-embed: true
   chat:
      enabled: true
      minecraft-message: "&8[&bDiscord&8] %role% &f%user% &9» &7%message%"
   topic:
      online: "There are %online% players online."
      offline: "The proxy is offline."
   proxy-status:
      enabled: true
      messages:
         enabled: "✅ Proxy enabled!"
         disabled: "⛔ Proxy disabled."
         title: "Server Status"
         message: "Status: "
         online: "Online ✅"
         offline: "Offline ⛔"
         use-timestamp: true

# 控制台相关设置 - 使用 Minecraft 消息格式
console:
   chat: true
   join: true
   leave: true
   switch: true
   discord-chat: true
   server-status: true

# 用于发送更新通知的消息。
# 插件前缀会自动追加到此消息的开头。
update-message: "&7There is an update! You are on &c%old%. New version is &a%new%&7: &6%link%"

# 请勿修改此部分
file-version: 10

commands

  • /spc-reload - 重新加载配置文件。
  • /spc-chat - 锁定/解锁聊天。
  • /spc-whisper - 向某人发送私聊消息。
  • /spc-reply - 回复私聊消息,无需指定用户。
  • /spc-ban - 将玩家从代理中封禁。
  • /spc-unban - 将玩家从代理中解封。
  • /spc-broadcast - 向网络中的所有玩家广播一条消息。

permissions

  • simpleproxychat.read.chat - 读取聊天消息。
  • simpleproxychat.read.join - 读取加入消息。
  • simpleproxychat.read.leave - 读取离开消息。
  • simpleproxychat.read.fake - 读取虚假的加入/离开消息。必须同时拥有真实权限。
  • simpleproxychat.read.switch - 读取切换服务器消息。
  • simpleproxychat.read.update - 读取更新通知。
  • simpleproxychat.toggle.chat - 为单个服务器切换代理聊天。
  • simpleproxychat.toggle.chat.all - 为所有服务器切换代理聊天。
  • simpleproxychat.reload - 重新加载配置文件。
  • simpleproxychat.ban - 封禁某人。
  • simpleproxychat.unban - 解封某人。
  • simpleproxychat.whisper - 私聊权限。
  • simpleproxychat.broadcast - 向服务器上的所有人广播消息。

占位符

  • %plugin-prefix% - 插件指定的前缀。
  • %server% - 当前连接的服务器。如果指定了别名,则使用别名。
  • %original_server% - 与 %server% 相同,但不使用别名。
  • %to% - 当前连接的服务器。如果指定了别名,则使用别名。
  • %original_to% - 与 %to% 相同,但不使用别名。
  • %from% - 玩家刚刚断开连接的服务器。如果指定了别名,则使用别名。
  • %original_from% - 与 %from% 相同,但不使用别名。
  • %player% - 玩家的 Minecraft 用户名。
  • %escaped_player% - 转义后的玩家 Minecraft 用户名。(在 '_' 之前添加 '\' 以防止斜体。)
  • %sender% - 发送私聊的人。仅限私聊
  • %receiver% - 接收私聊的人。仅限私聊
  • %user% - 玩家的 Discord 用户名。
  • %nick% - 玩家的 Discord 昵称。
  • %role% - 玩家的 Discord 角色。
  • %prefix% - 玩家的前缀。仅限 LuckPerms
  • %suffix% - 玩家的后缀。仅限 LuckPerms
  • %message% - 玩家的消息。
  • %epoch% - 获取当前时间(以毫秒为单位)。可以使用如 此 中的格式。例如 <t:%epoch%>。仅限 Discord
  • %time% - 类似于 %epoch%,但使用 config.yml 中找到的特殊格式和时区。
  • %online% - 仅限 Discord 状态
  • %max-players% - 仅限 Discord 状态

注意事项

  1. 目前,隐身支持仅在 BungeeCord/Waterfall 上可用。插件仍将正常运行,但如果您进入隐身模式,它将不会发送虚假的加入/离开消息。
  2. 为了使前缀和后缀生效,您必须在代理端安装 LuckPerms。然后,您可以使用 %prefix% 和 %suffix%。
  3. %epoch% 和时间戳仅在 Discord 的某些地方有效。作为替代方案,您可以选择一些嵌入项启用 use-timestamp: true。这 unfortunately 不在我的控制范围内... ?

统计数据

Velocity 统计数据

BungeeCord/Waterfall 统计数据

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源