Admin Commands
Admin command
/eventforge
Alias:
/ef
Required permission:
eventforge.admin
The admin command is used for starting, stopping, finishing, validating, reloading and managing EventForge systems.
Admin commands
/eventforge admin
Opens the EventForge admin GUI.
/eventforge admin
Useful for managing EventForge in-game without typing every command manually.
/eventforge reload
Reloads EventForge configuration, messages, GUI data, templates, event files, event packs, schedules and scheduled voting config.
/eventforge reload
If active events are running, EventForge may require confirmation:
/eventforge reload confirm
Reloading also refreshes the optional TextEffect hook state, cancels active votes, clears open queues and reloads runtime configuration safely.
Use /eventforge reload confirm carefully on live servers. Active events and open queues are cleared as part of the reload safety flow.
/eventforge validate
Validates loaded event files and global configuration checks without starting events.
/eventforge validate
This checks event files plus extra v1.0.3 systems such as TextEffect mode, participation defaults, queue visuals and scheduled voting config.
/eventforge validate <event_or_file>
Validates one event or supported config target.
/eventforge validate mining_rush
/eventforge validate schedule_config.yml
/eventforge validate scheduled-voting
This is useful when you only want to check one event or the scheduled voting config.
/eventforge errors
Shows recent validation or reload issues.
/eventforge errors
Use this after a reload or validation pass to quickly see what needs fixing.
/eventforge errors <event_or_file>
Shows recent issues for one event or file filter.
/eventforge errors mining_rush
/eventforge errors schedule_config.yml
/eventforge list
Lists loaded event templates.
/eventforge list
This is useful for confirming your event files loaded correctly.
/eventforge active
Lists currently active events.
/eventforge active
/eventforge start <event>
Starts an event manually.
/eventforge start mining_rush
If the event uses automatic participation, it starts normally.
If the event uses manual participation, this opens the event queue instead of starting the event instantly.
Manual starts still use EventForge's normal start flow. Cooldowns, conditions, active event checks and objective requirements still apply.
/eventforge stop <event>
Force-stops an active event.
/eventforge stop mining_rush
This cancels the event without treating it like a natural finish.
/eventforge finish <event>
Finishes an event naturally and processes normal end behaviour.
/eventforge finish mining_rush
Use this for testing rewards, history, leaderboards and event finish behaviour.
/eventforge check <event>
Checks whether an event can start.
/eventforge check mining_rush
This is useful for debugging conditions such as:
minimum players
world restrictions
region requirements
permission requirements
blocked permissions
operator requirements
Minecraft time windows
weather restrictions
cooldowns
Mob Invasion nearby requirements
/eventforge leaderboard <event>
Shows the current leaderboard for an active event.
/eventforge leaderboard mining_rush
/eventforge points <player> <event> <amount>
Adds points to a player for an active event.
/eventforge points Steve mining_rush 10
This is useful for testing scoring, milestones, PlaceholderAPI placeholders and reward behaviour.
For manual queue events, the target player must be participating in the event. EventForge protects manual events so non-queued players cannot receive event score.
/eventforge schedules
Shows normal scheduled events and scheduled event votes.
/eventforge schedules
In v1.0.3 this command can show:
normal per-event schedules
scheduled event votes from schedule_config.yml
next vote times
scheduled vote option IDs
/eventforge history
Shows recent completed event history.
/eventforge history
/eventforge templates
Lists bundled installable event templates.
/eventforge templates
/eventforge installtemplate <template>
Installs a bundled template into the active events folder.
/eventforge installtemplate mining_rush
/eventforge installtemplate <template> confirm
Overwrites an existing installed event file with a bundled template.
/eventforge installtemplate mining_rush confirm
Use confirm when you intentionally want to replace the file in:
plugins/EventForge/events/
This can overwrite your edited event file. Back up the event first if you are unsure.
/eventforge iteminfo
Shows information about the item in your hand.
/eventforge iteminfo
This is useful when configuring collection, fishing, custom item or provider-based events.
The output can help with:
material names
custom model data
display names
ItemsAdder IDs
Oraxen IDs
Nexo IDs
MMOItems IDs
persistent data keys
/eventforge entityinfo
Shows information about the entity you are looking at.
/eventforge entityinfo
This is useful when configuring mob hunt or mob invasion events.
The output can help with:
entity type
entity UUID
custom name
location
MythicMobs ID
scoreboard tags
persistent data keys
/eventforge dialogue <player> <event> <dialogue>
Starts an event dialogue for a player.
/eventforge dialogue Steve mining_rush intro
This is mainly useful for testing dialogue configuration while building event templates.