CauldronTap
适用于 Paper 的插件,通过发射器从熔岩或水的炼药锅中填充空桶。
工作原理
- 将发射器放置并朝向熔岩或水的炼药锅。
- 在发射器中放入空桶。
- 激活发射器——一个空桶变为熔岩桶或水桶;炼药锅随之变空。
要求
- Paper 26.1.2(或兼容版本)
- Java 25
安装
将 build/libs/ 目录下的构建好的 JAR 文件复制到 plugins/ 目录,然后重启服务器。
命令
| 命令 |
权限 |
描述 |
/cauldrontap reload |
cauldrontap.reload(默认:op) |
重新加载 config.yml |
配置
文件:plugins/CauldronTap/config.yml
| 选项 |
默认值 |
描述 |
debug |
false |
将诊断日志输出到控制台和 plugins/CauldronTap/debug.log |
filled-bucket-output |
inventory |
装满后的桶的输出位置:inventory(背包)或 chest(箱子) |
chest-output-position |
back |
当输出为 chest 时箱子的偏移位置(见下文) |
filled-bucket-output
inventory — 装满后的桶保留在发射器内。
chest — 装满后的桶会进入附近的箱子;如果未找到箱子或箱子已满,则回退到 inventory。
同时适用于熔岩桶和水桶。接受普通箱子和陷阱箱。
chest-output-position
仅在 filled-bucket-output: chest 时使用。相对于发射器的朝向位置:
| 值 |
位置 |
back |
发射器后方(默认) |
front |
发射器前方(与炼药锅同侧) |
down |
下方 |
up |
上方 |
left / right |
朝向方向的左侧或右侧 |
示例
debug: false
filled-bucket-output: chest
chest-output-position: back
构建
./gradlew build
输出:build/libs/CauldronTap-<version>.jar
CI / 发布
| 工作流 |
触发条件 |
结果 |
| Build |
推送到 main 分支、拉取请求、每周定时任务 |
运行测试、Checkstyle、SpotBugs;上传插件 JAR |
| Release |
推送到 main 分支且更改了 CHANGELOG.md,或手动运行 |
版本号递增,更新变更日志,构建 JAR,创建 GitHub Release |
发布版本
- 根据需要修改代码。
- 在
CHANGELOG.md 中的 ## [Unreleased] 下添加说明(使用 ### Added、### Changed、### Fixed 及项目符号)。
- 提交并推送到
main 分支(包含 CHANGELOG.md 的更新)。
发布工作流将执行以下操作:
- 自动递增版本号(默认为补丁版本;最新标签
v1.0.0 → v1.0.1)
- 将
[Unreleased] 下的内容移入新的 ## [x.y.z] - date 部分
- 重置
[Unreleased] 以准备下一个周期
- 构建
CauldronTap.jar 并在 GitHub Release 中附上这些说明
手动发布(选择 patch / minor / major):Actions → Release → Run workflow。
如果 [Unreleased] 下没有项目符号,工作流将跳过(避免意外生成空发布)。
许可证
GPL-3.0 — 请参阅 LICENSE。
CauldronTap
Paper plugin that fills empty buckets from lava or water cauldrons using a dispenser.
How it works
- Place a dispenser facing a lava or water cauldron.
- Put empty buckets in the dispenser.
- Power the dispenser — one empty bucket becomes a lava or water bucket; the cauldron is emptied.
Requirements
- Paper 26.1.2 (or compatible)
- Java 25
Install
Copy the built JAR from build/libs/ into plugins/ and restart the server.
Commands
| Command |
Permission |
Description |
/cauldrontap reload |
cauldrontap.reload (default: op) |
Reload config.yml |
Configuration
File: plugins/CauldronTap/config.yml
| Option |
Default |
Description |
debug |
false |
Log diagnostics to the console and plugins/CauldronTap/debug.log |
filled-bucket-output |
inventory |
Where filled buckets go: inventory or chest |
chest-output-position |
back |
Chest offset when output is chest (see below) |
filled-bucket-output
inventory — filled bucket stays in the dispenser.
chest — filled bucket goes into a nearby chest; falls back to inventory if no chest is found or the chest is full.
Works for both lava and water buckets. Accepts normal and trapped chests.
chest-output-position
Only used when filled-bucket-output: chest. Position relative to the dispenser’s facing:
| Value |
Location |
back |
Behind the dispenser (default) |
front |
In front (same side as the cauldron) |
down |
Below |
up |
Above |
left / right |
Left or right of the facing direction |
Example
debug: false
filled-bucket-output: chest
chest-output-position: back
Build
./gradlew build
Output: build/libs/CauldronTap-<version>.jar
CI / releases
| Workflow |
Trigger |
Result |
| Build |
Push to main, pull requests, weekly schedule |
Tests, Checkstyle, SpotBugs; uploads the plugin JAR |
| Release |
Push to main that changes CHANGELOG.md, or manual run |
Bumps version, updates changelog, builds JAR, creates GitHub release |
Publishing a release
- Change your code as needed.
- Add notes under
## [Unreleased] in CHANGELOG.md (use ### Added, ### Changed, ### Fixed and bullet points).
- Commit and push to
main (include the CHANGELOG.md update).
The release workflow will:
- Bump the version automatically (patch by default; latest tag
v1.0.0 → v1.0.1)
- Move
[Unreleased] notes into a new ## [x.y.z] - date section
- Reset
[Unreleased] for the next cycle
- Build
CauldronTap.jar and create a GitHub release with those notes
Manual release (choose patch / minor / major): Actions → Release → Run workflow.
If [Unreleased] has no bullet points, the workflow skips (no accidental empty releases).
License
GPL-3.0 — see LICENSE.
评论 0
登录后参与评分
还没有评论,来抢沙发吧