派对专家 - RPG等级集成

派对专家 - RPG等级集成

完整的派对系统,包含HUD、指南针追踪、信标标记、传送功能,以及多人服务器中的持久性团队。

生活质量

ClaimPro - 发布公告!https://www.curseforge.com/hytale/mods/claimpro

ko-fi(支持我们的链接)

💬 支持与反馈

文档:https://pro-hytale-mods.gitbook.io/pro-hytale-mods-docs/getting-started/quickstart

PartyPro

在 Hytale 中组队。PartyPro 添加了一套完整的队伍系统,包含实时 HUD、地图追踪、标记系统、队伍聊天、经验共享、统计数据和排行榜。

可独立运行 —— 无需任何依赖。 与 RPGLeveling、MMOSkillTree 和 SimpleClaims 的可选集成将在安装后自动激活。

📖 完整文档:https://pro-hytale-mods.gitbook.io/pro-hytale-mods-docs/getting-started/quickstart


⚔️ 队伍系统

  • 创建并管理最多 16 位玩家 的队伍
  • 公开队伍(任何人都可加入)或 密码保护 的私人队伍
  • 邀请系统,支持 自动接受自动拒绝 模式
  • 领导权转让、踢出成员、队伍重命名
  • 队伍在 服务器重启后仍然保持
  • 可配置离线超时,自动移除不活跃的玩家

🖥️ 实时队伍 HUD

  • 每位成员的生命值和能量条
  • 网络延迟(颜色编码:🟢 绿色 / 🟡 黄色 / 🔴 红色)
  • 与每位成员的距离或精确坐标
  • 在线/离线指示器和队长图标
  • 普通紧凑 两种显示模式
  • 每位玩家可自定义位置(左/右、X/Y 偏移)
  • 自定义文本槽位,用于显示等级、职业或头衔

🗺️ 地图追踪

  • 队伍成员在世界地图上以 彩色图标 显示
  • 每个标记上显示距离标签
  • 三种路径点模式:所有玩家、仅队伍或隐藏
  • 16 种独特的成员颜色

📍 标记系统

  • 鼠标中键 点击任意方块即可向队伍发出标记
  • 世界中可见的彩色信标粒子效果(持续 30 秒)
  • 在世界地图上显示标记
  • 每位成员拥有独特颜色,可配置冷却时间

💬 队伍聊天

  • 通过 /p chat 切换 —— 消息仅发送给队伍成员
  • 带有 [Party] 前缀格式
  • 可在队伍浏览器 GUI 中查看聊天历史

📋 队伍浏览器 GUI

使用 /p 打开 —— 一个完整的交互菜单:

  • 我的队伍 —— 成员、设置、踢出/转让/解散
  • 队伍 —— 浏览和搜索公开队伍,使用密码加入
  • 邀请 —— 接受或拒绝待处理的邀请
  • 玩家 —— 查看在线玩家并邀请他们
  • 聊天 —— 带有消息历史的队伍聊天
  • 统计 —— 每位成员及汇总统计数据
  • 排行榜 —— 比较服务器上所有队伍的排行榜
  • 设置 —— HUD、路径点、邀请模式
  • 集成 —— RPGLeveling、MMOSkillTree、SimpleClaims

📊 统计数据和排行榜

每位玩家和每个队伍都会追踪:

  • 怪物击杀数、玩家击杀数、死亡数
  • 造成和承受的伤害
  • 放置和破坏的方块数
  • 收集和制作的物品数
  • 行走距离、发送的标记数、使用的传送次数
  • 共处时间

排行榜 按击杀数、伤害、方块数、距离或时间对所有队伍进行排名。前三名分别用 🥇 金色、🥈 银色、🥉 铜色高亮显示。可配置自动重置(每日或每月)。

🛡️ PvP 保护

队伍成员之间的误伤 默认被阻止。队长可以开启或关闭 PvP。

🧑‍🤝‍🧑 玩家头像

队伍浏览器会在名字旁边显示玩家的头像。皮肤从可配置的 API 获取并本地缓存。


命令与权限

所有命令使用 /p(别名:/party)。

队伍命令 —— 权限组:冒险家

  • /p —— 打开队伍浏览器 (tsumori.partypro.command.p)
  • /p create <名字> —— 创建一个队伍 (tsumori.partypro.command.p.create)
  • /p invite <玩家> —— 邀请一位玩家 (tsumori.partypro.command.p.invite)
  • /p accept —— 接受一个邀请 (tsumori.partypro.command.p.accept)
  • /p decline —— 拒绝一个邀请 (tsumori.partypro.command.p.decline)
  • /p leave —— 离开你的队伍 (tsumori.partypro.command.p.leave)
  • /p kick <玩家> —— 踢出成员,仅限队长 (tsumori.partypro.command.p.kick)
  • /p transfer <玩家> —— 转让领导权 (tsumori.partypro.command.p.transfer)
  • /p disband —— 解散队伍,仅限队长 (tsumori.partypro.command.p.disband)
  • /p rename <新名字> —— 重命名队伍,仅限队长 (tsumori.partypro.command.p.rename)
  • /p tp <玩家> —— 传送至一位成员 (tsumori.partypro.command.p.tp)
  • /p chat —— 切换队伍聊天 (tsumori.partypro.command.p.chat)
  • /p info —— 显示队伍信息 (tsumori.partypro.command.p.info)
  • /p invites —— 显示待处理的邀请 (tsumori.partypro.command.p.invites)
  • /p browse —— 浏览队伍/玩家 (tsumori.partypro.command.p.browse)

实用命令

  • /ping —— 标记你正在看的方块 (tsumori.partypro.command.ping)

管理员命令 —— 权限组:创造模式(管理员)

  • /p debug —— 调试工具 (tsumori.partypro.command.p.debug)

通配符tsumori.partypro.command.* 授予所有命令,tsumori.partypro.command.p.* 授予所有 /p 子命令。

别名/p join = accept · /p deny = decline · /p remove = kick · /p promote = transfer · /p teleport / /p goto = tp · /p status / /p list / /p members = info · /p browser / /p find / /p players = browse · /p pending = invites


🔗 集成

RPGLeveling

  • 玩家等级显示在队伍 HUD 中
  • 队伍成员之间的 经验共享(平分或加成模式)
  • 根据队伍规模的大小倍率和距离限制
  • 配置文件:RPGLeveling_x_PartyPro.json

MMOSkillTree

  • 所选技能等级显示在 HUD 中
  • 技能经验共享(同技能或所有技能模式)
  • 根据队伍规模的倍率
  • 配置文件:MMOSkillTree_x_PartyPro.json

SimpleClaims

  • 队伍成员 自动添加为领地盟友
  • 离开队伍时自动移除
  • 可在“集成”标签页中配置

🌍 语言

包含 7 种语言:英语 · 德语 · 西班牙语 · 葡萄牙语(巴西) · 匈牙利语 · 法语 · 俄语

config.json 中设置 "language": "DE"。所有位于 PartyPro/language/ 的语言文件均可完全编辑。更新时会自动合并新的翻译键,你的自定义内容会被保留。


⚙️ 每位玩家的设置

每位玩家均可通过队伍浏览器中的“设置”标签页控制自己的体验:

  • HUD 开/关、左侧/右侧、普通/紧凑模式
  • HUD 位置的自定义 X/Y 偏移
  • 仅显示在线成员
  • 显示坐标而非距离
  • 鼠标中键标记开/关
  • 地图路径点模式(全部/仅队伍/无)
  • 邀请模式(普通/自动接受/自动拒绝)

所有设置在会话间保持。


📦 安装

  1. partypro-x.x.x.jar 放入服务器的 Mods 文件夹
  2. 启动服务器
  3. 完成

配置文件在首次运行时自动创建。无需任何依赖。


🔧 面向开发者

PartyPro 为其他模组提供 公共 API

if (PartyProAPI.isAvailable()) {
    PartyProAPI api = PartyProAPI.getInstance();
    
    boolean together = api.areInSameParty(player1, player2);
    api.setPlayerCustomText1(playerId, "Lv.42");
    
    api.registerListener(new PartyEventListener() {
        @Override
        public void onMemberJoin(PartyMemberJoinEvent event) {
            // 响应队伍变化
        }
    });
}

查询队伍数据、在 HUD 中显示自定义文本,并监听 6 种事件类型(创建、解散、加入、离开、队长变更、设置变更)。