
Blockfolk
NPC system
Create persistent NPCs with routes, behaviours, conversations, combat, and world interaction.
- Paper
- Java 25+
- v1.6.0
Achievements, messages, and rewards are defined in YAML. SQLite is available for a single server; MySQL can support shared tracking. Economy rewards need Vault and an economy provider.
Includes a full starter progression set with combat, utility, exploration, economy, and endgame milestone achievements
Tracks block break/place, item pickup/crafting/smelting, mob and player kills, damage dealt/taken, fishing, eating, enchanting, trading, mining, breeding, taming, death, walk distance, and play time with ANY and specific targets
Five reward types supported per achievement - items, XP, economy money (via Vault), server commands with {player} and {uuid} placeholders, and title messages - all defined directly in achievements.yml
Achievements can require other achievements to be unlocked first, enabling multi-step progression chains
Achievements can be flagged as hidden so they do not appear in the list or GUI until the player has already unlocked them
An inventory-based achievement browser with paginated display, real-time progress bars, colour-coded states (locked/unlocked/claimed), and click-to-claim reward functionality
Administrators can create new achievements interactively through a guided step-by-step chat flow without editing any YAML manually
Supports both SQLite (single-server) and MySQL (multi-server/network) with fully asynchronous load and save operations
On unlock, players receive a title and chat notification; an optional server-wide broadcast message is configurable
Unlock events trigger a configurable sound and an optional firework display at the player's location
Optional ActionBar or BossBar progress display, configurable refresh interval and display trigger
All chat output, prefixes, GUI labels, and notification text are editable in messages.yml
A full Java API (AchievementAPI) is exposed for other plugins to create achievements, query progress, grant unlocks, and add progress programmatically
Run Spigot / Paper with Java 17 or newer, built for Minecraft 1.20.4. No other plugins are required.
Stop the server, download Advanced-Achievements-1.0.3.jar, and place it in plugins/. When upgrading, replace the previous JAR.
Start the server and check the console. Review the generated configuration with the release documentation.
/ach guiOpen the achievement browser to inspect progress and claim unlocked rewards.
| Command | Description |
|---|---|
/ach | Open the paginated achievement list (same as /ach list) |
/ach list | Show all visible achievements (5 per page) |
/ach list <page> | Jump to a specific page number |
/ach list < | Go to the previous list page |
/ach list > | Go to the next list page |
/ach info <id> | Show full details for the given achievement including task, rewards, and prerequisites |
/ach progress <id> | Show your current progress and completion percentage for a specific achievement |
/ach stats | Show your overall unlock count, total achievements, and completion percentage |
/ach gui | Open the interactive inventory-based achievement browser |
/ach help | Display all available player and admin commands |
| Permission | Description | Default |
|---|---|---|
advancedachievements.use | Access to basic player commands (list, info, progress, stats, help) | true |
advancedachievements.gui | Access to /ach gui | true |
advancedachievements.claim | Ability to claim rewards from the GUI | true |
advancedachievements.admin | Access to all administrative commands | op |
advancedachievements.create | Create new achievements via /ach create | op |
advancedachievements.edit | Edit existing achievements via /ach edit | op |
advancedachievements.delete | Delete achievements via /ach delete | op |
advancedachievements.give | Give achievements to players via /ach give | op |
advancedachievements.reset | Reset player progress via /ach reset | op |
advancedachievements.setprogress | Set player achievement progress | op |
advancedachievements.resetall | Reset all achievements for a player | op |
| Key | Default | Description |
|---|---|---|
database.type | SQLite | Database backend: SQLite or MySQL |
database.sqlite.file | achievements.db | SQLite file name relative to the plugin folder |
database.mysql.* | - | MySQL host, port, database, username, password |
progress-bar.enabled | false | Show a progress bar to players |
progress-bar.type | ACTIONBAR | Display type: ACTIONBAR or BOSSBAR |
progress-bar.boss-bar.color | GREEN | BossBar colour (used when type is BOSSBAR) |
progress-bar.boss-bar.style | SOLID | BossBar style (e.g., SOLID, SEGMENTED_6) |
progress-bar.update-interval | 20 | Update interval in ticks (20 ticks = 1 second) |
progress-bar.show-on-progress | false | Only show bar when progress increases |
notifications.sound.enabled | true | Play sound on achievement unlock |
notifications.sound.sound | ENTITY_PLAYER_LEVELUP | Bukkit sound name |
notifications.sound.volume | 1.0 | Sound volume |
notifications.sound.pitch | 1.0 | Sound pitch |
notifications.title.enabled | true | Show title/subtitle on achievement unlock |
notifications.title.fade-in | 10 | Title fade-in duration in ticks |
notifications.title.stay | 70 | Title stay duration in ticks |
notifications.title.fade-out | 20 | Title fade-out duration in ticks |
notifications.chat.enabled | true | Send chat message on unlock |
notifications.chat.broadcast | false | Broadcast unlock to all online players |
notifications.firework.enabled | true | Spawn a firework on achievement unlock |
gui.rows | 6 | Number of inventory rows in the GUI (max 6) |
gui.items-per-page | 45 | Achievements shown per GUI page |
gui.auto-refresh | true | Automatically refresh the GUI for open players |
gui.refresh-interval | 60 | GUI auto-refresh interval in seconds |
defaults.icon | PAPER | Default icon material for new achievements |
| Task Type ID | Tracks | Valid target Values |
|---|---|---|
block_break | Breaking blocks | ANY, or any block material (e.g., OAK_LOG, STONE) |
block_place | Placing blocks | ANY, or any block material |
item_pickup | Picking up items | ANY, LOG (all log/wood types), or any item material name |
mob_kill | Killing entities | ANY, HOSTILE (any monster), or any entity type (e.g., ZOMBIE) |
player_kill | Killing players | ANY, or specific player name |
item_craft | Crafting items | ANY, or any craftable material name |
item_smelt | Smelting output collection | ANY, or smelted output item material (e.g., IRON_INGOT) |
fishing | Catching fish or items | ANY, or any caught item material name |
eating | Consuming food | ANY, or any food material name |
enchanting | Enchanting items | ANY (individual item target not tracked) |
trading | Completing villager trades | ANY (individual item target not tracked) |
mining | Mining ores | ANY, or any ore material name containing _ORE |
damage_dealt | Dealing combat damage | ANY, or entity type name |
damage_taken | Taking incoming damage | ANY, or damage cause (e.g., FALL, LAVA, ENTITY_ATTACK) |
walk_distance | Travel distance | ANY, or world name (stored as centi-blocks) |
play_time | Online play time | ANY, or world name (stored in seconds) |
breeding | Breeding animals | ANY, or any breedable entity type (e.g., COW) |
taming | Taming animals | ANY, or any tameable entity type (e.g., WOLF) |
death | Dying | ANY, or a specific player name to track per-player deaths |
| Format | Description | Example |
|---|---|---|
ITEM:<material>:<amount> | Give the player an item | ITEM:DIAMOND:5 |
XP:<amount> | Give XP experience points | XP:500 |
EXPERIENCE:<amount> | Alias for XP | EXPERIENCE:100 |
MONEY:<amount> | Give economy money via Vault | MONEY:1000 |
COMMAND:<command> | Execute a console command | COMMAND:give {player} golden_apple 1 |
TITLE:<text> | Send a title message to the player | TITLE:Master Crafter |
<material>:<amount> | Shorthand item reward | BREAD:5 |
Advanced Achievements v1.0.3
Advanced Achievements v1.0.3 updates achievement and progress handling for current Paper APIs.
Bug reports, questions, and contributions go to this plugin’s GitHub repository.