Payout

Payout

A simple mod that allows server admins to automatically give players items at definable intervals. This mod is highly-configurable.

by
63 Downloads
forgeeconomymanagementutility
Rent Server with this Mod

About this Mod

logo

Payout

A simple mod that allows server admins to automatically give players items at definable intervals.

Introduction

Payout is a simple yet highly-configurable mod that allows server owners and admins to routinely pay items to the server's playerbase.

Configuring Payout

Payout's config is located at world/serverconfig/payout-server.toml.

What you'll see when you first open the config.

[general]
	#The item to give players
	item = "minecraft:diamond"
	#How many items to give
	#Range: 1 ~ 64
	count = 1
	#Interval in milliseconds between payouts
	#Range: 1000 ~ 9223372036854775807
	intervalMillis = 60000
	#Sound event ID to play on payout
	payoutSound = "minecraft:entity.player.levelup"
	#Volume of payout sound
	#Range: 0.0 ~ 10.0
	payoutVolume = 1.0
	#Should payout play a sound?
	playPayoutSound = true
	#Should the server send a toast packet to connected clients during payout?
	showToast = true
	#What should the title of the toast say?
	toastTitle = "You got paid!"
	#What should the title of the toast say?
	toastDescription = "Thanks for playing!"

Definitions

Name Type Required Description Default Value Example Value
item String No The item to give players. Must be a valid item ID. "minecraft:diamond" "minecraft:emerald"
count Integer No How many items to give. Range: 1 ~ 64 1 5
intervalMillis Long No Interval in milliseconds between payouts. Range: 1000 ~ 9223372036854775807 60000 (60 seconds) 120000 (2 minutes)
payoutSound String No Sound event ID to play on payout. Must be a valid sound resource location. "minecraft:entity.player.levelup" "minecraft:entity.cat.purr"
payoutVolume Float No Volume of the payout sound. Range: 0.0 ~ 10.0 1.0 0.5
playPayoutSound Boolean No Whether the payout should play a sound. true false
showToast Boolean No Whether the server should send a toast packet to connected clients during payout. true false
toastTitle String No The title text of the toast shown on payout. "You got paid!" "Daily Reward!"
toastDescription String No The description text of the toast shown on payout. "Thanks for playing!" "Come back tomorrow!"

Commands

Command Syntax Description
Set Reward Item /payout setItem <item> <quantity> Sets the item and quantity given to players on each payout.
Set Interval /payout setTime <h,m,d> <duration> Sets the payout interval using hours (h), minutes (m), or days (d).
Debug Trigger /payout debug trigger Manually triggers a payout immediately.
Debug Reset /payout debug reset Resets the config back to defaults.
Debug Config Path /payout debug config Shows the current config file path and active values.
Reload Config /payout reload Reloads the payout-server.toml config file.
Status /payout status Shows current payout settings (reward, interval, time remaining, sounds, toasts).
Set Payout Sound /payout setPayoutSound <sound_id> <volume> Sets the sound event ID and volume for payout notifications.
Toggle Sound /payout setPlayPayoutSound <true,false> Enables or disables payout sound playback.
Toggle Toasts /payout setShowToasts <true,false> Enables or disables showing toast notifications to clients.
Set Toast Title /payout setToastTitle <text> Sets the title text of the toast notification.
Set Toast Description /payout setToastDescription <text> Sets the description text of the toast notification.

Available Versions

Payout 1.0.0release
MC 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6forge
September 7, 2025

How to Install Payout on Your Server

1

Order Server

Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).

2

Set forge Loader

In the panel under "Egg", select the forge loader and matching Minecraft version (1.20.6).

3

Install Mod

Open the mod browser in the dashboard and search for "Payout". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.

Compatibility

Mod Loaders

forge

Minecraft Versions

1.20.6, 1.20.5, 1.20.4 (+3 more)

Server-side

Required

Recommended RAM

4 GB(min. 3 GB)

Frequently Asked Questions

Payout server crashes on startup – what to do?

Most common cause: wrong forge version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.20.6). You can switch loaders with one click in the panel.

Is Payout compatible with forge?

Payout officially supports forge for Minecraft 1.20.6, 1.20.5, 1.20.4. The Mado dashboard automatically detects incompatible loader combinations.

Server lagging with Payout – how to optimize performance?

Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Payout consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.

Rent Modded Server

Install Payout with just one click on your server.

Recommended RAM
4 GBab €8/mo
Min. 3 GB | +1 GB pro 8 Spieler
Create Server Now
1-Click Mod Install
NVMe SSD Storage
DDoS Protection included

Details

License
MIT License
Server-side
Required

Supported Versions

1.20.61.20.51.20.41.20.31.20.21.20.1