← Back to Docs

// Guide

Ships & Hangar

Look up any Star Citizen ship with autocomplete, browse a manufacturer's full lineup, and build a personal hangar with one-click add/remove buttons.

TierFree
You'll needNothing — enabled by default; optionally restrict with an Allowed Role.

StarBot ships with a full Star Citizen ship database. Members can pull up any ship's stats and store price with /ship, page through everything a manufacturer makes with /manufacture, and keep a personal fleet — their hangar — that anyone can peek at via a right-click context menu. It all works out of the box; the only configuration is optional role-gating.

Looking up a ship

Run /ship name: and start typing — the name field autocompletes against the ship database, so carr finds the Carrack before you finish the word. The bot replies with a detail embed: manufacturer, role, crew, cargo capacity, dimensions, price, and a link to the RSI store page, plus buttons to add the ship to (or remove it from) your hangar.

/ship name:Carrack
SB
StarBotApp
Anvil Carrack
Expedition flagship — long-range exploration with a modular cargo bay, drone bay, and rover garage.
Manufacturer
Anvil Aerospace
Role
Expedition
Crew
4 – 6
Cargo
456 SCU
Length
126.5 m
Price
$600 USD
Data from the RSI ship database
Add to HangarRSI Store Page
A ship detail embed. The button adds the ship straight into your personal hangar.

Browsing a manufacturer

/manufacture name: shows a paginated lineup of every ship a manufacturer produces — handy when you know you want "something from Drake" but not which hull. The name field autocompletes manufacturers the same way /ship autocompletes ships; use the pager buttons under the embed to flip through the lineup.

/manufacture name:Drake Interplanetary

Your hangar

The hangar is each member's personal fleet list, built up from those Add to Hangar buttons (or trimmed with the remove button on the same embed).

| Command | What it does | |---|---| | /hangar view | List every ship in your hangar | | /hangar stats | Fleet totals — ship count and aggregate stats across your collection | | /hangar remove | Take a ship out of your hangar |

Curious what someone else flies? Right-click a member → Apps → View Hangar — the User context-menu command shows their fleet without them running anything.

Dashboard: restricting who can use it (optional)

Both halves of this feature appear as cards on the Features tab of your guild dashboard: Ship Sync (the ship database — /ship and /manufacture) and Hangar (the personal fleet — /hangar and the context menu). Each card's Configure modal has exactly one setting, an Allowed Role. Leave it empty and everyone can use the commands; set it and only members holding that role can.

Guild dashboard — Features tab
FeaturesPermissionsServer StatsAnalyticsEventsTokens
Ship Sync
Ship database lookups — /ship and /manufacture
Configure
Hangar
Personal fleets — /hangar and the View Hangar context menu
Configure
Configure Hangar
@Crew

Only members with this role can use the hangar commands. Leave empty to allow everyone.

CancelSave Changes
CancelSave Changes
Ship Sync and Hangar are separate cards, each with a single Allowed Role setting.
  1. 1

    Open the Features tab. Go to your guild's dashboard at trystarbot.com — Features is the default tab.

  2. 2

    Find the Ship Sync or Hangar card and click Configure. They're separate cards, so you can gate ship lookups and hangars independently.

  3. 3

    Pick an Allowed Role in the modal, then click Save Changes. Members without the role can no longer run the card's commands. To open it back up to everyone, clear the role and save again.

Per-command overrides too

Allowed Role is the quick, feature-wide gate. If you need finer control — say, /ship for everyone but /hangar remove limited to officers — the Permissions tab lets you override individual commands. See the command permissions guide.

  • Ship lookups pair naturally with citizen verification — verified members' RSI dossiers and hangars make a complete pilot profile.
  • The full command catalogue with arguments and tiers is in the command reference.

Have a question that isn't covered here? Ask in support.