NyronBot Documentation

Everything you need to set up, configure, and get the most out of NyronBot in your Discord server.

Invite the Bot

Add NyronBot to your server with the link below. The bot requires the following permissions to function fully:

• Manage Roles — for role rewards, reaction roles, verification
• Manage Channels — for tickets, personal channels (shop)
• Kick / Ban Members — for moderation
• Manage Messages — for purge, banned words
• Connect / Speak — for music playback
• Send Messages / Embed Links — for all commands

First Steps

Invite NyronBot

Add the bot to your server and make sure it has the required permissions.

Open the Dashboard

Go to nyronbot.xyz/dashboard, log in with Discord, and select your server.

Configure Modules

Enable and customize the features you want: economy, leveling, welcome messages, tickets, and more.

Start Using Commands

NyronBot supports both /slash commands and prefix commands (default n!). Type /help in your server to see all available commands.

Prefix & Language

NyronBot uses n! as the default prefix. You can change it per server.

Dashboard

The web dashboard lets you manage every aspect of NyronBot without using commands. Access it at nyronbot.xyz/dashboard.

Logging In

Available Modules

Moderation

NyronBot provides a comprehensive set of moderation tools to keep your server safe.

Warning System

Warnings are tracked per user per server. Each warning records the reason, the moderator who issued it, and the date.

Banned Words

Automatically delete messages containing banned words. When triggered, the message is deleted and the user is notified.

You can also manage banned words from the Moderation section in the dashboard.

Scripted Commands

Scripted Commands let server admins create fully custom slash commands using Python code. Write your script in the dashboard's built-in code editor, and NyronBot registers it as a real /slash command in your server. Your code can respond with text, rich embeds, buttons, and dropdown menus.

Getting Started

Your First Command

Here's the simplest possible scripted command — it just says hello:

await respond(f"Hello, {member.display_name}!")

That's it. When someone uses the command, the bot replies with "Hello, [their name]!".

API Reference

Every script has access to the following built-in variables automatically. You don't need to import anything.

Context Variables

Member Properties

Guild Properties

Channel Properties

Role Properties

Available on items inside member.roles and member.top_role.

The respond() Function

This is how your script sends a reply. You must use await when calling it.

await respond(content, embed=None, components=None, ephemeral=False)

Available Python Builtins

The following standard Python functions and types are available in your scripts:

str, int, float, bool, len, range, list, dict, tuple, set, min, max, abs, round, sum, sorted, reversed, enumerate, zip, any, all, map, filter, isinstance

Embeds

Use the Embed class to create rich embedded messages with titles, descriptions, colors, fields, images, and more.

Creating an Embed

embed = Embed(title="My Title", description="Some text", color=Color.blurple)

Embed Methods

Color Constants

Use Color.<name> for preset colors:

You can also use any hex color as an integer: color=0xFF5733

Full Embed Example

embed = Embed(
    title="Server Info",
    description=f"Welcome to **{guild.name}**!",
    color=Color.blurple
)
embed.set_thumbnail(url=guild.icon_url)
embed.add_field(name="Members", value=str(guild.member_count), inline=True)
embed.add_field(name="Channel", value=channel.mention, inline=True)
embed.set_footer(text=f"Requested by {member.display_name}", icon_url=member.avatar_url)

await respond(embed=embed)

Buttons & Select Menus

Make your commands interactive by adding buttons and dropdown menus. When a user clicks a button or selects an option, your code runs again with a different event.type.

Buttons

Button(label, style="primary", custom_id=None, emoji=None, url=None, disabled=False)

Select Menus

Select(placeholder="Choose...", custom_id=None, options=[], min_values=1, max_values=1)

Each option in the dropdown is created with:

SelectOption(label, value, description=None, emoji=None, default=False)

Action Rows

Components must be wrapped in an ActionRow (max 5 per row) and passed as a list to respond():

row = ActionRow(
    Button(label="Yes", custom_id="yes", style="success"),
    Button(label="No", custom_id="no", style="danger")
)
await respond("Do you agree?", components=[row])

Handling Button/Select Events

When a user interacts with a component, your same script runs again. Use event.type to tell what happened:

Command Arguments

You can add arguments to your command so users can pass data when they use it (e.g. /greet name:John). Arguments are configured in the dashboard when creating or editing a command.

Argument Types

Accessing Arguments

Use args.get("name", default) to safely read an argument with a fallback:

# If the user ran: /greet name:John
name = args.get("name", member.display_name)
await respond(f"Hello, {name}!")

For required arguments, you can access them directly:

target = args["target"]  # A User argument named "target"
await respond(f"You selected {target.mention}!")

Examples

Copy these examples and adapt them to your needs. Each one is a complete, working script.

Simple Greeting

A basic command that greets the user with an embed.

embed = Embed(
    title="Hello!",
    description=f"Welcome, {member.display_name}!",
    color=Color.green
)
embed.set_thumbnail(url=member.avatar_url)
await respond(embed=embed)

User Info Card

Displays information about a mentioned user. Add a User argument named target (optional).

target = args.get("target", member)

embed = Embed(
    title=f"User Info: {target.display_name}",
    color=Color.blurple
)
embed.set_thumbnail(url=target.avatar_url)
embed.add_field(name="Username", value=target.name, inline=True)
embed.add_field(name="ID", value=str(target.id), inline=True)
embed.add_field(name="Top Role", value=target.top_role.mention, inline=True)
embed.add_field(name="Joined", value=str(target.joined_at)[:10], inline=True)
embed.add_field(name="Is Bot", value=str(target.bot), inline=True)
embed.set_footer(text=f"Requested by {member.display_name}")

await respond(embed=embed)

Yes/No Poll with Buttons

Add a String argument named question.

if event.type == "command":
    question = args.get("question", "Yes or No?")
    embed = Embed(
        title="Poll",
        description=question,
        color=Color.blurple
    )
    row = ActionRow(
        Button(label="Yes", custom_id="yes", style="success", emoji="✓"),
        Button(label="No", custom_id="no", style="danger", emoji="✗")
    )
    await respond(embed=embed, components=[row])

elif event.type == "button":
    if event.button_id == "yes":
        await respond(f"{member.mention} voted **Yes**!", ephemeral=True)
    elif event.button_id == "no":
        await respond(f"{member.mention} voted **No**!", ephemeral=True)

Color Picker with Select Menu

if event.type == "command":
    options = [
        SelectOption(label="Red", value="red", emoji="🔴"),
        SelectOption(label="Blue", value="blue", emoji="🔵"),
        SelectOption(label="Green", value="green", emoji="🟢"),
        SelectOption(label="Gold", value="gold", emoji="🟡")
    ]
    row = ActionRow(
        Select(placeholder="Pick a color...", custom_id="color", options=options)
    )
    await respond("Choose your favorite color:", components=[row])

elif event.type == "select":
    chosen = event.values[0]
    colors = {"red": Color.red, "blue": Color.blue, "green": Color.green, "gold": Color.gold}
    embed = Embed(
        title=f"You picked: {chosen.capitalize()}!",
        description=f"{member.mention} chose **{chosen}** as their favorite color.",
        color=colors.get(chosen, Color.blurple)
    )
    await respond(embed=embed)

Server Stats

embed = Embed(title=f"{guild.name} Stats", color=Color.purple)
embed.set_thumbnail(url=guild.icon_url)
embed.add_field(name="Members", value=str(guild.member_count), inline=True)
embed.add_field(name="Channel", value=channel.name, inline=True)
embed.add_field(name="Server ID", value=str(guild.id), inline=True)
embed.set_footer(text=f"Requested in #{channel.name}")

await respond(embed=embed)

Role List

Lists all roles of the user who ran the command.

if member.roles:
    role_list = ", ".join(r.mention for r in member.roles)
else:
    role_list = "No roles"

embed = Embed(
    title=f"{member.display_name}'s Roles",
    description=role_list,
    color=Color.gold
)
embed.set_footer(text=f"{len(member.roles)} role(s)")

await respond(embed=embed)

Ephemeral Secret Message

Only the user who ran the command can see the response.

embed = Embed(
    title="Secret!",
    description="Only you can see this message.",
    color=Color.red
)
await respond(embed=embed, ephemeral=True)

Multi-Button Dashboard

A command with multiple buttons that each do something different.

if event.type == "command":
    embed = Embed(
        title="Quick Actions",
        description="Click a button below:",
        color=Color.blurple
    )
    row = ActionRow(
        Button(label="My Info", custom_id="info", style="primary"),
        Button(label="Server", custom_id="server", style="secondary"),
        Button(label="Ping", custom_id="ping", style="success")
    )
    await respond(embed=embed, components=[row])

elif event.type == "button":
    if event.button_id == "info":
        embed = Embed(title="Your Info", color=Color.blue)
        embed.add_field(name="Name", value=member.display_name)
        embed.add_field(name="ID", value=str(member.id))
        await respond(embed=embed, ephemeral=True)

    elif event.button_id == "server":
        embed = Embed(title=guild.name, color=Color.purple)
        embed.add_field(name="Members", value=str(guild.member_count))
        await respond(embed=embed, ephemeral=True)

    elif event.button_id == "ping":
        await respond("Pong!", ephemeral=True)

Security & Limits

Scripted commands run in a heavily sandboxed environment. This keeps your bot and server safe even if someone writes bad code.

What's NOT Allowed

• No imports — import os, from sys import ..., etc. are all blocked
• No class definitions — class MyClass: is not allowed
• No dangerous builtins — exec, eval, compile, open, input, print, getattr, setattr, type, and others are blocked
• No underscore access — Any name starting with _ (like __class__, __bases__) is forbidden
• No global/nonlocal — global and nonlocal statements are not allowed

Limits

Economy System

A full virtual economy per server with multiple ways to earn, spend, and compete.

Earning & Managing Currency

Users also earn currency passively by sending messages and spending time in voice channels. Admins can configure earning rates, cooldowns, and channel/role restrictions from the dashboard.

Stock Market

Shop System

Admins can create shop items that users purchase with their earned currency. Items can grant roles, create personal channels (text or voice), or be collectible items.

Item Types

• Role — Grants a Discord role on purchase
• Personal Channel (Text) — Creates a private text channel for the buyer
• Personal Channel (Voice) — Creates a private voice channel for the buyer
• Temporary Role — Grants a role for a limited duration (custom time units)
• Item — Collectible with no special action

Custom Currencies

Create multiple currencies per server, each with its own name and emoji. Shop items can be priced in any currency. Manage currencies through the dashboard Economy section.

Leveling System

Users earn XP by sending messages and spending time in voice channels. XP accumulates to level up, with exponential scaling. The leveling system runs automatically — configure all settings from the dashboard Levels section.

Role Rewards

Automatically assign roles when users reach specific levels. Configure these from the dashboard Levels section. For example, grant a "Regular" role at level 5 and a "Veteran" role at level 20.

Level Settings

All configurable from the dashboard:

• Text XP amount (min/max per message)
• Voice XP per minute
• XP cooldown between messages
• Vote boost percentage (top.gg integration)
• Level-up notification channel and message template
• Allowed/blocked channels and roles

Music

Play music from YouTube, Spotify, and SoundCloud directly in your voice channel.

Queue & Controls

Supported Platforms

• YouTube — Search by name or paste a URL (videos and playlists)
• Spotify — Paste a Spotify track, album, or playlist URL
• SoundCloud — Search or paste a SoundCloud URL
• Direct URL — Any direct audio/video link

Use the platform option in /play to force a specific source, or let the bot auto-detect.

Ticket System

Create a support ticket system for your server so members can get help from staff.

Setup

Using Tickets

Once a ticket is created, staff can claim it, close it, or delete it. Closed tickets can be reopened. All actions are logged to the configured log channel.

Verification System

Require members to verify before accessing the server.

Members click a button to receive a role that grants access to the server. Customize the embed title, description, image, button text, and button color.

Giveaways

Run giveaways with automatic winner selection.

Giveaways can be set up using the dashboard, no commands required! Members join by clicking a button. The embed shows a live participant count and countdown. Customize colors, button labels, and embed text from the dashboard.

Reaction Roles

Let members self-assign roles by clicking emoji reactions on a panel.

Panels support custom embed titles and descriptions. You can also manage them from the Reaction Roles section in the dashboard.

Welcome System

Automatically greet new members when they join your server.

Message variables: {user}, {username}, {server}, {count}. You can also configure everything from the dashboard Welcome section.

Games

Fun mini-games to play in your server.

Virtual Pets

Create and raise a virtual pet with stats, battles, and care mechanics.

Reports

A configurable report system where members can submit reports through a form.

Utilities

General

Reminders

Polls

Server Management

Notes

Steam Deals

Need Help?