NovaTracks Documentation
Everything you need to run an automated Roblox-limiteds shop inside Discord.

Introduction

NovaTracks is an automated Roblox limiteds trading bot for Discord. A buyer opens a ticket, pays by card or PayPal, and the moment the payment confirms, NovaTracks builds and fires the Roblox trade automatically — by UAID, with faces and dynamic heads included. No staff, no manual steps.

It's built for traders who want to scale a shop without babysitting every order. Item values pull live from Rolimons; stock, pricing, eligibility checks, payment capture, delivery, and ticket transcripts are all handled for you.

Under the hood it's a Discord-native engine: a persistent storefront, secure card & PayPal checkout, automatic payment capture, live Rolimons valuation, Roblox trade dispatch by UAID, and a tamper-resistant anti-theft layer — all coordinated so a single operator can run the volume of a small team.

Key capabilities

  • Hands-free delivery — trades fire automatically the moment a payment confirms.
  • Accurate inventory — per-copy tracking with live RAP/value and on-hold awareness.
  • Collectibles 2.0 ready — faces and dynamic heads are detected by CIID and traded by UAID.
  • Self-defending — PIN gating, burst auto-freeze, and a one-command kill-switch.
  • Auditable — every ticket is archived as a self-contained HTML transcript with images intact.

Getting started

Requirements

  • A Discord server where you have admin permissions.
  • One or more Roblox accounts to hold and deliver stock (Premium is required to send trades).
  • A Stripe and/or PayPal account to receive payments — card (Visa, Mastercard, Amex) and PayPal are supported.
  • Recommended: sticky residential proxies for stable Roblox sessions (prevents cookie churn from IP hopping).

Setup

  1. Invite NovaTracks to your server using the link on novatracks.gg.
  2. Link your delivery Roblox account(s) and connect your Stripe / PayPal payout account through the guided setup.
  3. Sync your catalog — values auto-pull from Rolimons; set your margin with INV_RATE and a price floor.
  4. Post your storefront with /shop. You're live — buyers can browse and open tickets.
Cookies are read just-in-time for each scan or trade and are never written to logs or transcripts.

Configuration

Most behaviour ships with sensible defaults — in practice you'll only touch pricing, your payout account, and a few channel IDs.

Pricing

Sale prices are derived from each item's Rolimons value with two knobs:

SettingWhat it doesExample
INV_RATEMultiplier applied to the Rolimons value to set your sale price.0.85 → sell at 85% of value
Price floorMinimum sale price so low-value items are never underpriced.$7

Accounts & sessions

SettingWhat it does
Holding accountsThe Roblox accounts that hold and deliver stock. Add several to spread volume.
PROXY_BASE_URLA sticky residential proxy so Roblox sessions keep a stable IP — rotating IPs get cookies revoked.
Payout accountWhere captured payments are settled (Stripe / PayPal).

Security

SettingDefaultWhat it does
TRADEGUARD_PINPIN required for /send, /lockdown, /unlock.
MAX_TRADES8Trades allowed inside the rolling window before auto-freeze.
WINDOW_MIN60Length of the rolling window, in minutes.

Channels

  • Shop — where the public storefront panel lives.
  • Orders log — payment and order events.
  • Transcripts — archived HTML transcripts on ticket close.
  • Alerts — owner DMs / posts for trades and lockdowns.

Commands

Slash commands are owner & staff tools — the buyer-facing flow (browse → pay → deliver) needs no commands at all. Anything that moves stock or money is PIN-gated.

Core

/stock

Description: Post or refresh the persistent live-stock panel.

Shows every item with its current value and quantity, and re-renders itself every minute so the "edited" timestamp stays fresh.

Usage
/stock
Example output
📦 Live Stock
────────────────
The Void Star — $3.2M  (1 in stock)
Valkyrie Helm — $330K (2 in stock)
Black Iron Horns — $170K (1 in stock)
/shop

Description: Post the public storefront browser.

Buyers pick an item from the panel, which opens a private ticket and starts the pay-first checkout. Faces and dynamic heads are detected from live inventory and listed correctly.

Usage
/shop
/send

Description: Owner-only manual trade builder.

Pick the items you're offering and receiving, then dispatch the Roblox trade by UAID. Used for off-panel deals or re-sends. Requires your security PIN.

Usage
/send pin:<your_pin>
Trades leave your accounts immediately. Double-check the buyer ID and items before confirming — sent trades cannot be recalled.
/lockdown

Description: Emergency kill-switch.

Instantly freezes all outgoing trades across every account. Use this the second something looks wrong. Requires your PIN.

Usage
/lockdown pin:<your_pin>
/unlock

Description: Lift a lockdown and resume trading.

Usage
/unlock pin:<your_pin>

Accounts & configuration

/addaccount

Description: Link a Roblox account that will hold & deliver stock.

You attach the account through a secure prompt; NovaTracks validates the session directly (never through a proxy) and only uses it just-in-time. The session is never written to logs or transcripts.

Usage
/addaccount
Add several accounts to spread stock — fewer trades per account keeps a healthier 48-hour hold pattern.
/accounts

Description: List linked accounts and their health.

Shows each account's username, RAP, and session status. Cookies are re-validated automatically every 30 minutes, so a dying session is caught before it hits a dispatch.

Usage
/accounts
Example output
👤 Linked accounts
──────────────────────
stronglaspect    RAP 2.1M   ✓ healthy
GraysonLavaRogue RAP 880K   ✓ healthy
lessfent         RAP 140K   ⚠ cookie expiring
/setpayout

Description: Connect the Stripe / PayPal account that captured payments settle to.

Usage
/setpayout provider:<stripe|paypal>
/setpin

Description: Set or change your security PIN.

The PIN gates every trade-affecting command. Choose something only you know and never paste it in a shared channel.

Usage
/setpin old:<current> new:<new>
/alerts

Description: Choose where trade alerts, payment events, and lockdown notices are posted.

Usage
/alerts channel:#alerts

Catalog & stock

/reprice

Description: Re-pull Rolimons values and recompute sale prices.

Refreshes every item's value, then reapplies your INV_RATE margin and price floor. This runs automatically about every 25 minutes — use it to force an immediate update.

Usage
/reprice
/hide

Description: Temporarily pull an item from the storefront without deleting it.

Usage
/hide item:<name|id>
Example
/hide item:Valkyrie Helm
/unhide

Description: Restore a hidden item to the storefront.

Usage
/unhide item:<name|id>
/reserve

Description: Hold a copy out of the sale pool while you arrange a deal.

The reserved copy won't be sold through the storefront and the reservation auto-expires after the time you set.

Usage
/reserve item:<name|id> minutes:<n>

Orders & tickets

/refund

Description: Issue a refund for an order that couldn't be delivered.

Refunds the buyer's payment, logs the action, and updates the ticket.

Usage
/refund order:<order_id>
Refunds return to the buyer's original card or PayPal — confirm the order ID and amount before issuing.
/close

Description: Close the current ticket.

Releases any held stock and saves a self-contained HTML transcript (images included) to your log channel. Anyone can close a ticket — the transcript is always saved either way.

Usage
/close
/health

Description: On-demand cookie & proxy health report.

Lists every account's session and proxy status, flagging any dead cookie that needs a re-login before it blocks a delivery.

Usage
/health

Stock management

Stock is tracked per copy, keyed by each item's UAID, so two copies of the same item are managed independently — different holds, the same price. Quantities and prices update live.

Pricing from Rolimons

Each item's value is pulled from Rolimons and cached for ~25 minutes. Your sale price is value × INV_RATE, never below the price floor. Run /reprice to force an immediate refresh.

Trade holds & off-hold detection

Roblox applies a 48-hour trade hold after an item is obtained, and that timer resets on every trade — including transfers between your own accounts. Roblox only exposes whether a copy is on hold, not when it frees, so NovaTracks reads the obtained timestamp (via Rolimons) and counts 48 hours to estimate the off-hold time. When you hold multiple copies, an off-hold copy is offered first, so a buyer is never sold a copy that can't move.

Faces & dynamic heads (Collectibles 2.0)

Faces and dynamic heads don't show up in the legacy collectibles endpoint. NovaTracks reads them from the v2 inventory by type, identifies them by CIID for listing, and dispatches them by UAID — so a dynamic-head sale both verifies and sends correctly, where simpler bots silently drop it.

Reserve & hide

Use /reserve to hold a copy while you arrange a private deal, and /hide to pull an item from the storefront entirely (e.g. while repricing). Both are reversible; reserves auto-expire.

How delivery works

The entire order runs itself — payment is collected first, so stock is never sent before funds clear.

  1. Buyer opens a ticket from the shop panel.
  2. A secure checkout (card & PayPal) is generated for that order and posted in the ticket.
  3. NovaTracks captures the payment automatically the moment checkout completes.
  4. The buyer enters their Roblox username; eligibility is verified — Premium, the 48-hour hold, and an off-hold copy.
  5. The Roblox trade is dispatched automatically by UAID — faces and dynamic heads included.
  6. A "Trade Sent" receipt posts, buyer roles are granted, and the ticket auto-closes with an HTML transcript saved.

Average dispatch is under 5 seconds from confirmation. Unpaid tickets auto-close after 30 minutes so the held stock is released back to the shop.

Edge cases

  • Buyer can't trade — if the account lacks Premium or the username is wrong, the ticket asks them to fix it first; no trade is sent.
  • Every copy on hold — the order is held and flagged rather than failing, and you're notified to deliver once a copy frees.
  • Underpaid / overpaid — the bot waits for the full amount; an overpayment is logged for manual reconciliation.
  • Dispatch fails — a clean "Manual Review Needed" card replaces any error, staff is pinged, and a refund can be issued with /refund.
  • Unpaid timeout — tickets with no payment auto-close after 30 minutes and release the held stock.

Security

NovaTracks ships with an anti-theft layer so a compromised token can't quietly drain your accounts.

  • PIN-gated actions/send, /lockdown, and /unlock all require your private PIN.
  • Burst auto-freeze — if more than 8 trades fire within 1 hour, the bot locks itself and DMs you.
  • Kill-switch/lockdown halts every outgoing trade instantly.
  • Instant owner alerts — every successful trade DMs you the item, source account, and buyer.
  • Just-in-time cookies — credentials are loaded for a single scan or trade and never persisted or logged.

How burst-freeze works

NovaTracks keeps a rolling list of recent successful trades. When a new trade would push the count inside the window past the limit (default 8 trades / 60 minutes), it's blocked, the bot enters lockdown, and you get a DM. This caps how much can leave your accounts in any window — even if your Discord token is fully compromised.

Best practices

  • Keep delivery cookies on a sticky proxy, and re-login promptly when /health flags one.
  • Set a PIN only you know; never paste it in a shared or logged channel.
  • Spread stock across several accounts so a single compromise is never catastrophic.
  • Lower MAX_TRADES if your normal volume is low — a tighter ceiling trips sooner on abuse.

Refunds & disputes

If a paid item can't be delivered — every copy on hold, a failed dispatch, or an item pulled mid-order — the buyer is entitled to a full refund to their original payment method, issued with /refund. The held stock is released back to the shop.

Warranty

Where you offer a warranty, its terms are shown at the point of sale and the claim is handled inside the ticket. Items that have already been delivered successfully are generally non-refundable.

Refunds return to the original card or PayPal — always confirm the order ID and amount first.

FAQ

Do buyers need Roblox Premium?

Yes. Roblox only lets Premium accounts trade, so a buyer needs Premium to receive the item. The ticket verifies this before dispatch.

How fast is delivery?

Typically under 5 seconds from payment confirmation to the trade landing in the buyer's inbox.

Why did an order say "Manual Review Needed"?

The automatic dispatch couldn't complete — for example a transient Roblox error or an eligibility issue. Staff is pinged to finish it or refund; the buyer's funds are safe the whole time.

Is my Roblox cookie safe?

Cookies are read just-in-time for a single scan or trade and are never written to logs, transcripts, or committed files.

What payment methods are supported?

Card (Visa, Mastercard, Amex) and PayPal, with secure in-ticket checkout and automatic capture.

Can I run more than one server?

Multi-server operation is available on the Enterprise plan.

Pricing

PlanPriceOrders
StarterFreeUp to 50 / month
Pro$29 / monthUp to 400 / month
Enterprise$99 / monthUnlimited + multi-server

Pro includes

  • Up to 400 orders / month
  • Warranty & dispute protection
  • Dynamic head & face detection (CIID)
  • Inventory pricing suite & conversion analytics
  • Anti-theft guard (PIN, burst-freeze, lockdown)
  • Priority support

See full pricing →