Gameplay

Advanced Achievements

Give player progress a purpose.

Create milestones with claimable rewards, linked prerequisites, and persistent player progress.

  • Spigot / Paper
  • Minecraft 1.20.4
  • Java 17+
  • MIT

What it does

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.

  • 30 Predefined Achievements
  • 19 Task Types
  • Reward System
  • Achievement Prerequisites

Features

  • 30 Predefined Achievements

    Includes a full starter progression set with combat, utility, exploration, economy, and endgame milestone achievements

  • 19 Task Types

    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

  • Reward System

    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

  • Achievement Prerequisites

    Achievements can require other achievements to be unlocked first, enabling multi-step progression chains

  • Hidden Achievements

    Achievements can be flagged as hidden so they do not appear in the list or GUI until the player has already unlocked them

  • Interactive GUI

    An inventory-based achievement browser with paginated display, real-time progress bars, colour-coded states (locked/unlocked/claimed), and click-to-claim reward functionality

  • Chat Creation Wizard

    Administrators can create new achievements interactively through a guided step-by-step chat flow without editing any YAML manually

  • Database Integration

    Supports both SQLite (single-server) and MySQL (multi-server/network) with fully asynchronous load and save operations

  • Broadcast Notifications

    On unlock, players receive a title and chat notification; an optional server-wide broadcast message is configurable

  • Sound and Firework Effects

    Unlock events trigger a configurable sound and an optional firework display at the player's location

  • Progress Bar Display

    Optional ActionBar or BossBar progress display, configurable refresh interval and display trigger

  • Fully Customisable Messages

    All chat output, prefixes, GUI labels, and notification text are editable in messages.yml

  • Developer API

    A full Java API (AchievementAPI) is exposed for other plugins to create achievements, query progress, grant unlocks, and add progress programmatically

Installation

  1. 1

    Check your server

    Run Spigot / Paper with Java 17 or newer, built for Minecraft 1.20.4. No other plugins are required.

  2. 2

    Add the JAR

    Stop the server, download Advanced-Achievements-1.0.3.jar, and place it in plugins/. When upgrading, replace the previous JAR.

  3. 3

    Start and configure

    Start the server and check the console. Review the generated configuration with the release documentation.

First command
/ach gui

Open the achievement browser to inspect progress and claim unlocked rewards.

Commands10

CommandDescription
/achOpen the paginated achievement list (same as /ach list)
/ach listShow 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 statsShow your overall unlock count, total achievements, and completion percentage
/ach guiOpen the interactive inventory-based achievement browser
/ach helpDisplay all available player and admin commands

Permissions11

PermissionDescriptionDefault
advancedachievements.useAccess to basic player commands (list, info, progress, stats, help)true
advancedachievements.guiAccess to /ach guitrue
advancedachievements.claimAbility to claim rewards from the GUItrue
advancedachievements.adminAccess to all administrative commandsop
advancedachievements.createCreate new achievements via /ach createop
advancedachievements.editEdit existing achievements via /ach editop
advancedachievements.deleteDelete achievements via /ach deleteop
advancedachievements.giveGive achievements to players via /ach giveop
advancedachievements.resetReset player progress via /ach resetop
advancedachievements.setprogressSet player achievement progressop
advancedachievements.resetallReset all achievements for a playerop

Configuration51

Show all 51 settings
KeyDefaultDescription
database.typeSQLiteDatabase backend: SQLite or MySQL
database.sqlite.fileachievements.dbSQLite file name relative to the plugin folder
database.mysql.*-MySQL host, port, database, username, password
progress-bar.enabledfalseShow a progress bar to players
progress-bar.typeACTIONBARDisplay type: ACTIONBAR or BOSSBAR
progress-bar.boss-bar.colorGREENBossBar colour (used when type is BOSSBAR)
progress-bar.boss-bar.styleSOLIDBossBar style (e.g., SOLID, SEGMENTED_6)
progress-bar.update-interval20Update interval in ticks (20 ticks = 1 second)
progress-bar.show-on-progressfalseOnly show bar when progress increases
notifications.sound.enabledtruePlay sound on achievement unlock
notifications.sound.soundENTITY_PLAYER_LEVELUPBukkit sound name
notifications.sound.volume1.0Sound volume
notifications.sound.pitch1.0Sound pitch
notifications.title.enabledtrueShow title/subtitle on achievement unlock
notifications.title.fade-in10Title fade-in duration in ticks
notifications.title.stay70Title stay duration in ticks
notifications.title.fade-out20Title fade-out duration in ticks
notifications.chat.enabledtrueSend chat message on unlock
notifications.chat.broadcastfalseBroadcast unlock to all online players
notifications.firework.enabledtrueSpawn a firework on achievement unlock
gui.rows6Number of inventory rows in the GUI (max 6)
gui.items-per-page45Achievements shown per GUI page
gui.auto-refreshtrueAutomatically refresh the GUI for open players
gui.refresh-interval60GUI auto-refresh interval in seconds
defaults.iconPAPERDefault icon material for new achievements
Task Type IDTracksValid target Values
block_breakBreaking blocksANY, or any block material (e.g., OAK_LOG, STONE)
block_placePlacing blocksANY, or any block material
item_pickupPicking up itemsANY, LOG (all log/wood types), or any item material name
mob_killKilling entitiesANY, HOSTILE (any monster), or any entity type (e.g., ZOMBIE)
player_killKilling playersANY, or specific player name
item_craftCrafting itemsANY, or any craftable material name
item_smeltSmelting output collectionANY, or smelted output item material (e.g., IRON_INGOT)
fishingCatching fish or itemsANY, or any caught item material name
eatingConsuming foodANY, or any food material name
enchantingEnchanting itemsANY (individual item target not tracked)
tradingCompleting villager tradesANY (individual item target not tracked)
miningMining oresANY, or any ore material name containing _ORE
damage_dealtDealing combat damageANY, or entity type name
damage_takenTaking incoming damageANY, or damage cause (e.g., FALL, LAVA, ENTITY_ATTACK)
walk_distanceTravel distanceANY, or world name (stored as centi-blocks)
play_timeOnline play timeANY, or world name (stored in seconds)
breedingBreeding animalsANY, or any breedable entity type (e.g., COW)
tamingTaming animalsANY, or any tameable entity type (e.g., WOLF)
deathDyingANY, or a specific player name to track per-player deaths
FormatDescriptionExample
ITEM:<material>:<amount>Give the player an itemITEM:DIAMOND:5
XP:<amount>Give XP experience pointsXP:500
EXPERIENCE:<amount>Alias for XPEXPERIENCE:100
MONEY:<amount>Give economy money via VaultMONEY:1000
COMMAND:<command>Execute a console commandCOMMAND:give {player} golden_apple 1
TITLE:<text>Send a title message to the playerTITLE:Master Crafter
<material>:<amount>Shorthand item rewardBREAD:5

Release notes

Advanced Achievements v1.0.3

Advanced Achievements v1.0.3 updates achievement and progress handling for current Paper APIs.

Questions or an issue?

Bug reports, questions, and contributions go to this plugin’s GitHub repository.

Open an issue