Installation Guide¶

Get Spruce Bot up and running on your Discord server in just a few simple steps.

Step 1: Invite the Bot¶

Click the button below to invite Spruce Bot to your Discord server:

Invite Spruce Bot

Step 2: Select Your Server¶

1. Choose Server: Select the Discord server where you want to add Spruce Bot
2. Confirm Permissions: Review the permissions being granted
3. Click "Authorize": Complete the invitation process

Step 3: Verify Installation¶

Once added, verify that Spruce Bot is working:

&ping

You should see a response showing the bot's latency and status.

Permission Levels¶

Spruce Bot works with different permission levels depending on your server's needs:

Server Requirements¶

Before inviting Spruce Bot, ensure your server meets these requirements:

Initial Setup Commands¶

After installation, run these essential commands:

1. Check Bot Status¶

&botinfo

2. Sync Slash Commands¶

&sync

3. View Available Commands¶

&help

4. Configure AutoRole (Optional)¶

&autorole add human @Members
&autorole add bot @Bots

Troubleshooting Installation¶

Bot Not Responding¶

Problem: Bot appears offline or doesn't respond to commands

Solutions: - Check if bot has "Send Messages" permission in the channel - Ensure bot role is not muted - Try using slash commands instead: /help - Verify bot is online (green status indicator)

Permission Errors¶

Problem: "I don't have permission to do that" errors

Solutions: - Move bot's role higher in the role hierarchy - Grant specific permissions for the feature you're trying to use - Use &sync to refresh slash command permissions

Slash Commands Not Appearing¶

Problem: Slash commands don't show up when typing /

Solutions: - Use &sync command (requires Administrator permission) - Wait 1-2 minutes after syncing - Restart Discord client - Check bot has "Use Slash Commands" permission

Custom Installation¶

For advanced users who want to customize the bot's permissions:

Creating Custom Invite Link¶

1. Go to Discord Developer Portal
2. Select Spruce Bot application
3. Navigate to OAuth2 > URL Generator
4. Select scopes: bot and applications.commands
5. Choose specific permissions needed
6. Copy generated URL

Recommended Permission Sets¶

✅ Manage Channels
✅ Manage Roles
✅ Send Messages
✅ Embed Links
✅ Read Message History
✅ Use Slash Commands
✅ Mention Everyone

✅ Kick Members
✅ Ban Members
✅ Manage Messages
✅ Manage Channels
✅ Manage Roles
✅ Send Messages
✅ Embed Links
✅ Read Message History

✅ Send Messages
✅ Embed Links
✅ Read Message History
✅ Use Slash Commands
✅ Add Reactions

Post-Installation Steps¶

After successful installation:

1. Configure Permissions → - Set up proper role hierarchy
2. Quick Setup → - Configure basic features
3. Explore Commands → - Learn about available commands

Multiple Server Setup¶

If you're adding Spruce Bot to multiple servers:

Support¶

Need help with installation?

• 📚 Common Issues - Solutions to frequent problems
• 💬 Support Server - Get help from our community
• 📧 Email: support@nexinlabs.com

Next Step: Configure Permissions →