Leveling system

Set where level-ups appear, stop spam channels from giving XP, add level roles, and customize the message members see. Automatic setup can handle the starting settings for you.

Open setup/setup → Fine-tune → Leveling System → Setup

Before you start

You need Manage Server, Manage Roles, and Manage Channels for every leveling command and button.

Tiko needs Send Messages and Attach Files where it posts level-ups. The level card is an image.
For level roles, give Tiko Manage Roles and place its role above every level role in Server Settings → Roles.
Tiko needs Administrator for automatic setup. Manual setup works without it.

Start with automatic setup

Run /setup → Fine-tune → Setup next to Leveling System.
Press Start under Automatic setup.
Wait for the progress message and review the summary.

Notifications: Turns level-up messages on.
Channel: Chooses a channel for level-up messages. You can change it afterward.
Roles: Sets up level roles that you can review and change afterward.

Review the channel and roles in the result. You can also use /setup → Auto Setup to configure leveling with your other server features.

Set it up yourself

Run /levelconfig setup, or use /setup → Fine-tune → Leveling System → Setup. Press Done when finished.

Level-up notifications

Click Enable next to Leveling System in Fine-tune, or use /levelconfig toggle enabled:True. Notifications are off by default. Turning them off hides level-up messages; members still earn XP and rewards.

Level-up channel

Use Pick a level-up channel… in the panel to always post there. Leave it unset to post in the channel where the member was chatting. Clear removes a selected channel.

XP-excluded channels

Click Manage next to XP-excluded channels. Add Channels can select several at once; Remove Channels restores XP, and View Current lists exclusions. Good candidates are bot-command, counting-game, and other spam-heavy channels.

/spam channel #channel excludes a channel; /spam remove #channel includes it again. Omit the channel to use the one you're in.

Add level roles

In the leveling panel, click Configure next to Level roles. Tiko gives a member each role when they reach its level. Members keep earlier level roles as they advance.

Press ＋ Add Role.
Pick a role, enter the level it unlocks at, then press Confirm.

To stop assigning a role, press － Remove Role, select its level, then press Remove. Members who already have the role keep it. Tiko must be able to manage every role you select.

Customize the level-up message

The default is a member ping and a generated level card. To edit it, click Customize next to Notification message in Fine-tune or the leveling panel, or run /levelconfig message. A live preview updates above the controls.

✓ Save & Close saves your text and embed changes. Disable / Enable Embed switches between text only and text plus embed.

<@user> just hit level {new_level}! 🎉 You're now rank #{rank} in {server_name}.

Editor controls and formats

✎ Level Message: Plain text above the embed. The default is <@user>.
⌘ Variables: Shows the placeholders you can use.
✎ Content: Embed title, description, footer, and footer icon URL.
▦ Fields: Opens a private panel to add, edit, and organize embed fields.
◉ Author: Choose Member, Server, Custom, or Remove in a private picker for the small line above the title.
◇ Color: Embed side color, as a hex code such as FF8800.
▣ Thumbnail / 🔗 Image URL: Small top-right image or large bottom image. Use {level_card} in Image URL to show the level card.
↺ Reset Draft: Return to the default message. Save to keep it.

Message variables

Type these placeholders into the message or embed text boxes. Tiko fills them in when a member levels up.

Member & server

Variable	What it becomes
`<@user>`	Pings the member.
`{username}`	Their username.
`{nickname}`	Their server nickname.
`{user_avatar}`	Link to their avatar.
`{server_name}`	Your server name.
`{server_member_count}`	Current member count.
`{server_icon}`	Link to the server icon.

Level & rewards

Variable	What it becomes
`{old_level}`	The level before this one.
`{new_level} / {level}`	The new level.
`{xp}`	Total XP.
`{rank}`	XP rank in the server.
`{xp_for_next}`	XP needed for the next level.
`{wage_increase}`	New wage bonus, if it changed.
`{unlocked_items}`	Items unlocked at this level.
`{timestamp}`	Current time.
`{level_card}`	The generated level card image.

Commands & fixes

Command reference

Every admin command below needs Manage Server, Manage Roles, and Manage Channels.

Command	What it does
`/levelconfig setup`	Open the leveling panel.
`/levelconfig toggle`	Turn level-up notifications on or off.
`/levelconfig channel`	Set the level-up channel.
`/levelconfig remove`	Clear the level-up channel.
`/levelconfig autorole`	Open the level role manager.
`/levelconfig message`	Open the level-up message editor.
`/spam channel`	Exclude a channel from XP.
`/spam remove`	Let a channel give XP again.
`/enable features / /disable features`	Turn Level-up Notifications or other features on or off.
`/setup`	Open the main setup dashboard and all-in-one Auto Setup.

For members: /level shows their card; /level @member shows another member's card.

Something not working?

Problem	What to check
No level-up messages	Notifications start off. Use /levelconfig toggle enabled:True.
Messages appear in different channels	No level-up channel is set. Choose one with /levelconfig channel.
Messages are missing even though they're on	Check Send Messages and Attach Files where Tiko is posting.
Level roles are not assigned	Give Tiko Manage Roles and move its role above every level role in Server Settings → Roles.
Cannot assign a role	Choose a role below both your highest role and Tiko's, or adjust the role order.
Automatic setup cannot start	Check that you and Tiko have the permissions listed above.
A spam channel still gives XP	Exclude it with /spam channel #channel.
Message edits disappeared	Use ✓ Save & Close before leaving the editor.