About Plugin
hsOtoEvent, developed by HeliosProject, is a free and highly configurable plugin designed to automate running scheduled events (via console commands) on your Minecraft server. Keep your community active and informed with daily or weekly custom events, automatic Discord announcements using rich embeds, and basic alt account protection for event rewards.


Features

• Advanced Event Scheduling:
  • Daily Events: Schedule commands to run automatically every day at one or multiple specific times (e.g., "14:00", "20:30") defined in `config.yml`. (Toggleable)
  • Weekly Events: Define different events (commands, names) for each day of the week, running at a specific time for that day. (Toggleable globally and per day).
  • Flexible Commands: Configure any number of console commands to run for each event. Use
    Code (Text):

    @a
    to target all online players (works with IP Limit) and placeholders like
    Code (Text):

    %online_players%
    .
• Discord Integration (via JDA Bot):
  • Admin Notifications: Automatically send a detailed embed message to a specified Discord channel (for staff) when an event starts, including event name, online player count, and player list. (Toggleable, embed fully configurable).
  • Public Announcements: Announce upcoming events automatically to a public Discord channel a configurable number of minutes before they start, using a stylish embed message showing event name and time remaining. (Toggleable, embed fully configurable).
• IP Limit (Alt Protection):
  • When using commands targeting all players (
    Code (Text):

    @a
    ), the plugin ensures that only the first player from each unique IP address is affected by the command during that specific event execution. Helps prevent alt accounts from farming event rewards. (Toggleable).
• Management & Performance:
  • Reload Command: Reload all settings from
    Code (Text):

    config.yml
    without restarting the server using
    Code (Text):

    /hseventreload
    .
  • Configurable Interval: Set how often the scheduler checks for due events in `config.yml`.
  • Asynchronous Discord: All communication with Discord runs asynchronously to prevent server lag.
  • Detailed Configuration: Control every aspect through a well-commented
    Code (Text):

    config.yml
    .

Commands

• Code (Text):

  /hseventreload
  - Reloads the plugin's configuration from
  Code (Text):

  config.yml
  . (Permission:
  Code (Text):

  hsotoevent.reload
  )

Permissions

• Code (Text):

  hsotoevent.reload
  - Allows usage of the
  Code (Text):

  /hseventreload
  command. (Default: op)

Configuration
All plugin settings are managed through the file located in the folder, generated on first run. You can configure:

• Scheduler check interval.
• Daily event times and commands.
• Weekly event settings for each day (enable/disable, time, name, commands).
• Discord bot token, channel IDs for reports and archives.
• Full customization of Discord embed messages (title, description, color, fields, footer, timestamp).
• Discord action buttons (label, style, action type, duration).
• IP Limit enable/disable toggle.
• Messages for reload command.
• bStats toggle.

Please review the default configuration file carefully for detailed explanations of each option.