🧺 Collection Rush
Collection Rush is a built-in EventForge objective where players earn points by collecting configured items.
Custom items require the relevant plugin to be installed on the server, such as ItemsAdder, Oraxen, Nexo, or MMOItems.
Objective type
Collection Rush uses:
type: COLLECT_ITEMS
Recommended v1.0.1 format:
objectives:
resources:
type: COLLECT_ITEMS
The old single-objective format still works:
objective:
type: COLLECT_ITEMS
Use the new objectives: format for new events. It works for both single-objective and multi-objective events.
Basic example
id: collection_rush
enabled: true
display-name: "{var:event_color}Collection Rush"
duration: 10m
variables:
event_color: "&a"
arena_name: "Main World"
objectives:
resources:
type: COLLECT_ITEMS
display-name: "Resources"
display-items:
- "Wheat"
- "Carrot"
- "Potato"
- "Iron Ingot"
- "Diamond"
weight: 1.0
items:
WHEAT: 1
CARROT: 1
POTATO: 1
IRON_INGOT: 3
DIAMOND: 10
Items
The items: section controls which collected items give points.
items:
WHEAT: 1
CARROT: 1
IRON_INGOT: 3
DIAMOND: 10
This means:
WHEAT gives 1 point
CARROT gives 1 point
IRON_INGOT gives 3 points
DIAMOND gives 10 points
Detailed item format
You can also use a more detailed item format.
items:
WHEAT:
points: 1
display-name: "Wheat"
DIAMOND:
points: 10
display-name: "Diamond"
Use this if you want clearer display names in menus, sidebars, or event details.
Material names
Items should use valid Bukkit/Paper material names.
Common examples:
WHEAT
CARROT
POTATO
BEETROOT
SUGAR_CANE
IRON_INGOT
GOLD_INGOT
DIAMOND
EMERALD
NETHERITE_SCRAP
Use /eventforge iteminfo while holding an item to help identify material information.
Objective weight
Each objective can have a weight.
weight: 1.0
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 |
Use Multiplier: x... in player-facing text. weight is the config/API term.
Using variables
Variables are useful when the same colour, arena name, or reward name is used in multiple sections.
variables:
event_color: "&a"
arena_name: "Main World"
reward_name: "Collection Supplies"
Example:
messages:
start:
- "{var:event_color}&lCollection Rush has started!"
- "&eCollect resources in &f{var:arena_name} &eto earn points."
Actions and triggers
Collection Rush works well with player score triggers.
triggers:
player-score:
actions:
- type: ACTIONBAR
message: "{var:event_color}+{score_change} points &8| &f{score} total"
You can also play a sound whenever a player scores:
triggers:
player-score:
actions:
- type: SOUND
sound: ENTITY_EXPERIENCE_ORB_PICKUP
volume: 1.0
pitch: 1.2
Cooldown
A cooldown stops the event from being started again too quickly.
cooldown:
enabled: true
duration: 30m
Cooldowns start after the event finishes naturally.
Full event example
id: collection_rush
enabled: true
display-name: "{var:event_color}Collection Rush"
duration: 10m
metadata:
category: "Collection"
tags:
- collection
- farming
- survival
- economy
difficulty: "Easy"
author: "HxZe"
version: "1.0.1"
description:
- "Collect configured items to earn points."
variables:
event_color: "&a"
arena_name: "Main World"
reward_name: "Collection 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:
resources:
type: COLLECT_ITEMS
display-name: "Resources"
display-items:
- "Wheat"
- "Carrot"
- "Potato"
- "Iron Ingot"
- "Diamond"
weight: 1.0
items:
WHEAT: 1
CARROT: 1
POTATO: 1
BEETROOT: 1
SUGAR_CANE: 2
IRON_INGOT: 3
GOLD_INGOT: 4
DIAMOND: 10
EMERALD: 12
triggers:
player-score:
actions:
- type: ACTIONBAR
message: "{var:event_color}+{score_change} points &8| &f{score} total"
bossbar:
enabled: true
text: "{var:event_color}Collection Rush &8| &f{time_left} &8| &eScore: {score} &8| &7Rank: #{rank}"
color: GREEN
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}&lCollection Rush Results"
line: "&e#{position} &f{player} &8- &a{score} points"
footer:
- ""
messages:
start:
- "{var:event_color}&lCollection Rush has started!"
- "&eCollect resources in &f{var:arena_name} &eto earn points."
end:
- "{var:event_color}&lCollection Rush has ended!"
- "&eRewards have been processed."
announcements:
start-title:
enabled: true
title: "{var:event_color}&l{event_display} Started!"
subtitle: "&eCollect: &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} bread 8"
- "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
Items do not give points
Check:
The event is active
The material name is correct
The item is listed under items
The point value is greater than 0
The player is collecting the configured item
Custom items do not score
Check:
The custom item plugin is installed
The provider is supported
The custom item ID is correct
The event file uses the correct custom item section
Scores are higher than expected
Check the objective weight.
weight: 2.0
That means the objective scores at Multiplier: x2.
The event does not start
Check:
minimum players
cooldown
conditions
event ID
console validation warnings