Amanuensis documentation – Main page

 

Introduction

Welcome to Amanuensis, or Ami for short! Ami is a versatile Discord bot designed to enhance your server’s engagement and provide a rich entertainment experience. At its core, Ami is a general-purpose currency and minigame bot, but it offers much more:
  • Interactive AI: With premium features, Ami can respond to mentions of its name or “bot,” adopting a personality you can customize for your server – from cute and helpful to witty and mean. This AI can also utilize various server functions to be more interactive and memorize details about the user on demand.
  • Economy & Customization: Dive into an economy where you can earn and spend coins. Personalize your user profile with unique cosmetic items purchased from the shop, and even trade these items with other users.
  • Engagement & Games: Participate in various minigames such as a stock market, coinflipping, races (with more planned for the future!) that interconnect with the central currency system.
  • Utility Features: Ami also includes basic moderation tools, such as a “Purge Until” command, to help keep your server tidy.
  • Buyable roles: if you enable it in the settings, users can buy and equip color roles from the shop 

Ami aims to be an all-in-one solution for fun, interaction, and light server management.

Inviting Ami:

Getting Ami on your server is straightforward:

  1. Invite Link: You can add Ami by using the official invite link found on:
  2. Discord’s “Add App” Feature: Alternatively, if you see Ami on another server or in the Discord App Directory, you can click on its profile and use the “Add App” button.
  3. Set up the bot: This bot mostly works “out of the box” however some channels or roles might need setting up for it to properly function. For this you’ll need those channels or roles ID (for now)

Required permissions

For Ami to function correctly and provide all its features, it requires certain permissions. When inviting Ami, ensure it has the following:

  • Read Messages: To see commands and messages for XP calculation.
  • Send Messages: To respond to commands and send event messages.
  • Manage Messages: For context menu commands like “Purge Until.”
  • Use External Emojis: For custom currency emojis and other visual elements like stock charts, awards etc.
  • Manage Members: Crucial for features like “Timeout Roulette”, the report function, and potential AI-driven moderation (e.g., temporarily muting users for inappropriate behavior towards the AI).
  • Manage Roles: If you enable Buyable roles, you will need this so the bot may generate potentionally missing roles.

It’s also recommended that Ami has visibility into most active channels to accurately calculate user XP based on message activity (with an appropriate cooldown).

Various features:

Many features of the bot are interconnected with others, but it’s separated into categories for readability sake.

Click on one to open the page related to that topic!

Future planned features

  • Custom server items
  • Pet system with breeding
  • Cross server interactivity features
  • More decors
  • ID-less inputs for channel/role settings