🛠️ Commands & Permissions
EventForge includes admin commands for managing events and player commands for viewing event information.
Main commands
| Command | Description |
|---|---|
/eventforge | Main admin command |
/ef | Admin command alias |
/events | Player event command |
Admin command
/eventforge
Alias:
/ef
The admin command is used for starting, stopping, reloading, validating, and managing EventForge events.
Player command
/events
The player command is used for event information, stats, UI toggles, and event join locations.
Admin commands
/eventforge help
Shows the EventForge command help menu.
/eventforge help
Permission:
eventforge.admin
/eventforge reload
Reloads EventForge configuration, messages, templates, packs, events, and schedules.
/eventforge reload
Permission:
eventforge.admin.reload
After reloading, EventForge shows a useful summary:
Loaded events: 8 | Warnings: 0 | Errors: 0
The console also logs more detail, including:
Files scanned
Loaded events
Disabled files skipped
Failed files
Validation warnings
Validation errors
Scheduled events
Registered objectives
Use /eventforge reload after editing event files, templates, packs, schedules, rewards, metadata, or conditions.
/eventforge validate
Validates all loaded event files without starting them.
/eventforge validate
Permission:
eventforge.admin.validate
Use this after editing multiple files.
/eventforge validate <event>
Validates one event.
/eventforge validate mining_rush
Permission:
eventforge.admin.validate
This is useful before testing a specific event.
/eventforge errors
Shows recent validation or reload errors.
/eventforge errors
Permission:
eventforge.admin.errors
/eventforge errors <event>
Shows recent errors for one event.
/eventforge errors mining_rush
Permission:
eventforge.admin.errors
/eventforge list
Lists loaded EventForge events.
/eventforge list
Permission:
eventforge.admin.list
This is useful for checking whether your event files loaded correctly.
/eventforge active
Lists currently active EventForge events.
/eventforge active
Permission:
eventforge.admin.active
/eventforge start <event>
Starts an event manually.
/eventforge start mining_rush
Permission:
eventforge.admin.start
Manual starts still check event conditions. If the event fails its conditions, it will not start.
/eventforge stop <event>
Force-stops an active event.
/eventforge stop mining_rush
Permission:
eventforge.admin.stop
This is treated as a forced stop.
/eventforge finish <event>
Finishes an event naturally and processes normal end behaviour.
/eventforge finish mining_rush
Permission:
eventforge.admin.finish
This is useful for testing rewards, history, leaderboards, and event finish behaviour.
/eventforge check <event>
Checks whether an event can start.
/eventforge check mining_rush
Permission:
eventforge.admin.check
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
Permission:
eventforge.admin.leaderboard
/eventforge points <player> <event> <amount>
Adds points to a player for an active event.
/eventforge points Steve mining_rush 10
Permission:
eventforge.admin.points
This is useful for testing:
objectives
milestones
scoreboards
PlaceholderAPI placeholders
Bukkit events
reward behaviour
/eventforge schedules
Shows scheduled events.
/eventforge schedules
Permission:
eventforge.admin.schedules
/eventforge history
Shows recent completed event history.
/eventforge history
Permission:
eventforge.admin.history
/eventforge templates
Lists available event templates.
/eventforge templates
Permission:
eventforge.admin.templates
/eventforge installtemplate <template>
Installs a template into the active events folder.
/eventforge installtemplate mining_rush
Permission:
eventforge.admin.templates
/eventforge installtemplate <template> confirm
Overwrites an existing installed event file with a bundled template.
/eventforge installtemplate mining_rush confirm
Permission:
eventforge.admin.templates
Use confirm when you intentionally want to replace the file in:
plugins/EventForge/events/
This can overwrite your edited event file. Back up your event first if you are unsure.
/eventforge iteminfo
Shows information about the item in your hand.
/eventforge iteminfo
Permission:
eventforge.admin.debug
This is useful when configuring collection, fishing, or custom item events.
/eventforge entityinfo
Shows information about the entity you are looking at.
/eventforge entityinfo
Permission:
eventforge.admin.debug
This is useful when configuring mob hunt or mob invasion events.
Player commands
/events
Opens the player events menu or shows event information.
/events
Permission:
eventforge.player
/events toggle
Toggles player event UI features.
/events toggle
Permission:
eventforge.player.toggle
This can be used for player-side event displays such as sidebars.
/events stats
Shows the player's EventForge stats.
/events stats
Permission:
eventforge.player.stats
/events join <event>
Teleports the player to an event join location, if that event supports one.
/events join mob_invasion
Permission:
eventforge.player.join
This is mainly useful for event types such as Mob Invasion where the event has a configured location.
An event must be active and must have a join location configured for this command to work.
Recommended permissions
Admin
Give this to trusted admins:
eventforge.admin
You can also give specific permissions if you want more control:
eventforge.admin.reload
eventforge.admin.validate
eventforge.admin.errors
eventforge.admin.list
eventforge.admin.active
eventforge.admin.start
eventforge.admin.stop
eventforge.admin.finish
eventforge.admin.check
eventforge.admin.leaderboard
eventforge.admin.points
eventforge.admin.schedules
eventforge.admin.history
eventforge.admin.templates
eventforge.admin.debug
Players
Give these to normal players:
eventforge.player
eventforge.player.toggle
eventforge.player.stats
eventforge.player.join
Example LuckPerms setup
Admin group:
/lp group admin permission set eventforge.admin true
Player group:
/lp group default permission set eventforge.player true
/lp group default permission set eventforge.player.toggle true
/lp group default permission set eventforge.player.stats true
/lp group default permission set eventforge.player.join true
Command aliases
EventForge provides:
/eventforge
/ef
Player command:
/events
Reload summary
When you run:
/eventforge reload
EventForge provides a clear summary.
Example:
Loaded events: 8 | Warnings: 0 | Errors: 0
In console, EventForge logs additional details:
Event load summary:
- Files scanned: 8
- Loaded events: 8
- Disabled files skipped: 0
- Failed files: 0
- Validation warnings: 0
- Validation errors: 0
- Scheduled events: 1
- Registered objectives: 8
If something is not working, check this summary first. It will usually tell you whether an event failed to load or whether a YAML file has validation warnings.
Summary
Use /eventforge or /ef for admin management.
Use /events for player-facing event features.
For most servers, give admins:
eventforge.admin
and players:
eventforge.player