# Hytale

### Connect your Hytale Server

#### 1. Add Your Game Server

1. Navigate to the [**My Servers**](https://tip4serv.com/dashboard/my-servers) section of your Tip4Serv dashboard.
2. Click **Connect a Game Server**, and choose **Hytale**.
3. Enter your **server name,** then continue and **follow the instructions provided**.

***

#### 2. Set Up the Plugin on your Hytale Server

1. Download the Tip4Serv plugin, unzip and drag & drop into the `/mods`  folder.
2. Replace **YOUR\_SECRET\_KEY** by the **key** provided in [My Servers](https://tip4serv.com/dashboard/my-servers).
3. Paste the API key into the Tip4Serv plugin configuration file: `mods/data/tip4serv/config.json`
4. Save the file.
5. Restart the Hytale server and check your console

{% hint style="info" %}
Link to the github: <https://github.com/Tip4Serv/hytale-donation>
{% endhint %}

***

#### 3. Make sure the Plugin is connected to Tip4Serv

**The server is successfully connected** once you restart it and see the following message in your Hytale server console:

```txt
[Tip4Serv] Tip4Serv is now connected!
```

#### ✅ You're All Set! <a href="#youre-all-set" id="youre-all-set"></a>

Your server is now ready to receive donations via Tip4Serv. Players will be automatically recognized and rewarded based on your configuration.

***

#### Configure commands to be executed after purchase <a href="#configure-commands-to-be-executed-after-purchase" id="configure-commands-to-be-executed-after-purchase"></a>

Next, you’ll need to configure the console commands that the Tip4Serv plugin should execute after each successful purchase.

This is done directly through the [**Command Editor**](https://docs.tip4serv.com/store-setup/server-commands) in your Tip4Serv dashboard, under each product.

You’ll find some examples below, but feel free to use any standard Hytale commands or commands from plugins you’ve installed on your server.

**📣 Broadcast**

Send a public thank-you message in the server chat.

```
say A big thank you to {hytale_username} for their donation of {total_paid} {currency}
```

Display an event title on the player screen.

```
eventtitle --title "You receive your order" --secondary "WebShop"
```

🎁 **Give Item**

**Give 5 pie apple to the player.**

```
give {hytale_username} Food_Pie_Apple --quantity {quantity}
```


---

# 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://docs.tip4serv.com/games/hytale.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.
