Calendar First
Staff schedule events, boosts, rotations, and announcements from a single calendar model.
Festival - Introduction
Festival - Live Event Orchestration
Section titled “Festival - Live Event Orchestration”What is Festival?
Section titled “What is Festival?”Festival is the live-ops event engine for Matcha! servers. It owns the event calendar: scheduled weekends, spotlight hours, server modifiers, community rallies, one-off staff events, Discord reminders, web calendars, and safe multi-node activation.
If Jubilee is the season, Festival is the moment. Jubilee says “this is the three-month campaign”; Festival says “tonight from 7-9, the Dragon Outbreak Rally is live, Renown is doubled, and the contest hall has bonus ribbons.”
Live Modifiers
Activate temporary multipliers, spawn rules, reward bundles, NPC appearances, or objective overrides.
Community Presence
In-game banners, actionbar reminders, web countdowns, and Discord posts make events visible.
Safe Operations
Dry-runs, conflict detection, node locks, automatic rollback, and audit history keep events from breaking production.
Core Concepts at a Glance
Section titled “Core Concepts at a Glance”🎪 Festivals
Section titled “🎪 Festivals”A Festival is a named event package with time windows, modifiers, announcements, rewards, and optional participation tracking.
🗓 Calendar
Section titled “🗓 Calendar”The Calendar is the authoritative schedule across all nodes. It knows upcoming, active, paused, and completed events.
✨ Boons
Section titled “✨ Boons”Boons are temporary effects: renown multipliers, spawn boosts, Bazaar fee discounts, Journey objective boosts, Frontier queue bonuses, and more.
📣 Heralds
Section titled “📣 Heralds”Heralds are announcements delivered in game, on the web, and through Discord.
🎫 Attendance
Section titled “🎫 Attendance”Attendance tracks participation for reward eligibility, Passport stamps, Jubilee deeds, or event analytics.
Quick Example
Section titled “Quick Example”Step 1: Schedule
Staff schedules Festival: Moonlit Market for Friday night with Bazaar fee discounts and rare vendor NPCs.
Step 2: Announce
Festival posts a Discord reminder 24 hours before, a web countdown, and in-game heralds 15 minutes before start.
Step 3: Activate
At start time, node-safe locks activate market boons, Journey side quests, and a limited Jubilee deed.
Step 4: Recap
After the event, Festival posts stats, grants Treasury rewards, and mints Passport attendance stamps.
Why Festival?
Section titled “Why Festival?”For Players
Section titled “For Players”- Server Feels Alive: Events are visible before, during, and after they happen.
- Reliable Timing: Web and Discord calendars make it clear when to show up.
- Shared Moments: Boost windows, boss trains, market fairs, contests, and outbreak rallies become social rituals.
- Event Rewards: Attendance and participation can unlock cosmetics, titles, badges, or Jubilee progress.
For Server Owners
Section titled “For Server Owners”- Live-Ops Control: Schedule recurring and one-off events without manual command spam.
- Conflict Prevention: Detect overlapping modifiers, unsafe reward combos, and node mismatch before publishing.
- Cross-Mod Orchestration: Coordinate Outbreaks, Frontier, Bazaar, Relic, Journey, Reverie, and Jubilee from one calendar.
- Operational Memory: Keep a history of what ran, who changed it, which nodes activated, and what rewards went out.
Documentation
Section titled “Documentation” Overview & Design Calendar model, event packages, gameplay loops, and scheduling architecture
Commands & Integrations Command sketches, permissions, web calendar, Discord heralds, and modifier adapters
Naming Direction
Section titled “Naming Direction”Festival fits the Matcha! style because it is broad, social, and instantly understandable. It can cover a battle weekend, a market fair, a contest gala, an outbreak hour, or a season finale without becoming tied to one mechanic.
| Candidate | Read |
|---|---|
| Festival | Recommended. Eventful, server-wide, flexible, and aligned with social live operations. |
| Carnival | Fun, but slightly too whimsical and less premium. |
| Revel | Strong, but overlaps with Jubilee’s celebration language. |
| Calendar | Accurate, but too utilitarian for a bespoke mod name. |
Development Status
Section titled “Development Status”- Phase 1: Calendar model, event lifecycle, in-game status UI, manual start/stop
- Phase 2: Scheduled activation, boons, Discord/web announcements
- Phase 3: Cross-mod adapters, attendance, Treasury rewards, Passport stamps
- Phase 4: Staff dashboard, conflict checks, analytics, recurring event templates
Estimated Development Time: 9-13 weeks