PLUGIN DOCS

CyExppond

经验挂机池：在水池区域自动产出经验，支持金币/点券/指令奖励、特效和排行榜变量。

免费 v4.0.1 Paper 1.21.11

简介

CyExppond 让玩家站在指定水域池区自动获得经验。池子由两个对角坐标定义，可以配置经验瓶/直接经验、金币/点券/指令奖励、粒子、音效和界面。

核心功能

每个池独立配置世界、区域、权限、经验模式和奖励
经验瓶模式或直接发经验
金币、点券、控制台指令奖励，带每日上限
防结冰、粒子、音效、ActionBar/BossBar
每日 00:00 重置当日奖励
PlaceholderAPI 变量

支持环境

项目	要求
服务端	Paper 1.21.11
Java	Java 21
软依赖	Vault、PlayerPoints、PlaceholderAPI
硬依赖	无

安装

把 CyExppond-4.0.1.jar 放进 plugins/。
重启服务器，生成 config.yml、messages.yml、ponds.yml。
配置 ponds.yml 的池区域和奖励。
执行 /cep reload。
玩家走进池区即可挂机。

玩家使用

无需玩家命令。

进入池区自动开始产出。
默认每 5 秒生成经验瓶；mode: direct 时直接发经验。
池内显示 ActionBar / BossBar；离开后停止。
没有权限但 pond_join: true 时仍可进入，只是不产出奖励。

管理命令

需要 cyexppond.admin。

命令	作用
`/cep help`	查看帮助
`/cep list`	列出所有池
`/cep wand`	获取区域选择工具（左键 pos1，右键 pos2）
`/cep create <池名>`	用当前选择创建池
`/cep setregion <池名>`	重新设置池区域
`/cep info <池名>`	查看池信息
`/cep resetday [玩家]`	重置当日奖励计数
`/cep reload`	重载配置

权限

权限	默认	说明
`cyexppond.admin`	OP	管理命令
`cyexppond.bypass`	OP	绕过池子传送限制和权限进入，并正常获奖
`cyexppond.<池名>`	无	进入指定池并获奖，例如 `cyexppond.default`

配置

主配置

debug: false
daily_reset_time: "00:00"
timezone: "Asia/Shanghai"
logging:
  enabled: true

池配置

ponds.yml 每个顶层键就是一个池：

default:
  enable: true
  world: "world"
  region:
    pos1: "0, 60, 0"
    pos2: "0, 60, 0"
  permission: "cyexppond.default"
  pond_join: true
  mode: "bottle"
  number: 5
  time: 5
  height: 4.0
  multiplier: 1

字段	说明
`world`	池所在世界
`region.pos1` / `pos2`	两个对角坐标
`permission`	进入并获奖所需权限；留空不限制
`pond_join`	无权限时是否允许进入
`mode`	`bottle` 经验瓶 / `direct` 直接经验
`number`	每轮经验瓶数量；direct 模式为 `number × 6` 点经验
`time`	产出间隔（秒）
`height`	经验瓶相对水面的高度
`multiplier`	经验倍率

奖励

reward:
  money:
    enable: false
    speed: 60
    count: 50
    max: 2000
  points:
    enable: false
    speed: 120
    count: 3
    max: 20
  command:
    enable: false
    speed: 150
    commands: []

max: 0 表示不限制；指令奖励支持 {player} 占位符。

防结冰与特效

ice_prevention:
  enable: true

effects:
  steam_hot_spring:
    enable: true
    rate: 5
    particle: "CLOUD"
  water_bubble:
    enable: true
    rate: 10
    particle: "BUBBLE_COLUMN_UP"
  density: 1.0

界面

ui:
  actionbar: true
  bossbar:
    enable: true
    color: "BLUE"
    style: "SEGMENTED_10"

传送限制

block_enter_by_teleport: false

设为 true 时禁止用传送直接进入池子。

变量与 API

PlaceholderAPI 标识符：cep

变量	含义
`%cep_pond%`	当前所在池名
`%cep_money_total%`	累计金币奖励
`%cep_points_total%`	累计点券奖励
`%cep_money_today%`	当前池今日金币
`%cep_points_today%`	当前池今日点券
`%cep_money_max%` / `%cep_points_max%`	当前池每日上限
`%cep_money_today_<池名>%` / `%cep_points_today_<池名>%`	指定池今日数据
`%cep_money_max_<池名>%` / `%cep_points_max_<池名>%`	指定池上限

当前版本没有公开 Java API。

许可证验证

本插件启用前会校验许可证：插件把 license.yml 里的许可证号发送到授权服务器，服务器用私钥签名，插件用内置公钥验证签名。校验不通过时插件不会启用。

首次启动

必须联网：第一次启动没有缓存，联网校验失败会直接停止加载。
首次启动会在插件目录生成 license.yml。
控制台出现「许可证验证通过」表示正常。

license.yml

# 插件目录下的 license.yml
license:
  key: "CYP-XXXX-XXXX-XXXX"

许可证号在网站用户中心查看，一个账号只有一个许可证，所有插件共用。

免费插件与付费插件

类型	是否需要填许可证	说明
免费插件	不需要	留空即可，插件仍会联网确认「免费」状态
付费插件	需要	先用兑换码在网站开通，再填入许可证号

心跳与缓存

运行期间每小时向服务器发一次心跳。
服务器临时无法连接时，有 7 天宽限期，期间插件继续可用。
服务器明确返回「许可证无效 / 已被禁用」时，立即停止，没有宽限。
插件被禁用后，需要到网站解绑或联系作者处理。

常见问题

控制台提示「无法连接验签服务器」

检查服务器能否访问 https://license.mc33.top，以及是否只启用了 IPv6（授权站仅支持 IPv4）。

提示「当前许可证未开通本插件」

到网站兑换码页面输入兑换码开通，或确认购买的是这个插件。

提示「IP 数量已达上限」

每个插件最多绑定 2 个 IP，到用户中心解绑旧服务器后再启动。

更换服务器后无法启动

旧 IP 仍占用名额，先在网站解绑，再在新服务器启动。

常见问题

站在池里没有经验？

检查池是否 enable: true、区域坐标是否正确、玩家是否有 cyexppond.<池名> 权限，以及 mode / number / time 配置。

没有权限能进池吗？

pond_join: true 时能进，但不产出奖励；false 时会被拦在外面。

金币/点券奖励不触发？

对应 reward.money.enable / reward.points.enable 默认关闭；开启后还要检查 Vault/PlayerPoints 和每日上限。

池水结冰了？

ice_prevention.enable: true 会在结冰事件发生时化回水；启动/reload 时也会清一次存量冰。

每日几点重置？

由 daily_reset_time 和 timezone 控制，默认 00:00、Asia/Shanghai。

更新日志

按时间倒序，最新的在最上面。当前版本是 4.0.0。

4.0.0（2026-10-02 · 当前版本）

当前构建版本；完整记录见项目根目录 更新日志.md。

3.0.0

从 KukeExpPond 更名为 CyExppond，命令改为 /cep。
重写池加载、奖励、粒子、防结冰和配置补齐。
PAPI 标识符改为 %cep_*%。

获取插件全部文档