3. Discord

Connect the official Saba-chan bot, then choose the servers and command permissions for each Discord server.

3. Discord

The Saba-chan Discord bot is an official bot that runs in the Saba-chan cloud. You don't need to make a bot or manage a token, and you don't need port forwarding (a router setting that passes outside connections to your PC). The Saba-chan on your PC connects out to the cloud and picks up Discord commands from there.

Setting it up takes three steps: connect the bot (pairing), choose which servers each Discord server can use, and decide who can use which commands.


Step 1: connect the bot (pairing)

Saba-chan
ServersDiscordSettings
DaemonBot off
ConnectionNot connected
Discord servers
General
Connect to DiscordGet a code and type it in your Discord server. Once connected, you can start and stop game servers from that server through the bot.
Connect a Discord serverInvite the bot
#generalOur Server
kimchi12:00
Invited the bot!
Message #general
  1. On the Discord screen at the top of the app, open Connection and press Connect a Discord server.
  2. If the Saba-chan bot isn't in your Discord server yet, invite it first with Invite the bot.
  3. When the pairing code and the command to type (/saba connect code:…) appear, press Copy.
  4. Paste it in a Discord channel and send it. Only people with the Manage Server permission in that Discord server can use this command.
  5. If this is your first time using Saba-chan with this Discord account, the bot guides you through registration first. Press Register, read the terms on the website and register, and that reply turns into a connection confirmation. The code waits in the meantime.
  6. When the bot asks whether to connect, press Connect. Press it only when the code came directly from your own Saba-chan app; if someone else gave you the code, that person's PC gets connected to your account.
  7. The bot confirms the connection, and the app switches to Connected.

A code is valid for 5 minutes. After that, press Get a new code. Once your Discord account has been connected, you can connect another Discord server without a code: send just /saba connect there and every PC on your account is connected to that Discord server right away. This also needs the Manage Server permission on that Discord server, and a Discord server connected this way shows no game servers at first, so pick which servers to open in the app (Step 2 below). A Discord server connected with a code follows the Open my servers right away in new Discord servers setting on the app's Discord → Connection screen.

You can connect several PCs to one Discord account. If you send a new code from an account that already has a PC, the bot shows Connect as new PC and Reconnect <PC name> buttons. Choose Connect as new PC for a PC you are connecting for the first time, or pick the PC if you are reconnecting one you connected before (its old connection stops working). See your PCs, rename them or remove them with /saba my-pcs.

One Discord server can also have several PCs. When a friend connects their own PC to the same Discord server, the servers of both PCs appear together, and each command goes to the PC that has that server. If server names clash, the server of the PC that joined later gets -PCname added to its name. Shared settings such as language, prefix, music and channel assignments are changed by the owner of the first connected PC and the Discord server owner. Each PC's servers and permissions are set by that PC's owner.


Step 2: choose the servers for each Discord server

Connected Discord servers are listed under Discord → Discord servers. Pick one and its tabs open.

Saba-chan
ServersDiscordSettings
DaemonBot online
ConnectionConnected
Discord servers
GOur Server
General
Our Server
InstancesMembersCommandsWordsChannelsBot settings
Instances this Discord server can use
All instances
New instances show up right away
Only the ones I pick
Only instances you turn on are visible in Discord

On the Instances tab you choose which game servers this Discord server can use. An instance is one game server registered in Saba-chan.

  • All instances: every server, now and in the future, is visible.
  • Only the ones I pick: only the servers you turn on are visible and usable from this Discord server. Use this to give different groups of friends different servers.

A server you haven't allowed doesn't show up anywhere in that Discord server: not in commands, lists or slash commands.


Step 3: set command permissions

There are five permission levels. Levels are cumulative, so a higher level can use every command a lower level can.

LevelWho
Owner (3)The person who connected this Discord server. Can use every command and can't be demoted
Admin (2)People you trust with dangerous commands
User (1)People who can start and stop servers. This is every member's default level at first
Guest (0)People who can only use safe commands, such as viewing status
Banned (-1)Can't use any bot feature, Singing Saba-chan and Talking Saba-chan included

You open permissions by clicking a server (instance) on the Instances tab. Press All instance permissions to see all servers at once. There are two screens.

  • Level commands: A ladder where commands sit as chips. A chip sits at the lowest level that can use that command. Drag a chip to another step or press it to change the required level. The Command preset at the top (Loose, Default, Strict) places commands all at once by risk (Safe, Caution, Danger). The default preset is Safe = Guest, Caution = User, Danger = Admin. Changing the preset puts chips you moved by hand back to the preset. The Talking Saba-chan cap at the bottom is the level that requests through Talking Saba-chan can't exceed (Guest at first).
  • Levels per member: Set the default level (the level members without their own level follow) and give each member a level. In Edit levels you can rename levels, add steps and reorder them.

Member levels and the preset apply to all servers of this Discord server together. If you move a server-wide command (a command not tied to one server), it changes on every server's permission screen. Help and list are open to everyone who isn't banned.

  • In the window that opens when you press a chip, you can also change the Discord confirmation step (Safe, Caution, Danger) per command. This step is used only for comparison with the confirm-before-commands setting below, and it doesn't change the required level or the confirmation in the app and CLI.
  • In Discord, the owner can also change member levels and the default level with /saba permission. If you pick a user, it is that member's level (picking remove in the level list returns them to the default level); if you leave the user empty, it is the default level. The preset, the Talking Saba-chan cap and per-command levels are changed only in the app.

Confirm before running

Whether the bot asks again with a button before running a command requested in Discord is set on the Confirm before commands card of the Discord server's Bot settings tab. Only the person who asked can press the button.

ItemSteps you can chooseStarting value
Requests made directly to the bot (prefix commands and slash commands)Every command · Caution and above · Dangerous commands only · Don't askDangerous commands only
Talking Saba-chanEvery command · Caution and above · Dangerous commands only · Don't askEvery command
  • Management actions that Talking Saba-chan picks, and requests that mix several people, are always asked, whatever this setting is.
  • The app, web and CLI ask for dangerous commands and for stop and restart, whatever this setting is.
  • In the CLI, view and change it with saba-chan-cli bot confirm.

Try it in Discord

#generalOur Server

Message commands go prefix server command. The prefix is the word that starts a command. The default prefix for a Discord server where the bot answers in English is Saba-chan; change it or add more per Discord server on the Discord server's Bot settings tab under Command prefix.

What you wantWhat to send
Server list and statusSaba-chan list
Start / stop / statusSaba-chan mc start · Saba-chan mc stop · Saba-chan mc status
Show how to use itSaba-chan help

To name a server, use its server name, a call word you set on the server screen's Discord tab, or, when it is the only server of that game, the game name (for example mc or minecraft). If you have several servers of the same game, call them by server name or by the word you set for each. Dangerous commands are not run by game name, so call them by server name or a set word. Each server also gets its own /server-name slash command.

On the same Bot settings tab, under Slash commands, you choose whether to put saba in front of commands such as /saba status (turn it off and they appear directly as /status), whether the server command name uses the server name or its first call word, and whether lookup results are visible only to the person who called them.

To manage more from your phone with buttons, open Saba-chan web with /saba web.