BacapGuess
BacapGuess 是一款在 Paper 服务器上供两名玩家游玩的迷你游戏,需安装
BlazeandCave's Advancements Pack (BACAP) 数据包。
每位参与者会被分配一个隐藏的进度目标。玩家可以查看对手的目标,但看不到自己的,必须通过只能回答“是”或“否”的问题来推断出自己的目标。率先完成自己隐藏进度的玩家获胜。
功能
- 第二名玩家加入时自动打开菜单;
- 通过命令手动开始回合;
- 三个难度等级,配有独立的点击按钮;
- 每位参与者获得不同的随机目标;
- 仅考虑玩家尚未完成的进度;
- 目标名称以原版进度链接的形式显示,悬停可查看描述;
- 通过
PlayerAdvancementDoneEvent 自动检测胜利者;
- 独立的单人测试模式;
- BACAP 1.18.1 的完整难度映射;
- 可通过配置文件手动覆盖任意进度的难度;
- 从选择中排除技术性且不合适的进度。
要求
- Java 21;
- Paper 1.21.x(插件基于 Paper API 1.21.4 构建);
- BlazeandCave's Advancements Pack,且命名空间为
blazeandcave;
- Maven 3.9+ 仅用于自行构建插件。
本插件不包含 BACAP 数据包本身。它必须在世界中单独安装。
安装
- 将 BACAP 安装到目标世界的
datapacks 文件夹中。
- 将
bacap-guess-1.0.0.jar 放入服务器的 plugins 文件夹。
- 将
config.yml 放入 plugins/BacapGuess。
- 完全重启服务器。
- 运行
/advgame status,确保 BACAP 进度已被检测并分配到各个难度类别中。
本地构建后,生成的文件位于此处:
target/bacap-guess-1.0.0.jar
玩法
正常回合需要服务器上恰好有两名玩家在线。
- 运行
/advgame start,或在第二名玩家加入后等待菜单自动打开。
- 其中一名参与者选择该回合共享的难度等级。
- 插件为每位玩家随机分配一个未完成的、所选难度的目标。
- 每位玩家会收到对手的进度,但无法看到自己的目标。
- 参与者互相提问,试图确定自己的目标。
- 当其中一名玩家完成分配给自己的进度时,回合自动结束。
如果参与者在难度选择开放期间或进行中的回合里离开,游戏将被停止。
命令
| 命令 |
用途 |
/advgame start |
打开难度选择并开始两人回合 |
/advgame stop |
停止当前游戏或难度选择 |
/advgame test |
为单人测试目标打开难度选择 |
/advgame test easy |
使用简单目标开始测试 |
/advgame test medium |
使用中等目标开始测试 |
/advgame test hard |
使用困难目标开始测试 |
/advgame complete |
强制完成当前测试目标的所有条件 |
/advgame status |
显示插件状态及各难度类别中的目标数量 |
/advgame difficulty <level> 命令由菜单按钮内部使用。
回合参与者无需管理员权限即可点击这些按钮。
权限
bacapguess.admin
此权限默认授予服务器操作员。启动、停止、测试以及查看诊断信息需要此权限。
测试模式
测试模式允许你在没有第二位参与者的情况下验证插件:
- 运行
/advgame test。
- 点击所需难度的按钮。
- 插件将显示分配的进度及其 ID。
- 自行完成目标或使用
/advgame complete。
- 如果事件被正确检测,插件将报告测试成功完成。
与正常回合不同,在测试模式中玩家可以看到自己的目标。
难度分布
内置映射是基于
BlazeandCave's Advancements Pack 1.18.1.zip 中所有进度 JSON 文件创建的。
总共分析了 1106 个进度文件。在排除根进度和隐藏的条目后,游戏玩法地图包含:
| 等级 |
数量 |
| Easy |
220 |
| Medium |
379 |
| Hard |
431 |
| Excluded technical entries |
4 |
分类考虑了以下因素:
- 世界进程阶段及所需维度;
- 生物群系、结构、生物或物品的稀有度;
- 所需条件的数量;
- 所需的准备工作和资源;
- 对随机掉落的依赖;
- 累计刷怪量及预期回合持续时间;
- BACAP 框架类型 ——
task、goal 或 challenge —— 作为额外而非唯一的指标。
例如,blazeandcave:monsters/ender_worm 尽管使用了常规进度框架,仍被归类为 hard。
配置
完整配置文件位于:
plugins/BacapGuess/config.yml
项目源文件:src/main/resources/config.yml。
配置结构:
difficulty-map-version: "bacap-1.18.1-v1"
difficulty-overrides:
easy:
- "blazeandcave:building/a_masterpiece"
medium:
- "blazeandcave:adventure/a_chiptune_relic"
hard:
- "blazeandcave:monsters/ender_worm"
excluded-advancements:
- "blazeandcave:technical/big_cheater"
每个完整的 ID 应仅出现在一个列表中。如果同一个 ID 意外地包含在多个类别中,在加载时,easy、medium、hard 顺序中最后一个匹配的列表将具有优先权。excluded-advancements 列表拥有最高优先级,会完全从游戏中移除该目标。
手动更改配置后,请重启服务器。目前尚无用于热重载配置的命令。
首次启动时,完整配置会从 JAR 包中复制。如果在更新插件后检测到没有地图版本的旧空配置文件,它将自动填充。非空的自定义用户列表不会被覆盖。
来自更高版本 BACAP 且不在显式映射中的进度目标不会被忽略:插件会根据其 ID、名称、描述、框架类型以及后期游戏进展的指标,使用回退分类器为其分配难度等级。
为另一个 BACAP 版本更新地图
项目包含一个生成器:
tools/generate_bacap_difficulty.py
PowerShell 示例命令:
python tools\generate_bacap_difficulty.py `
"C:\path\to\BlazeandCave's Advancements Pack.zip" `
--output src\main\resources\config.yml
生成完成后,应手动审查地图:特定挑战的难度部分取决于主观判断,并受世界状态、可用农场以及玩家进展的影响。
局限性
- 仅支持
blazeandcave 命名空间;
- 普通回合专为两名玩家设计;
- 参与者可能已经拥有不同的累计进度目标完成量;
- 分类是基于典型生存世界和预期的游戏回合时长设计的;
- 更新 BACAP 后,新增或修改的进度目标理想情况下应重新进行审查。
BacapGuess
BacapGuess is a mini-game for two players on a Paper server with the
BlazeandCave's Advancements Pack (BACAP) datapack installed.
Each participant is assigned a hidden advancement. A player can see their opponent's goal, but not
their own, and must figure out their own goal by asking questions that can only be
answered with “yes” or “no”. The winner is the first player to actually complete
their hidden advancement.
Features
- automatically opens the menu when the second player joins;
- manual round start via command;
- three difficulty levels with separate clickable buttons;
- different random goals for each participant;
- only advancements the player has not yet completed are considered;
- the goal name is displayed as a vanilla advancement link with a description on hover;
- automatic winner detection via
PlayerAdvancementDoneEvent;
- separate single-player test mode;
- complete difficulty map for BACAP 1.18.1;
- manual difficulty overrides for any advancement through the config;
- exclusion of technical and unsuitable advancements from selection.
Requirements
- Java 21;
- Paper 1.21.x (the plugin is built against Paper API 1.21.4);
- BlazeandCave's Advancements Pack with the
blazeandcave namespace;
- Maven 3.9+ is required only for building the plugin yourself.
The plugin does not include the BACAP datapack itself. It must be installed in the world separately.
Installation
- Install BACAP into the
datapacks folder of the target world.
- Place
bacap-guess-1.0.0.jar into the server's plugins folder.
- Place
config.yml into plugins/BacapGuess.
- Fully restart the server.
- Run
/advgame status and make sure BACAP advancements are detected and distributed
across the difficulty categories.
After a local build, the generated file can be found here:
target/bacap-guess-1.0.0.jar
How to Play
A normal round requires exactly two players to be online on the server.
- Run
/advgame start or wait for the menu to open automatically after the second player joins.
- One of the participants selects the shared difficulty level for the round.
- The plugin randomly assigns each player an unfinished goal of the selected difficulty.
- Each player receives their opponent's advancement, but cannot see their own goal.
- The participants ask each other questions and try to determine their own goal.
- The round ends automatically when one of the players completes the advancement assigned to them.
If a participant leaves while difficulty selection is open or during an active round, the game will be stopped.
Commands
| Command |
Purpose |
/advgame start |
Open the difficulty selection and start a two-player round |
/advgame stop |
Stop the current game or difficulty selection |
/advgame test |
Open the difficulty selection for a single-player test goal |
/advgame test easy |
Start a test with an easy goal |
/advgame test medium |
Start a test with a medium goal |
/advgame test hard |
Start a test with a hard goal |
/advgame complete |
Force-complete all criteria of the current test goal |
/advgame status |
Show the plugin status and the number of goals in each difficulty category |
The /advgame difficulty <level> command is used internally by the menu buttons.
Round participants can click these buttons without administrative permission.
Permissions
bacapguess.admin
This permission is granted to server operators by default. It is required for starting,
stopping, testing, and viewing diagnostic information.
Test Mode
Test mode allows you to verify the plugin without a second participant:
- Run
/advgame test.
- Click the button for the desired difficulty.
- The plugin will show the assigned advancement and its ID.
- Complete the goal yourself or use
/advgame complete.
- If the event is detected correctly, the plugin will report that the test was completed successfully.
Unlike a normal round, the player can see their own goal in test mode.
Difficulty Distribution
The built-in map was created from all advancement JSON files in
BlazeandCave's Advancements Pack 1.18.1.zip.
A total of 1106 advancement files were analyzed. After excluding root advancements and hidden
internal entries, the gameplay map contains:
| Level |
Count |
| Easy |
220 |
| Medium |
379 |
| Hard |
431 |
| Excluded technical entries |
4 |
The classification takes the following factors into account:
- world progression stage and required dimension;
- rarity of the biome, structure, mob, or item;
- number of required criteria;
- required preparation and resources;
- dependence on random drops;
- cumulative grinding and expected round duration;
- BACAP frame type —
task, goal, or challenge — as an additional, but not exclusive, indicator.
For example, blazeandcave:monsters/ender_worm is classified as hard despite
using a regular advancement frame.
Configuration
The full configuration is located at:
plugins/BacapGuess/config.yml
Project source file: src/main/resources/config.yml.
Configuration structure:
difficulty-map-version: "bacap-1.18.1-v1"
difficulty-overrides:
easy:
- "blazeandcave:building/a_masterpiece"
medium:
- "blazeandcave:adventure/a_chiptune_relic"
hard:
- "blazeandcave:monsters/ender_worm"
excluded-advancements:
- "blazeandcave:technical/big_cheater"
Each full ID should appear in only one list. If the same ID is accidentally
included in multiple categories, the last matching list in the order
easy, medium, hard takes precedence during loading. The
excluded-advancements list has the highest priority and removes the goal from the game entirely.
Restart the server after manually changing the configuration. There is currently
no command for hot-reloading the config.
On first launch, the full config is copied from the JAR. If an old empty config
without a map version is detected after updating the plugin, it will be populated automatically.
Non-empty user-defined lists are not overwritten.
Advancements from newer BACAP versions that are not present in the explicit map are not ignored:
the plugin assigns them using a fallback classifier based on their ID, name, description, frame,
and indicators of late-game progression.
Updating the Map for Another BACAP Version
The project includes a generator:
tools/generate_bacap_difficulty.py
Example PowerShell command:
python tools\generate_bacap_difficulty.py `
"C:\path\to\BlazeandCave's Advancements Pack.zip" `
--output src\main\resources\config.yml
After generation, the map should be reviewed manually: the difficulty of a specific challenge
is partly subjective and depends on the state of the world, available farms, and player progression.
Limitations
- only the
blazeandcave namespace is supported;
- normal rounds are designed for exactly two players;
- participants may already have different amounts of progress toward cumulative advancements;
- the classification is designed around a typical survival world and expected game-round duration;
- after updating BACAP, new or modified advancements should ideally be reviewed again.
评论 0
登录后参与评分
还没有评论,来抢沙发吧