How to Use Akumal

Use this page to learn how to manage alter profiles, journal entries, front logs, and your Discord bot connection.

Start by creating an account, logging in, creating alters, then connecting your Discord ID from the Dashboard.

Akumal Basics

1. Create or log into your account

Use the Login page to create an Akumal account or sign into an existing one.

2. Create alter profiles

Go to Create Alter and add details like name, proxy, pronouns, age, species, source, likes, dislikes, triggers, and fun facts.

3. Edit or delete profiles

Use Edit Alter to update saved information, or Delete Alter to remove an alter profile you no longer want saved.

4. Use logs and journal entries

Journal Entries are for longer notes and reflections. Log Front is for tracking who is fronting, mood, time, and context.

Dashboard Tools

Your Dashboard is the main control center for Akumal. From there you can open your alter tools, load saved alters, connect Discord, and move between protected pages.

Saved Alters

The Dashboard can load alter profiles saved to your AWS-backed Akumal account.

Discord Connection

The Dashboard includes a Discord User ID field. This connects your website account to your Discord bot account.

Go to Dashboard Create Alter

Discord Bot Setup Instructions

Follow these steps to prepare Discord, add the bot, and connect your Discord account to Akumal.

Step 1: Turn on Developer Mode in Discord

  1. Open Discord.
  2. Click the gear icon near your username to open User Settings.
  3. Scroll down to Advanced.
  4. Turn on Developer Mode.

Step 2: Copy your Discord User ID

  1. After Developer Mode is turned on, go back to Discord.
  2. Right-click your Discord profile, username, or avatar.
  3. Click Copy User ID.
  4. Your Discord ID should be a long number, usually around 17 to 20 digits.

Step 3: Add the Akumal bot to your server

  1. Click the Discord invite button on the right.
  2. Choose the Discord server where you want to add the bot.
  3. Approve the requested permissions.
  4. Finish the authorization screen.
Only add the bot to servers where you have permission to manage or invite bots.

Add Akumal Bot

Invite Akumal to your Discord server so it can connect with your saved alters.

Add to Discord

Step 4: Add your Discord ID to Akumal

  1. Log into Akumal.
  2. Open the Dashboard.
  3. Find the Connect Discord section.
  4. Paste your copied Discord User ID into the field.
  5. Click Save Discord ID.

Step 5: Use the bot with your saved alters

Once your Discord ID is saved, the bot can connect your Discord user to the alters saved in your Akumal account. Make sure your alter profiles are created before trying to use alter-based bot commands.

Step 6: Bot Commands

Once your Discord account is connected and your alters are saved, you can use these slash commands inside your Discord server.

/alters

Shows your saved alters connected to your Akumal account.

/autoproxy (NAME)

Sets Auto Proxy to the alter name you provide. Messages you send will automatically proxy as that alter until turned off.

/autoproxy (OFF)

Turns off Auto Proxy and returns your messages to normal posting.

/autoproxystatus

Shows the current status of your Auto Proxy so you can see which alter is currently active.

/front

Logs who is currently fronting so you can keep track of front history and system activity.

/refreshalters

If your alters are not syncing correctly, this command forces a refresh and syncs your saved alters with the website.

If a command does not work immediately, try using /refreshalters first to resync your saved alter data.
Connect Discord ID Need Help?

Important Notes

  • Keep your Akumal login private.
  • Only paste your own Discord User ID into your account.
  • Do not share private system information in public Discord channels unless you feel safe doing so.
  • If the bot does not recognize your alters, make sure your Discord ID is saved on the Dashboard.
  • If you change Discord accounts, update your Discord ID in Akumal.