Suite

配置

Abyss 主配置 ArcartXAbyss.yml 详解

配置

Abyss 的主配置文件为 config.yml，位于 plugins/ArcartX-Suite/data/abyss/（jar 内资源名 ArcartXAbyss.yml，首次启动自动导出）。地牢定义在同级 abysses/ 目录，详见 地牢模板编写。

修改后执行 /axs abyss reload（重载模板）或 /axs reload abyss（重载模块配置）生效。

abyss（世界与实例）

字段类型默认值说明
abyss.world-prefixString"axs_abyss_"副本实例世界名前缀，用于清理识别
abyss.instance-cleanup-timeoutint7200实例清理超时（秒），结束/无人实例超过该时间强制回收
abyss.instance-check-intervalint30实例检查周期（秒），超时/无人检测间隔
abyss.world-load-timeoutint120000世界加载超时（毫秒）
abyss.max-entities-per-instanceint100单实例实体上限，防止实体爆炸
abyss.nms-fast-loadbooleantrue启用 NMS 快速世界加载通道，失败自动回退 Bukkit API
abyss.async-world-copybooleantrue世界文件夹复制异步执行（大目录建议开启）
abyss.empty-cleanup-delay-secondsint30副本无人后回收延迟（秒），掉线玩家在窗口内重连可继续
abyss.afk-kick-minutesint0副本内挂机踢出（分钟）：玩家处于 Essentials AFK 状态超时则移出副本；0=关，需 essentials 模块
abyss.preload.enabledbooleanfalse副本预热池：启动后预建世界，进本秒开
abyss.preload.strictbooleanfalse严格模式：预热池空时拒绝进入（false=回退即时创建）
abyss.preload.dungeonsMap{}各地牢预热数量，如 skeleton_throne: 2

death（死亡判定）

字段类型默认值说明
death.fatal-damage-checkbooleantrue拦截致死伤害判为副本死亡（玩家不真正死亡）
death.allow-totembooleantrue手持不死图腾时图腾正常救活，不算死亡
death.team-wipe-modeString"STRICT"团灭判定：STRICT=全员死亡立即失败 / DELAYED=延迟判定（配合复活脚本）
death.team-wipe-delay-ticksint60DELAYED 模式下的判定延迟（tick）

escape（防逃逸）

字段类型默认值说明
escape.modeString"BLOCK"BLOCK=拦截传送 / TELEPORT_BACK=拉回副本 / FAIL=逃逸判负
escape.block-ender-pearlbooleantrue拦截末影珍珠
escape.block-chorus-fruitbooleantrue拦截紫颂果
escape.block-portalbooleantrue拦截传送门
escape.block-spectate-teleportbooleantrue拦截旁观玩家点击实体传送

restrictions（副本内限制）

字段类型默认值说明
restrictions.command-modeString"BLACKLIST"NONE=不限制 / BLACKLIST=列表内禁用 / WHITELIST=仅列表内可用
restrictions.blocked-commandsList<String>[spawn,tpa,home,back,warp,tp]命令控制列表（whitelist 模式下=允许的命令）；副本模板 disabled-commands/world.command-control 可覆盖
restrictions.blocked-itemsList<String>[CHORUS_FRUIT]副本内禁用物品（Material 名）
restrictions.block-breakbooleanfalse禁止破坏方块（false=允许，交给交互点判定）
restrictions.block-placebooleanfalse禁止放置方块

party（队伍）

字段类型默认值说明
party.max-membersint4队伍最大人数
party.invite-timeoutint60邀请有效时间（秒）
party.allow-custom-namebooleantrue允许自定义队伍名/颜色

副本奖励统一走 rewards.yml 奖励集 + ItemRewardDispatcher（背包→个人仓库→邮件→离线暂存→掉落），掉落物按原版归属由击杀者拾取。邀请有 60 秒冷却；玩家可 /party allowinvite 关闭接收。

stamina（体力）

字段类型默认值说明
stamina.enabledbooleantrue体力系统开关
stamina.maxint100最大体力值
stamina.regen-amountint1每次回复量
stamina.regen-interval-secondsint300回复间隔（秒）

进本实际消耗由各地牢 config.yml 的 requirements.stamina-cost 决定。

leaderboard（排行榜）

字段类型默认值说明
leaderboard.enabledbooleantrue排行榜开关
leaderboard.sizeint20榜单缓存行数
leaderboard.auto-show-completebooleantrue通关后自动展示排行榜

statistics（战斗统计）

字段类型默认值说明
statistics.enabledbooleantrue统计开关
statistics.track-damagebooleantrue记录造成伤害
statistics.track-damage-takenbooleantrue记录承受伤害
statistics.track-healingbooleantrue记录治疗量
statistics.auto-showbooleantrue副本结束自动展示统计 UI

storage（存储）

字段类型默认值说明
storage.modeString"sqlite"sqlite=共享宿主数据源 / mysql=模块自建连接池
storage.sqlite-file-nameString"abyss.db"SQLite 文件名（位于模块数据目录）
storage.host / port / database / username / password—127.0.0.1/3306/arcartxsuite/root/""MySQL 连接参数
storage.table-prefixString"axs_abyss_"表名前缀
storage.pool-sizeint8MySQL 连接池大小

ui（ArcartX UI）

字段类型默认值说明
ui.register-on-enablebooleantrue模块启动时注册全部 UI 到 ArcartX 桥
ui.overwrite-ui-filesbooleanfalse更新时覆盖 ui/ 目录已存在的同名文件
ui.browser-idString"abyss_browser"地牢浏览器 UI ID（自动加 AXS: 前缀）
ui.confirm-idString"abyss_confirm"进本确认 UI
ui.lobby-idString"abyss_lobby"组队大厅 UI
ui.party-idString"abyss_party"队伍房间 UI
ui.chest-idString"abyss_chest"宝箱 UI
ui.stats-idString"abyss_stats"战斗统计 UI
ui.leaderboard-idString"abyss_leaderboard"排行榜 UI
ui.hud-idString"abyss_hud"副本内 HUD

recovery（异常退出恢复）

字段类型默认值说明
recovery.enabledbooleantrue玩家在副本中掉线/崩服后，下次进服执行恢复动作
recovery.actionsList<String>["message ..."]动作序列，与副本脚本 DSL 一致（单目标无选择器）：message/title <in> <stay> <out> <主>|<副>/console/player_command/teleport [世界] <x,y,z[,yaw,pitch]>/clear_inventory/aria:/js:，支持 {player} {dungeon} 占位

debug

字段类型默认值说明
debugbooleanfalse开发者调试日志

本页目录