- 支持多池管理（按世界与选区配置多个池）
- 支持使用工具快捷创建经验池选取
- 支持经验瓶模式与直接模式经验发放
- 支持金币、点券与自定义指令奖励
- 支持每日重置与补偿重置（服务器错过预定时间时）
- 支持 ActionBar、BossBar、Title 展示
- 支持粒子特效，拥有沉浸真实的温泉效果
- 支持传送进入拦截与绕过权限
- 支持防结冰系统与调试日志开关
- 支持配置热重载与自动补全缺失项
- 支持从 Exppond-Next 导入池配置
- 支持 PlaceholderAPI 变量
- 兼容 1.8–1.21 服务端
| 指令 | 介绍 | 权限 |
|---|---|---|
/kep help |
显示帮助信息 | — |
/kep wand |
获取区域选择工具（左键 pos1，右键 pos2） |
kukeexppond.admin |
/kep create <池名> |
以当前选区创建池，写入世界与坐标 | kukeexppond.admin |
/kep setregion <池名> |
将当前选区应用到指定池的 region |
kukeexppond.admin |
/kep list |
查看所有已配置的池及模式/瓶状态 | — |
/kep info <池名> |
查看指定池的世界、区域、模式、权限等详情 | — |
/kep reload |
重载配置并重建奖励/经验/UI/特效任务 | kukeexppond.admin |
/kep updateconfig |
自动检查并补全缺失的配置项 | kukeexppond.admin |
/kep importnext [override] |
从 Exppond-Next 导入配置；override 表示覆盖同名池 |
kukeexppond.admin |
提示：
wand需要在游戏内执行；importnext需服务端存在plugins/Exppond-Next/config.yml。bypass绕过进入限制的权限节点为kukeexppond.bypass。
# 获取选择工具并创建名为 default 的池
/kep wand
/kep create default
# 将当前选区写入指定池
/kep setregion default
# 重载配置并重建任务
/kep reload
# 从 Exppond-Next 导入（覆盖同名池）
/kep importnext override############################################
# KukeExpPond 配置文件 (1.8–1.21 兼容)
# 所有配置均可热重载。
#
# 变量占位：
# - {player}: 玩家名
# - {pond}: 池名称
# - {money_today}/{money_max}: 今日/每日上限的金币
# - {points_today}/{points_max}: 今日/每日上限的点券
# - 其他 UI 项按实现映射
#
# 使用说明：
# - 该文件为默认配置示例，插件启动时会自动补全缺失项。
# - 修改后可执行 `/kep reload` 热重载；也可用 `/kep updateconfig` 自动补全缺失项。
# - 文本支持彩色代码（&a/&b 等），按服务端显示规则渲染。
############################################
# 配置文件版本（请勿修改）
config_version: "1.0.0"
general:
# 全局消息前缀
prefix: "&7[&bKukeExpPond&7] "
# 数据存储方式：yaml 或 sqlite（首版推荐 yaml）
storage: yaml
debug: false # 调试日志：奖励计算、占位符取值、事件拦截
# 全局每日重置时间（HH:mm），池级可覆盖；默认凌晨 00:00
daily_reset_time: "00:00"
# 全局时区（例如 Asia/Shanghai），池级可覆盖
timezone: "Asia/Shanghai"
# 防结冰系统配置
ice_prevention:
enable: true # 是否启用防结冰系统
check_interval: 30 # 检查间隔（秒）
convert_ice_to_water: true # 是否将冰块转换为水
debug_log: false # 是否记录防结冰调试日志
# 更新检测配置
update_checker:
enable: true # 是否启用更新检测
check_on_startup: true # 启动时检测更新
notify_admins_on_join: true # 管理员登录时提示更新
github_repo: "kukemc/KukeExpPond" # GitHub仓库地址
check_interval: 3600 # 检查间隔（秒），默认1小时
# 经验瞬间吸收配置
instant_exp_absorb:
enable: true # 是否启用经验瞬间吸收功能
search_radius: 2.0 # 搜索附近玩家的半径（方块）
delay_ticks: 1 # 延迟处理的tick数（确保经验球完全生成）
play_sound: true # 是否播放吸收音效
version_mapping:
# 粒子/音效的跨版本回退策略，仅示例（找不到枚举时使用这些回退）
particle_fallback: CLOUD
join_sound_fallback: ENTITY_EXPERIENCE_ORB_PICKUP
leave_sound_fallback: BLOCK_WATER_AMBIENT
# 多池配置：键为池名
ponds:
default:
world: world
region:
# 选区两个点，支持跨版本；未设置时命令无法创建/启用
pos1: { x: 0, y: 64, z: 0 }
pos2: { x: 10, y: 70, z: 10 }
permission:
pond_permission: pond.default # 进入权限节点（动态，按池自定义）
pond_join: true # 无权限是否允许进入（true/false）
bypass_permission: kukeexppond.bypass # 可跳过限制（如传送阻止）
mode:
xp_mode: bottle # bottle 或 direct
bottle:
enable: true
bottle_speed: 5 # 每轮生成间隔（秒）
bottle_count: 3 # 每轮生成个数
only_above_water: true # 仅在水方块上方生成
drop_height: 4.0 # 瓶子生成相对高度（米），从玩家附近位置往上抬高后投掷
reward:
exp:
# direct 模式下的经验配置
enable: true
mode: interval # continuous 连续模式 | interval 间隔模式
per_tick: 1 # 连续模式配置：每tick给予的经验点数（默认取 count）
tick_period: 20 # 连续模式配置：每隔多少tick发放一次（默认1，每tick）
interval_ticks: 200 # 间隔模式配置：两次发放之间的tick数（20tick=1秒）
count: 5 # 间隔模式/瓶模式下每次发放点数
money:
enable: true
speed: 10 # 发放周期（秒）
count: 5 # 每周期金额
max: 500 # 每日上限
points:
enable: false
speed: 15
count: 2
max: 200
command:
enable: false
speed: 30
commands:
- "say Congrats {player}"
async: true # 强制异步发放（必要）
daily_reset_time: "04:00" # 每日重置时间（HH:mm）
timezone: "Asia/Shanghai" # 时区
ui:
title:
join_title: "&b欢迎来到经验温泉"
join_subTitle: "&7放松身心，享受奖励"
leave_title: "&7你离开了经验温泉"
leave_subTitle: ""
error_title: "&c无法进入"
error_subTitle: "&7你没有权限"
fadeIn: 10
stay: 40
fadeOut: 10
actionbar:
enable: true
template: "&b{pond}&7: 金币 {money_today}/{money_max} | 点券 {points_today}/{points_max}"
bossbar:
enable: true
color: BLUE
style: SEGMENTED_10
items: [MONEY_PROGRESS, POINTS_PROGRESS, ONLINE_IN_POND, NEXT_REWARD_COUNTDOWN]
message:
money: "&a获得金币 {amount} (今日 {money_today}/{money_max})"
points: "&a获得点券 {amount} (今日 {points_today}/{points_max})"
teleport: "&e请不要使用传送功能进入挂机池"
sound:
join_sound_id: ENTITY_PLAYER_LEVELUP
join_sound_volume: 1.0
join_sound_pitch: 1.2
leave_sound_id: BLOCK_WATER_AMBIENT
leave_sound_volume: 0.8
leave_sound_pitch: 1.0
effects:
steam_hot_spring: # 蒸汽特效
enable: true
rate: 10
particle: CLOUD
water_bubble: # 气泡特效
enable: true
rate: 10
particle: BUBBLE_COLUMN_UP
smoke_bottom: # 烟雾特效
enable: true
rate: 20
particle: CAMPFIRE_SIGNAL_SMOKE
density: 1.0
teleport:
block_enter_by_teleport: true
message: "&e请不要使用传送功能进入挂机池"| 变量 | 说明 |
|---|---|
%kep_pond% |
当前所在池名（为空表示不在池中） |
%kep_money_today% |
当前池今日获得金币 |
%kep_money_max% |
当前池每日金币上限 |
%kep_money_total% |
累计获得金币总数 |
%kep_points_today% |
当前池今日获得点券 |
%kep_points_max% |
当前池每日点券上限 |
%kep_points_total% |
累计获得点券总数 |
%kep_pond_<池名>% |
指定池名（显式后缀） |
%kep_money_today_<池名>% |
指定池的今日金币（显式后缀） |
%kep_points_today_<池名>% |
指定池的今日点券（显式后缀） |
%kep_money_max_<池名>% |
指定池的每日金币上限（显式后缀） |
%kep_points_max_<池名>% |
指定池的每日点券上限（显式后缀） |
说明：显式后缀支持
*_today_<池名>与*_max_<池名>；*_total不支持后缀。
- QQ 讨论群：
981954623 - GitHub：
https://github.com/kukemc/KukeExpPond