Overview
The Rusty4Serv page connects a Tip4Serv store to your server. Players pay real money on a storefront that looks like your community, and the bot delivers the reward to their linked Discord account. This is separate from the in-game currency shop (Economy & Shop).
- Create your store on Tip4Serv and have your Store ID (a number, for example 4213) and Store API Key ready. The key is in your Tip4Serv dashboard under Store, API Keys.
- Give the key the Payments permission, or purchases will not be delivered.
- Your Tip4Serv dashboard needs a Discord server connected, or product rewards will not work.
- Buyers must be in your Discord server and have linked their gamertag (Account Linking).
Setup & Configuration
- Log in to the RustyWorks website, open Servers Configure, pick your server and select Rusty4Serv. If your Discord has more than one Rust server, choose which server the shop is for.
- The page has five tabs: Connection, Theme, Categories, Products and Purchases.
- There is no Discord setup. Use /shop send-embed to post a shareable Open Shop card for the storefront.
Connection
| Setting | What it does |
|---|---|
| Store ID | The number of your Tip4Serv store |
| Store API Key | Your key. Leave it blank to keep the one already saved |
| Save | Saves the connection |
| Test Connection | Checks the key works |
| Disconnect | Clears your Store ID and API Key |
A status line shows when the shop was last checked. The bot checks Tip4Serv for new payments about every 30 seconds. If checks fail for several days in a row, checking is paused and the page tells you. Enter your Store API Key again and press Save to resume. Nothing is lost.
Once connected, View Shopfront opens the live storefront, and Copy Link gives you a link to share. Anyone with the link can browse and buy without needing access to this page.
Your shop on your own website
You can also show this shop on your own website, with a basket and a checkout that finishes on the RustyWorks shop page. See the Website API guide.
How a purchase is delivered
Every shop belongs to one Discord server and one Rust server, the ones you chose when you connected it. When a payment arrives the bot works in this order:
- Discord server. The shop's Discord server decides where the purchase belongs.
- Rust server. Rewards go to the Rust server the shop is connected to. If a product names another Rust server of the same Discord, that one is used. A product that names a server which no longer exists is delivered to the shop's own server.
- The buyer. The bot reads the buyer's Discord ID from the payment. If Tip4Serv does not give one, it uses the account the buyer was logged in as when they started checkout.
- The check. The buyer must be in your Discord server and have linked their gamertag on that Rust server. Only then is anything delivered: kits, currency, roles and everything else in the purchase.
If the check fails, nothing is delivered yet. The buyer gets one direct message telling them to join the Discord or link their account, and the bot tries again about every 30 seconds. As soon as they join or link, the whole purchase is delivered. After 2 days without success the bot stops trying, so link or join quickly. Premium Shop upgrades are not tied to a Discord server, so they skip this check.
At checkout, someone who is not in the Discord server is asked to join first, and someone who has not linked is asked to link first, before they pay.
Plans
| Plan | Limits |
|---|---|
| Free | 5 categories, 10 products per category |
| Premium | 25 categories, 50 products per category, plus six animated themes |
Press Upgrade to Premium to buy Premium. You must have joined the support Discord first.
Theme: branding and imagery
| Setting | Limits |
|---|---|
| Shop Title | Up to 100 characters |
| Store Currency | USD, EUR, GBP, Cent, JPY / CNY, RUB, INR, KRW, ILS, PHP / CUP, THB, TRY, AUD, CAD or Generic |
| Tagline | Up to 200 characters |
| Logo Image | PNG, JPG or WebP. Press Upload Logo, or Remove |
| Banner Image | PNG, JPG or WebP. Press Upload Banner, or Remove |
| Post Shop Card to Discord | Choose a channel and press Post. It posts an embed with an Open Shop button that matches your theme's title, tagline, colour, logo and banner |
| Purchase Announcements | Choose a channel and the bot posts a short announcement when someone buys. Leave it unset to turn announcements off |
Theme: layout and display
| Setting | Choices |
|---|---|
| Shop Visual Theme | Free: Classic, Vault Tiers, Field Command. Premium: Aurora Command, Solar Flare, Frostbyte, Toxic Rift, Obsidian Throne, Neon Black Market. Each theme sets the colours, fonts, header, footer and how products are arranged |
| Product Grid Columns | 2, 3 or 4 |
| Products Per Page | 1 to 25 |
| Product Image Count | 1, 3 or 5 |
| Product Title Position | Below or above the image |
| Description Length | Short or Full |
| Toggles | Show Price, Show Add to Cart, Show "Hot" Badge (Featured), Show Variants, Enable Wishlist, Enable Quick-View Modal, Enable Coupons, Hide "All Products" Category |
| Extra pages and sections | About Us page, Contact page (redirects to Discord) and an FAQ section. Add About Us text and FAQ questions |
Theme: styling, add-ons and social links
| Setting | Choices |
|---|---|
| Theme Accent Colour | Any colour |
| Buy Button Style and Product Card Border | Rounded, Square or Pill |
| Button Colour and Button Hover Colour | Any colour |
| Product Card Shadow | None, Subtle or Strong |
| Announcement Bar Text and Bar Background Colour | A banner across the top of the shop |
| Custom Footer Text | Free text |
| Social links | Discord invite, YouTube, TikTok, Instagram, Facebook, Twitch and Kick. Leave blank to hide. The Discord link is used for the Contact page |
Press Save All Theme Settings when you are done.
Categories
These are RustyWorks' own categories, used to organise your products on this page and on your shopfront. Tip4Serv's own categories are not used. Use New Category, rename, reorder or delete them. Deleting a category makes its products Uncategorised.
Products
Choose a category, then press New Product.
| Field | What it does |
|---|---|
| Product Name | Required |
| Price | In your store currency. Required |
| Category | Required |
| Description | Optional. Supports bold, italic, underline, strikethrough, text colour and size |
| Product Photo | Optional |
| Attach RustyWorks Reward | The reward delivered on purchase |
| Reward type | What you set |
|---|---|
| No Reward (Dummy Item) | Nothing is delivered |
| In-Game Kit, One-Time Claim | Pick a kit. It goes to the buyer's Eco Bag |
| Permanent Role Kit | Pick a kit that has a Role Lock. It grants the role lock forever |
| Subscription Role Kit | Pick a kit with a Role Lock, and the days granted per payment |
| Queue Skip | A quantity |
| Lucky Wheel Spins | A quantity and a period: Daily, Weekly or Monthly |
| Rusty Crate Tickets | 1 to 99,999 tickets per purchase. Opened with /gamble crate |
| Discord Role | Pick a role |
| Server Currency | An amount, paid to the Wallet or the Bank |
| Nuke Drop | Pick a slot from /nuke config |
Reward settings are not editable once a product is created. Delete the product and make a new one if it needs to deliver something different.
Coupons and sales
- Coupons work straight away at checkout. Choose Percentage off or Fixed amount off, a value, an optional code (a random one is made if blank, up to 32 characters), an optional use limit, minimum spend and expiry date. There is no delete, only Deactivate.
- Sales can only be viewed here. Create them on the Tip4Serv dashboard with Create a Sale on Tip4Serv, and active ones are listed on this page.
Purchases
The Purchases tab shows Sales Overview, Most Bought Items and Recent Purchases. It only counts payments Tip4Serv marked Paid or Processed.
Commands & Usage
| Command | What it does | Who can use it |
|---|---|---|
| /shop send-embed | Posts a shareable Open Shop card for the storefront | Staff |
Troubleshooting
| Problem | Cause | Fix |
|---|---|---|
| "Shop purchases are not being delivered right now" | The last check of Tip4Serv failed | Check the Store API Key has the Payments permission. The bot keeps retrying and nothing is lost |
| "We stopped checking this shop" | It failed for several days in a row | Enter the Store API Key again and press Save |
| A buyer did not get their reward | They are not in your Discord server, or have not linked their gamertag | They join the Discord and link with /user link. The whole purchase is delivered within a minute |
| A purchase was never delivered after 2 days | The bot stopped trying | Give the reward by hand, or ask the buyer to contact you |
| Tip4Serv does not show the order as delivered | RustyWorks tracks delivery itself | Check the Purchases tab instead |
| "You do not have a Discord Server connected in your Tip4Serv dashboard" | Rewards need a Discord server connected in Tip4Serv | Connect it in Tip4Serv |
| "Link a Rust server to this Discord first" | No Rust server is linked | Add one in Server Setup |
| A kit option says "No role-locked kits yet" | Role kits need a Role Lock on the kit | Set a Role Lock in Emote Kits first |
Checked against RustyWorks on 3 Nov 2026.
Tell us which setting you are on and what the bot said, and paste a screenshot if you can. Staff in the support Discord can usually fix it in a minute.