> For the complete documentation index, see [llms.txt](https://troxlabs.gitbook.io/gearevolution/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://troxlabs.gitbook.io/gearevolution/editor-and-visual-effects.md).

# Editor & Visual Effects

***

### 🛠️ 1. How to use `/gevo editor`

Type the command to see all your items.

* **Left Click:** Edit the item.
* **Right Click:** Delete it.
* ~~**Shift + Click:** Clone it. This is great if you want to make a set of items quickly.~~

***

### 📈 2. Managing Levels

You can add as many levels as you want. For each level, you can set:

* **XP needed:** How much the player must mine or kill.
* **The Reward:** Exactly what they get. The editor saves **everything** (names, enchants, NBT).
  * **Commands:** Make the server run a command when they level up.
    * *Example:* `broadcast %player% just reached Level 10!`

***

### ✨ 3. Cool Upgrade Effects (VFX)

Make level-ups look epic! You can pick from many animations:

* **RAINBOW\_CIRCLE:** A colorful spinning ring.
* **PHOENIX\_ANIMATION:** Fire wings and particles.
* **SOUL\_SPIRAL:** A dark, spooky effect.
* **MAGIC\_BURST / BOOM:** Big particle explosions.
* **AURA:** A glowing light that goes up.

***

### ⚔️ 4. How Gear gains XP

The plugin knows what tool you are using and gives XP correctly:

* **Swords & Axes:** Fighting mobs.
* **Mace:** Big bonus for smash attacks from high up.
* **Spear:** Throwing or charging at enemies.
* **Pickaxe, Shovel, Hoe:** Mining and farming.
* **Brush:** Using it on suspicious sand or gravel.
* **Bow, Crossbow, Trident:** Shooting or throwing.

***

### 🛡️ 5. Anti-Exploit

We make sure players don't cheat. If a player places a block and then breaks it, they get **zero XP**. This stops people from farming XP by placing and breaking the same block over and over.

***

> \[!IMPORTANT] The editor saves items exactly as they are in your hand. This includes custom models and textures!


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://troxlabs.gitbook.io/gearevolution/editor-and-visual-effects.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.