Taro bot
What Taro does in our server.
Taro is the multi-server bot powering Tomodachi. It pulls together chat-based features (leveling, starboard, giveaways) and connects them to your taro.gg or tomodachi.to profile, so logging a game on Discord shows up on the site and vice versa.
Games
#Log games to your library and view anyone's profile inline.
`/games log` adds a game to your log. Start typing the game name and pick a result from the autocomplete list — Taro pulls in cover art and details automatically. Pick a status (Playing, Finished, Dropped, Backlog, Wishlist), optionally a half-star rating, and a short note. Your full log lives at the Game Log page on the website, and a public snapshot lives at `tomodachi.to/<your handle>` — what you're playing, recent logs, and four favorites. `/games profile` pulls that same snapshot into Discord for any member in the channel.
Commands
/games log game:<name> status:<...> [rating] [note]
Log a game. The game option uses live autocomplete — type a few letters and pick a match.
e.g. /games log game:Celeste (2018) status:Finished rating:★★★★★ (5.0) note:Best platformer.
/games profile [user]
Show a member's Taro game profile (defaults to you). Links out to tomodachi.to/<handle>.
Leveling
#Earn XP from chat, level up, get role rewards.
Members earn XP when they chat (configurable rate + cooldown). Levels can grant roles automatically. Mods configure XP rate, cooldown, restricted channels, and role rewards. Use `/rank` to see your XP and `/leaderboard` to see the top members.
Commands
/rank [user]
Show your or someone else's level and XP.
/leaderboard
Show the top members in this server.
/xp-config show | set-rate | set-cooldown | set-channel
(Manage Server) View or change XP rate, cooldown, and where XP is granted.
/xp-reward add | remove | list
(Manage Server) Grant a role automatically when a member hits a level.
/xp-exclude channel | role | list
(Manage Server) Block specific channels or roles from earning XP.
Profile Cards
#Generate a personalized PNG card showing your level + identities.
Run `/profile` to render your card — username, avatar, level, rank, and any in-game handles you've added. Set platform handles with `/profile-set-ign` (PSN, Xbox, Steam, etc.) so they show up on your card and on your profile on the site.
Commands
/profile [user]
Render the profile card image.
/profile-set-ign platform:<...> handle:<...>
Add or update a platform handle.
/profile-remove-ign platform:<...>
Remove a platform handle.
/profile-set-background url:<...>
Set a custom background image on your card (or clear it).
Starboard
#Pin top-reacted messages into a starboard channel automatically.
When a message hits the threshold of star reactions, Taro reposts it to the starboard channel. Mods configure the channel, threshold, emoji, and whether self-stars and NSFW posts count.
Commands
/starboard view
Show the current starboard configuration.
/starboard set-channel channel:<#channel>
(Manage Server) Set where starred messages get posted.
/starboard set-threshold count:<n>
(Manage Server) How many reactions a message needs before pinning.
/starboard set-emoji emoji:<...>
(Manage Server) Pick the reaction that counts toward the starboard.
/starboard toggle-self-star | toggle-nsfw
(Manage Server) Toggle whether self-stars or NSFW channels count.
RSS
#Pipe RSS / Atom feeds into a channel.
Subscribe a feed to a channel and Taro will post new entries on a schedule. List, test, pause, or remove feeds at any time.
Commands
/rss subscribe url:<...> channel:<#channel> [interval]
(Manage Server) Pipe an RSS/Atom feed into a channel.
/rss list
List feeds in this server.
/rss test url:<...>
(Manage Server) Preview the latest entry from a feed without subscribing.
/rss set-interval id:<...> interval:<...>
(Manage Server) Change the polling interval for a feed.
/rss enable id:<...>
(Manage Server) Re-enable a paused feed.
/rss unsubscribe id:<...>
(Manage Server) Remove a feed.
Giveaways
#Run timed giveaways with role gates and bonus entries.
Start a giveaway with a duration, prize, and number of winners. Members enter by clicking a button. Optional role gates restrict eligibility, and bonus-entry roles let regulars or boosters get extra weight in the draw.
Commands
/giveaway start prize:<...> duration:<...> [winners] [...]
(Manage Server) Launch a giveaway with optional role gates and bonus entries.
/giveaway list
Show active giveaways in this server.
/giveaway end id:<...>
(Manage Server) End a giveaway early.
/giveaway reroll id:<...>
(Manage Server) Re-pick winners after a giveaway ends.
Scoreboards
#Custom scoreboards for whatever the server tracks.
Define a scoreboard, give it columns, and let members submit scores. Useful for tournaments, run-tracking, and anything your server competes on.
Commands
/scoreboard create | edit | delete
(Manage Server) Manage scoreboards.
/scoreboard submit name:<...> score:<...>
Submit your score.
/scoreboard show name:<...>
Show a scoreboard.
Custom Embeds
#Author rich embeds without copy-pasting JSON.
Compose, save, and post styled embeds (rules, info posts, FAQs) without writing JSON by hand. Edits propagate so you can update an existing embed in place.
Commands
/embed create | edit | post | delete | list
(Manage Server) Author and manage server-side embed templates.
Help
#Browse what's enabled in your server right now.
`/help` lists every command available in this server, grouped by module. `/help command:<name>` shows full details for a single command, including subcommands and required options.
Commands
/help
Overview of every command available here.
/help command:<name>
Detailed help for a specific command.