Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/developer51709/Noxie/llms.txt

Use this file to discover all available pages before exploring further.

Noxie supports multiple command prefixes per guild, stored in SQLite. Every server always has the global noxie prefix available regardless of any custom configuration — it is hardcoded and cannot be removed. On top of that, server admins can register any number of shorthand prefixes (like ! or n!) to make prefix commands faster to type. Slash commands always work without any prefix configuration.

​
Command Reference

CommandSlashRequires Permission
noxie prefix/prefixAnyone
noxie prefix add <prefix>/prefix add <prefix>Manage Server
noxie prefix remove <prefix>/prefix remove <prefix>Manage Server
All prefix responses are ephemeral — only you see them.

​
Commands

​
List Prefixes

Shows every currently active prefix for the server — the global prefix plus any custom ones your admins have added. 
noxie prefix
/prefix
Example output: 
Active prefixes for this server:
• `noxie `
• `!`
• `n!`

The prefix `noxie ` is always available and cannot be removed.

​
Add a Prefix

Registers a new custom prefix for the current guild. The prefix is saved immediately to the guild_prefixes SQLite table. Requires the Manage Server permission. 
noxie prefix add <prefix>
/prefix add <prefix>
​
prefix
string
required
The prefix string to register. Any non-empty string is valid. The prefix is case-sensitive when used to invoke commands. Attempting to add the global noxie prefix or a duplicate is silently rejected with an error message.
Examples: 
noxie prefix add !
noxie prefix add n!
noxie prefix add >>

​
Remove a Prefix

Removes a previously registered custom prefix from the current guild. Requires the Manage Server permission. 
noxie prefix remove <prefix>
/prefix remove <prefix>
​
prefix
string
required
The exact prefix string to remove. Must match an existing entry in the guild’s prefix list. Attempting to remove the permanent global prefix noxie is blocked with an error message.
Examples: 
noxie prefix remove !
noxie prefix remove n!

​
Rules and Behaviour

The global prefix noxie (with a trailing space) is permanently active in every guild and cannot be removed. It is the only prefix that works in DMs.
  • Custom prefixes are per-guild — a prefix registered in one server has no effect in another.
  • Duplicate prefixes are silently rejected — if you try to add a prefix that already exists, the bot replies with an error and no duplicate is created.
  • The global prefix always takes precedence — trying to register noxie as a custom prefix is blocked at the source.
  • manage_guild permission is required to add or remove prefixes. Regular members can only list them.
  • Case-sensitive matching — ! and ! are the same, but N! and n! are treated as distinct prefixes.

​
How Prefix Resolution Works

discord.py calls prefix_callable() for every incoming message to determine which prefixes are valid. The callable:
  1. If the message is in a DM, returns ["noxie "] only.
  2. If the message is in a guild, queries guild_prefixes for all stored custom prefixes.
  3. Deduplicates (case-insensitive) and prepends the global noxie prefix.
  4. Returns the full list to discord.py, which attempts to match any of them against the start of the message content.
# Simplified from cogs/prefixes.py
def prefix_callable(bot, message):
    if message.guild is None:
        return ["noxie "]
    return all_prefixes_for_guild(bot.db, str(message.guild.id))
    # → ["noxie ", "!", "n!"]
This means command parsing is prefix-agnostic from the cog author’s perspective — you write @commands.command(name="hunt") once, and it responds to noxie hunt, ! hunt, n!hunt, etc., automatically.

​
Full Example Session

# Admin sets up shorthands
noxie prefix add !
noxie prefix add n!

# Anyone can now use any of these
!hunt
n!inventory 2
noxie profile

# List to confirm
noxie prefix
→ Active prefixes: `noxie `, `!`, `n!`

# Admin removes one
noxie prefix remove !
→ ✅ Prefix `!` removed.

# Trying to remove the global prefix
noxie prefix remove noxie 
→ ❌ The global prefix `noxie ` is permanent and cannot be removed.

Build docs developers (and LLMs) love

Get started for freeTalk to us