Documentation
Everything you need to get started with MMO Maid — from setting up your first server to building marketplace plugins.
Getting Started
What is MMO Maid?
MMO Maid is a multi-tenant Discord bot platform built for gaming communities. It provides analytics, moderation, voice channel management, and a marketplace where developers can publish and sell custom plugins.
Every server gets its own isolated configuration, data, and plugin settings. Nothing is shared between servers.
Adding the Bot to Your Server
Click "Summon to Your Server" on the home page to invite the shared MMO Maid bot. Once added, visit the Dashboard to select your server and start configuring.
The shared bot is free and includes all 6 built-in plugins. For custom branding and marketplace access, upgrade to a BYO subscription.
Shared Bot vs BYO (Bring Your Own)
- Uses the MMO Maid identity (name, avatar)
- All 6 built-in plugins included
- Per-server configuration via the dashboard
- No marketplace plugin access
- Your own bot name, avatar, and token
- Full marketplace plugin access
- Sandbox controls for plugin permissions
- Transferable server slot
- Priority support
Setting Up a BYO Subscription
- Go to Account → + Buy BYO Slot
- Choose a plan (Nanny, Mistress, or Governess)
- Complete payment via Stripe
- Back on the Account page, assign the slot to your server
Configuring Your Custom Bot Token
After assigning a BYO slot to your server:
- Create a bot application at Discord Developer Portal
- Copy the bot token
- Go to Bot Settings in the MMO Maid dashboard
- Paste the token and click Set Token
- Invite your custom bot to your server using the generated invite link
Plugin System
Built-in Plugins
Every server gets access to these plugins for free:
- Analytics — Member activity, message trends, voice usage, and growth metrics
- Sentinel Moderation — Auto-moderation, word filters, spam detection, and raid protection
- Join-to-Create Voice — Dynamic voice channels that create and delete automatically
- Tickets — Support ticket system with panels, forms, and transcripts
- Beacon Events — Community event scheduling and reminders
- Group Finder — LFG matchmaking for MMO activities
Marketplace Plugins
The Marketplace is where developers publish custom plugins. BYO subscribers can browse, purchase, and install third-party plugins directly from the dashboard.
Each marketplace plugin runs in a sandboxed Docker container with no direct network access, memory limits, and read-only filesystem. Plugins interact with Discord through a controlled RPC API.
Permissions & Sandbox
When installing a marketplace plugin, you choose which permissions to grant:
- Capabilities — what the plugin can do (read messages, send messages, manage roles, etc.)
- Proxy Domains — external URLs the plugin can access through the proxy
- Privacy Mode — whether the plugin sees message content or only metadata
You can change permissions at any time from the Plugins page.
Developer Guide
Building Plugins
Plugins are Python packages built with the MMO Maid SDK. The SDK provides event handlers, KV storage, Discord API access, and more.
For full SDK documentation, code examples, and the template project: Plugin SDK Docs (login required).
- Log in and go to Developer → My Plugins
- Download the template project
- Build your plugin using the SDK
- Upload a new version from the developer portal
- Set up pricing plans
- Submit for review
Submission & Review
All marketplace plugins go through a security and quality review before publishing. The review checks:
- No malicious code or data exfiltration
- Proper use of SDK APIs
- Reasonable resource usage
- Working functionality as described
Reviews typically complete within 48 hours.
Revenue & Payouts
Developers earn revenue from plugin sales. The platform takes a percentage fee (starting at 30%, decreasing with volume).
- Stripe handles all payments and payouts automatically
- 30-day hold period on new sales before funds are released
- Daily automatic payouts to your connected Stripe account
- Track earnings, sales, and upcoming payouts in the Earnings dashboard
Account & Billing
BYO Subscription Tiers
BYO subscriptions are priced per server. Each slot covers one Discord server with a custom bot identity. Visit Buy BYO to see current pricing and start a free trial.
Plugin Licenses
Marketplace plugins are licensed per server. When you purchase a plugin, the license is tied to your BYO subscription. If you move your BYO slot to a different server, your plugin licenses move with it.
Manage all your licenses from Account → All Purchased Plugins.
Cancellation & Refunds
You can cancel your BYO subscription at any time from the Account page. When a BYO subscription is cancelled:
- All plugin licenses tied to that subscription are automatically cancelled
- Your server reverts to the shared bot
- Plugin data is retained for 30 days in case you re-subscribe
Plugin refunds can be requested within 7 days of purchase from the plugin's Marketplace page.
Frequently Asked Questions
Can I use marketplace plugins with the free shared bot?
No. Marketplace plugins require a BYO subscription because they run in a sandboxed environment tied to your custom bot token.
What happens if I switch servers?
You can reassign your BYO slot to a different server from the Account page. All plugin licenses and configurations move with the slot.
Is my server's data shared with other servers?
No. MMO Maid uses full per-server data isolation. Your configuration, analytics, and plugin data are completely separate from every other server.
Can plugins read my messages?
Only if you explicitly grant the events:message_content capability during installation. By default, plugins only see metadata (who sent a message, which channel) without the actual content.
How do I become a plugin developer?
Log in, go to Developer → My Plugins, and create your first plugin. You'll need to connect a Stripe account to receive payouts.
Where can I get help?
Join our Discord support server or use the ticket system in the dashboard.