# Results

There are a few results you can use. A detailed list is given on this page.

### Send a message to the player

Send a message to the player (only they are able to see it).

Result name: `message`

{% hint style="info" %}
You can use the *\&p* to replace it with the name of the player.
{% endhint %}

|  Example usage  |       Explanation       |
| :-------------: | :---------------------: |
| 'Great job \&p' | Great job *player name* |

### Perform a command

Perform a command

Result name: `command`

{% hint style="info" %}
You can use the *\&p* to replace it with the name of the player.
{% endhint %}

| Example usage |   Explanation   |
| :-----------: | :-------------: |
|    kill \&p   | Kill the player |

### Play a client-side effect

Show a particle effect at the player's position

Result name: `effect`

{% hint style="info" %}
For a list of effects, see [this page](https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Effect.html).
{% endhint %}

|     Example usage    |               Explanation              |
| :------------------: | :------------------------------------: |
|     STEP\_SOUND;8    | Make the sound of flowing water (id 8) |
| BREWING\_STAND\_BREW |     Make the sound of brewing stand    |

### Teleport the player to a location

Teleport the player to a specific location

Result name: `tp`

{% hint style="info" %}
&#x20;The syntax requires an x, y, z position and a world name. **Yaw and pitch are optional.**
{% endhint %}

|      Example usage      |                                Explanation                                |
| :---------------------: | :-----------------------------------------------------------------------: |
|   0;0;0;world\_nether   |               Teleport the player to 0,0,0 in world\_nether               |
| 1;2;3;world\_nether;1;1 | Teleport the player to a location in world\_nether, with a yaw and pitch. |

### Play firework at the player's location

Play any type of firework at the player's location

Result name: `firework`

{% hint style="info" %}
&#x20;Types of fireworks can be found [here](https://hub.spigotmc.org/javadocs/spigot/org/bukkit/FireworkEffect.Type.html). Colors or RGB can be found [here](https://www.rapidtables.com/web/color/RGB_Color.html).
{% endhint %}

|      Example usage      |                                                                Explanation                                                               |
| :---------------------: | :--------------------------------------------------------------------------------------------------------------------------------------: |
| player;2;STAR;164;23;23 | Show fireworks at the current player, with power 2, and of type STAR. It has the color with R=164, G=23 and B=23 (color is sort of red). |

### Give money

Reward a player with money

Result name: `money`

{% hint style="info" %}
&#x20;You will need to install an economy plugin and Vault.
{% endhint %}

| Example usage |                      Explanation                      |
| :-----------: | :---------------------------------------------------: |
|      500      | Give the player 500 money (in your server's currency) |


---

# Agent Instructions: 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:

```
GET https://autorank.staartvin.com/path-configuration/building-your-own-paths/results.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
