Gene_DungeonBridgeTeam

Gene_DungeonBridgeTeam 插件文档

发包文档

1

数据首包

首包: Gene_DungeonBridgeTeamView

界面文件名: dungeonBridgeViewScreen

2

副本展示数据

数据包1: dungeon_key

数据包2: 副本关键key

变量名: GeneDungeonBridgeTeamView_DungeonInfo

返回副本数据:

基础信息:

  • GeneDungeonBridgeTeamView_DungeonKey (副本名)
  • GeneDungeonBridgeTeamView_自定义数据key (配置中自定义)

排行榜数据:

  • GeneDungeonBridgeTeamView_0_RankTime (第1名通关时间)
  • GeneDungeonBridgeTeamView_0_RankPlayer (第1名玩家名)
  • GeneDungeonBridgeTeamView_1_RankTime (第2名通关时间)
  • GeneDungeonBridgeTeamView_1_RankPlayer (第2名玩家名)
  • GeneDungeonBridgeTeamView_2_RankTime (第3名通关时间)
  • GeneDungeonBridgeTeamView_2_RankPlayer (第3名玩家名)

个人数据:

  • GeneDungeonBridgeTeamView_UseTime (自己的通关时间)
  • GeneDungeonBridgeTeamView_MeUseTime (自己的通关时间，用于UI刷新)

副本CD信息:

  • GeneDungeonBridgeTeamView_CDRemainingTime (剩余CD时间，格式: "1小时30分钟" 或 "45分钟")
  • GeneDungeonBridgeTeamView_InCD (是否在CD中: "true" 或 "false")
  • GeneDungeonBridgeTeamView_CDPeriod (副本CD周期配置，单位: 分钟)

副本列表信息:

  • GeneDungeonBridgeTeamView_DungeonKeySize (副本总数)
  • GeneDungeonBridgeTeamView_DungeonKey_0 (第1个副本key)
  • GeneDungeonBridgeTeamView_DungeonKey_1 (第2个副本key)
  • ... (以此类推)

槽位变量名: GeneDungeonBridgeTeamView_Slot_索引

3

进副本

数据包1: enter

数据包2: 副本关键key

数据包3: 副本困难程度 (1,2,3) 数字分别对应简单 中等 困难

无返回数据,通过title提示队员是否满足进服数据

4

退出副本

数据包1: leave

无返回数据,直接结束当前副本

命令文档

主命令

  • /GeneDungeonBridgeTeam 或 /gdbt - 主命令，显示帮助信息
  • 权限: GeneDungeonBridgeTeam.command

子命令

reload

  • 用法: /gdbt reload
  • 功能: 重新加载插件配置和副本数据
  • 权限: 需要主命令权限

open

  • 用法: /gdbt open <dungeon_key>
  • 功能: 打开指定副本的UI界面
  • 参数:
    • dungeon_key: 副本关键key（支持Tab补全）
  • 权限: 需要主命令权限
  • 说明: 只有玩家可以使用，控制台无法使用

resetCD

  • 用法: /gdbt resetCD <player_name> <dungeon_key>
  • 功能: 重置指定玩家的指定副本CD
  • 参数:
    • player_name: 玩家名称
    • dungeon_key: 副本关键key（支持Tab补全）
  • 权限: 需要主命令权限

resetAllCD

  • 用法: /gdbt resetAllCD <player_name>
  • 功能: 重置指定玩家的所有副本CD
  • 参数:
    • player_name: 玩家名称
  • 权限: 需要主命令权限

viewCD

  • 用法: /gdbt viewCD <player_name>
  • 功能: 查看指定玩家的所有副本CD状态
  • 参数:
    • player_name: 玩家名称
  • 权限: 需要主命令权限
  • 输出格式: 显示每个副本的剩余CD时间

配置Kether变量

CareerLevel (生涯等级)

CombatPower (战斗力)

Max (最大人数限制)

Min (最小人数限制)

TeamNumber (队伍人数)

Kether脚本注意事项

切记返回要是字符串

如果判断全部成功则返回 true

判断失败返回 false

判断中出问题则返回 一句话用于提示全队

配置中副本难度

PEACEFUL(0),

EASY(1),

NORMAL(2),

HARD(3);

切记都是字符串

API接口文档

DungeonBridgeTeamApi

副本时间相关

  • setPlayerDungeonUseTime(playerName: String, dungeonKey: String, useTime: Int) - 设置玩家副本通关时间
  • getPlayerDungeonDataTime(playerName: String, dungeonKey: String): Int? - 获取玩家副本通关时间

副本CD相关

  • isPlayerInDungeonCD(playerName: String, dungeonKey: String): Boolean - 判断玩家是否在副本CD中
  • setPlayerDungeonCD(playerName: String, dungeonKey: String, cdMinutes: Int) - 设置玩家副本CD
  • getPlayerDungeonCDRemainingTime(playerName: String, dungeonKey: String): Long - 获取玩家副本CD剩余时间（分钟）
  • getDungeonCDPeriod(dungeonKey: String): Int - 获取副本CD周期配置（分钟）

队伍相关

  • startCheckTeamReady(teamLeader: String, playerNames: MutableList<String>, dungeonKey: String, dungeonLevel: String) - 开始检查队伍准备状态
  • dungeonAllowEnter(player: Player, dungeonKey: String, teamNumber: Int): String - 检查玩家是否可以进入副本

插件工作日志

提交时间提交内容
2025-09-16 12:14:32 +0800新增副本startCheckTeamReady设置CD接口
2025-09-16 00:38:14 +0800更新副本CD接口与发包
2025-09-10 00:37:48 +0800更新cicd流程
2025-09-09 10:31:52 +0800更新cicd流程
2025-09-07 11:17:44 +0800从dp迁移到ax上
2024-12-11 23:13:23 +0800[fix]修复退副本导致不传送Bug
2024-12-11 16:17:23 +0800[fix]修复退副本逻辑after取不到成员问题
2024-12-03 18:56:14 +0800[fit]新增dp副本对接所需难度参数
2024-12-03 15:31:58 +0800[fit]暂移除难度测试
2024-11-23 16:12:15 +0800[fat]新增副本流程开始与结束返回服务器
2024-11-23 12:41:27 +0800[fat]新增副本中队长身份字段
2024-11-20 13:18:34 +0800[fat]更新版本号
2024-11-20 12:39:04 +0800[fat]新增kehter脚本错误提示
2024-11-19 20:11:11 +0800[fat]更新新版api
2024-11-19 16:58:45 +0800[fat]更新版本号
2024-11-19 16:57:42 +0800[fat]新增副本难度流程
2024-11-13 23:13:27 +0800[fat]新增循环检测副本队伍满足,以及回传子服
2024-11-13 00:06:25 +0800[fat]修正KetherApi中返回字符串问题
2024-11-12 19:50:46 +0800[fat]新增逻辑判断Api,更新版本号至1.0.7
2024-11-08 00:29:34 +0800[fat]更新版本号至1.0.6
2024-11-08 00:29:07 +0800[fat]新增排行榜与设置战斗时间API
2024-11-06 23:22:26 +0800[fix]修复open导致的数据不正确,以及发包未对应
2024-11-06 18:26:53 +0800[fat]升级版本号
2024-11-06 18:21:16 +0800[fix]修复发包顺序问题
2024-11-06 16:12:39 +0800[fix]修复依赖问题与重载,新增数据库
2024-11-04 18:34:06 +0800[fat]初始化提交
2024-11-01 22:32:35 +0800Initial Commit

插件工作日志