Splatnet/Music bot was originally created in 2017 to be a music/soundclip playing bot. It has evolved into its primary purpose of fetching info from Nintendo Switch Online
- Splatoon 2 & Splatoon 3: Rotation info, Splatnet gameplay stats, ordering gear and notifications of specific gear arriving in the store
- Animal Crossing New Horizons: Passports
If you don't care about self-hosting the bot, you can use the following link:
For self-hosting: See Here
S2S - @frozenpandaman Foundation of iksm
iMink - @jonewang - Built-in F-Token provider
Splatoon 3 database - @leanyoshi - Data mine
Running /token and giving it the link it requests pulls your account session token from Nintendo to grant it access to game specific data. It is identical to logging into the NSO App on your phone. The game specific tokens are ONLY used to access your Splatoon 2 stats and ACNH passports to post within Discord and order gear for you. The account session token is used to refresh game tokens if they expire. They are used for nothing else. Feel free to look over modules/nsotoken.py to audit the handling of keys yourself.
There are a few admin commands to configure the bot. To run these commands, you need the administrator permission in your discord server. Can't DM the bot with any of these commands
/admin playlist: Brings up a view to manage the/voice play randomplaylist/admin dm add: Subscribe to DMs on users leaving the server/admin dm remove: Unsubscribe from DMs on users leaving the server/admin announcement set CHANNEL: Sets a chat channel for announcements about restarts/new features from the devs/admin announcement get: Gets the name of the channel that is set to receive announcements/admin announcement stop: Disables announcements from the devs for the server/admin s2feed create: Create (or change) a Splatoon 2 feed for rotation updates. Takes 3 True/False flags to put maps/sr/gear info in the feed./admin s2feed delete: Deletes a Splatoon 2 feed for a channel./admin s3feed create: Create (or change) a feed for Splatoon 3 rotations. The flags for maps/sr/gear will enable/disable those rotation updates for a channel./admin s3feed delete: Deletes a Splatoon 3 feed for a channel.
Commands to get info from SplatNet 3 - These commands are largely beta. Feedback is welcome.
/s3 stats sr: Displays your stats from Salmon Run/s3 stats battle NUM: Displays the results of a previous battle (1-50)/s3 schedule: Shows the map/mode schedule for a specific game type/s3 maps: Shows the current multiplayer maps/s3 srmaps: Shows the current Salmon Run maps/s3 fit: Posts your current gear loadout/s3 fest: Shows if there is an announced SplatFest/s3 scrim: Generate a list of Splatoon 3 maps and modes/s3 weapons info WEAP: Gets Sub/Special/Level/Points for special for WEAP/s3 weapons sub SUB: Gets all weapons with the subweapon SUB/s3 weapons special SPECIAL: Gets all weapons with the special SPECIAL/s3 weapons stats WEAPON: Gets gameplay stats for a weapon/s3 store list: Shows the current items in the store/s3 store order GEAR: Orders the name of a piece of gear in the store/s3 storedm add TRIGGER: Sends a DM when gear with TRIGGER arrives. TRIGGER is Name of gear/brand of gear/main ability on gear/s3 storedm remove TRIGGER: Removes you from getting a DM with TRIGGER (see above for TRIGGER)/s3 storedm list: Shows your current triggers for getting a DM on items arriving in the store/s3 replays watch: Watches for new replays to post in a channel for 2 hours. Rerun to refresh the timer.
These commands cannot be used in DM's.
/voice join CHANNEL: Join a Voice Channel. If no channel is provided, joins the voice channel you are currently connected to./voice play url URL: Play/Queue Up a website to Play from URL/voice play search SOURCE SEARCH: Searches SOURCE for SEARCH to play/voice play sound SOUND: Plays a soundclip if in voice chat (get from/voice sounds)/voice play random NUM: Plays a random url from my playlist./voice currentsong: Displays the currently playing Song/Video/voice queue: Displays my current queue of songs to play/voice skip: Stop a current playing video and play the next one/voice end: Stops all music playback/voice volume: Sets my voice volume for the current song (Youtube defaults to 7%, caps at 60% vol)/voice sounds: List all possible sounds for/voice play soundto play
/s2 maps current: Displays the current Splatoon 2 Gamemodes/Maps/s2 maps next NUM: Displays the upcoming Splatoon 2 Gamemodes/Maps NUM rotations in the future (1-11)/s2 maps currentsr: Displays the current Splatoon 2 Salmon Run Map/Weapons/s2 maps nextsr: Displays the next Splatoon 2 Salmon Run Map/Weapons/s2 maps random NUM: Generates a list of random maps (1-10, NUM is optional for just 1 random map)/s2 maps callout MAP: Provides a map with callout locations/s2 maps list: Shows all Splatoon 2 maps w/ abbreviations/s2 store currentgear: Gets all of the current gear for sale on SplatNet/s2 store dm add FLAG: DM's you when a piece of gear with FLAG (Ability/Brand/Gear Name) appears in the SplatNet store. Can't DM the bot with this./s2 store dm list: Shows you all FLAGS you are subscribed to for when gear with FLAG appears in the store. Can't DM the bot with this./s2 store dm remove FLAG: Removes you from receiving DM's when a piece of gear with FLAG (Ability/Brand/Gear Name) appears in the SplatNet store. Can't DM the bot with this./s2 weapons random NUM: Generates a list of random weapons (1-10), NUM is optional for just 1 random weapon)/s2 weapons info WEAP: Gets Sub/Special/Level/Points for special for WEAP/s2 weapons sub SUB: Gets all weapons with the subweapon SUB/s2 weapons special SPECIAL: Gets all weapons with the special SPECIAL/s2 weapons list TYPE: Gets all weapons of the type TYPE
The following commands require you to run /token and follow the instructions. Run /token again to remove all tokens from the bot.
/s2 stats battle NUM: Gets stats from NUM last battle (1 is latest, upto 50)/s2 stats rank: Shows your ranks in the ranked gamemodes/s2 stats multi: Shows various stats from your gameplay/s2 stats sr: Shows various stats from Salmon Run/s2 stats maps MAP: Pulls stats for a specific map/s2 store order ID/ITEM NAME:/store currentgearprovides an ID. Use either the ID or the name of an item on the store to order it/s2 weapons stats WEAPON: Pulls stats for a specific weapon
The following commands require you to run /token and follow the instructions. Run /token again to remove all tokens from the bot.
/acnh passport: Posts your passport for Animal Crossing: New Horizons/acnh getemotes: Gets all available emotes to use with/acnh emote/acnh emote: Makes your character in ACNH perform an emote. Must be connected to the internet with your game/acnh message: Makes your character in ACNH say a message. Must be connected to the internet with your game
/fc get: Displays your Nintendo Switch friend code from NSO. Can bet set manually with /fc set/fc set: Sets a Friend Code so you don't need to run/token./token: Used to setup a NSO token. Required for specific commands
/github: Displays my github link/support: Posts an invite link to my discord support guild