Simple SpaceWatch Setup for NFT Collection
Get started with SpaceWatch by inviting it to your server, adding an NFT Collection and setting up a role to be assigned.
1. Invite SpaceWatch to Your Server
- Sign in to the dashboard and open
Dashboard → Servers. - Scroll to Servers Without SpaceWatch.
- Click Invite Bot. This opens Discord’s OAuth screen at
https://discord.com/oauth2/authorize?client_id=1099835126738866228&permissions=268435456&scope=bot+applications.commands. - Complete the Discord prompts (pick the server, grant permissions). When the bot joins, the card moves to Configured Servers with a Manage Server button.
Tip: if the bot is already present, click Manage Server to jump straight into configuration.
2. Add an NFT Collection
Once inside the Server Management view, you land on the NFT Collections tab.
Option A – Import from XRP Café vanity URL
- Click Add Collection.
- In the dialog’s Import with XRP Café section, paste the vanity slug (the piece after
xrpcafe.com/collection/). - Press Find. The app resolves issuer/taxon automatically.
- Review the pre-filled fields (you can still edit them) and click Add Collection.
Option B – Enter details manually
- In the same dialog, fill in:
- Collection Name – e.g.,
RudeBoys. - Issuer Address – the XRPL issuer account.
- Taxon – optional; leave blank to include every NFT from that issuer.
- Collection Name – e.g.,
- Submit with Add Collection.
While saving, watch the inline status indicator (top-right “Saving…”). Once complete, the table shows live on-chain counts plus metadata coverage, so you can verify the import succeeded.
3. Create a Role Rule
Navigate to the Roles tab in the same server page.
- Click Add Role.
- Pick the Discord role to grant (dropdown lists every non-managed role).
- Choose a Category:
- NFT for collection-based gating (with options for amount, trait type, or trait value).
- Token for issued currencies or MPTs.
- Set your condition:
- Simple roles use a single rule (e.g., “hold 1 NFT from Collection A”).
- Multi-condition (Premium) allows complex AND/OR logic across multiple collections/tokens.
- Save the rule. It appears in the table with edit/delete controls and a blacklist manager for edge cases.
Remember: premium limits unlock more rules (20), multi-condition logic, token gating, and sales feeds. Use the Settings → Premium Features card for a quick comparison if you need to upgrade.
4. Publish the Verification Flow in Discord
With collections and roles ready, switch to your Discord server:
- Ensure SpaceWatch has a text channel where members can verify.
- Run the slash command
/setupand pick the channel to post the message to. - Test it yourself: click Verify and link your wallet or use the web dashboard, then wait and see if your role is granted.
5. Check Discord Role Hierarchy
Discord only allows a bot to assign roles that sit below the bot’s highest role.
- Open Server Settings → Roles in Discord.
- Drag the
SpaceWatchrole above every role you configured in the dashboard (e.g., “Verified Holder”). - Save the order.
- If the hierarchy is wrong, SpaceWatch cannot grant the role.
Final Checklist
- Bot invited and visible in Configured Servers.
- At least one NFT collection added (via XRP Café or manual issuer/taxon).
- Role rule created and saved (simple or multi-condition).
-
/setuprun in a live Discord channel to post the verification message. -
SpaceWatchrole positioned higher than every auto-assigned role.