Skip to content

Salty Pirate

Setup

From invite to your first crew card – set up Salty Pirate on your server in a few minutes.

Setup guide

Ready to sail in a few steps

The first three steps are all you need. Everything after that is optional – turn on what your crew will use.

  1. Invite Salty Pirate

    Click Add to Discord, pick your server and keep the suggested permissions – they are exactly what the features need. You need the Manage Server permission on that server.

    Never give the bot Administrator – it doesn’t need it. Manage Channels, Manage Roles and Manage Events are only used by the optional extras below; if you untick them, everything else still works.

    When it joins, Salty Pirate posts a short hello in your server’s system channel pointing to /discover and /help. Already have the bot on another server? /invite gives you the same link.

    # tavern
    ⚓
    Deckhand/invite
    ☠
    Salty Pirate APP

    🏴‍☠️ Bring Salty Pirate aboard

    Add Salty Pirate to your server

    Join the support server – questions, bugs, ideas

    Add to your serverSupport server

  2. Check that it’s aboard

    Type /ping – if the bot answers, you’re good. /about shows bot and setup info. If the slash commands don’t show up right away, wait a moment and reopen Discord.

  3. Set your server’s timezone

    When members type times into /session plan (like fri 21:00), the bot reads them in your server’s timezone. Set it once:

    /settings timezone:Europe/Berlin

    Run /settings without options any time to see all current settings.

    Who can change settings? Only members with Manage Server see and use /settings, /usage and the crew admin commands (/crew create, /crew delete, /crew captain) – for everyone else they don’t even show up. To let your mods use them too: Server Settings → Integrations → Salty Pirate, pick the command and add their role.

    # tavern
    ⚓
    Deckhand/settings
    ☠
    Salty Pirate APP

    ⚙️ Salty Pirate Settings

    News channelNot set

    Cooking remindersEnabled

    Timezone for /sessionEurope/Berlin

    Crew voice channelsOff

    Sessions as server eventsOff

    Weekly reputation summaryOff

  4. Channel permissionsIf needed

    The bot’s role works everywhere @everyone can post. For private or locked channels (news, LFG, sessions, reputation), add it by hand: Edit Channel → Permissions → add Salty Pirate and allow:

    • View Channel
    • Send Messages
    • Embed Links

    For crew voice channels the bot also needs Manage Channels in the category you pick with lfg_voice_category:.

    Want the commands only in certain channels or for certain roles? Server Settings → Integrations → Salty Pirate.

  5. Sea of Thieves newsOptional

    Pick a channel for the official Sea of Thieves announcements – the bot checks every 30 minutes and posts new ones there:

    /settings news_channel:#sot-news

    The bot needs Send Messages in that channel. Stop it with /settings disable_news:True. /news shows the latest three on demand.

  6. Weekly reputation summaryOptional

    Members log their faction levels with /rep set. Pick a channel and the bot posts who levelled up every Monday at 09:00 in your server’s timezone:

    /settings rep_channel:#reputation

    Turn it off with /settings disable_rep_summary:True.

  7. Voice channels for full crewsOptional

    When an /lfg crew fills up, the bot can open a temporary voice channel for it – limited to the crew size and removed once everyone has left (or after 10 minutes if nobody joins).

    /settings lfg_voice:True lfg_voice_category:Crews

    Needs Manage Channels (part of the invite). Without a category, the channel goes next to the LFG post.

  8. Sessions under EventsOptional

    Every /session plan can also be listed under your server’s Events. Clicking Interested there counts as Going on the card.

    /settings session_events:True

    Needs Manage Events (part of the invite).

  9. Crews with their own roleOptional

    With /crew create every crew gets a mentionable Discord role. The invite already asks for Manage Roles – one thing is left for you:

    • In Server Settings → Roles, drag the bot’s role above the crew roles. Discord only lets a bot manage roles below its own.

    Then pick captains with /crew captain. If you invited the bot before version 1.6.0, give its role Manage Roles by hand or invite it again.

  10. Show your crew around

    Tell your members about /discover – a guided tour of all features – and /help for the full list. A good first step for everyone: /profile set with gamertag, platform and favourite roles on board.

    # tavern
    ⚓
    Deckhand/discover
    ☠
    Salty Pirate APP

    🏴‍☠️ Discover Salty Pirate

    Choose a category below to quickly learn which commands to use.

    Start hereNavigationSurvivalVoyageGuildCommunity

  11. Stay updatedOptional

    Join our support server and follow #announcements – new versions then show up in a channel on your own server.

  12. Bot doesn’t answer?

    • Is the bot down? Check status.saltypiratebot.com first.
    • Nothing happens in one channel: the bot can’t see or post there – check the channel permissions above.
    • Slash commands are missing: reopen Discord, then check Server Settings → Integrations → Salty Pirate for channel or role limits.
    • /crew can’t give roles: drag the bot’s role above the crew roles.
    • No crew voice channel: the bot needs Manage Channels in that category.

    Still stuck? Send /feedback or ask in the support server.

All hands on deck

Hoist Salty Pirate on your server

Add the bot to your Discord in a few clicks – it asks only for the permissions its features use. Questions, bugs or ideas? Join our community server.

Add to DiscordJoin the crew Buy the crew a grog