Help & Commands

📋 How to Register Your Ranch

1

Purchase a license

Head to the Buy License page and complete checkout. Right after payment you'll land on a success page that reveals your license key, dashboard username, and password on screen — copy them somewhere safe. We do not send credentials by email; the success page is the only place they appear, and the password is only viewable for 24 hours.
2

Invite the bot to your Discord server

On that same success page, click "Invite Bot to Discord" to add Ranch Manager Bot to your server. Make sure to grant it permission to read and send messages.
3

Register your server with the bot

In any channel your bot can see, type:

!register YOUR-LICENSE-KEY
4

Log in to your web dashboard

Visit /login and sign in with the username and password you saved from the success page. From there you can configure prices, splits, channel settings, and view live tracking & payouts.
5

Start tracking!

Your ranch hands can now use !milk, !eggs, and cattle sales auto-parse from your cattle log channel. Run !help in Discord for the full command list.

💳 Pricing

🏅

Lifetime License

$40

One-time purchase.
Full access forever for one Discord server.

Single Discord server
Unlimited ranch hands
All features included
Lifetime updates
No recurring fees

🔁

Monthly License

$10/mo

Monthly subscription.
Cancel any time — no lock-in.

Single Discord server
Unlimited ranch hands
All features included
Monthly updates
Cancel anytime

🛡️

12-Day Satisfaction Guarantee

Not happy with your purchase? Get a full refund within 12 days — no questions asked. Just reach out and we'll sort it out.

Get Ranch Manager Bot →

🔧 Discord Server Setup

After registering your bot, you'll need to create a few channels and a role in your Discord server, then paste their IDs into the Configure page. Here's exactly what to set up:

Step 1 — Enable Developer Mode

In Discord, go to User Settings → Advanced → Developer Mode and turn it on. This lets you right-click anything to copy its numeric ID.

Step 2 — Create the Ranch Hand Role

Create a role called Ranch Hand. Assign it to all your active sellers. Right-click the role → Copy Role ID and paste it into Roles & Filters → Ranch Hand Role ID on the Configure page.

Step 3 — Create a Queue Panel Channel

Create a channel such as #ranch-queue. This is where the live queue panel with Join / Leave / Start Turn buttons will live. Copy its ID and paste it into Discord Channels → Queue Channel ID. Then have a manager run !queuepanel in that channel.

Step 4 — Create a Queue Status Channel

Create a second channel such as #queue-updates. The bot posts all turn announcements here. Copy its ID and paste it into Discord Channels → Queue Updates Channel ID.

Step 5 — (Optional) Create a PayDay Channel

Create a channel such as #payday. Copy its ID and paste it into Payout Announcements → PayDay Channel ID, then turn on the toggle and choose a 3-day or 5-day schedule.

💡 Tip: All IDs are set on the Configure page in your web dashboard. After saving, changes take effect immediately — no bot restart needed.

🤠 Player Commands — usable by all ranch hands

Command	What it does
!milk <amount>	Log milk you produced this period. Adds to your running total for the current payout cycle. e.g. !milk 50
!eggs <amount>	Log eggs you collected this period. Adds to your running total. e.g. !eggs 30
!mystats	View your personal breakdown — milk, eggs, cattle earnings, any debt, and your exact payout owed this period.
!stats	View the full leaderboard/stats table for all active ranch hands, including paid/unpaid status.
!stats @player	View a specific player's current stats and payout breakdown. e.g. !stats @JohnDoe
!queue	View who's currently in the queue, their position, and how long until it's their turn.
!joinqueue	Join the cattle queue directly via command.
!leavequeue	Leave the queue if you're in it.
!help	Show the full command list directly in Discord.

🔒 Manager Commands MANAGER ROLE

These require the manager/owner role configured in your settings.

Command	What it does
!register <key>	Link your license key to this Discord server. Run once right after purchasing. e.g. !register RANCH-XXXXXXXXX
!cattle @player <amount>	Manually record a cattle sale for a specific player. e.g. !cattle @JohnDoe 1500
!removecattle @player <amount>	Remove a previously recorded cattle sale from a player's total. e.g. !removecattle @JohnDoe 500
!payout @player	Process a payout for a specific player — shows their full earnings breakdown and resets their milk, eggs, and cattle totals to zero.
!payoutall	Mark all players as paid and reset all stats at once. Posts a summary in Discord.
!setmilk @player <amount>	Manually override a player's milk count. e.g. !setmilk @JaneDoe 80
!seteggs @player <amount>	Manually override a player's egg count. e.g. !seteggs @JaneDoe 60
!setsplit <player%> <ranch%>	Set the cattle earnings split. Both numbers must add up to 100. e.g. !setsplit 75 25 → player 75%, ranch 25%
!setprice milk <$>	Set the per-unit payout price for milk (or eggs). e.g. !setprice milk 0.50 / !setprice eggs 0.25
!debtexempt @player	Toggle debt exemption for a player. Debt-exempt players never have ledger deductions applied.
!resetplayer @player	Reset a single player's stats back to zero without marking them as paid.
!payday	Manually trigger a payday announcement immediately.

🎟 Queue Commands MANAGER ROLE

Queue management commands for managers.

Command	What it does
!queuepanel	Post the live queue panel with Join / Leave / Start Turn buttons in the current channel. Run this once in your queue channel to set up the panel.
!clearqueue	Remove everyone from the queue and reset it to empty. Use at the end of a session.
!skipqueue	Skip the current player and advance to the next person in line. Use if someone's turn has been called but they aren't responding.

💬 Frequently Asked Questions

How do I get my license key after purchasing?

Your license key, dashboard username, and password are shown directly on the success page right after Stripe confirms payment — usually within a few seconds. We do not send credentials by email, so copy them somewhere safe before closing the tab. The password is only revealable for 24 hours; after that, use the Forgot Password flow (Discord DM recovery) to set a new one.

I closed the success page before saving my password — what now?

Your username is still on file, and the success URL stays valid for 24 hours if you have it bookmarked. If you've lost both, use Forgot Password — it sends a recovery code to the Discord account that registered the server. (Make sure your bot has DMs from server members enabled.) After 24 hours, the password reveal expires permanently.

Can I use the bot on multiple Discord servers?

Each license covers one Discord server. If you want to use Ranch Manager on multiple servers, you'll need a separate license for each one.

What happens if I lose my dashboard password?

Use Forgot Password — recovery is handled via a code DM'd to the Discord account that originally ran !register on your server. For sub-user passwords, the ranch owner can reset them directly from the My Team page in the dashboard.

Can I get a refund?

Yes — every plan comes with a 12-day satisfaction guarantee. If you're not happy within 12 days of purchase, reach out and you'll get a full refund, no questions asked.

How does auto-parsing cattle sales work?

Set your cattle log channel ID in the Configure page. When a sale notification appears in that channel, the bot reads the dollar amount and the player's Discord mention, then automatically adds it to their total — no commands needed.

What is debt / ledger tracking?

When a player makes a ledger purchase (horses, supplies, etc.), that amount is recorded as debt against their account. At payout time, the debt is deducted from their gross earnings. If the debt is larger than what they earned, the remaining debt carries forward to the next payout period.

📋 How to Register Your Shop Manager

1

Purchase a Shop Manager license

Head to the Shop Manager page and complete checkout ($10/month, flat). Your SHOP- license key, dashboard username, and password are revealed directly on the success page — no email is sent. Save them before closing the tab; the password is only viewable for 24 hours.
2

Invite the Shop Manager bot

From the success page, click "Invite Bot to Discord" to add the Shop Manager bot to your server. (It's a separate bot from Ranch Manager — both can coexist.)
3

Register your server with the bot

In any channel the bot can see, type:

!shopregister SHOP-YOUR-LICENSE-KEY
4

Point your in-game shop webhook at the channel

Send your RDR2 shop webhook embeds (Item Sold to Shop / Bought Item / Deposit) into a Discord channel the bot can read. The bot auto-parses every embed and updates inventory + ledger live.
5

Log in to your shop dashboard

Visit /shop-manager and sign in with the username/password from your success page. You'll see every shop, live inventory, and the last-known ledger — refreshing automatically.

💳 Shop Manager Pricing

🛒

Shop Manager Monthly

$10/mo

Flat $10/month, all features.
Cancel anytime — no lock-in.

Single Discord server
Unlimited shops per server
Live inventory + ledger
Full transaction history
Sub-user team access
Cancel anytime

🛡️

12-Day Satisfaction Guarantee

Same guarantee as Ranch Manager — full refund within 12 days, no questions asked.

Get Shop Manager →

🔧 Shop Webhook Setup

The Shop Manager bot reads your in-game shop webhook embeds straight from a Discord channel. Here's how to wire it up:

Step 1 — Create a shop log channel

Make a channel like #shop-log in your Discord. The bot needs Read Messages there.

Step 2 — Point your in-game webhook at it

In your RDR2 server config, set the shop webhook URL to that Discord channel's webhook. Every "Item Sold to Shop", "Bought Item", and "Deposit" embed will now land there.

Step 3 — (Optional) Lock the bot to that channel

In the shop dashboard's Configure page, set the Webhook Channel ID. The bot will then ignore embeds posted in any other channel — useful if you have multiple webhook destinations.

Step 4 — (Optional) Rename your shops

Each shop is auto-created the first time a webhook for it lands. To give one a friendlier name, run !setname <shop_id> <new name> in Discord.

🛒 Shop Commands — usable by anyone in your server

Command	What it does
!shopregister <key>	Link this Discord server to your Shop Manager license. Run once after purchase. e.g. !shopregister SHOP-XXXXXXXXX
!shop <id>	Show a single shop's ledger summary — current balance, item count, total units. e.g. !shop 1
!inventory <id>	List every item in a shop's inventory along with quantities and last-known buy/sell prices. Alias: `!inv`. e.g. !inventory 1
!shops	List every shop currently tracked for this server, with shop ID, name, and ledger.
!lastfor <id> <item>	Show the most recent transaction for a specific item — type, amount, total, unit price, and timestamp. e.g. !lastfor 1 whiskey
!resetpw <SHOP-key>	DM yourself a one-time code to reset your shop dashboard password (sent to the Discord account that originally registered the server).
!shophelp	Print the full Shop Manager command list directly in Discord.

🔒 Shop Admin Commands REGISTRANT / ADMIN

These adjust shop data manually. Restricted to the Discord user who registered the server (and any sub-users with edit permissions).

Command	What it does
!setname <id> <name>	Override the auto-detected shop name with a friendlier label. e.g. !setname 1 Valentine General Store
!removeitem <id> <item>	Delete a stuck/orphaned item from a shop's inventory. e.g. !removeitem 1 brokenhat
!adjustledger <id> <amt>	Manually adjust a shop's ledger balance. Use `+50` or `-50` for a delta, or a plain number to set an absolute value. Alias: `!ledger`. e.g. !adjustledger 1 +250 / !adjustledger 1 0
!deposititem <id> <qty> <price> <item>	Manually record a deposit when no in-game webhook fired. Alias: `!di`. e.g. !deposititem 1 12 1.50 whiskey

💬 Shop Manager FAQ

Is Shop Manager the same bot as Ranch Manager?

No — they're two separate bots with separate licenses (RANCH- vs SHOP- prefixes) and separate dashboards. They can both live in the same Discord server side by side.

How do I get my shop license key after purchase?

Same as Ranch — your SHOP- key, username, and password are revealed on the success page right after Stripe confirms payment. We do not email credentials. The password is only viewable for 24 hours; copy it somewhere safe.

What if I forgot my shop dashboard password?

Run !resetpw SHOP-YOUR-KEY in Discord — the bot DMs a recovery code to the account that registered the server. Or use the Forgot Password page; it auto-detects the SHOP- prefix and routes to the shop recovery flow.

How does the bot know which embeds are shop transactions?

It looks for the standard RDR2 shop webhook embed titles ("Item Sold to Shop", "Bought Item", "Deposit") and parses item, quantity, prices, and the resulting ledger straight out of the embed fields. Anything else in the channel is ignored.

Where does the ledger value come from?

Every shop webhook embed includes the ledger balance after the transaction. We store that as the last-known ledger — it's always exactly what the game reported, never our own guess.

Can I track multiple shops on one license?

Yes — unlimited shops per Discord server. Each shop is identified by its in-game shop ID and gets its own inventory, ledger, and history.

Can I let team members see the dashboard?

Yes. From the shop dashboard's Team page, the owner can create sub-users with their own logins and granular permissions (view-only, edit settings, edit inventory).