Modding Tools - mapnerd-crossing/acnh GitHub Wiki

After installing CFW, you can start using modding tools from your PC or Android. Mobile Spawner is also supported for MacOS.

Note: For most of these tools, the sys-botbase and ldn_mitm files need to be installed on your Switch. The download links can be found here: Download CFW files. Follow step 10 to put these files on your SD card. You must restart your Switch after.

Poker

Mobile Spawner

NHSE

Sysbot

An ACNH Sysbot is a bot used to automate orders. This Wiki will also create a bot in Discord.

Create a bot in Discord

  1. Sign into your Discord account on your PC
  2. Open the Discord Developer Portal
  3. On the top right, click New Application
  4. Give your bot a name and click "Create"

Build-A-Bot

  1. In the Discord Developer Portal, click the Bot page on the left
  2. To the right of the Build-A-Bot option, click Add Bot > Yes, let's do it
  3. Optional: You can change the bot's picture and name in this view
  4. Turn Public bot OFF, this will keep strangers from accessing your bot
  5. Under Privileged Gateway Intents, turn PRESENCE INTENT and SERVER MEMBERS INTENT ON
  6. Save your changes
  7. Generate a token for your server by clicking "Copy" under TOKEN. Paste this value somewhere on your computer. This is a unique ID for your bot. Do not share your token with others.

Download ACNH.Sysbot and create config files

  1. Download the most recent release by clicking the button on their landing page: sys-bot
  2. Unzip the downloaded folder
  3. In the unzipped folder, run the CrossBot.ConsoleApp.exe. This will create a config file for you.
  4. Follow the prompts, press any key to exit
  5. In the unzipped folder, there will be two .json files: config.json and discord.json.

Modifying config files

  1. Double-click on the config.json file. It should open in your default Text Document viewer (usually Notepad) Note: A full description of parameters can be found on the sys-bot wiki
  2. Most of the settings can stay as-is. Scroll to the bottom of the file and change the IP value to your Switch's IP address. How do I find my Switch's IP address?
  3. Save and close this file
  4. Double-click the discord.json file.
  5. Enter a name for the bot. This is not the name for the bot in your Developer Portal. This is the message that shows under the bot in the server.
  6. Change the Token value to the token string you copied after saving your changes in Build-A-Bot. This will tell your Switch which bot you're running.
  7. Within the brackets [ ] for Channels, paste the channel ID where members will send commands like $lookup, $drop, and $order.
  8. Save and close the file

Invite your bot to your server

Note: You will need admin permissions to invite a bot to your server

  1. Go to the Discord Developer Portal and go to the OAuth2 page on the left
  2. Under SCOPES, check on the bot option
  3. Under BOT PERMISSIONS, check on the Send Messages, Manage Messages, Embed Links, Attach Files, and Read Message History options.
  4. Under SCOPES, click the Copy button to copy the Discord URL
  5. Paste that URL into a web browser
  6. Follow the prompt when it appears, selecting a server and clicking "Okay"

Re-run the Console app to make sure the bot was configured correctly

  1. Repeat step 3. This time, check that the program can connect to your Switch successfully

Orderbot for hosting Treasure Islands

Download and configure Sysbot.ACNHOrders

  1. Download the latest release of Sysbot.ACNHOrders by clicking the button here: SysBotOrders
  2. Unzip the folder
  3. If you have been given a config.json or Anchors.bin file already, copy and paste them into this folder.
  4. To generate an empty config.json file, double-click the SysBot.ACNHOrders exe to run the bot.
  5. To set anchors, follow the steps here: Setting anchor points

Orderbot

In order to use the Orderbot for fetching new Dodo codes automatically, there are a few requirements:

  1. The character cannot have any nook mile tickets in their inventory
  2. All "legal eagle" dialogs for flying and accepting visitors must be agreed to before running the bot
  3. The character must be linked to a working NSO account

Setting anchor points

Anchor points are stored in the Anchors.bin file. Anchors tell the bot where your character should stand for certain events.

  • Anchor 0: Where your character exists their house after the morning announcement
  • Anchor 1: Where your character should stand as visitors arrive and leave
  • Anchor 2: Where your character stands to enter the airport (so you will be staring at the airport entrance on your dock, do not enter the airport yet)
  • Anchor 3: Where your character stands to talk to Orville and get a Dodo code
  • Anchor 4: Where your character stands to exit the airport (so you will be staring at the airport exit from inside the airport, do not exit the airport yet)
  1. Double-click the config.json file in your Sysbot.ACNHOrders folder on your PC to open it in your default Text Document reader
  2. Under the DodoModeConfig section in the config.json file, change the LimitedDodoRestoreOnlyMode option to false. The LimitedDodoRestoreOnlyMode option tells the bot whether or not to automatically get a new Dodo code when you start. Usually, the option will be set to true. To set anchors manually, it must be set to false.
  3. Save and close the config.json file
  4. Open Animal Crossing on your Switch. Let the morning announcement run. When your character exits their house, do not move them. Do not touch the joycons at all.
  5. Double-click the SysBot.ACNHOrders exe to run the bot from your PC
  6. In your bot's Mission Control channel on Discord, type $setanchor 0 and send the message
  7. Repeat these steps for each anchor point. Move your character to the designated spot described above before type $setanchor + the anchor number in the Mission Control channel on Discord
  8. Close the SysBot.ACNHOrders exe on your PC
  9. Repeat steps 1-3 above, changing the option back to true
  10. Repeat step 5 above. If you have configured everything correctly, the SysBot.ACNHOrders exe dialog should show a success message and your character should automatically head to the airport for a Dodo code.

You do not need to touch your Switch again. If your island crashes, the bot will restart itself using the anchors you set. If you have automd enabled through Mission Control, a DM will be sent to all active players in your queue when the Dodo code updates. Otherwise, you will manually have to send the code yourself.

Full workflow for using Orderbot with Treasure Islands

  1. Restore a clean copy of the Treasure Island map in JKSV
  2. Opening Animal Crossing and go through the morning announcement
  3. Open Mobile Spawner and connect to your Switch
  4. Freeze the map using Mobile Spawner
  5. Open Sysbot.ACNHOrders, the bot will start the process of getting a Dodo code Note: Always restart your Switch in between islands, this will disconnect your Switch from Mobile Spawner and unfreeze your map. Closing Mobile Spawner will not unfreeze your map. You can also "Unfreeze" from MS.