User Manual

Welcome to the Imperium User Manual. This guide is crafted to help server owners, administrators, and moderators master the bot's features. We will bypass the technical jargon and focus purely on how to manage your community effectively.

Note: The default prefix for Imperium is , (comma). All examples in this guide utilize this prefix. If you change it, simply replace the comma with your custom symbol.

Initial Setup

Getting started is simple. Once invited, you should immediately configure the Core Settings to align with your server's identity.

1. Customizing the Prefix

If your server has multiple bots, prefixes often clash. You can change Imperium's prefix to something unique like !, ?, or even ..

,setprefix [new_symbol]

Example usage: ,setprefix ! will instantaneously change the trigger to an exclamation mark.

2. Role Hierarchy & Permissions

For Imperium to moderate users effectively, it must have authority. In your Discord Server Settings > Roles, ensure the "Imperium" role is dragged above the roles of regular members and moderators.

Why? Discord does not allow a bot to ban, kick, or manage a user who has a role higher than or equal to its own.

Moderation Tools

Keep your community safe and organized with our advanced moderation suite. These commands are designed for speed and precision.

,kick @user [reason]
Removes a user from the server. This is a warn-level action; the user can rejoin if they find a new invite link. Useful for first-time serious offenses.
,ban @user [reason]
Permanently blocks a user. They cannot rejoin unless you explicitly unban them. Use this for severe violations like raids or hate speech.
,timeout @user [duration] [reason]
puts the user in a Timeout (Discord's native mute). They can read but cannot type or speak.
Format: 1m (minute), 1h (hour), 1d (day).
,clean [amount]
Also known as Purge. Instantly deletes the specified number of recent messages.
Limit: You can delete up to 100 messages at once.
,lock / ,unlock
Emergency Lockdown. Prevents the @everyone role from sending messages in the current channel. Use this immediately if a raid occurs.

Security Center (Anti-Nuke)

The Anti-Nuke System is Imperium's signature defense feature. It acts as an automated guardian that watches over your server 24/7, detecting suspicious administrative actions.

Critical Warning: Only the Server Owner should configure Anti-Nuke settings. Misconfiguration can lead to the bot punishing valid admins.

How Protection Works

If a rogue admin or a hacked account attempts to "nuke" your server, Imperium intervenes within milliseconds:

  1. Detection: The bot notices improper behavior, such as Mass Banning (e.g., banning 5 users in under 10 seconds) or Channel Deletion.
  2. Intervention: Imperium immediately strips all roles from the perpetrator or bans them, depending on your config.
  3. Restoration: If configured, it will attempt to restore the deleted channels or roles.

Enabling Security

To activate the default (strict) security profile, simply run:

/antinuke enable

From there, you can use the interactive menu to whitelist trusted admins who should bypass these checks.

Global Economy

Boost engagement with a fun, cross-server economy system. Users retain their balance across all servers that use Imperium, creating a massive global market.

Making Money

  • Daily Reward: Run ,daily once every 24 hours to claim your free stipend.
  • Work Shifts: Use ,work to perform a random job and earn a paycheck. Cooldown: 1 hour.
  • Gambling: Feeling lucky? Use ,coinflip [amount] or ,slots [amount] to double your money—or lose it all.

Banking & Security

Cash in your "wallet" can be stolen by other users using the ,rob command. To keep your wealth safe, you must deposit it.

,deposit [amount] / all
Moves money from your wallet to your Bank Vault. Money in the bank cannot be stolen.
,withdraw [amount]
Moves money back to your wallet for spending.

XP & Leveling

Gamify your server! Imperium tracks user activity and awards XP (Experience Points) for every minute they spend chatting. This encourages members to stay active.

Rank Cards

Users can showcase their prowess with a generated image card. This card displays their Current Level, Total XP, and Server Rank.

,rank

Automatic Role Rewards

You can configure the bot to automatically assign roles when users reach specific milestones. This is great for creating "Level Roles" (e.g., Level 5, Level 10, Veteran).

,setrank [level] @Role

Example: ,setrank 10 @Gold Member — Now, anyone who hits Level 10 is automatically promoted to the Gold Member role.

VoiceMaster

Keep your voice channels clean and dynamic. **VoiceMaster** effectively replaces the need for dozens of empty voice channels by allowing users to creation their own Temporary Channels.

One-Time Setup

Admins simply run ,setupvoice once. The bot will create a special category and a "Join to Create" channel.

How Users Interact

When a user clicks/joins the "Join to Create" channel:

  1. Imperium instantly creates a new voice channel and moves the user into it.
  2. The user becomes the Host of that specific channel.
  3. The bot sends a Control Panel (buttons or commands) to the text chat associated with that voice channel settings.

Host Controls

The channel host has full power over their temporary room:

  • Lock Channel: Make it private so no one else can join.
  • Set Limit: Cap the room at 2, 3, 4, or any number of users.
  • Kick User: Remove unwanted guests from the voice call.

Magic: When the last person leaves the temporary channel, Imperium automatically deletes it to keep your server clean.