Documentation & Guides

Aosumi Documentation

Everything you need to configure your server, customize leveling mechanics, and set up invite telemetry in minutes.

1. Getting Started & Bot Setup

Adding Aosumi to your Discord guild takes less than a minute. Click the invite link to authorize the bot with required permissions.

Quick Setup Checklist:
  1. Invite the bot and move its role above member roles.
  2. Configure prefix: `/setprefix prefix:!`
  3. Bind invite logger: `/logger channel:#invites state:on`
  4. Set level up channel: `/levelup mode:Custom Channel channel:#level-up`

2. Required Discord Permissions

To ensure uninterrupted background tracking and role distribution, verify Aosumi possesses the following permissions:

Manage Roles (Rolleri Yönet)To grant milestone role rewards and vanity tag roles.
Manage Guild (Sunucuyu Yönet)To inspect server invite lists and vanity usage.
View Audit Log (Denetim Kaydı)To track deleted single-use invites and kicked users.
Attach Files (Dosya Ekle)To upload hardware-rendered PNG rank cards.

3. How Leveling & XP Progression Works

Aosumi rewards organic engagement. Text chat grants 15-25 XP once every 60-second cooldown window. Active voice channel members receive XP each minute provided they are not server muted or deafened.

Example Commands:/rank - View your current level and card/leaderboard - Display top 10 ranked users/daily - Claim daily bonus XP/addreward level:5 role:@Member - Award role at level 5

4. Invite Telemetry & Vanity URL Tracking

Aosumi accurately reconciles every member join against Discord API invite delta logs. It handles temporary single-use invites and Level 3 Boost Vanity URL joins with zero false 'Unknown' errors.

Analytics Commands:/invites [user] - Regular, bonus, leaves, fake counts/joins timeframe:24h - Attribution logs for the last 24h/leaves timeframe:7d - Member retention and leave stats

5. Command Permissions & Administrator Role

From the Aosumi Web Dashboard, configure granular role restrictions per command. Users with the 'Administrator' Discord permission automatically bypass role restrictions across all moderation commands.