🧟 Mob Hunt
Mob Hunt is a built-in EventForge objective where players earn points by killing configured mobs.
info
Custom mobs require the relevant plugin to be installed on the server, such as MythicMobs.
Objective type
Mob Hunt uses:
type: KILL_MOBS
Recommended v1.0.1 format:
objectives:
hostile_mobs:
type: KILL_MOBS
The old single-objective format still works:
objective:
type: KILL_MOBS
Basic example
id: mob_hunt
enabled: true
display-name: "{var:event_color}Mob Hunt"
duration: 10m
variables:
event_color: "&c"
arena_name: "Main World"
objectives:
hostile_mobs:
type: KILL_MOBS
display-name: "Hostile Mobs"
display-items:
- "Zombie"
- "Skeleton"
- "Creeper"
- "Spider"
- "Enderman"
- "Witch"
weight: 1.0
mobs:
ZOMBIE: 1
SKELETON: 1
SPIDER: 1
CREEPER: 2
WITCH: 4
ENDERMAN: 5
Mobs
The mobs: section controls which mobs give points.
mobs:
ZOMBIE: 1
SKELETON: 1
CREEPER: 2
ENDERMAN: 5
This means:
ZOMBIE gives 1 point
SKELETON gives 1 point
CREEPER gives 2 points
ENDERMAN gives 5 points
Detailed mob format
You can also use a more detailed format.
mobs:
ZOMBIE:
points: 1
display-name: "Zombie"
ENDERMAN:
points: 5
display-name: "Enderman"
Use this if you want cleaner display names in menus and event details.
Entity names
Mob names should use valid Bukkit/Paper entity type names.
Common examples:
ZOMBIE
SKELETON
CREEPER
SPIDER
ENDERMAN
WITCH
BLAZE
WITHER_SKELETON
PILLAGER
VINDICATOR
RAVAGER
tip
Use /eventforge entityinfo to help identify entity information while configuring events.
Objective weight
Each objective can have a weight.
weight: 1.5
This works like a score multiplier.
Examples:
| Weight | Player-facing wording | Meaning |
|---|---|---|
1.0 | Multiplier: x1 | Normal score |
1.5 | Multiplier: x1.5 | 50% more score |
2.0 | Multiplier: x2 | Double score |
For example, if a ZOMBIE gives 2 points and the objective has:
weight: 1.5
the final score added is 3.
Using variables
Variables help keep event text easier to edit.
variables:
event_color: "&c"
arena_name: "Main World"
reward_name: "Combat Supplies"
Example:
messages:
start:
- "{var:event_color}&lMob Hunt has started!"
- "&eKill mobs in &f{var:arena_name} &eto earn points."
Actions and triggers
A common Mob Hunt trigger is an actionbar when players score.
triggers:
player-score:
actions:
- type: ACTIONBAR
message: "{var:event_color}+{score_change} points &8| &f{score} total"
You can also use sounds:
triggers:
player-score:
actions:
- type: SOUND
sound: ENTITY_EXPERIENCE_ORB_PICKUP
volume: 1.0
pitch: 1.2
Cooldown
cooldown:
enabled: true
duration: 30m
This stops the event from being started again until the cooldown is over.
Full event example
id: mob_hunt
enabled: true
display-name: "{var:event_color}Mob Hunt"
duration: 10m
metadata:
category: "Mobs"
tags:
- mobs
- survival
- hunt
difficulty: "Easy"
author: "HxZe"
version: "1.0.1"
description:
- "Hunt configured mobs to earn points."
variables:
event_color: "&c"
arena_name: "Main World"
reward_name: "Combat Supplies"
schedule:
enabled: false
type: INTERVAL
every: 1h
announce-before:
- 5m
- 1m
- 30s
cooldown:
enabled: false
duration: 30m
conditions:
minimum-players: 1
worlds:
- world
permissions: []
blocked-permissions: []
require-op: false
require-non-op: false
time:
enabled: false
min: 0
max: 23999
weather:
allowed: []
objectives:
hostile_mobs:
type: KILL_MOBS
display-name: "Hostile Mobs"
display-items:
- "Zombie"
- "Skeleton"
- "Creeper"
- "Spider"
- "Enderman"
- "Witch"
weight: 1.0
mobs:
ZOMBIE: 1
SKELETON: 1
SPIDER: 1
CREEPER: 2
WITCH: 4
ENDERMAN: 5
triggers:
player-score:
actions:
- type: ACTIONBAR
message: "{var:event_color}+{score_change} points &8| &f{score} total"
bossbar:
enabled: true
text: "{var:event_color}Mob Hunt &8| &f{time_left} &8| &eScore: {score} &8| &7Rank: #{rank}"
color: RED
style: SOLID
sidebar:
enabled: true
title: "{var:event_color}&l{event_display}"
max-objective-lines: 8
lines:
- "{var:event_color}Objectives:"
- "{objective_lines}"
- ""
- "&7/events toggle"
leaderboard:
announce-results: true
max-shown: 3
no-participants-message: "&7No players scored during this event."
header:
- ""
- "{var:event_color}&lMob Hunt Results"
line: "&e#{position} &f{player} &8- &a{score} points"
footer:
- ""
messages:
start:
- "{var:event_color}&lMob Hunt has started!"
- "&eKill mobs in &f{var:arena_name} &eto earn points."
end:
- "{var:event_color}&lMob Hunt has ended!"
- "&eRewards have been processed."
announcements:
start-title:
enabled: true
title: "{var:event_color}&l{event_display} Started!"
subtitle: "&eKill: &f{objective_items}"
fade-in: 10
stay: 60
fade-out: 20
end-title:
enabled: true
title: "{var:event_color}&l{event_display} Ended!"
subtitle: "&eYou placed &f#{rank} &ewith &f{score} &epoints"
subtitle-no-score: "&7You did not participate."
fade-in: 10
stay: 80
fade-out: 20
rewards:
participation:
enabled: true
minimum-score: 1
commands:
- "give {player} iron_sword 1"
- "say {player} earned {var:reward_name}."
chance-rewards:
bonus_emerald:
chance: 5.0
commands:
- "give {player} emerald 1"
leaderboard:
1:
commands:
- "give {player} diamond 3"
2:
commands:
- "give {player} diamond 2"
3:
commands:
- "give {player} diamond 1"
Troubleshooting
Mobs do not give points
Check:
The event is active
The entity name is correct
The mob is listed under mobs
The point value is greater than 0
The player is the killer
Custom mobs do not work
Check:
The custom mob plugin is installed
The provider is supported
The mob ID is correct
The event file is using the correct custom mob section
Scores are higher than expected
Check the objective weight.
weight: 1.5
This means the objective scores at Multiplier: x1.5.
The event does not start
Check:
minimum players
cooldown
conditions
event ID
console validation warnings