Your GoNuts handbook.

SWARM API

Join the shared market network

Link a bot to the Discord-authenticated dashboard to contribute public market observations and receive shared discovery hints. Learn the benefits, setup steps, contribution details and what the anonymous activity count means.

01 / GET STARTED

First install

New navigation: five workspaces organize the client: Trading, Markets, Accounts, Safety and Settings. Settings opens the Simple view. Read the Simple / Advanced settings guide. Switching views preserves your saved settings.

1. Prepare Fabric. For the official Minecraft Launcher, follow Fabric’s installer and OS-specific instructions. Other launchers have their own Fabric setup. Get the matching Fabric API mod too.
2. Download GoNuts. Use the website’s Minecraft 26.2 download. Keep the .jar intact; do not extract it.
3. Close Minecraft and open the right game folder. Use the directory for the installation you actually launch. Put GoNuts and Fabric API in its mods folder; create that folder if missing. Keep only one GoNuts JAR. A custom instance may not use the default .minecraft folder.
4. Launch the Fabric 26.2 profile and join DonutSMP. Enable the sidebar scoreboard in /settings so GoNuts can read your balance. Press B (default binding).
5. Choose your limits. A new install opens START HERE. Select its large gold Set up trading button to reach this step. Set maximum per trade and maximum session spend, then select Review & continue. If you see any other tab, choose the Settings → Help & setup, then Set up trading. Screenshot amounts are examples, not recommended limits.
6. Review protections. Review Evasion and Staff Watch if you use them, then return to setup. Swarm linking and Discord are optional. Normal keyless setup needs no manual API key.
7. Review & Start. Check the amounts and readiness. Read any blocker. Start trading saves these fixed caps and starts through the existing checks. Opening a guide does not start or resume anything. Fresh data may need time to gather. No purchase or profit is guaranteed.
8. Find your controls. Trade is the current AutoPilot tab. B opens GoNuts; End is the default emergency stop. Check Minecraft Controls if you changed bindings. Settings → Advanced view → Tutorials → Find AutoPilot / Trade reopens the explanation.

3 min 58 sec · silent, with captions directly on the video · follows Settings → Help & setup → Set up trading, limits, review, Trade and Show menus + hotbar. Real offline GUI captures; the server-join blocker is visible. Read your own client’s readiness message. No live bots were used.

CURRENT CLIENT

Where did AutoPilot go?

It is now called Trade. Press B and choose the Settings → Help & setup, then Open Trade, or choose Trading → Trade in the navigation, or Manage trading on the Dashboard. Older videos may say AutoPilot or Automation.

1. Want the guided setup? Choose Settings → Help & setup → Set up trading. Set your maximum per trade and session spend in Choose limits, then continue to Review & Start.
2. Already configured? Open Trading → Trade and review the Continuous page. If live trading is off, review both limits, choose Enable live trading and confirm. Review readiness before pressing Start.
3. Read any blocker. A recovery or exposure hold needs reconciliation. Do not clear positions or repeatedly restart to bypass it. Opening a guide does not start or resume a bot.

Can’t see the game menus or hotbar? Settings → Help & setup → Show menus + hotbar switches off only those two hiding options for this account. It keeps name privacy, trading limits and other settings. This is not a full reset.

Looking for API, Discord or web-panel setup?

Trade’s page selector cycles through Tools: API key / test, Discord command centre, Web panel and Back to Continuous. Swarm linking is on Swarm. These optional connections are separate from local trading setup.

In game, Settings → Advanced view → Tutorials → Find AutoPilot / Trade explains these paths. For item selection and prices, continue to the trading handbook.

02 / MULTI-ACCOUNT SETUP

Many accounts. One hive.

A hive shares market information and a trading database between separate Minecraft instances on one computer. Newly combined members retain separate settings, presets, limits and recovery state. Each account still signs in separately. Headless mode is optional.

Set up a Hive from either panel, including headless clients

Use Hive & commands in the local panel or in the panel opened with Open panel on your website dashboard. Updated running bots on this computer appear automatically. A client must load this update once to advertise itself; discovery does not connect accounts, start trading or scan other computers.

1. Choose the new bot and your existing Hive. Existing members are grouped together. No game window or copied Hive code is required.
2. Choose Add selected bot to Hive. The existing member registers its local Hive metadata at a safe checkpoint. It keeps running on the same database. The new bot rechecks that it has no trading history or saved account records, pauses safely if necessary, then leaves only its own world before creating its native Hive link.
3. Restart only the new instance normally. Its own settings, execution gates and Swarm installation link stay intact. Existing Hive members can keep running. Adding a member never merges existing histories, clears records or enables trading.

Queue a manual command for one bot

Are my accounts together? Open Hive & commands. Same Hive confirmed means the detected running bots share this panel's ledger. Choose All accounts on Money or Hive for combined figures. Separate instances detected means their local Hives are still separate, even if both are linked to Swarm. Only one running bot detected means the other updated instance is not currently visible to same-user discovery. Start it normally and wait for the roster to refresh. Do not delete a Hive to fix detection. The Hive page remains visible on current builds, including single-account setups.

In either panel, choose Hive & commands → Send as, select a bot in your Hive, enter the command, then choose Review command → Confirm and queue once. Commands wait for a safe native checkpoint and the normal FIFO pacing behind current work. Recovery, cursor, persistence, connection and teleport guards remain in control. A stopped trader is not started by queuing a command.

Supported utility commands are /rtp, /home, /spawn, /pay player amount, /bal, /balance, /msg, /reply, /r and /help. Native guards may refuse a command. Trading and inventory actions retain their existing controls; this box does not bypass them. For a confirmed region transfer, use the Region Map’s existing switch controls.

The selected bot shows QUEUED, WAITING, SENT, CANCELLED, EXPIRED, REFUSED or an uncertain handoff. SENT means handed to the game connection, not confirmed paid or teleported. Payments are never retried automatically. Pending work expires after two minutes, can be cancelled before sending, and is not replayed after a client restart or on a replacement connection. If submission is uncertain, check that bot’s queue and the server result before issuing another payment.

Alternative: setup from the game window

Current captioned walkthrough: Accounts → Hive setup, then the supported disconnected Hive wizard. For a fresh member, choose Join existing hive and restart only the new instance.

With both instances on the current build, GoNuts can detect another running account on this computer. When you open the panel, choose Review setup, Not now or Don’t ask again. Detection is local and does not link accounts or interrupt trading. Accounts already in the same hive and duplicate windows using the same account do not trigger it. Existing histories are not merged by this prompt.

1. Share your existing hive. On an existing account, disconnect and open Multiplayer → GoNuts hive → Share this hive. Copy its code. Older shared-folder setups need this registration once before appearing in the discovery list. Keep the original folder.
2. Open each new account separately. Use a fresh Minecraft instance with the current GoNuts build. Disconnect from any world or server, open Multiplayer → GoNuts hive → Link accounts, select the existing hive or paste its code, then choose Review connection.
3. Choose Join existing hive (new account). This checks that the new instance has no trading history or saved order/balance records, then keeps its own settings in a separate profile. Existing members and their histories stay in place. Its Swarm installation link stays with its Minecraft instance.
4. Restart only the new instance. Existing hive members can keep running. Repeat for each additional account; a hive is not limited to two accounts. Joining does not enable trading or bypass recovery checks.
5. Already have separate trading histories? Use Queue safe combination only for the supported two-single-account history merge. That separate operation requires closing both instances and starting the requesting instance first. It is not the flow for adding a fresh third or later member. Keep all original folders.

What is shared?

03 / BROWSER CONTROLS

Web panel

1. Open GoNuts → Trade → WEB and set a PIN.
2. Open the address shown there. The default on the same computer is http://localhost:8765.
3. For a phone on your home Wi-Fi, enable home-network access and use the LAN address shown by the mod. localhost on your phone means the phone itself.

In a hive, one shared panel handles both accounts. Separate, unlinked instances on one PC need different ports, such as 8765 and 8766. Keep the PIN private and avoid exposing the panel directly to the internet.

EVASION AND HOMES

Choose where the bot teleports

1. Open Safety → Evasion in GoNuts or the local web panel.
2. Choose /rtp for random teleports or /home to cycle named homes.
3. Enter home names such as base, vault, farm and save. Set these homes on the server first; GoNuts does not create them.

With /home selected, teleports cycle through the names in entered order. With /home selected, an empty list does not silently fall back to /rtp; add a valid home or explicitly choose /rtp. Hive clients sharing this list need the same home names. Guard, distance, damage and resume controls are on this tab; Staff Watch region transfers remain separate.

Choose automatic or manual slot capacity: automatic detection stays on by default and uses confirmed rank/menu observations for this account. Editing Auction slots or Order slots in the GUI turns detection off for this account and preserves your chosen numbers, including across relaunches. For an 18-slot account, set both capacities to 18 if both should be limited to 18. To resume detection after a rank upgrade, open Settings → Advanced view → Money & limits and enable Detect account slots automatically. The same setting is available in the local and hosted panels. Each Hive account keeps its own choice. A manual limit does not unlock server slots.

The guard switch, Settings and web panel now use one per-client on/off value. The web panel also shows the Evasion activity summary and latest hive events alongside the settings; refreshing the history keeps your unsaved settings edits.

YOUR MARKETS

Only trade specific items

Want automatic prices for selected items? Open Items, select the items and click Include. Review the Included list and remove old entries you no longer want. Track alone does not restrict trading; an empty Included list allows normal item selection.

Want your own buy and sell prices? Add entries on Flips, save and turn Flips only ON. General scans stay off, including when the list is empty. Existing stock maintenance still runs. With Flips only OFF, manual entries run alongside automatic markets.

Included versus Tracked · Price and quantity examples · Why one item at a time?

KNOW YOUR SERVER

Region Map

Open Region Map in the GoNuts GUI, web panel or Discord page selector. It uses the numbered 9×9 layout to show the area mapped from this client's current Overworld position, even when the connection address is simply donutsmp.net. The white area marks the whole server area; it is not an exact player marker.

The existing Hide name and coordinates privacy toggle scrambles GUI XYZ with dummy characters. Web and Discord images always hide exact XYZ and never receive those coordinates. Disconnected clients, other networks, other dimensions and positions outside the built-in map show an unavailable region. This view describes the client hosting the panel, not every hive member.

Donut’s own Randomized Coords setting must be OFF. The client cannot determine the real region from randomized XYZ, and an in-bounds randomized position can produce an incorrect label. This server setting is separate from GoNuts screenshot privacy: turning on GoNuts privacy hides the displayed numbers without changing the map calculation. Opening the map does not move the player. To move manually, choose a destination and press Switch this client in the GUI. In the web panel or Discord, select one account, choose a destination, then press Switch selected account. Destinations are Asia, East, West, EU Central, EU West and Oceania. The map always describes the panel host; the account selector targets the switch, not the map. Requests wait up to 30 seconds for a safe checkpoint, then up to 30 seconds for fresh server confirmation. A stopped or manually paused session stays stopped or paused; only trading paused by this transfer can resume. A timeout requires checking the client manually. The existing teleport safety setting remains enforced. The region layout is built into the client and may need updating if the server changes it.

SERVER RESTARTS

Restart queue bypass

Open Settings → Advanced view → Session & data → Restart queue bypass. It is enabled by default; an explicitly saved off setting stays off. When DonutSMP puts the client in its restart waiting room, GoNuts waits for a safe trading checkpoint, disconnects, and joins through another regional address.

The default choices are east.donutsmp.net, west.donutsmp.net, asia.donutsmp.net, oceania.donutsmp.net, eu-central.donutsmp.net and eu-west.donutsmp.net. It skips the current connection address and tries the next if a region fails or also returns the client to the waiting room. Addresses to come back in through accepts a custom order of up to six addresses on the same network.

It stays on the working region and verifies a stable world and fresh balance sidebar before attempting to resume. Positions, orders and limits are retained. A manual Stop or unresolved-trade hold still prevents automatic trading. Leaving the waiting room can lose your previous world position, as the server warns.

STAFF WATCH

Choose the response

In the GUI Staff Watch tab, enable Switch regions first to use an available /rtp destination on the first alert. The web and Discord Staff Watch pages offer the same response choice. The Module and Escape / reconnect controls must also be enabled; choosing a response does not enable them.

After the transfer is confirmed, a two-minute follow check starts for that staff member. A fresh local alert for the same identity during that window disconnects immediately and uses the existing 5–10 minute reconnect cooldown. Duplicate alerts during a transfer do not count, and seeing another staff member does not erase an earlier follow check. A repeat beyond two minutes is a new first alert. This is a precautionary response, not proof that staff are following you.

With Switch regions first off, staff alerts disconnect immediately. Region discovery, safe transfer checks and reconnect safeguards remain in force. Entry hostnames are not used as proof of the current in-game region.

04 / STAY CURRENT

Updates

Enable Auto-update in GoNuts Settings. It checks for the newest already-published build; it does not require a fresh release after you turn it on.

If an older updater never downloads, close Minecraft and manually replace the old mod JAR with the current release once. Do this in each launcher instance. Updating the mod does not require deleting the config or database.

05 / GET HELP

Bug reports

1. Open GoNuts → About → Report bug.
2. Describe what happened, what you were doing and what you expected. The first line should be a short summary.
3. Sanitized diagnostic logs are included automatically. Optional preview lets you inspect what will be sent. If the log is unreadable, the report includes an availability notice.
4. Click Send report. Wait for the submitted issue link; a prepared report is not a sent report.

No GoNuts service token or GitHub account is required for the in-game direct submission. Reports create public GitHub issues. The attachment is a limited, sanitized diagnostic excerpt, not your full Minecraft log. Avoid adding private information to your description.

Critical automatic reporting is a separate, per-instance opt-in. It covers supported critical failures, not every pause or a slow-selling market. Feature requests are separate and are considered without a promise of implementation.

Configuration context is included: every new report carries a sanitized Settings code containing approved numeric settings and toggles, including this account's slot limits. The preview shows the code. Home names, player lists, webhook URLs, Discord identifiers, tokens and all other text settings are excluded. Settings are diagnostic evidence; support does not automatically apply them.

Step-by-step MultiMC + HeadlessMC guide →

06 / OPTIONAL

Headless mode

You do not need headless mode to run a hive. Set up and verify the hive and web panel with the normal game window first.

Our Windows Prism setup uses the HeadlessMC LWJGL agent. Get the matching agent from the official HeadlessMC releases; the example below uses headlessmc-lwjgl-3.0.0-RC6-no-asm.jar. Keep it in a path without spaces.

1. Before hiding the game window, enable Join the server by itself in each instance and verify web-panel access.
2. In Prism: Edit instance → Settings → Java, enable the Java-arguments override and add the arguments below, using your actual agent path. Preserve any other required arguments.
3. Disable Sodium, Iris, ImmediatelyFast and Entity Culling in that instance. Launch it and verify recent automation activity in the panel.

-javaagent:C:/hmc/headlessmc-lwjgl-3.0.0-RC6-no-asm.jar -Djoml.nounsafe=true -Dfabric.systemLibraries=C:/hmc/headlessmc-lwjgl-3.0.0-RC6-no-asm.jar

To close normally, create send-command.txt containing !quit in that instance’s Minecraft folder. Avoid the launcher’s Kill button. To restore the game window, close normally and remove the headless-specific arguments.

Official HeadlessMC documentation

07 / OPTIONAL

Discord panel

The Discord panel is separate from the browser panel. It needs a Discord bot that you control and an operator account allowed to use its controls. Never share the Discord bot token.

Detailed Discord instructions

SAVED SETUPS / LOCAL ANALYSIS

Presets and Analyzer

In Settings, choose Saved presets to save your current setup under a name. Save experiments under new names and apply your baseline to switch back. Applying a preset does not overwrite the saved copy and does not require restarting.

Open Analyzer to review your local 24-hour ledger, bankroll, purchase cap, hive context and observed markets. Each finding explains the evidence, a suggested experiment and the limits of any estimate. Save a suggested preset to review it before applying. Analysis never sends trades or uploads settings to a backend.

Full presets and Analyzer guide

MOVING YOUR INSTALL

Changing launcher?

The JAR does not contain your saved database. Back up the original instance and keep both games closed during the transfer.

Move GoNuts to another launcher and recover missing history

08 / COMMON QUESTIONS

Troubleshooting