D&D Companion

🎲 D&D Companion Bot

A versatile Discord bot designed to enhance your D&D gaming experience with dice rolling, NPC interactions, character management, and more!

🛡️ Basic Features

🎯 Dice Rolling

• /roll [dice] - Roll dice using standard notation (e.g., "d20", "2d6")
• Basic rolls are available to all users
• Example: /roll d20 rolls a single d20
• Example: /roll 2d6+3 rolls two six-sided dice and adds 3 to the result

🧙‍♂️ NPC Interaction

• /chat [message] - Chat directly with the NPC
  • Example: /chat Tell me about this town
• /greet - Get a greeting from the NPC
  • Example: /greet for a friendly introduction
• /clear - Clear chat history with the NPC
  • Use this to start fresh conversations
• /npc-info - View current NPC settings
  • Shows name, personality, and other attributes

👥 Character Management

• /join [name] [species] [class] [personality] - Join the party with your character
  • Example: /join Elric Human Fighter "Brave and loyal warrior"
• /leave - Leave the party with your character
  • Removes your character from the current adventure
• /character-info [username] - View your or another player's character details
  • Example: /character-info to see your own character
  • Example: /character-info @username to see another player's character
• /character-list - Show all current party members
  • Displays everyone currently in the adventure

🗺️ Campaign Management

• /campaign-info - View current campaign setting information
  • Shows the world setting for your adventure
• /help - Display all available commands and their usage
  • Complete reference for all bot features and commands

✨ Premium Features

Premium features are available to servers with an active subscription. Contact your server admin for details.

🎲 Enhanced Dice Rolling

• Advantage/disadvantage rolls with /roll [dice] advantage:true or /roll [dice] disadvantage:true
• Multiple rolls in one command with /roll [dice] times:[1-10]
• Example: /roll d20 advantage:true or /roll 2d6 times:3

👥 Extended NPC Management

• /npc-add [name] [description] - Add additional NPCs (up to 15)
• /npc-remove [name] - Remove NPCs from your collection
• /npc-list - View all NPCs in your collection
• /chat [message] name:[npc_name] - Chat with specific NPCs by name
• /greet name:[npc_name] - Get greeting from specific NPCs
• /npc-info name:[npc_name] - View specific NPC details

🖼️ Image Generation

• /image [prompt] - Create AI-generated images
  • Example: /image a mysterious wizard tower in a dark forest
• Options to enhance your images:
  • include_campaign:true - Include campaign setting context
  • include_npc:true - Include NPC details
  • include_party:true - Include party member information
  • battlemap:true - Create the image as a battlemp
  • Example: /image dragon attack include_party:true include_npc:true
• Higher image generation limits
• Better image quality with premium subscription

💎 Premium Status

• /premium-status - Check your server's premium subscription status
• View available premium features
• See usage limits and remaining quota

🛡️ Moderator Commands

These commands require moderator permissions:

🧙‍♂️ NPC Management

• /npc-set-default [name] [description] - Change NPC name and personality (description is optional if NPC exists)
• /reset npc:true - Reset NPC to default settings

🗺️ Campaign Management

• /campaign-setup [description] - Set campaign setting description
• /campaign-reset - Reset campaign setting to default
• /reset campaign:true - Alternative way to reset campaign settings

👥 Party Management

• /character-add [username] [name] [species] [class] [personality] - Add a character for another player
• /character-remove [username] - Remove a character from the party
• /reset party:true - Remove all characters from the party

🔄 Combined Reset Command

• /reset - Reset multiple elements at once with options:
  • party:true - Reset all party members
  • npc:true - Reset NPC settings
  • campaign:true - Reset campaign settings

🚀 Getting Started

1. Invite the bot to your server
2. Use /help to see all available commands and their detailed usage
3. Start with basic commands like /roll d20 for dice rolling and /chat hello to interact with NPCs
4. Server administrators should set up your campaign with /campaign-setup and customize NPCs with /npc-set-default
5. Players can join the party using /join [name] [species] [class] [personality]
6. Once set up, use /character-list to see everyone in your adventure
7. Start role-playing and enjoying your D&D sessions with enhanced features!

💫 Premium Benefits

Premium features include:

• Advanced dice rolling options (advantage/disadvantage, multiple rolls)
• Support for multiple NPCs (up to 15 different characters)
• AI image generation for visualizing scenes, characters, and items
• Access to premium NPC commands like /npc-add, /npc-remove, and /npc-list
• Significantly higher usage limits:
  • 150 text interactions per hour (vs 20 for basic users)
  • 40 images per hour (vs 4 for basic users)
  • 30 characters per server (vs 8 for basic users)
  • 15 NPCs per server (vs 1 for basic users)

🔄 Command Combinations & Tips

• Combine campaign context with NPCs for immersive storytelling
  • First use /campaign-setup to establish your world
  • Then create NPCs with /npc-set-default or /npc-add
  • Use /chat to interact with NPCs in your campaign setting
• Create memorable moments with image generation
  • Use /image with include_campaign:true and include_party:true to visualize key scenes
• Roll with advantage when your character has favorable conditions
  • /roll d20 advantage:true for important skill checks
• Use multiple NPCs to create interactive dialogues
  • Premium users can create diverse characters with /npc-add

❓ Support

For support or to inquire about premium features:

1. Contact your server admin
2. Join our support server
3. Check the /help command for detailed command usage
4. Use /premium-status to check your current subscription benefits

Note: Premium features are server-wide and benefit all members of the server.