uxmEssentials Redis 附加组件
uxmEssentials 跨服总线的 Redis 传输层,通过 Redis pub/sub 保持家园、传送点、经济、金库、交易、隐身等功能在服务器网络间同步,无需代理。
Paper 26.2 · Java 25 · 支持 Folia · uxmEssentials 配套插件 · 开源 (GPL-3.0)
功能说明
uxmEssentials 通过一个轻量级的“变更通知”总线而非在网络中传输完整数据包来保持跨服状态一致。此附加组件是该总线的 Redis 传输层:将其指向 Redis 服务器后,共享同一数据库和同一个 Redis 实例的一组后端节点将直接同步,中间无需 Velocity 代理。
当玩家设置家园、存入金钱、编辑金库或跨服交易时,发起方会通过 Redis pub/sub 发布简短通知;其他所有后端节点会丢弃该行数据的缓存副本,并从共享数据库中重新读取权威值。数据库始终保持为唯一真实数据源,且变更不会以完整对象的形式传输。
同步内容
家园、传送点、玩家自定义传送点、经济、金库、交易、隐身、管理、全息图、NPC、投票派对以及消息忽略列表——这些是 uxmEssentials 在所有共享同一数据库的节点间复制的所有上下文内容。
安装步骤
-
将
uxmEssentials-redis-0.8.0.jar放入每个后端节点的plugins/文件夹中,与主 uxmEssentials jar 文件并列放置。 -
在
plugins/uxmEssentials/config.conf中将 uxmEssentials 指向你的 Redis 服务器并选择传输方式:network { enabled = true server-id = "survival-1" # 每个后端节点必须唯一 transport = "redis" # velocity | redis | both redis { host = "127.0.0.1" port = 6379 password = "" db = 0 channel = "uxmessentials:bus" } } -
启动后端节点。所有共享数据库和 Redis 通道的节点会自动加入总线;若无法连接 Redis、代理或对等节点,则会自动优雅地回退到仅本地模式,因此单机行为始终不受影响。
依赖要求
- Redis: 任何可访问的 Redis 服务器(单个实例即可)。
- 后端节点: 运行 uxmEssentials 0.8.0 的 Paper 26.2,且全部共享同一数据库。对于实际的网络环境,请使用 MySQL / MariaDB / PostgreSQL;SQLite 仅支持单写入者。
- 主插件必需: 此附加组件无法独立运行;它是 uxmEssentials 的传输模块。
备注
本插件开源 (GPL-3.0)。当你希望在无 Velocity 代理的情况下实现跨服同步时使用此插件。如果你已经运行了 Velocity,可使用 Velocity 附加组件,它通过插件消息通道承载相同的总线功能。
uxmEssentials Redis add-on
The Redis transport for uxmEssentials' cross-server bus keep homes, warps, economy, vaults, trade, vanish, and more in sync across a network over Redis pub/sub, with no proxy required.
Paper 26.2 · Java 25 · Folia-ready · Companion to uxmEssentials · Open source (GPL-3.0)
What it does
uxmEssentials keeps cross-server state consistent over a small "this changed" bus rather than shipping full payloads around the network. This add-on is the Redis transport for that bus: point it at a Redis server and a plain set of backends sharing one database and one Redis instance sync directly, with no Velocity proxy in the middle.
When a player sets a home, deposits money, edits a vault, or trades across servers, the origin publishes a short notice over Redis pub/sub; every other backend drops its cached copy of that row and re-reads the authoritative value from the shared database. The database stays the single source of truth, and a change never travels as a full object.
What stays in sync
Homes, warps, player-warps, economy, vaults, trade, vanish, moderation, holograms, NPCs, the vote party, and the messaging ignore list every context uxmEssentials replicates across nodes that share one database.
Setup
-
Drop
uxmEssentials-redis-0.8.0.jarinto each backend'splugins/folder, alongside the main uxmEssentials jar. -
Point uxmEssentials at your Redis server and pick the transport in
plugins/uxmEssentials/config.conf:network { enabled = true server-id = "survival-1" # unique per backend transport = "redis" # velocity | redis | both redis { host = "127.0.0.1" port = 6379 password = "" db = 0 channel = "uxmessentials:bus" } } -
Start the backends. Every node that shares the database and the Redis channel joins the bus automatically; with no Redis, proxy, or peer reachable it falls back cleanly to local-only, so single-server behaviour never changes.
Requirements
- Redis: any reachable Redis server (a single instance is enough).
- Backends: Paper 26.2 running uxmEssentials 0.8.0, all sharing one database. For a real network use MySQL / MariaDB / PostgreSQL SQLite is single-writer.
- Main jar required this add-on does nothing on its own; it is the transport for uxmEssentials.
Notes
Open source (GPL-3.0). Use this when you want cross-server sync without a Velocity proxy. If you already run Velocity, the Velocity add-on carries the same bus over plugin messaging instead.
下载 uxmEssentials Redis
下载 uxmEssentials Redis
下载 uxmEssentials Redis
下载 uxmEssentials Redis
下载 uxmEssentials Redis
下载 uxmEssentials Redis
下载 uxmEssentials Redis
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 uxmEssentials Redis
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 uxmEssentials Redis
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 uxmEssentials Redis
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
从 0.10.0 升级
替换 jar 文件并重启即可。无需手动编辑任何内容。
- 您的数据保留在原位。 数据库中的表保持其当前名称,已应用的迁移会被识别且不会重复执行。
- 您的文件得以保留。 您修改过的设置或消息行不会被改动。新的设置和新的消息行会添加到您的文件中。从未修改过的消息行会更新为新的措辞。
- 存储块拥有新名称
type和pool-size,与该插件系列的其他部分共享。仍然写入backend和read-pool-size的文件将继续按原样工作。 - 一个未指定数据库的存储配置项会阻止新安装,从而防止网络服务器悄悄地在独立的文件上启动。已在该配置项下基于 SQLite 文件运行的服务器将继续正常运行,并在控制台中输出相关信息。
- 没有命令、权限节点或公共 API 被移除或重命名。
修复
/lay、/bellyflop和/spin可能导致玩家永久隐身:在旁观者模式下开始姿势、饮用隐形药水后,以及在姿势进行中重载或重启时发生此问题。现在,每次退出姿势以及崩溃后下次加入时,都会恢复身体模型。/poses reveal <player>(权限uxmessentials.poses.reveal,默认对管理员和控制台可用)可让旧版本遗留的隐身状态恢复身体模型。- 仅当账号确实拥有该名称时,才会将玩家名称填入管理员命令、点击动作、套装动作、投票奖励、NPC 命令和占位符货币中。关闭 Paper 名称检查的服务器可能允许包含空格或括号的名称进入,这会导致向命令添加参数或更改消息。此类行现在会被跳过,并在控制台中提示。
- 聊天消息保留其他插件为其设置的颜色。
- 当没有任何内容锁定世界时,世界的昼夜和天气周期保持不变。
- 即使 Floodgate 在此插件之后启用,也能被正确检测到。
新增
storage.table-prefix用于新安装;storage.local-only用于网络中保留自身行的单一服务器;storage.copy-from-file用于首次启动时将 SQLite 文件移动到网络数据库中。- 全息图使用数据包为每位观看者单独绘制,使用其各自的语言,并在执行
/uxmess reload时重新绘制。默认情况下,点击距离全息图可达 12 格。 - 名字标签、标签页名称和聊天前缀为每位读者单独绘制,关系占位符和等级以目录行的形式显示在读者的语言中。
- NPC 在其观看者走开时会转回放置时的朝向。
%uxmessentials_player_language%,即玩家阅读所使用的语言。- 以
<center>开头的聊天行会居中显示,公告可以设置centered = true。 /uxmess reload会重新读取自定义菜单。- 管理员命令会以管理员自身的语言进行回复。
性能优化
- 计分板和标签页将其工作分散到刷新间隔内,并且每行只解析一次。
- NPC 为每位观看者发送单个数据包,且仅在朝向发生变化时发送。
- PlaceholderAPI 仅在被询问包含占位符的文段时才进行查询。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧