LLR Stream Admin Module
- class StreamAdminCMD(*args: Any, **kwargs: Any)
Module specifically designed to meet the evergrowing needs of LLR Stream Management.
See also
Module is locked to the Love Live Radio (LLR) server.
Attention
All commands assume minimum bot permissions: View Channel, Send Messages.
- async choose(ctx, *choices: str)
Decides the winner of Featured Idol if there is a tie.
Syntax:
!!choose <choices>Example:
!!choose Kotori Honoka Umi- Parameters:
choices (str, required) – The list of tied idols to choose from.
- Returns:
Sends an embed message announcing the randomly chosen winner among the tied idols.
- Return type:
discord.Embed
- async devstaato(ctx)
Put Staato into debug mode for 10 minutes.
Syntax:
!!devstaato- Returns:
Confirmation message.
- Return type:
discord.Message
- async forceupidolstamina(ctx)
Force update all Idol Stamina. Runs automatically before and after an LLR stream.
Aliases:
uaisSyntax:
!!forceupidolstamina- Returns:
Confirmation message.
- Return type:
discord.Message
- async get_lfu(ctx)
Return the current Featured User.
Syntax:
!!get_lfu- Returns:
Sends a message with the name and ID of the current Featured User.
- Return type:
discord.Message
- async llr_schedule(ctx, time=None, date=None)
Check or update the LLR schedule. The secondary schedule is automatically calculated off of this time. Will also update the database with early or late stream params.
Syntax:
!!llr_schedule [time] [date]Example:
!!llr_schedule 19:00 !!llr_schedule 19:00 2023-07-16
- Parameters:
time (str, optional) – The time to schedule the next stream in HH:MM format. If not provided, the schedule is checked.
date (str, optional) – The date to schedule the next stream in YYYY-MM-DD format. If not provided, the current date is used.
- Returns:
Sends a message displaying the updated schedule or the current schedule if no time is provided, updates embed in #llr-schedule. Runs automatically from
thanks.- Return type:
discord.Message, discord.Embed
- async next_schedule(ctx, option)
Manually trigger the next schedule update for LLR Schedule.
Syntax:
!!next_schedule <option>Example:
!!next_schedule early- Parameters:
option (str, required) – The time option for the next schedule update. Use “early” for 13:00 or late for 20:00.
- Returns:
The Unix timestamp for the next scheduled update.
- Return type:
int
- async nrs(ctx)
Begins the auto message for the NRS Sequence, sends a series of animated GIFs in sequence, each depicting a different phase of the NRS Sequence. Outdated after autostream implementation.
Syntax:
!!nrs- Returns:
Multiple timed messages displays GIFs
- Return type:
discord.Message
- async raffle(ctx, winners: int = 1, role: Role = None)
Decides the winner of the Featured User raffle.
Syntax:
!!raffle <winners> [role]Example:
!!raffle !!raffle 1 !!raffle 2 @entry
- Parameters:
winners (int, optional) – The number of winners to select. Defaults to 1.
role (discord.Role, optional) – The role of the participants. Defaults to ‘@entry’ if not specified.
- Returns:
Sends a message announcing the winner(s) of the raffle and updates the last featured user.
- Return type:
discord.Embed
- Returns:
Direct messages the winner with other details pending users privacy settings.
- Return type:
discord.DMChannel, discord.Message
- async reqs(ctx, option=None)
Check or change the status for listeners to make LLR Requests during stream.
Syntax:
!!reqs [option]Example:
!!reqs !!reqs on !!reqs off
- Parameters:
option (str, optional) – The desired status for requests (
onoroff). If left blank, the current status is checked.- Returns:
Sends an embed message displaying the current or updated status of requests.
- Return type:
discord.Embed
- async set_delay(ctx, time_input: str | None = None)
Delay stream end by a specified amount of time. If enabled, the LLR stream in progress will not be able to end before this time has expired.
Aliases:
delay- Parameters:
time_input (Optional[str], optional) – The delay time in the format ‘XhYm’ (e.g., ‘1h30m’ or ‘5m’). If None, displays the current delay time.
Syntax:
!!set_delay [time_input]Example:
!!set_delay 1h30m !!set_delay
- Returns:
Sends a message displaying the current delay time or confirming the updated delay time.
- Return type:
discord.Message
- async set_lfu(ctx, id: int)
Manually overwrite the current Featured User.
Syntax:
!!set_lfu <id>Example:
!!set_lfu 123456789012345678- Parameters:
id (int, required) – The ID of the new Featured User.
- Returns:
Sends a message confirming the update of the Featured User.
- Return type:
discord.Message
- async staato(ctx)
Starts the LLR Stream, begins timer for auto messages during stream. Updates Chii-chans activty, enables all stream-related commands, calculates lucky chii-bun probabilities.
Automatically ends the stream 4hrs after command is executed unless
set_delayis used during stream.Aliases:
stato,stattto,staattoSyntax:
!!staato- Returns:
Sends hourly embed messages detailing the start, progress, and end of the LLR stream.
- Return type:
discord.Embed
Debug
If in debug mode, debug information will be displayed and a simulated live-stream enabled environment will be created.
- async starttwitch(ctx)
Manually set Chisato’s activity to Streaming Love Live Radio.
Syntax:
!!starttwitch- Returns:
Sends a message confirming the presence change to streaming Love Live Radio.
- Return type:
discord.Message
- Returns:
Update activity to Streaming Love Live Radio with Twitch link
- Return type:
discord.Activity
- async stoptwitch(ctx)
Manually revert Chisato’s activity to default rotation.
Syntax:
!!stoptwitch- Returns:
Sends a message confirming the presence change to default rotation.
- Return type:
discord.Message
- Returns:
Update activity to default rotation.
- Return type:
discord.Activity
- async thanks(ctx: Context, idol, img: Attachment)
Send a thank you message at the end of the stream, announcing the Featured Idol winner and thanking supporters.
Syntax:
!!thanks <idol> <image attachment>Example:
!!thanks Hanamaru <image attachment>- Parameters:
idol (str, required) – The name of the winning idol.
- Returns:
Sends a formatted thank you message to the announcements channel.
- Return type:
discord.Message
- async updateidolstamina(ctx, name: str, date: str = None, stamina: int = None, totalwins: int = None)
Use to create a new Idol in the Idol Stamina database or update existing info.
Date shall be formatted as YYYY-MM-DD e.g. 2024-07-23
Aliases:
uisSyntax:
!!updateidolstamina <name> <date> <stamina> <totalwins>Example:
..code-block:: console
!!uis Rurino 2024-07-21 2 3
- Parameters:
name (str, required) – The name of the idol
date (date, required (YYYY-MM-DD e.g. 2024-07-21)) – The date of their last win
stamina (int, required) – The current stamina drain (if any) else set 0
totalwins (int, required) – The overal total wins for the idol
- Returns:
Confirmation message.
- Return type:
discord.Message
- async win(ctx, idol)
Announces the winner of the Featured Idol poll for the current LLR stream. Updates records such as the last Featured Idol, sets the server icon to the winning idol’s icon, records updated LFI and LFU, and moves voting records accordingly.
Syntax:
!!win <idol>Example:
!!win dia- Parameters:
idol (str, required) – The name of the idol who won the Featured Idol poll.
- Returns:
Sends an embed message announcing the Featured Idol winner and updates various data records.
- Return type:
discord.Embed