🚀 Getting Started

📋 Requirements

Requirement	Version
🖥 Server	Paper 1.21+ (or forks like Purpur)
☕ Java	Java 21 or newer
📦 Optional	Vault (for economy rewards)
📦 Optional	PlaceholderAPI (for placeholders)

Note: This plugin is built for Paper and uses Paper specific APIs. Spigot is not supported.

---

📦 Installation

1. Download the CustomAchievements1653.jar file

2. Place it in your server's plugins/ folder

3. Restart the server (do not use /reload)

4. The plugin will generate:

   • plugins/CustomAchievements1653/config.yml

   • plugins/CustomAchievements1653/advancements.yml

   • plugins/CustomAchievements1653/lang/ (with 21 language files)

   • plugins/CustomAchievements1653/data/ (SQLite database)

---

⚡ First Steps

1. Choose your language

Open config.yml and set your preferred language:

language: de_DE

Available languages: en_US, de_DE, nl_NL, es_ES, fr_FR, pt_BR, ar_SA, cs_CZ, tr_TR, pl_PL, ru_RU, it_IT, ko_KR, hu_HU, ja_JP, zh_CN, vi_VN, sv_SE, sk_SK, hi_IN, id_ID

2. Choose your message format

message-format: LEGACY

Options:

• LEGACY - Uses &a, &c, &6, &#RRGGBB color codes

• MINI_MESSAGE - Uses <red>, <green>, <gradient:red:blue> MiniMessage tags

3. Open the GUI

In game, type /ca gui to open the advancement browser GUI.

4. Create your first advancement

Either edit advancements.yml directly, or use the admin GUI with /ca admin.

5. Reload

After making changes, use /ca reload to apply them without restarting.

---

📁 File Structure

plugins/CustomAchievements1653/
├── config.yml              # Main configuration
├── advancements.yml        # All advancements and categories
├── lang/                   # Language files
│   ├── en_US.yml
│   ├── de_DE.yml
│   ├── ... (21 files)
└── data/
    └── customachievements.db  # SQLite database (if using SQLite)

---