> For the complete documentation index, see [llms.txt](https://docs.tip4serv.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tip4serv.com/games/scum.md).

# Scum

Connect and monetize your SCUM server. The Tip4Serv mod checks whether a player has donated, then automatically delivers their order (items, vehicles, fame points, money)

#### Connect your SCUM Server

**1. Make sure UE4SS is installed**

Tip4Serv requires **UE4SS Experimental v3.0.1-946** to work.

Use this exact build. Newer experimental builds (tested: 1161 and 1196) crash the server as soon as a player joins, and the stable UE4SS v3.0.1 does not use the `ue4ss` folder layout required here. Tested on SCUM 1.3.5.2.

{% hint style="info" %}
Already have UE4SS on your SCUM server? If `dwmapi.dll` in `SCUM\Binaries\Win64\` is **61,952 bytes**, skip to step 5 to check its settings. Otherwise, follow all steps below to replace it.
{% endhint %}

1. Download [Win64.zip](https://github.com/herbie96x/SCUM-AllowMods/releases/download/v0.1.0/Win64.zip), a bundle that includes UE4SS v3.0.1-946. Ignore its `INSTALL.txt`: it is written for game clients, and **you do not need to disable BattlEye**.
2. Unzip the downloaded file.
3. Open the extracted folder, then **copy the `ue4ss` folder and the `dwmapi.dll` file** into your server’s `SCUM\Binaries\Win64\` folder.
4. Delete the `ue4ss\Mods\scum_allow_mods` folder
5. Open `ue4ss\Mods\mods.txt` and set this line to `0`:

```
scum_allow_mods : 0
```

5. Open `ue4ss\UE4SS-settings.ini` and, in the `[Hooks]` section, set these two lines to `1`. Leave all the other `Hook` lines at `0`.

```ini
HookEngineTick = 1
HookUObjectProcessEvent = 1
```

Reboot your server and wait for it to load.

***

**2. Connect Your SCUM Server to Tip4Serv**

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 **SCUM**.
3. Enter your **server name,** then continue and **follow the instructions provided**.

The instructions install two parts:

* the **Tip4Serv plugin** (`Tip4Serv` folder), which fetches purchases from your store;
* **Tip4ServRcon** (`Tip4ServRcon` folder), which lets the plugin run the delivery commands **without an admin online**.

***

#### Configure Automatic Reward Delivery

Next, you’ll need to configure the console commands that the Tip4Serv mod 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.

Commands are regular **SCUM admin commands**, written exactly as an admin would type them in chat (the leading `#` is optional). `{steam_id}` is automatically replaced with the buyer's SteamID.

Set the command state to **"Must be online"** for anything that gives something to the player. The command waits until the buyer is connected, then is delivered automatically.

You’ll find some examples below.

**📣 Broadcast**

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

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

🎁 **Give Item, Vehicle**

You can retrieve the item IDs here: <https://www.bisecthosting.com/blog/scum-console-commands-admin-item-ids-spawn-items>

**Give 5 bottles of water to the player.**

```
SpawnItem Water_05l 5 Location {steam_id}
```

**Spawn a Wolfswagen car next to the player.**

```
SpawnVehicle BPC_Wolfswagen {steam_id}
```

Items are dropped **on the ground at the player's feet** (this is how SCUM spawns items), not directly in the inventory.

**Complete weapons** (e.g. AK-47) are blocked by SCUM itself when spawned by an admin. Sell ammunition, parts and attachments instead, or give in-game money so the player can buy their weapon from a trader.

⭐ **Give Fame Points**

**Add 1000 fame points to the player.**

```
ChangeFamePoints 1000 {steam_id}
```

💰 **Give Money, Gold**

The currency type is **required** before the amount: `Normal` (money, credited to the player's bank account) or `Gold`.

**Add 1000 money to the player's bank account.**

```
ChangeCurrencyBalance Normal 1000 {steam_id}
```

**Add 10 gold to the player.**

```
ChangeCurrencyBalance Gold 10 {steam_id}
```

#### How it work?​

Players can type the command `!webstore` (or `!store`) in the in-game chat to see the link to the store and their **SteamID**.

When making a purchase, the player simply enters this **SteamID** in the Tip4Serv checkout.

Once the payment is completed, the purchased product is **automatically delivered directly to the player in-game**.

**Mod configuration**

The `config.json` file allows you to customize the Tip4Serv SCUM mod, including messages, delays, your store URL, and other options.

```json
{
  "interval": 1,
  "command_delay": 1,
  "messageSuccess": "[Tip4Serv] You have just received your purchase, thank you!",
  "storeLink": "https://tip4serv.com",
  "storeMessage": "Link to the store: {storeLink}"
}
```

**Configuration options:**

* `interval` — How often the mod checks Tip4Serv for new purchases to deliver, in minutes.
* `command_delay` — Delay between the execution of delivery commands, in seconds (minimum 1).
* `messageSuccess` — Message displayed to the player after their purchase has been successfully delivered.
* `storeLink` — URL of your Tip4Serv store.
* `storeMessage` — Message displayed when a player uses the `!webstore` command. Use `{storeLink}` to automatically insert your store URL.
