Skip to main content

🔗 Quick Links

Use this page to jump to the part of the docs you need.


Getting started

PageUse it for
InstallationInstalling EventForge on your server
Folder StructureUnderstanding EventForge files and folders
Commands & PermissionsViewing commands and permissions
TroubleshootingFixing common setup issues

Server owners

PageUse it for
Templates vs EventsUnderstanding how EventForge event files work
Event PacksGrouping events into packs
Event VariablesReusing colours, names, rewards, and text
Multi-objective EventsRunning multiple objectives in one event
RewardsParticipation, leaderboard, and chance rewards
Bossbars & SidebarsShowing event progress on-screen
Schedules & ConditionsScheduled events, start rules, and cooldowns
Actions & TriggersRunning actions when events start, finish, stop, or players score
DialoguesNPC-style dialogue sequences for event addons
GUI CustomizationCustomizing EventForge menu titles
PlaceholderAPIUsing EventForge placeholders in other plugins

Built-in objectives

PageUse it for
Mining RushMine blocks for points
Mob HuntKill mobs for points
Fishing FrenzyCatch items for points
Collection RushCollect items for points
Mob InvasionSpawn invasion waves
Custom Content SupportCustom items, mobs, catches, and addon objectives

Developers

PageUse it for
Maven SetupAdding the EventForge API to your addon
API OverviewUnderstanding the public API
EventServiceReading and controlling events
ScheduleServiceReading schedules and upcoming events
ObjectiveServiceReading registered objective types
Custom ObjectivesCreating addon objective types
Action RegistryRegistering custom action types
Dialogue ServiceStarting and managing dialogues
Bukkit EventsListening to EventForge developer events

Examples

PageUse it for
Simple Addon ExampleReading EventForge data from another plugin
Advanced Relic Hunt ExampleCreating a custom objective and custom action
Skript AddonUsing EventForge from Skript
Skript Example ScriptsReady-to-use Skript files bundled with the addon

Changelog

PageUse it for
v1.0.0 ReleaseInitial stable release notes
v1.0.1 ReleaseLatest v1.0.1 feature update

Common tasks

Create a basic event

Start with:

Mining Rush
Mob Hunt
Fishing Frenzy
Collection Rush

Add bonus rewards

Read:

Rewards

Stop events from starting too often

Read:

Schedules & Conditions

Reuse text across an event file

Read:

Event Variables

Make one event use several objectives

Read:

Multi-objective Events

Run commands, titles, sounds, or webhooks from triggers

Read:

Actions & Triggers

Build an addon

Read:

Maven Setup
API Overview
Custom Objectives
Action Registry
Dialogue Service

Use Skript

Read:

Skript Addon
Skript Example Scripts

Summary

Use this page as a shortcut hub when setting up, configuring, extending, or debugging EventForge.