BitCraft Sync — Discord Bot

Calculator Settlement Planner
🤖

BitCraft Sync Discord Bot

Bring your team's crafting progress and claim energy alerts directly into Discord — no need to keep the web app open.

Add to Discord

Setup

1
Add the bot to your server

Click the "Add to Discord" button above and select your server. You need the Manage Server permission in Discord to add bots.

2
Create a team share on BitCraft Sync

Open the calculator, load your claims, then click "Share Your Page" → "Create Team Share". After creation, your share URL will look like bitcraftsync.app/s/AbCdEf — the 6-character code at the end is your share code.

3
Register the share code

In any channel in your Discord server, run:

/bitcraft-setup AbCdEf

Requires the Manage Channels permission on your Discord server. The bot verifies the share code before saving it.

Commands

Command Description Who
/bitcraft-setup <share_code> Register your team share code with this server Admin
/bitcraft-progress [profession] Show crafting progress summary — all professions or one filtered Everyone
/bitcraft-items <profession> [tier] Show item-level detail for a profession, optionally filtered by tier Everyone
/bitcraft-sync-link Show the web URL for this server's team share Everyone
/bitcraft-claim-monitor on|off|status Enable daily claim energy reports and low-supply alerts in this channel Admin
/bitcraft-hexite-monitor add|remove|status|off [region] Track Hexite Sealed Vaults by region; daily reports and harvestable alerts in this channel Admin

Admin commands require the Manage Channels Discord permission.

Claim Energy Monitor

1
Grant the bot permission to post in the alert channel

The bot needs View Channel and Send Messages permissions in the channel where alerts should appear. These are separate from the Discord user permissions required to run the command — the bot itself must be able to post there proactively.

In Discord: open the channel settings → Permissions → add the BitCraft Sync bot (or its role) with View Channel and Send Messages enabled.

2
Enable the monitor in that channel

Run /bitcraft-claim-monitor on in your team's notification channel. The bot verifies permissions by posting the first report immediately using the same mechanism as daily alerts. If it succeeds, monitoring is enabled and you'll see a confirmation. If permissions are missing, the command will tell you exactly what to fix — nothing is saved until the first post works.

3
Automatic reports and alerts

The bot checks claim energy every 5 minutes. It posts a daily summary and escalates to warnings (every 4 hours) when supplies drop below 48 hours, and to critical alerts (every 30 minutes) below 24 hours. Run /bitcraft-claim-monitor status at any time to see the current state, or /bitcraft-claim-monitor off to disable.

Hexite Deposit Monitor

Tracks Hexite Deposits by region and tells you when they're ready to harvest. Of the game's 25 regions, 9 contain deposits (regions 7, 8, 9, 12, 13, 14, 17, 18, 19); the bot uses BitJita's live map export (the same data behind map.bitjita.com) to read each deposit's coordinates and respawn timer. You build up the set of regions you care about one at a time.

1
Grant the bot permission to post in the alert channel

Same as the claim energy monitor: the bot needs View Channel and Send Messages in the channel where deposit alerts should appear.

2
Add the first region

Run /bitcraft-hexite-monitor add region: 14 in your notification channel (autocomplete lists the valid region ids). The bot verifies permissions by posting the first report immediately; if it succeeds, monitoring is enabled for that region. Add more regions the same way — each one is picked up on the next 5-minute check.

3
Daily reports and harvestable alerts

The bot checks deposit status every 5 minutes. It posts a daily summary (upcoming respawns with countdowns and coordinates, plus currently harvestable deposits), and an immediate Harvestable alert the moment a deposit finishes its respawn timer. Each deposit alerts at most once per active period. Use /bitcraft-hexite-monitor status to see the current state on demand, /bitcraft-hexite-monitor remove region: 14 to drop a region, or /bitcraft-hexite-monitor off to disable entirely.

Note: the monitor tracks the harvestable Hexite Deposit resource nodes (the large ore deposits scattered across the inland regions), sourced from BitJita's empireResources.geojson map export. Region numbers follow the 5×5 grid on the map's Regions panel.