Star Comms

Installation Guide

From zero to comms-ready.

Everything in one rundown: install the client, invite the bot, use the new modal/panel Discord commands, then manage channels and assignments from the client Admin panel.

01 Install the client 02 Invite the bot 03 Discord setup 04 Crew flow 05 Go-live checklist API Docs
Start the rundown

Step 01 — Every operator

Install the client.

Every member who wants to talk needs the client. The standalone Windows MSIX is the recommended Windows path. Alternates below.

Recommended Windows MSIX

Azure-signed installer for direct installs, troubleshooting, and the fastest current release path.

 Store Microsoft Store

Alternate Windows install path for users who prefer Store-managed updates.

 Linux Linux AppImage

Make it executable, run it, link Discord inside the app.

 Android Android Control APK

Mobile control panel for admins and squad leads — no voice.

Premium shard hosts

Running a private shard?

Private shard owners should install the normal client above, then run the matching shard host build below on the machine or VPS that will route the org's dedicated network.

Building bots, dashboards, or op automation around a shard? Open the Owner API Docs.

Windows host Shard Setup

Windows installer with the shard control panel and bundled runtime.

 Linux Node Linux Shard

Node-based Linux shard host script.

 Linux Bun Bun Shard

Bun-based Linux shard host script.

 Automation Owner API Docs

Scopes, endpoint reference, PowerShell examples, and shard integration patterns.

After installing, members should open the client, run Check Updates, and link Discord once. They'll see your org as soon as the bot is configured — which is the rest of this guide.

Step 02 — Org leader, once

Invite the Star Comms bot.

The bot handles the one-time setup and role checks. It never joins voice channels — Star Comms voice runs through its own network, not Discord voice.

  1. Click Invite Star Comms and pick your org's Discord server. You need Manage Server permission.
  2. Keep both requested scopes: bot and applications.commands — the second one is what makes /star commands appear.
  3. Create (or pick) a command channel like #star-comms and decide which role is your commander role and which is your admin role. Those roles unlock client-side Admin controls.

Ready? This opens Discord's own authorization screen.

Invite Star Comms Bot + slash commands only. No voice channel access needed.

Step 03 — Org leader, in Discord

Use startup, config, status, then the Admin panel.

Discord setup is now three clean commands: /star startup, /star config, and /star status. Channel creation, channel removal, live assignment, and operator management happen in the Star Comms client Admin panel.

3.1

/star startup - wire the org

Run this first to open the setup modal. The modal collects the command channel, initial Full Admin role, initial Squad Leader role, and discovery options without forcing a long slash-command argument list.

# star-comms Startup modal
OC
Operation Commander
/star startup opens First-time setup modal asks for command channel, admin role, squad leader role optional org discovery gate
SC
Star Comms APP
Startup complete. Your org is now configured for Star Comms.
3.2

/star config - manage settings

Use /star config whenever you need to add or remove admin roles, change Squad Leader roles, adjust org discovery gates, or review the core server configuration from Discord.

# star-comms Config panel
AD
Server Admin
/star config panel roles, discovery, command settings buttons add, remove, update
SC
Star Comms APP
Configuration panel opened. Use the buttons to manage roles and discovery gates.
3.3

/star status - see the live picture

/star status shows premium entitlement, operation state, active users, net layout, and the current shape of the Star Comms server.

# star-comms Status panel
SL
Squad Lead
/star status shows premium, active users, net layout useful for pre-op sanity checks
SC
Star Comms APP
Premium active. 12 users online. 8 nets configured. Operation open.
3.4

Client Admin - build and run the radio board

Full Admins and Squad Leaders use the Star Comms client Admin panel for the actual operation work: create nets, rename nets, remove channels, assign users, disconnect stuck clients, and send ACARS alerts.

SC Star Comms Client Admin panel
AD
Client Admin
Admin panel channels Add, rename, remove members drag, assign, disconnect alerts ACARS broadcast
SC
Star Comms Client ADMIN
Board updated. Connected clients refresh automatically.

Current command reference

/star startup

One-time org setup through a modal. Use it to establish the command channel, initial admin roles, and discovery behavior.

/star config

Opens the configuration panel for roles, discovery gates, and server-level Star Comms settings.

/star status

Shows premium status, active users, net layout, and operation state.

Client Admin panel

Add, rename, remove, assign, disconnect, and send ACARS from the desktop client.

Removed old command flow

Net add/remove, open/close, and role add/remove work moved into panels and the client Admin surface.

Need more nets?

Premium lifts the ceiling to 20 nets, and a dedicated shard to 50 - see Premium Features.

Step 04 — Op night

What your crew sees.

Real captures from the actual client. This is the whole member journey: link, enter, get assigned, talk.

Star Comms launcher with Discord linked and org selected
1. Link & enter Members link Discord once, pick your org, and hit Enter Network. Only orgs running Star Comms appear.
Star Comms admin tab with connected operators and channel boards
2. Get assigned Your admins see everyone in the waiting room and drag them into the right nets for the op.
Star Comms radio console with assigned channels and keybinds
3. Key up Each assigned net appears as a channel card — set a push-to-talk key, route the audio, and transmit.

Step 05 — Before the first op

Go-live checklist.

Invite Star Comms Install the client Get help in the Discord