Polymart is now Voxel Shop! We're upgrading many features of the site, and during this open beta you will experience occasional bugs. Learn more
✨ The ultimate custom advancements plugin for Minecraft ✨
📖 Description
CustomAchievements1653 is a fully customizable advancements plugin for Paper 1.21+ servers. Create your own advancement system with over 300 trigger types, combinable conditions, vanilla GUI integration, configurable rewards, and much more.
Players can track their progress in the Minecraft advancement GUI, receive toast notifications, and earn custom rewards including money, items, XP, effects, sounds, titles, and more.
📋 Requirements
✨ Features
📦 Installation
[LIST=1]📥 Download CustomAchievements1653.jar📂 Place in your server's plugins/ folder🔄 Restart the server⚙ Configure in plugins/CustomAchievements1653/config.yml🏆 Create advancements in advancements.yml or via /ca admin
[/LIST]
💻 Commands
| /ca gui | Open the advancement GUI | customachievements.gui |
| /ca list [category] | List advancements | customachievements.use |
| /ca info | Show advancement details | customachievements.use |
| /ca progress [player] | Show progress | customachievements.use |
| /ca help | Show help menu | customachievements.use |
| /ca admin | Open admin GUI | customachievements.admin |
| /ca reload | Reload configuration | customachievements.admin.reload |
| /ca grant | Grant advancement | customachievements.admin.grant |
| /ca revoke | Revoke advancement | customachievements.admin.revoke |
| /ca reset | Reset progress | customachievements.admin.reset |
Aliases: /ca, /cach, /achievements
🔑 Permissions
| customachievements.use | Basic usage (list, info, progress) | true |
| customachievements.gui | Open the achievements GUI | true |
| customachievements.admin | Full admin access | op |
| customachievements.admin.create | Create advancements via GUI | op |
| customachievements.admin.reload | Reload configuration | op |
| customachievements.admin.grant | Grant advancements | op |
| customachievements.admin.revoke | Revoke advancements | op |
| customachievements.admin.reset | Reset progress | op |
🎯 Trigger Types (300+)
Many triggers are generic — you specify the block/entity/item type in config. For example, use ORE_MINE with material: DIAMOND_ORE instead of a specific trigger.
🔗 Conditions System
Combine multiple conditions with any trigger. All conditions must be true at the same time.
[SPOILER="Condition Examples"]
State Conditions: falling, sprinting, sneaking, swimming, flying, gliding, climbing, on ground, in water, in lava, in rain, burning, riding, sleeping, min/max health, min/max food, min/max level, equipment requirements (main hand, off hand, helmet, chestplate, leggings, boots), time of day
Location Conditions: specific world, point + radius, region box (min/max x/y/z), height range
World Conditions: dimension (NORMAL, NETHER, THE_END), biome, biome list, storm, thunder, clear weather, specific world name
Chat Filters: exact text, contains text, regex pattern
Command Filters: specific command name
Example: Eat golden apple while falling in the Nether at night with low health
trigger:
type: EAT_ITEM
amount: 1
material: GOLDEN_APPLE
conditions:
falling: true
max-health: 6.0
daytime: false
world:
dimension: NETHER
⚙ Configuration Example
Config
# Prefix for all plugin messages
prefix: "&8[&6CustomAchievements1653&8] &r"
# Language setting
language: en_US
# Message format: LEGACY or MINI_MESSAGE
message-format: LEGACY
# Database
database:
type: SQLITE
mysql:
host: localhost
port: 3306
database: customachievements
username: root
password: ""
# Auto-save interval in minutes
auto-save-interval: 5
# Toast notifications
toast:
enabled: true
default-frame: TASK
# BossBar
bossbar:
enabled: true
duration: 5
color: GREEN
# ActionBar
actionbar:
enabled: true
duration: 3
# Chat notifications
chat:
broadcast-completion: true
show-progress-updates: true
# Title on completion
title:
enabled: true
fade-in: 10
stay: 70
fade-out: 20
# Sounds
sound:
completion-sound: ENTITY_PLAYER_LEVELUP
progress-sound: ENTITY_EXPERIENCE_ORB_PICKUP
# Effects on completion
effects:
enabled: true
firework: true
particles: true
# Performance
performance:
distance-check-interval: 10
time-check-interval: 20
debug: false
Advancement Example
advancements:
fallschirm-snack:
name: "&e&lParachute Snack"
description: "Eat a golden apple while falling"
icon: GOLDEN_APPLE
frame: CHALLENGE
category: abenteuer
trigger:
type: EAT_ITEM
amount: 1
material: GOLDEN_APPLE
conditions:
falling: true
rewards:
xp: 200
money: 500.0
title: "&e&lParachute Snack!"
subtitle: "&7How did you eat that?!"
sound: UI_TOAST_CHALLENGE_COMPLETE
firework-enabled: true
🌍 Supported Languages
🇬🇧 English · 🇩🇪 German · 🇳🇱 Dutch · 🇪🇸 Spanish · 🇫🇷 French · 🇧🇷 Portuguese · 🇸🇦 Arabic · 🇨🇿 Czech · 🇹🇷 Turkish · 🇵🇱 Polish · 🇷🇺 Russian · 🇮🇹 Italian · 🇰🇷 Korean · 🇭🇺 Hungarian · 🇯🇵 Japanese · 🇨🇳 Chinese · 🇻🇳 Vietnamese · 🇸🇪 Swedish · 🇸🇰 Slovak · 🇮🇳 Hindi · 🇮🇩 Indonesian
Custom languages can be created by adding files to the lang/ folder.
💬 Support
Support is only available via Discord.
Please do not request support in the reviews.
Discord (Support)
Made with ❤ by Jan1653