🛠️ Commands & Permissions
EventForge has two main command groups:
/eventforge
/ef
/events
/eventforge and /ef are for admin management.
/events is the player-facing command for menus, stats, voting, queues and event teleporting.
Permission model
EventForge currently uses one main admin permission gate:
eventforge.admin
This permission is checked before using /eventforge or /ef.
The /events player command does not currently require a plugin permission by default. If you want to restrict player commands, use your permissions plugin, command blocker, menu plugin or server command rules.
For most servers, give trusted staff eventforge.admin and leave /events available to normal players.
Main commands
| Command | Description |
|---|---|
/eventforge | Main admin command |
/ef | Short admin command alias |
/events | Player-facing event command |
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.
Admin voting commands
/eventforge vote start <event1> <event2> [event3...]
Starts a manual player vote.
/eventforge vote start mining_rush mob_hunt fishing_frenzy
Players vote with /events vote <event> or by clicking the broadcast options in chat.
/eventforge vote cancel
Cancels the active event vote.
/eventforge vote cancel
/eventforge vote status
Shows the current vote status.
/eventforge vote status
/eventforge vote confirm
Starts the pending winning event when automatic winner startup is disabled.
/eventforge vote confirm
This only applies when:
voting:
start-winner-automatically: false
Player commands
/events
Opens the player events menu.
/events
From console, /events lists active events instead.
/events stats
Shows the player's EventForge stats.
/events stats
/events toggle
Toggles the player's event sidebar display.
/events toggle
/events vote <event>
Votes for an event during an active vote.
/events vote mining_rush
Vote options are also clickable in chat when EventForge broadcasts a vote.
/events join <event>
Joins an open manual event queue.
/events join mining_rush
If the event has a queue lobby configured, EventForge teleports the player to the waiting area after joining.
/events leave <event>
Leaves an open manual event queue.
/events leave mining_rush
This only works if the queue allows leaving before the event starts.
/events tp <event>
Teleports the player to an active event location, if the event supports one.
/events tp mob_invasion
This is mainly useful for events such as Mob Invasion where a join/teleport location is configured.
/events teleport <event>
Alias for /events tp <event>.
/events teleport mob_invasion
/events join backwards compatibility
In v1.0.3, /events join <event> is queue-first:
If an open queue exists, the player joins the queue.
If no queue exists and the event is active with a teleport location, the command falls back to the old teleport behaviour.
For active event teleporting, /events tp <event> is the clearer command going forward.
Tab completion
EventForge includes tab completion for the main admin and player commands.
Admin tab completion includes:
admin
start
stop
finish
list
templates
installtemplate
active
leaderboard
points
schedules
check
history
iteminfo
entityinfo
validate
errors
reload
vote
Player tab completion includes:
stats
toggle
join
leave
tp
teleport
vote
Queue and vote tab completion is context-aware:
/events join <tab> shows open queues and teleportable active events.
/events leave <tab> shows queues the player has joined.
/events tp <tab> shows active teleportable events.
/events vote <tab> shows current vote options.
Recommended LuckPerms setup
Admin group:
/lp group admin permission set eventforge.admin true
Player group:
No EventForge player permission is required by default for /events.
If you restrict commands through another plugin, allow players to use:
/events
/events stats
/events toggle
/events vote
/events join
/events leave
/events tp
/events teleport
Common admin workflows
Reload after config changes
/eventforge reload confirm
/eventforge validate
Install a bundled template
/eventforge templates
/eventforge installtemplate mining_rush
Test a normal automatic event
/eventforge check mining_rush
/eventforge start mining_rush
/eventforge leaderboard mining_rush
/eventforge finish mining_rush
Test a manual queue event
/eventforge start mining_rush
/events join mining_rush
/events leave mining_rush
If enough players stay queued, the event starts after the queue countdown.
Start a manual vote
/eventforge vote start mining_rush mob_hunt fishing_frenzy
/events vote mining_rush
/eventforge vote status
Check scheduled voting
/eventforge schedules
/eventforge validate schedule_config.yml
Summary
Use /eventforge or /ef for admin management.
Use /events for player-facing event features.
For v1.0.3, the main enforced admin permission is:
eventforge.admin
The new v1.0.3 command additions are mainly:
/eventforge vote start/cancel/status/confirm
/events vote <event>
/events join <event>
/events leave <event>
/events tp <event>
/events teleport <event>