Events

Events

The Events system brings occasional server-wide random encounters that reward quick participation. These are opportunistic mini-events (not to be confused with Settlement's internal events).

Admins configure the system with /setup_events (requires Administrator permission). This sets the current channel as the spawn location for events.

How Events Work

• A background task checks every 2 hours (120 minutes) and has a 50% chance to trigger a random event.
• When triggered, it posts an embed in all configured event channels across guilds.
• The embed includes a themed description and a single claim button.
• First player to click claims the reward. Subsequent clicks are blocked per user (one claim per event instance).
• The embed updates live to show recent claims (keeps the last 5).
• After a timeout, the button disables.

Events are server-scoped via the setup command — each guild can have its own channel.

Event Types

Four themed events currently exist, each tied to core activities:

• Leprechaun (☘️): "A leprechaun appears! Click the button to reach into his... uh..."
  Reward: 1 Curio.

• Meteorite (⛏️): "A meteorite crashes nearby! Miners required!"
  Reward: Mining resources based on your current pickaxe tier (yields from the Mining skill table).

• Dryad (🪓): "A giant dryad appears! Foresters required!"
  Reward: Woodcutting resources based on your current axe tier.

• High Tide (🎣): "The High Tide rises! Trawlers required!"
  Reward: Fishing resources based on your current rod tier.

All skill-based events require the appropriate tool (pickaxe/axe/rod) in your skills data; otherwise, you get a message that you need the tool.

Claiming & Limitations

• Click the button once per event.
• The view tracks claimed users to prevent double-dipping.
• Rewards are granted instantly via the database (curios or skill resources).
• A "Recent Claims" field is appended/updated on the original embed so others can see who got what.
• If the event times out before anyone claims (or after), the button is disabled.

Tips

• Events are opportunistic — keep an eye on the configured channel if you're active in the server.
• The skill events (Meteorite, Dryad, High Tide) are excellent for topping up resources without using your normal gathering cooldowns or minigames.
• Leprechaun events are a nice free Curio source.
• Guild admins: Use /setup_events in a visible, non-spammy channel (e.g., #events or #announcements). Only one channel per guild is supported.
• Because the loop is global with a 50% trigger chance, events won't fire every cycle in every guild.

Events add a light, social layer of random rewards that encourage checking in on the server without being a heavy chore.

---

Stay alert. Fortune (and resources) favor the attentive.

Last updated: May 2026 (sourced from cogs/events.py, core/events/views.py, CLAUDE.md Events section, and integration with skills/curios systems)