Events Module

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

Handles management and scheduling of LLR (Love Live Radio), Bandori, and Ainya events.

This class provides commands to create, manage, and synchronize scheduled events related to LLR, Bandori Radio, and Suzuki Aina Birthday Radio.

It includes functionalities to create new events with specific details such as start time, manage event IDs, start and stop scheduled events, and fetch currently scheduled events within the Discord server.

See also

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

Attention

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

async bangstart(ctx)

Starts the Bandori or Ainya event based on the stored event IDs.

This command checks if either the Bandori or Ainya event ID is set and then starts the corresponding scheduled event. If no event ID is set, it prompts the user to set it using ssid bandori <eventID> or ssid ainya <eventID>.

Aliases: ainyastart

Syntax:

!!bangstart

Usage:

  • If Bandori event ID is set, starts the Bandori Radio and notifies the Bandori stream role.

  • If Ainya event ID is set, starts the Ainya Radio and notifies everyone about Suzuki Aina’s birthday.

  • If no event ID is set for either, prompts the user to set it with ssid.

Returns:

Confirmation message indicating the start of the event or an error message if no event ID is set.

Return type:

discord.Message

Permissions

Author: Bangstream and LLR

Bot: Manage Events

async bangstop(ctx)

Stops the currently running Bandori or Ainya event based on the stored event IDs.

This command checks if either the Bandori or Ainya event ID is set and then stops the corresponding scheduled event. If an event is stopped, it resets the event ID to 0.

Syntax:

!!bangstop

Aliases: ainyastop

Usage:

  • If Bandori event ID is set and an event is running, stops the Bandori Radio and sends a closing message.

  • If Ainya event ID is set and an event is running, stops the Ainya Radio and sends a closing message.

  • If no event ID is set for either, notifies the user that no Bandori event is currently listed.

Returns:

Confirmation message indicating the end of the event or an error message if no event ID is set.

Return type:

discord.Message

Permissions

Author: Bangstream and LLR

Bot: Manage Events

async create_event(ctx, name, early=None, time=None, date=None)

Create an LLR/Bandori/Ainya Event with published Announcement.

Syntax:

!!create_event <name> [early] [time] [date]

Examples:

!!create_event llr
!!create_event bandori 18:00:00 2023-06-20
Parameters:

  • name (str, required) – The type of event to create (LLR, Bandori, Ainya).

  • early (str, optional) – Determines if the event starts early. Optional.

  • time (str, optional) – The time at which the event starts (format: HH:MM:SS). Optional.

  • date (str, optional) – The date on which the event starts (format: YYYY-MM-DD). Optional.

  • attachment – Image attachment to use in announcement and event creation. Optional for Bandori/Ainya. Required for LLR.

Returns:

A scheduled event ID upon successful creation. Create published announcement. Create event.

Return type:

int

Permissions

Author: LLR, Bangstream

Bot: Create Events

async end_event(ctx, event_id: int)

Stop a scheduled event with a specified event ID.

Syntax:

!!end_event <event_id>

Examples:

!!end_event 1259645725902639127
Parameters:

event_id (int, required) – The ID of the event to stop.

Returns:

Confirmation message indicating the event has been stopped or an error message if the event cannot be found or stopped.

Return type:

discord.Message

Permissions

Author: LLR Admin, LLR

Bot: Manage Events

async find_events(ctx)

Find currently scheduled server events.

Syntax:

!!find_events
Returns:

A list of currently scheduled events.

Return type:

discord.Message

Permissions

Author: Administrator

async setstreamid(ctx, name: str = None, event_id: int = None)

Manually set the event ID for LLR, Bandori, or Ainya streams. Used to set internal params if LLR Stream Module is restarted between event creating and event starting.

Syntax:

!!setstreamid <name> <event_id>

Aliases: ssid

Examples:

!!setstreamid llr 1257109341782278165
!!ssid bandori 1254465834336649358
Parameters:

  • name (str, optional) – The name of the stream (LLR, Bandori, or Ainya).

  • event_id (int, optional) – The ID to set for the specified stream.

Returns:

Confirmation message indicating the event ID has been set or an error message if the stream name is invalid.

Return type:

discord.Message

Permissions

Author: LLR Admin

async start_event(ctx, event_id: int)

Start a scheduled event with a specified event ID.

Syntax:

!!start_event <event_id>

Examples:

!!start_event 1259645725902639127
Parameters:

event_id (int, required) – The ID of the event to start.

Returns:

Confirmation message indicating the event has been started or an error message if the event cannot be found or started.

Return type:

discord.Message

Permissions

Author: LLR, Admin

Bot: Manage Events