Skip to main content

Servers and RCON Connection

RCON (Remote Console) is the protocol Tirify uses to send commands to a game server. When a player purchases a product, the system issues an RCON command to the server and the player receives the item instantly.

How to connect a server​

  1. Admin panel → your store → Servers → "Add server"

  2. Fill in:

    • Server name — how it appears on the storefront
    • IP address — public IP of the game server
    • Game Port — the port players connect to (not RCON!)
    • RCON Port — the RCON port (usually game port + 1, or a dedicated port)
    • RCON Password — password from the server configuration

  3. Save. The system will verify the connection.

Plugin installation​

Rust servers require the TirifyRUST plugin (C# Oxide plugin).

Installation steps​

  1. Download TirifyRUST.cs from the admin panel (Servers → "Download plugin")
  2. Place it in the oxide/plugins/ folder on your server
  3. In the plugin config, set: 
    ApiUrl: https://api.tirify.shop
    StoreId: <your store ID>
    RconSecret: <secret key from admin panel>
  4. Reload the plugin: oxide.reload TirifyRUST

What the plugin does​

  • Handshake — registers the server with Tirify (IP + port)
  • Receives baskets — commands for item delivery
  • Reports player balance — checks the wallet
  • Wipe schedule — notifies about wipes

RCON commands​

You specify the RCON command in the product settings. The system substitutes {player}.

Syntax​

give <item> {player} <qty>
addgroup {player} <group>
removegroup {player} <group>

Rust examples​

# Give an item
give AK47 {player} 1
give ammo.rifle {player} 128

# Grant a privilege
addgroup {player} vip
addgroup {player} premium

# Give resources
give wood {player} 5000
give stones {player} 5000
Rust Item ID

Use the item's ShortName or ItemID. Reference: Rust Item List.

Plugin Secret​

Plugin Secret is the key the plugin uses to sign requests to the API. It is generated in the admin panel.

  • Create new — "Generate secret" button on the server page
  • View — the secret is shown ONCE. Copy it and save it to the plugin config
  • Rotation — you can generate a new secret. The old one stops working after 60 seconds (grace period)
Security

Never share the Plugin Secret with third parties. It grants full access to your store's plugin API. Treat it like a password.

Server status​

The server status is shown on the storefront (left rail):

StatusMeaning
ONLINEServer is running, online count known
OFFLINEServer is not responding
UNKNOWNStatus not yet determined (first launch)

The system automatically detects and updates server status.

Target server​

A product can be linked to a specific server (targetServerId):

  • If set — the product is shown ONLY on that server
  • If null — shown on all servers in the store
  • The server filter on the storefront respects this linking

Next steps​