BetaAchievement

BetaAchievement

Bring all 16 original achievements to the server side of Minecraft Beta 1.7.3, with persistent progress and competitive speedruns.

English · 简体中文

Download ·
Source & Full Docs ·
Report an Issue

BetaAchievement is a server-side achievement plugin for Minecraft Beta 1.7.3 Project Poseidon. It evaluates and persists all 16 original achievements on the server, supports SQLite and MySQL/MariaDB, and exposes an API for querying achievement progress.

Preview · Features
| [](che11111.github.io/BetaAchievement/) | • Detect all 16 original achievements on the server and verify achievement parent requirements.

• Adapt to missing inventory, crafting, and special-behavior events on Beta 1.7.3 servers.
• Broadcast unlocks server-wide and optionally output them to the console.
• Record cumulative time, split times, run history, personal bests, and a server leaderboard for each 16/16 run.
• Persist players, runs, and individual progress using SQLite or MySQL/MariaDB.
• Expose current progress, full-completion rank, and run data queries to other plugins through the API. |

Server-Side Achievement Detection

Client and server achievement states are not synchronized because Beta 1.7.3 evaluates achievements only on the client. There are 16 achievements in total, and some triggers differ slightly because the server does not receive every event the client uses.

Icon · # · Achievement ID · Achievement · Requirement · Detection · Parent
1 · openInventory · Taking Inventory · Pick up any item · Unlocks when the player picks up any item. Opening the inventory with E in Beta 1.7.3 does not send a packet and produces no server event. · None
2 · mineWood · Getting Wood · Break a tree and pick up the dropped wood block · Unlocks when the player picks up item ID 17 (wood). · Taking Inventory
3 · buildWorkBench · Benchmarking · Craft a crafting table from four wood planks · Unlocks when item ID 58 (crafting table) is taken from a crafting output slot. · Getting Wood
4 · buildPickaxe · Time to Mine! · Craft a pickaxe from planks and sticks · Unlocks when any pickaxe is taken from a crafting output slot: iron 257, wood 270, stone 274, diamond 278, or gold 285. · Benchmarking
5 · buildFurnace · Hot Topic · Craft a furnace from eight cobblestone · Unlocks when item ID 61 (furnace) is taken from a crafting output slot. · Time to Mine!
6 · acquireIron · Acquire Hardware · Smelt an iron ingot · Unlocks when item ID 265 (iron ingot) is taken from a furnace result slot. · Hot Topic
7 · buildHoe · Time to Farm! · Craft a hoe from planks and sticks · Unlocks when any hoe is taken from a crafting output slot: wood 290, stone 291, iron 292, diamond 293, or gold 294. · Benchmarking
8 · makeBread · Bake Bread · Craft bread from wheat · Unlocks when item ID 297 (bread) is taken from a crafting output slot. · Time to Farm!
9 · bakeCake · The Lie · Craft a cake from wheat, sugar, milk, and eggs · Unlocks when item ID 354 (cake) is taken from a crafting output slot. · Time to Farm!
10 · buildBetterPickaxe · Getting an Upgrade · Craft a pickaxe better than a wooden one · Unlocks when an iron 257, stone 274, diamond 278, or gold 285 pickaxe is taken from a crafting output slot. · Time to Mine!
11 · cookFish · Delicious Fish · Catch and cook a fish · Unlocks when item ID 350 (cooked fish) is taken from a furnace result slot. · Hot Topic
12 · onARail · On A Rail · Travel by minecart at least 1 km (1,000 m) from the boarding point · Records the boarding position and uses 3D straight-line distance: dx² + dy² + dz² >= 1000000, or 1,000 m. Changing worlds resets the starting position. · Acquire Hardware
13 · buildSword · Time to Strike! · Craft a sword from planks and sticks · Unlocks when any sword is taken from a crafting output slot: iron 267, wood 268, stone 272, diamond 276, or gold 283. · Benchmarking
14 · killEnemy · Monster Hunter · Attack and kill a hostile mob · Unlocks when a hostile mob damaged by the player dies within 30 seconds. · Time to Strike!
15 · killCow · Cow Tipper · Obtain leather · Unlocks when the player picks up item ID 334 (leather). · Time to Strike!
16 · flyPig · When Pigs Fly · Ride a pig off a cliff · Unlocks on fall damage greater than 2, corresponding to a fall of more than 5 blocks, when the damaged entity is a pig carrying a player. · Cow Tipper

Normal gameplay requires parent achievements. /ach grant automatically grants any missing parents. Admin grants, revokes, and resets invalidate the current run for leaderboard eligibility.

Compatibility

Component · Requirements and Compatibility
Server · Project Poseidon based on Minecraft Beta 1.7.3
Java · Compiled for Java 8
Storage · SQLite (default) or MySQL/MariaDB
Build dependency · com.legacyminecraft.poseidon:poseidon-craftbukkit:1.1.8 (provided)

Configuration

The configuration file is plugins/BetaAchievement/config.yml.

database:

When false, achievements are kept in memory and lost on restart.

enabled: true

Storage type: sqlite or mysql.

type: sqlite
file: achievements.db

MySQL/MariaDB settings, used when type is mysql.

host: 127.0.0.1
port: 3306
database: minecraft
username: minecraft
password: change_me
table-prefix: beta_achievements_

runs:

Maximum active time for run 2 and later, in hours.

Set to 0 to disable the timeout.

repeat-timeout-hours: 12

announce:
broadcast: true
console: true

messages:
achievement-unlocked: '&6Achievement Get! &f{player} &eunlocked &f{achievement}'
no-permission: '&cYou don''t have permission.'

Achievement Runs

The first time a player joins, they receive run 1 in the READY state. When the player unlocks their first achievement, normally openInventory, the run changes to ACTIVE and starts timing. The total time is saved after all 16 achievements are completed.

After completing a run, use /ach run next to create the next run:

• Completed runs and manually abandoned runs remain in history. Active runs numbered 2 or later are deleted under the timeout rule if they are not completed within 12 hours.
• A new run starts at 0/16.
• Every run still starts timing when its first achievement is completed.
• Timing uses real server time and continues while the player is offline or the server is stopped.
• Only players who have completed at least one 16/16 run can use /ach run next and /ach run abandon.
• A READY run cannot be abandoned. An active run numbered 2 or later is deleted if it remains incomplete after 12 hours.

The leaderboard includes only COMPLETED runs, sorts them by total duration, and keeps each player's fastest run. Admin grants, revokes, and resets close the current run and remove it from leaderboard eligibility. Debug mode never writes data.

Commands

/ach is the only alias for /achievement.

Player Commands

Command · Description
/ach · View your progress in the current run
/ach run info · View elapsed time and all splits for the current run
/ach run next · Start another run after completing all achievements
/ach run abandon · Abandon an active run numbered 2 or later
/ach history · View your 10 most recent runs
/ach pb · View your personal best
/ach top [count] · View the server leaderboard, with at most 25 entries

Administrator Commands

Command · Description · Permission
/ach check · View an online player's achievement progress · betaachievement.view.others
/ach pb · View an online player's personal best · betaachievement.view.others
/ach grant · Grant one achievement and its parents; invalidates the current run · betaachievement.grant
/ach grantall · Grant all 16 achievements; invalidates the current run · betaachievement.grantall
/ach revoke · Revoke one achievement; invalidates the current run · betaachievement.revoke
/ach reset · Invalidate the current run and create a new READY run · betaachievement.reset
/ach debug · Enable achievement debug mode · betaachievement.debug
/ach debug · Disable debug mode · betaachievement.debug

The target player must be online. betaachievement.admin can replace all of the specific permissions above. If a player's data is still loading, administrative actions are queued and run in order after loading finishes.

Debug mode applies only to the administrator who ran the command. It ignores parent requirements and reports detection information when triggered, but does not write to the database or change leaderboard data.

Plugin API

Other plugins can obtain the API from the main plugin class:

BetaAchievement beta = (BetaAchievement) getServer()
.getPluginManager()
.getPlugin("BetaAchievement");
BetaAchievementApi api = beta.getApi();

The API provides cached and persistent progress queries, full-completion rank lookup, personal bests, leaderboard entries, run history, and run splits. Database reads are asynchronous, and callbacks return to the Bukkit main thread.

Public API classes are under dev.che1s.betaachievement.api. Run data classes are under dev.che1s.betaachievement.run.

For the complete configuration, command reference, and Java examples, see the full English documentation or the 简体中文文档.

Sponsorship and Support

If this project is useful to you, you can support development through Ko-fi or Afdian. Sponsors can receive help with installation, configuration, and troubleshooting.