Core Features

AFK System

An overview of Lumière Bot's AFK (Away From Keyboard) system.

Let your server know when you're away. The Bot will automatically manage your status, update your nickname with [AFK], and notify others when they mention you.

Auto-Return: Your status is automatically removed when you send a message or join a voice chat.

Table of Contents


Quick Reference

Essential Commands

# Set yourself as AFK
/afk set reason:On a lunch break, back in 30 mins.

# View all AFK users (moderators)
/afk list

# Clear someone's status (moderators)
/afk clear user:@username

# Remove all AFK statuses (moderators)
/afk clearall

What You Need to Know

  • Nickname changes require the Bot to have the Manage Nicknames permission.
  • Your status will be auto-cleared when you send a message or join a voice channel.
  • AFK reasons are limited to 100 characters.
  • No invite links or mass mentions are allowed in AFK reasons.

Setting Your Status

Basic Usage

/afk set reason:Taking a break

What happens:

  1. The [AFK] prefix will be added to your nickname.
  2. Your reason will be saved with a timestamp.
  3. Others will be notified when they mention you.
  4. Your status will be cleared automatically when you return.

How It Works

Automatic Features

1. Status Activation

When you use /afk set, your nickname will get the [AFK] prefix, and your reason will be stored.

2. Notifications

When someone mentions you, they will see:

⏰ @Username has been AFK for 2 hours.
Reason: Taking a lunch break

3. Auto-Return

Your status will be cleared when you:

  • Send any message (a 👋 reaction will be added).
  • Join or switch voice channels.

Smart Rate Limiting

To prevent spam, each person will only get one notification about your status per minute.

Moderator Tools

View All AFK Users

/afk list

This will show a paginated list of all AFK users with their reasons and timestamps (10 users per page).

Manage Statuses

/afk clear user:@username

This will remove the AFK status for a specific user.


Permissions

Required Permissions

RolePermissionsPurpose
Any UserNoneTo set their own status.
ModeratorsManage ServerTo view or clear other users' statuses.
BotManage NicknamesTo update users' nicknames.
Role Hierarchy: The Bot can only change the nicknames of users with roles lower than its own. The AFK status will still work without the nickname change.

Troubleshooting

Common Issues

Quick Fixes

ProblemFix
My status will not clear.Send any message or join a voice channel.
I want to update my reason.Use /afk set again with the new reason.
There is a false status for someone.Use /afk clear user:@them.

FAQ


Need help? Join our support server or check out our FAQ.