uxmEssentials Redis

插件

· 作者 siracozmen

uxmEssentials 跨服总线的 Redis 传输层,通过 Redis 发布/订阅机制在您的网络中同步家园、传送点、经济系统、金库等数据,无需代理。需要安装 uxmEssentials 插件。

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

最新 0.10.1 · 26.2 · Folia / Paper

一键开服(送7天)

uxmEssentials Redis 附加组件

uxmEssentials 跨服总线的 Redis 传输层,通过 Redis pub/sub 保持家园、传送点、经济、金库、交易、隐身等功能在服务器网络间同步,无需代理。

阅读文档 在 GitHub 上查看我们

适用于 Paper 适用于 Purpur

在 Hangar 上获取 基于 Java 25 构建

Paper 26.2  ·  Java 25  ·  支持 Folia  ·  uxmEssentials 配套插件  ·  开源 (GPL-3.0)

功能说明

uxmEssentials 通过一个轻量级的“变更通知”总线而非在网络中传输完整数据包来保持跨服状态一致。此附加组件是该总线的 Redis 传输层:将其指向 Redis 服务器后,共享同一数据库和同一个 Redis 实例的一组后端节点将直接同步,中间无需 Velocity 代理。

当玩家设置家园、存入金钱、编辑金库或跨服交易时,发起方会通过 Redis pub/sub 发布简短通知;其他所有后端节点会丢弃该行数据的缓存副本,并从共享数据库中重新读取权威值。数据库始终保持为唯一真实数据源,且变更不会以完整对象的形式传输。

同步内容

家园、传送点、玩家自定义传送点、经济、金库、交易、隐身、管理、全息图、NPC、投票派对以及消息忽略列表——这些是 uxmEssentials 在所有共享同一数据库的节点间复制的所有上下文内容。

安装步骤

  1. 将 uxmEssentials-redis-0.8.0.jar 放入每个后端节点的 plugins/ 文件夹中,与主 uxmEssentials jar 文件并列放置。

  2. 在 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"
      }
    }
    
  3. 启动后端节点。所有共享数据库和 Redis 通道的节点会自动加入总线;若无法连接 Redis、代理或对等节点,则会自动优雅地回退到仅本地模式,因此单机行为始终不受影响。

依赖要求

  • Redis: 任何可访问的 Redis 服务器(单个实例即可)。
  • 后端节点: 运行 uxmEssentials 0.8.0 的 Paper 26.2,且全部共享同一数据库。对于实际的网络环境,请使用 MySQL / MariaDB / PostgreSQL;SQLite 仅支持单写入者。
  • 主插件必需: 此附加组件无法独立运行;它是 uxmEssentials 的传输模块。

备注

本插件开源 (GPL-3.0)。当你希望在无 Velocity 代理的情况下实现跨服同步时使用此插件。如果你已经运行了 Velocity,可使用 Velocity 附加组件,它通过插件消息通道承载相同的总线功能。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源