# Minecraft

## Connect your Minecraft 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 on **Connect a Game Server**, and choose Minecraft.
3. Enter your **server name.**

***

### 2. Choose Player Identification Method and click Add

Depending on whether your server is online or offline mode:

* **Online mode** (recommended): Select **Check UUID**
* **Offline mode**: Select **Username**

> ⚠️ Using UUID ensures more reliable player identification across name changes.

***

### 3. Download & Configure the Plugin

Tip4Serv supports the following Minecraft server types:

* Spigot
* Bukkit
* Paper
* Forge
* Fabric
* Velocity
* Bungeecord

***

### 4. Set Up the Plugin

1. Copy the **API key** provided in your server configuration panel.
2. Paste the API key into Tip4Serv plugin configuration file: `tip4serv/tip4serv.key`
3. Save the file.

***

### 5. Connect the Plugin to Tip4Serv

To **connect your Minecraft server to the Tip4Serv** store, once the plugin is installed and configured and your tip4serv.key is filled in, run the following command in your server console:

```
tip4serv connect
```

To reload the config.json file and **execute the pending commands**, run the following command:

```
tip4serv reload
```

For **Velocity** and **Bungeecord**, the command is `tip4proxy` to avoid conflicts:

```
tip4proxy connect
tip4proxy reload
```

***

### ✅ You're All Set!

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

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 Minecraft commands or commands from plugins you’ve installed on your server.

#### 📣 Broadcast

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

```bash
say Thank you {minecraft_username} for your {total_paid} {currency} donation
```

***

#### 🎁 Give Rank

Give a rank to the player ([LuckPerms ](https://www.spigotmc.org/resources/luckperms.28140/)example)

```bash
lp user {minecraft_uuid} parent add vip
```

***

#### 🧱 Give Item

**Give 5 apples to the player**

```bash
give {minecraft_username} enchanted_golden_apple 5
```

***

#### 💰 Give Money

Give 5000 money to the player account ([EssentialsX ](https://essentialsx.net/)example).

```bash
eco give {minecraft_uuid} 5000
```