> For the complete documentation index, see [llms.txt](https://vanillasmp.gitbook.io/vanillasmp-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://vanillasmp.gitbook.io/vanillasmp-docs/documentation/getting-started/publish-your-docs.md).

# Player Progression

The more advancements you complete, the more privileges you gain.

Welcome! This plugin links your **Minecraft advancement progress** to a rank system and unlocks new commands as your achievement progress grows.

### ✨ What is this plugin

`AchievementRanks` calculates your personal progress based on available advancements and gives you rank badges and permissions.

* ✅ Rank is based on done advancements (excluding some technical/root/recipe advancements)
* 🔄 Synchronized with Discord Roles (Player with roles focused on side panel)
* 🧾 Special In-Game prefix in Tab and Chat

### 🏆 Advancements unlocks

{% stepper %}
{% step %}

### 10% — <mark style="color:$info;">`Exp`</mark>

* <mark style="color:$danger;">`Compass`</mark> shift+rclick shows your advancement progress and current rank.
* <mark style="color:$danger;">`Stick`</mark> shift+rclick shows block interaction history
* <mark style="color:$danger;">`Spyglass`</mark> zoom + press left zoom more
  {% endstep %}

{% step %}

### 20% — `Adv`

* <mark style="color:$danger;">`Pickaxe`</mark> rclick shows time and count until block breaks
* <mark style="color:red;">`Axe`</mark> rclick glows whole tree, also under leaves
* <mark style="color:$success;">`/spit [player]`</mark> — Shoot a projectile for fun/teasing.
  {% endstep %}

{% step %}

### 30% — <mark style="color:$primary;">`Pro`</mark>

* <mark style="color:$danger;">`Food`</mark> shift + rclick breed many nearby animals at once
* <mark style="color:$danger;">`Pickaxe`</mark> if mine much time more breaking particles and cleaner break sound
* <mark style="color:$success;">`/quests`</mark> - dont need lantern to open quests, command access
* <mark style="color:$success;">`/frog [player]`</mark> — Spawn a frog at your location (or near another player).
* <mark style="color:$success;">`/sit`</mark> - Sit anywhere you want
  {% endstep %}

{% step %}

### 40% — <mark style="color:blue;">`Plat`</mark>

* <mark style="color:$success;">`/foodbook`</mark> - dont need Food Book to open food stats, command access
* <mark style="color:$success;">`/nightvision`</mark> — Toggle Night Vision for 10 min (once a 6 hours)
* <mark style="color:$success;">`/whello`</mark> (set join message)
* <mark style="color:$success;">`/lay`</mark> - Lay down anywhere you want
  {% endstep %}

{% step %}

### 50% — <mark style="color:$success;">`Veteran`</mark>

* <mark style="color:$success;">`/feed`</mark> — Restores hunger (once a 6 hours)
* <mark style="color:$success;">`/glow`</mark> — Toggle Glowing outline.
* <mark style="color:$success;">`/falldamage on|off`</mark> — Toggles fall damage cancel for you in spawn radius.
* <mark style="color:$success;">`/crawl`</mark> — Crawl on a Block
* <mark style="color:$success;">`/toolstat`</mark> - Toggle tool/armor tooltip repair count
  {% endstep %}

{% step %}

### 60% — <mark style="color:orange;">`Champion`</mark>

* <mark style="color:$success;">`/home`</mark> — Teleport to bed (once a 6 hours)
* <mark style="color:$success;">`/pvp on|off`</mark> — Controls whether you allow PvP from/to you in spawn radius.
* <mark style="color:$success;">`/heal`</mark> — Restores health and food for 10 min (once a 6 hours)
* <mark style="color:$success;">`/spin`</mark> — Spin on a Block
* <mark style="color:$success;">`/toolage`</mark> - Toggle tool/armor tooltip info age (how much time ago item created/found)
  {% endstep %}

{% step %}

### 70% — [*<mark style="color:purple;">**`Hero`**</mark>*](#user-content-fn-1)[^1]

* `/near` — Show nearby players in 50 blocks.
* <mark style="color:$success;">`/bellyflop`</mark> — BellyFlop on a Block
* <mark style="color:$success;">`/hologram`</mark> - Create float text (maximum 5 in the world)
* <mark style="color:$success;">`/toolowner`</mark> - Toggle tool/armor tooltip info owner (who made or found item first)
* <mark style="color:$success;">`/getpot`</mark> - Every 24 hour random free LootPot (red or purple)
  {% endstep %}

{% step %}

### 80% — *<mark style="color:yellow;">**`Legend`**</mark>*

* <mark style="color:$danger;">`Shulker`</mark> - Shift+rclick in the arm opens box immediately
* <mark style="color:purple;">`Playtime rewards`</mark> increased X2
* <mark style="color:$success;">`/hat`</mark> — Put held block as helmet.
  {% endstep %}

{% step %}

### 90% — *<mark style="color:$success;">**`End`**</mark>*

* <mark style="color:$success;">`/particle [type]`</mark> — Spawn particles around you for 10 min (once a 6 hours).
* <mark style="color:$success;">`/wec`</mark> — Opens your ender chest.
* <mark style="color:$success;">`/craft`</mark> — Opens a crafting grid.
  {% endstep %}

{% step %}

#### 100% — *<mark style="color:$danger;">**Asc**</mark>*

* <mark style="color:purple;">**`World`**</mark>  — Generates your personal 100x100 world, no access for others
  {% endstep %}
  {% endstepper %}

### 🛠️ Tips & Lifehacks 💡

1. Use `/astat` often — it’s the fastest way to know exactly how many advancements remain.
2. Use `/whello %player%` so your name is shown automatically in welcome text.
3. Need to test PvP safely? Turn on `/pvp off` and `/falldamage on` in spawn.
4. For chat visibility, set bright color with `/color GOLD` (or any valid color name).
5. Use `/near 50` for quick local scouting when searching teammates.
6. If `/pack` failed many times, wait for cooldown and try again later — it is chance-based.

### ⚙️ Player FAQ

<details>

<summary><strong>Q: Why I don’t have command though I already played a lot?</strong></summary>

A: Progress recalculates on join, when an advancement is completed, and every 5 minutes by default.

</details>

<details>

<summary><strong>Q: Can I set /home again after set?</strong></summary>

A: Not in default config: `/sethome` is one-time by default for players.

</details>

<details>

<summary><strong>Q: What happens with <code>/whello</code>?</strong></summary>

A: It is sent automatically on join replacing `{player}` / `%player%` with your name.

</details>

<details>

<summary><strong>Q: Why some permissions mention other plugins (<code>GSit</code>, <code>CoreProtect</code>, etc.)?</strong></summary>

A: Those are optional integrations defined in ranks; actual availability depends on your server plugins.

</details>

[^1]: