MYTHICGHOULPLUGIN FORGE
Home / Resources / MythicEvents
MythicEvents icon
In Development

MythicEvents

Automated world events and chat games that keep quiet hours active.

In development
—Spigot downloads
—Modrinth downloads
No ratings yetSpigot rating
1.1.1Current version
—Last public update

Full overview

Automated world events and chat games that keep quiet hours active.

MythicEvents is a modular activity engine intended to keep the server active during both busy and quiet periods. It supports lightweight chat challenges alongside physical world events that send players exploring, mining, hunting or surviving unusual conditions.

Events can rotate automatically, announce through Discord and deliver configurable rewards, allowing the server to create regular moments without requiring a staff member to host each one manually.

Best suited toCommunity survival servers that want varied automated activity without running a separate minigame network.

How it works

Automatic rotation with very different kinds of activity

The scheduler selects an eligible event, announces it and begins tracking the relevant objective. Chat games focus on speed and accuracy, while world events create locations, targets, mobs or temporary global conditions.

Each event manages its own completion state, winner information and rewards. Administrative menus are planned to make questions, reward commands and event settings editable without rebuilding configuration by hand.

  • Mixes quick chat games with larger world activities
  • Reduces the need for staff-hosted events
  • Configurable rewards and Discord announcements
  • Expandable event types for future server content

Administration

Configuration and live-server use

The project is in development. Automatic scheduling, reward editing, winner reporting and event cleanup are treated as production requirements so activities do not leave behind unmanaged entities or locations.

CompatibilityPaper 1.21.x IntegrationsVault, Discord webhooks, LevelCraft hooks VersionIn development

Feature breakdown

Everything included in MythicEvents

Each headline feature is expanded below so visitors can understand the real server use rather than seeing a short tag list.

✓

Automatic event rotation

Eligible activities begin on a schedule without manual staff commands.

✓

Chat games and quizzes

Maths, scrambles, typing and questions create quick participation opportunities.

✓

Treasure and block hunts

Players receive hints and search the world for temporary objectives.

✓

Mob and mining events

Tracked targets turn ordinary combat and gathering into competitions.

✓

Blood moon system

Selected nights can create dangerous global mob pressure and special announcements.

✓

Reward and question editor

Administration tools are designed to manage content from inside the server.

Getting started

Installation and rollout

This project is not currently offered as a public platform download; its page documents the system and development status.

  1. 1

    The project remains in development and is tested as part of the GhoulCraft stack.

  2. 2

    Event cleanup, scheduling and rewards are verified individually.

  3. 3

    Discord and economy hooks are staged before live use.

  4. 4

    New event types are enabled only after their tracking and reset logic is confirmed.

Tokens & placeholders

Text tokens found in the source

Availability depends on the feature that references each token.

%active%%amount%%block%%event_id%%event_name%%event_type%%name%%next_time%%objective%%phrase%%place%%player%%player_played%%player_uuid%%player_uuid_trimmed%%player_wins%%prefix%%question%%radius%%score%%scrambled%%target%%target_amount%%target_raw%%time%%top_1_name%%top_1_score%%top_1_wins%%top_2_name%%top_2_score%%top_2_wins%%top_3_name%%top_3_score%%top_3_wins%%uuid%%uuid_dashed%%winner%%wins%%word%%world%

Source architecture

42 Java classes across 18 packages

editor (8), events.chat (5), listeners (5), managers (4), utils (4), gui (3), events (2), commands (1)

◆

Core systems

ConfigFile, EditorConfigStore, PluginConfigStore, ReflectiveConfigStore, LocationUtil, TimeUtil, WeightedPicker

◆

Commands

MythicEventsCommand

◆

GUI & menus

EditorHolder, EditorMenuType, MythicEventsGUIHolder, MythicEventsPlaceholderHook

◆

Listeners & events

GameEditorListener, AbstractGameEvent, GameEvent, BlockHuntEvent, AbstractChatGameEvent, MathPuzzleEvent, QuizEvent, TypeRaceEvent, WordScrambleEvent, MiningRushEvent, MobHuntEvent, TreasureHuntEvent, EventGUI, EventGUIListener, BlockHuntListener, ChatGameListener, MiningRushListener, MobHuntListener and 5 more

◆

Managers & services

ChatPromptManager, GameEditorManager, DiscordWebhookManager, MessageManager, PlacedBlockManager, PlayerStatsManager

◆

Utilities

ColorUtil

Configuration reference

5 bundled YAML files

Top-level sections and defaults are summarised from the supplied resources.

⚙

config.yml

  • Settings — 16 nested settings: Enabled, Prefix, Auto-Start, Interval-Minutes, Initial-Auto-Start-Delay-Seconds, Auto-Retry-Seconds, Default-Duration-Minutes…
  • Random-Event-Pool — 8 configured entries
  • Chat-Games — 4 nested settings: Case-Sensitive, Cancel-Correct-Answer-Message, Cancel-All-Answers-During-Chat-Games, Strip-Colors
  • Block-Tracking — 3 nested settings: Track-Player-Placed-Blocks, Save-Player-Placed-Blocks, Max-Saved-Player-Placed-Blocks
  • Rewards — 1 nested settings: Default
  • GUI — 2 nested settings: Enabled, Title
  • Discord-Webhook — 10 nested settings: Enabled, Url, Username, Avatar-Url, Player-Head-Url, Footer, Show-Rewards…
  • PlaceholderAPI — 1 nested settings: Enabled
⚙

data.yml

  • Players — 0 nested settings:
  • Stats — 2 nested settings: Last-Winner, Last-Event
  • Placed-Blocks — 0 configured entries
⚙

events.yml

  • Events — 8 nested settings: Block-Hunt, Math-Puzzle, Word-Scramble, Quiz, Type-Race, Mob-Hunt, Mining-Rush…
⚙

gui.yml

  • GUI — 1 nested settings: Main
⚙

messages.yml

  • Messages — 30 nested settings: Prefix, No-Permission, Player-Only, Reloaded, No-Active-Event, Already-Active, Invalid-Event…

Permissions

8 declared permission nodes

Defaults and descriptions come directly from plugin.yml.

✓

mythicevents.use

Allows players to use basic MythicEvents commands.

Default: True

✓

mythicevents.status

Allows players to view the active event status.

Default: True

✓

mythicevents.top

Allows players to view event leaderboards.

Default: True

✓

mythicevents.participate

Allows players to participate in events.

Default: True

✓

mythicevents.admin

Allows full MythicEvents admin access.

Default: op

✓

mythicevents.admin.start

Allows admins to start events.

Default: op

✓

mythicevents.admin.stop

Allows admins to stop events.

Default: op

✓

mythicevents.admin.reload

Allows admins to reload MythicEvents.

Default: op

Commands

1 declared command

Aliases, usage and permissions come directly from plugin.yml.

/

/mythicevents

Main MythicEvents command.

Aliases: /mevents, /event, /events · Usage: /mythicevents · Permission: None declared

Source-verified reference

Checked against MythicEvents 1.1.1

This static reference is built from the supplied plugin.yml, YAML resources and Java source. No browser-generated documentation is used.

Main classme.Ghoul.WorldEvents.MythicEventsAPI version1.21Java classes42 Hard dependenciesNoneSoft dependenciesPlaceholderAPI, VaultLoad beforeNone

Related projects

Continue exploring