Server configuration

While many of Ami’s features work right out of the box, some functionalities benefit from or require initial setup by a server administrator. This is primarily done using the /server_config and /bot_settings commands. Both commands require administrator permissions to use.

1. Key Channels to Configure

Event Channel:This is important for features like stock market news and various other minigame events. If not set, the bot will not send these types of messages. This can be set using the /bot_settings command.

Weekly Channel (Premium): For servers with premium status, you can designate a channel where Ami will post a list of the week’s most active users. If not set, Ami will attempt to DM the top 3 users instead. This can be set using the /server_config command.

AI Reply Channel (Premium): This is the channel where the bot not only responds to keywords if its enabled, but also to reply and @mention tags. You can set this using /bot_settings.

 

2. The /server_config Command

This command allows administrators to tailor various general server-specific settings for Ami.

Usage: /server_config <config_name> <value>

Key Configuration Options (via config_name):

  • Currency Name: Set a custom name for your server’s currency (max 10 characters).
  • Currency Emoji: Set a custom emoji for your server’s currency.
  • Currency Manager Role: Users with this role may distribute currency to users with the /addcoin command from the Server bank.
  • ID of Reputation role X: Assign roles to be automatically given to users when they reach certain reputation levels.
  • Mod report channel:Specify a channel where moderation reports are sent.
  • Weekly awards channel:Designate the channel for weekly activity reward announcements (premium feature).
  • Join message enabled / Join message / Join message channel: Configure custom welcome messages for new users
  • Leaving message enabled / Leave message / User leaving channel: Configure custom messages for departing users.
  • Best of channel / Best of enabled: Configure a “best of” channel, where the bot reposts the most reacted images/messages.
  • Reaction amount for trigger: Set an amount of reactions on a message to trigger a “best of” entry.
  • Buyable role colors enabled: Enable or disable user owned role color items to be equipped as discord roles by users. If the role doesn’t exist, the bot will create it.

(For a full list of config_name options, you can refer to the choices provided by the slash command interface.)

Example:
To set your currency name to “Ducks”, you would use:
/server_config config_name:Currency name value:Ducks

To set your weekly awards channel, you would use:
/server_config config_name:Weekly awards channel value:123213213 (replace 123213213 with your channel ID)

 

soon the configs will work with the #channelname and @rolename, instead of id-s

 

Custom join or leave message formatting guide:

To add various dynamic text to your welcome message, just add the following function names into your message:

{user_display_name} – The users Display name or Nick name.

{user_name} – The users account name

{id} – The users ID

{server} – The name of your server

So for example if you type as a welcome message:

“{user_name} ({id}) has joined {server}, epic.”

And lets assume the user joining is named big_duck_123 to the server called Test Server.

This is how the welcome message will look:

“big_duck_123 (123213211) has joined Test Server, epic”

3. The /bot_settings Command

This command is used to manage settings related to the bot’s AI, event notifications, and other bot-specific behaviors.

Usage: /bot_settings <config_name> <value>

Key Configuration Options (via config_name):

  • AI reply enabled:Enable or disable the AI’s ability to reply to mentions (1 for enabled, 0 for disabled). This is a premium feature.
  • Personality:Customize the AI’s personality (e.g., shy, mean, chill, ralek, marti, ponzeeh).
  • AI reply channel:A channel ID here the AI will reply to @mentions and message replies as well.
  • Event channel:Designate the channel ID for bot events like stock market news.
  • Bot update news enabled: Enable or disable bot update news.
  • Update News Channel ID:Set the channel ID for bot update news.
  • Stock Market:Enable or disable the stock market feature.

(For a full list of config_name options, refer to the choices provided by the slash command interface.)

Example:
To enable AI replies, you would use:
/bot_settings config_name:AI reply enabled value:1

To set the AI personality to “chill”, you would use:
/bot_settings config_name:Personality value:chill

For further information on AI personalities please go to [AMI AI] page

 

 

4. The /ignore_channel Command

This is for premium servers only

With this command you may disable either the AI replies or Treasure chests from happening in the channels specified.

 

First you select which type you’d like to add channels for the bot to ignore that specific feature on.

ignored_coingen: Channels where you don’t want treasure chests to spawn.

ignored_ai: Channels where you don’t want the AI to reply to any input or randomly pop into a conversation

After you selected one, this window pops up (if you didn’t the default choice is ignored_coingen):

(channels names will be different probably)

It will show you channels already marked as ignored.

If you’d like to add more to it click on the drop down menu, and select the ones you’d like to add.

Important! Before you click save, you have to close the drop down menu! Otherwise your changes won’t be saved.

 

5. The Disable AI Command

If you got premium you might need to use this.

If some users just cant stop abusing the AI and spam the server too much with it, feel free to use this command to disable the AI on that specific user.

 

/disable_ai user:@mention status:True/False

 

If the status or user argument is missing, the bot will list you all the users currently disabled from using the AI