Naya Docs
Use these docs as a setup manual for Naya. Most modules are designed to be configured in 5 to 15 minutes, and each guide focuses on the choices an admin needs to make before turning a feature on.
How to use these docs
Open a module from the left menu, then use the section links for setup, commands, limits, and recommendations. If you are configuring Naya for the first time, read the setup section first and leave advanced options at their defaults until the feature is working.
Fast setup
Most modules only need a channel, a few basic settings, and a posted panel. You can refine the details later.
Useful defaults
Naya is designed so the default settings are reasonable. Change values when you have a specific server need.
Recommended setup order
- Start with Main Settings so access rules and safety controls are clear.
- Set up Server Currency if your server wants coins, shop items, chests, or item rewards.
- Add Leveling, Pets, Garden, or Guildboard as optional engagement modules.
- Configure Tickets and Applications if staff need private workflows.
- Use Autoresponders, Stickies, and Embeds to reduce repeated questions.
Main Settings
Use /main-settings when you need server-wide command access, safety controls, or prefix behavior. Most feature setup should happen in the dashboard, but Main Settings is still useful for deciding who can manage Naya.
Access control
Restrict sensitive tools to the server owner, admins, selected roles, or selected users. This is the first place to check if someone cannot access a management workflow. This includes access to commands such as /clearleaderboard, /give, /set and /remove, and also all panel editor commands.
Safety controls
Use blacklist and safety options for members who should not use custom rank card visuals, profile fields, or user-uploaded custom hug and bonk image sets.
Permissions
Naya can be set up with selected permissions, but giving her Administrator is the easiest option if you trust the bot and want every module to work without channel-by-channel troubleshooting. If you do not use Administrator, grant the permissions below in the channels where Naya needs to operate.
Total permissions for all features
Manage RolesNeeded for role rewards, shop role items, booster roles, role menus, verification roles, giveaway reward roles, and role removal actions. Naya's role must be above every role she gives, removes, edits, or creates.
Manage ChannelsNeeded for tickets, private channels, custom item actions that create channels, and channel-based automation.
Manage NicknamesNeeded for nickname custom item action.
Manage WebhooksNeeded for webhook-style messages in modules such as embeds, stickies, welcome messages, tickets, or other polished posts.
View ChannelsNeeded so Naya can see setup channels, panels, logs, ticket channels, application channels, and module channels.
Moderate MembersNeeded for timeout custom item action.
Send MessagesNeeded for panels, replies, logs, announcements, autoresponders, and most command responses.
Send Messages in ThreadsNeeded for ticket threads, event threads, co-op threads, and any thread-based workflow.
Create Public ThreadsNeeded when a module creates public threads for discussion, events, co-op, or other server workflows.
Create Private ThreadsNeeded when a module creates private thread workflows.
Manage ThreadsNeeded to update, archive, rename, lock, or manage thread-based workflows.
Embed LinksNeeded for panels, embeds, logs, cards, previews, tickets, applications, giveaways, rank cards, and most styled output.
Attach FilesNeeded for rank cards, generated images, transcripts, attachments, and uploaded files.
Read Message HistoryNeeded when Naya has to inspect previous messages such as for generating ticket transcripts.
Add ReactionsNeeded for reactions such as for autoresponders.
Use External EmojiNeeded when panels, rewards, embeds, or messages use emojis from other servers.
Important extras
Use Application CommandsMembers and staff need this available in a channel to run Naya slash commands there.
Manage MessagesNeeded if you want Naya to clean up old module messages, remove invalid posts, or manage message-based automation.
Mention @everyone, @here, and All RolesOnly needed if you intentionally configure Naya to ping everyone, here, or roles that are normally not mentionable. Leave this disabled unless you need it.
Recommended setup
For the smoothest setup, place Naya's role near the top of your role list, above every role she needs to manage. Then grant Administrator or the full permission set above. For a tighter setup, grant only the needed permissions in the channels where each module runs.
Common permission issues
- Role rewards fail when Naya's role is below the role she needs to manage.
- Panels fail when Naya cannot view the channel, send messages, or embed links.
- Tickets and private channels fail when Manage Channels is missing.
- Thread workflows fail when thread permissions are missing.
- Rank cards, transcripts, and generated files fail when Attach Files is missing.
Before asking for help
- Confirm the module is enabled and posted in the correct channel.
- Review the Permissions section and check the exact channel where the module is posted.
- Review the command list for the module you are setting up.
- Search this page for the setting name, command name, or feature name.