LLR Stream Module

class StreamCMD(*args: Any, **kwargs: Any)

This module provides functionality for managing LLR stream-related commands and is locked to LLR. Most of these commands are also dependant on a live-stream being in progress.

See also

Module is locked to the Love Live Radio (LLR) server.

Attention

All commands assume minimum bot permissions: View Channel, Send Messages.

async entry(ctx)

Join our Featured User Raffle! The Featured User raffle is active during radio streams. At the end of a stream, a user who entered is randomly chosen to be “featured” in the next stream with a custom message of their choosing! Once you are entered, there is no way to remove yourself from the entries.

See also

The current Featured User is automatically denied entry during their Featured Stream.

Syntax:

!!entry
Returns:

Sends a confirmation message indicating the user has been entered into the raffle or an error if the user is ineligible or the command was used outside the designated channels.

Return type:

discord.Message

Permissions

Author: LLR

async featuredinfo(ctx)

Provides information regarding LLR Featured User/Idol raffle.

Aliases: raffleinfo, featured idol, idolinfo, featured user, featured

Syntax:

!!featuredinfo
Returns:

Sends detailed information about the Featured User raffle and Featured Idol poll for LLR streams.

Return type:

discord.Message

Permissions

Author: LLR

async instant_request(ctx, *, request=None)

Instantly requests a song to play next during an LLR Stream. This can be done by LLR Supporter Tier members or by using 3000 Chiipoints.

See also

Max 2 IR requests per stream.

Aliases: ir

Parameters:

request (str, optional) –

The song request to be played next.

  • none If not specified, shows request history.

  • all to view complete history

  • admin for admin view

Syntax:

!!instant_request [request]

Example:

!!ir
!!ir all
!!ir Aishiteru Banzai
Returns:

Sends a confirmation message or error message if the request fails or if user doesn’t meet the criteria.

Return type:

discord.Embed, discord.View

Permissions

Author: LLR

async lastwin(ctx, idol: str)

Show the last date when the specified idol won Featured Idol.

Aliases: lw

Syntax:

!!lastwin <idol>

Example:

!!lastwin Yoshiko
Parameters:

idol (str, required) – The first full name of the idol to check.

Returns:

Sends a message displaying the date of the idol’s last win, if found.

Return type:

discord.Message

async np(ctx)

Shows the current song playing during LLR Streams.

Syntax:

!!np
Returns:

Sends an embed with the current song’s title, artist, and thumbnail of album artwork if LLR is live. Sends an error message if LLR is not live or the stream hosts status is not detected.

Return type:

discord.Embed

Permissions

Author: LLR

async nrs1(ctx)

Sends the first NRS gif. 5 gifs are available

Syntax:

!!nrs1

Example:

!!nrs1
!!nrs2
!!nrs3
!!nrs4
!!nrs5
Returns:

Sends a message containing the link to the specified NRS gif.

Return type:

discord.Message

Permissions

Bot: Embed Links

async patreon(ctx)

Sends a link to the LLR Patreon page.

Syntax:

!!twitch
Returns:

Sends a message containing the link to the Love Live Radio Patreon page.

Return type:

discord.Message

async queue(ctx)

Displays the current Love Live Radio (LLR) stream queue in the specified channels. It can only be used in #stream-chat during live radio streams and provides a formatted embed with the queue details and request status.

See also

Conditional checks will be bypassed for bot staff.

Aliases: q

Syntax:

!!queue
Returns:

An embed message with the current LLR stream queue and request status.

Return type:

discord.Embed

Permissions

Author: LLR

async radiorules(ctx)

Provides rules regarding LLR live streams.

Syntax:

!!radiorules
Returns:

Sends the rules and guidelines for participating in LLR live streams, including song request limits, etiquette for mentioning specific users, channel restrictions, and supporter perks.

Return type:

discord.Message

async rr(ctx, req: int | None, solo: str | None)

Initiates a Random Request on your behalf during LLR Streams.

See also

Using rr 2 and rr 2 all requires multi-request perk received from an LLR Premium Mebership

Syntax:

!!rr [req] [solo]

Example:

!!rr
!!rr 2
!!rr all
!!rr 2 all
Parameters:
  • req (int, optional) – The number of requests to make. Default is 1 if not provided.

  • solo (str, optional) – If set to all, requests from the entire LL song list including solo’s, otherwise, requests from unique songs list.

Returns:

Sends a request to play a random song during the LLR stream. If LLR is not live or requests are off, sends an appropriate message.

Return type:

discord.Message

Permissions

Author: LLR

async setmsg(ctx)

Set your LLR Featured User message. You can change it at any time up to 30 minutes before the stream. This command only works in Direct Messages with Chii-chan.

Syntax:

!!setmsg

Example:

!!setmsg Hello World
Returns:

Sends a confirmation message with the featured user message or an error if the user didn’t respond in time or used the command outside of DMs.

Return type:

discord.Message

Permissions

Author: Featured User

async stamina(ctx, *, name: str)

The stamina level of an idol in LLR Streams acts as a handicap for the most recent winning idols.

Stamina Range: The stamina ranges from 0 (Fully Recovered) to -6 (Maximum Handicap).

Effect on Votes: The higher the stamina drain (-6), the more votes an idol needs to appear on the leaderboard.

Stamina Reduction: Stamina decreases by 1 point every 28 days, maintaining the handicap for approximately 6 months after each win.

This system ensures that roughly half of the idols are affected by the handicap at any given time on a rolling 6-month basis.

The stamina data will only be updated 1 hour before stream, and shortly after a stream ending.

Syntax:

!!stamina [name]

Example:

!!stamina sumire
Returns:

A message with the information regarding that idols stamina levels, last win; and other details..

Return type:

discord.Message

Permissions

Author: LLR

async topfeatured(ctx)

Show the leaderboard of featured idols by their number of wins. Pagination will be removed after 3 minutes. Pages can only be changed by the comamnd author.

Aliases: tf

Syntax:

!!topfeatured
Returns:

Sends a paginated message showing the leaderboard of featured idols by their number of wins.

Return type:

discord.Message

async twitch(ctx)

Sends a link to the LLR Twitch stream.

Syntax:

!!twitch
Returns:

Sends a message containing the link to the Love Live Radio Twitch stream.

Return type:

discord.Message