ALREN HELP CENTER

Commands

Verify your osu! account, find your next beatmap, and set up your community. Start with /help in Discord or explore the guide below.

[options] are optional. Replace <placeholders>, @roles, and #channels with your own values. Select options from Discord's slash command menu.

COMMAND GUIDE

General commands

Open the guide, check latency, and chat privately with Alren.

CommandDescription
/helpOpen the command guide privately, with a link to this website.
/pingCheck whether Alren is online and view the bot's latency.
/alren message:<message>Start a private AI chat. Replies are automatically deleted after five minutes by default.
/alrenclearClear your private chat memory in the current channel.

COMMAND GUIDE

osu! verification

Link your osu! account through OAuth and check your server profile.

CommandDescription
/verify [osu_id]Get a private osu! OAuth verification link. Your account is detected automatically when osu_id is omitted.
/verify-statusView your linked osu! account privately in the current server.

COMMAND GUIDE

Beatmap discovery

Find a random beatmap using the current channel's saved filters.

CommandDescription
/map [status] [mode]Post a random beatmap with cover artwork. Optional filters override this channel's settings for one request. Unconfigured channels default to Ranked and All Mode.

COMMAND GUIDE

Server setup

All /setup commands require Manage Server and must be used in a server.

CommandDescription
/setup statusView verification settings, every configured channel feed, and community alert settings privately.
/setup verify [role] [channel]Configure the role assigned after verification and the channel for public verification announcements. Omit options to view settings.
/setup beatmap [channel] [status] [mode] [enabled]Configure a separate automatic feed for each channel. Defaults to the current channel. Use enabled:false to stop only the selected channel's feed, or enabled:true to enable it.
/setup alerts [channel] [bn_mode]Configure Beatmap Nominator request opening/closure alerts and new Mappers' Guild missions. bn_mode filters BN alerts; missions include all modes.

Choose your filters

/map inherits the current channel's saved filters unless you override them. Ranked + Loved watches both statuses for feeds; /map randomly selects one of the two.

Beatmap status

Option: status

ranked
Ranked
qualified
Qualified
loved
Loved
ranked_loved
Ranked + Loved
all
Ranked, Qualified, and Loved

Beatmap mode

Option: mode

any
All Mode
osu
Standard (osu!)
taiko
osu!taiko
catch
osu!catch / fruits
mania
osu!mania

BN alert mode

Option: bn_mode

all
All Mode
osu
Standard (osu!)
taiko
Taiko
catch
Catch / fruits
mania
Mania

Use mode:any for all beatmap modes and bn_mode:all for all BN modes. The BN filter does not limit Mappers' Guild missions.

Ready-to-use examples

Each channel keeps its own filters and posting history. Run /setup status to review every configured feed.

Verify members

/setup verify role:@Verified channel:#welcome

Assign a role and announce successful verifications. Members can then run /verify.

Mania · Ranked + Loved

/setup beatmap channel:#mania mode:mania status:ranked_loved

Receive new Ranked and Loved beatmaps together in #mania.

Standard · Ranked

/setup beatmap channel:#standard mode:osu status:ranked

Keep Standard maps in their own channel.

Taiko · Ranked

/setup beatmap channel:#taiko mode:taiko status:ranked

Add another feed with independent filters and posting history.

Catch · Ranked

/setup beatmap channel:#catch mode:catch status:ranked

Repeat the setup for each channel you want to use.

Pause one feed

/setup beatmap channel:#mania enabled:false

Stop #mania's feed. Other channel feeds keep running.

Find a map

/map status:ranked_loved mode:mania

Pick a random Ranked or Loved Mania beatmap without changing the saved feed.

Community alerts

/setup alerts channel:#alerts bn_mode:mania

Receive Mania BN opening/closure alerts and new Mappers' Guild missions in all modes.

Legacy prefix commands

These ! commands are still supported as fallbacks. Use the slash commands above for the current command menu.

View prefix commands and aliases
CommandDescription
!help / !alrenhelpSend the command guide by DM. Enable direct messages from server members.
!pingShow bot latency in the channel.
!alren <message> / !chat <message>Chat with Alren by DM. Mentioning the bot with a message also starts a chat.
!alrenclear / !resetClear your chat memory in the current channel and confirm by DM.
!osuverify [osu_id]Start osu! OAuth verification.
!verify-status / !osuverify-statusShow your linked osu! account.
!verify-setting @role / !verify-role @roleConfigure the verification role. Requires Manage Server.
!verify-role-statusShow the configured verification role.
!osumap [status] [mode]Post a random beatmap using the current channel's filters, with optional overrides.
!osumap-settings [status] [mode]Configure a beatmap feed in the current channel. Requires Manage Server.
!osumap-statusView the current channel's beatmap feed settings.
!community-alert-settings #channel [mode]Configure community alerts. Mode choices are all, osu, taiko, catch, and mania. Requires Manage Server.