⛏️ Mining Rush

Mining Rush is a built-in EventForge objective where players earn points by mining configured blocks.

info

Custom items require the relevant plugin to be installed on the server, such as ItemsAdder, Oraxen, Nexo, or MMOItems.

Objective type

Mining Rush uses:

type: MINE_BLOCKS

In v1.0.1, the recommended format is the new objectives: section:

objectives:
  ores:
    type: MINE_BLOCKS

The older single-objective format still works:

objective:
  type: MINE_BLOCKS

tip

Use objectives: for new events. It supports single-objective and multi-objective events.

Basic example

id: mining_rush
enabled: true
display-name: "{var:event_color}Mining Rush"
duration: 10m

variables:
  event_color: "&6"
  arena_name: "Main World"

objectives:
  ores:
    type: MINE_BLOCKS
    display-name: "Ores"
    display-items:
      - "Coal Ore"
      - "Iron Ore"
      - "Gold Ore"
      - "Diamond Ore"
      - "Emerald Ore"
    weight: 1.0

    require-natural-blocks: true

    blocks:
      COAL_ORE: 1
      IRON_ORE: 2
      GOLD_ORE: 4
      DIAMOND_ORE: 10
      EMERALD_ORE: 12

Blocks

The blocks: section controls which blocks give points.

blocks:
  COAL_ORE: 1
  IRON_ORE: 2
  GOLD_ORE: 4
  DIAMOND_ORE: 10

This means:

COAL_ORE gives 1 point
IRON_ORE gives 2 points
GOLD_ORE gives 4 points
DIAMOND_ORE gives 10 points

Detailed block format

You can also use a more detailed format if you want readable names.

blocks:
  COAL_ORE:
    points: 1
    display-name: "Coal Ore"

  DIAMOND_ORE:
    points: 10
    display-name: "Diamond Ore"

Both styles are useful.

For simple templates, this is clean:

DIAMOND_ORE: 10

For clearer public configs, this is more readable:

DIAMOND_ORE:
  points: 10
  display-name: "Diamond Ore"

Natural block checking

Mining events can require natural blocks.

require-natural-blocks: true

When enabled, players should only score from blocks that were naturally present or tracked as valid by EventForge.

tip

This helps stop players from placing and breaking the same blocks repeatedly for points.

If you are making a prison mine event or controlled event area where blocks are regenerated by another plugin, test this setting carefully.

Material names

Block names should use valid Bukkit/Paper material names.

Common examples:

STONE
COAL_ORE
DEEPSLATE_COAL_ORE
COPPER_ORE
IRON_ORE
GOLD_ORE
REDSTONE_ORE
LAPIS_ORE
DIAMOND_ORE
EMERALD_ORE
ANCIENT_DEBRIS

tip

Use /eventforge iteminfo while holding an item/block to help identify material information.

Objective weight

Each objective can have a weight.

weight: 1.0

This acts like a score multiplier for that objective.

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

info

Use Multiplier: x... in player-facing text. weight is the config/API term.

Using variables

Mining Rush supports EventForge variables anywhere normal event text is parsed.

variables:
  event_color: "&6"
  arena_name: "Main World"
  reward_name: "Mining Supplies"

Example usage:

display-name: "{var:event_color}Mining Rush"

messages:
  start:
    - "{var:event_color}&lMining Rush has started!"
    - "&eMine natural ores in &f{var:arena_name} &eto earn points."

Actions and triggers

You can use triggers to make the event feel more responsive.

triggers:
  player-score:
    actions:
      - type: ACTIONBAR
        message: "{var:event_color}+{score_change} points &8| &f{score} total"

This shows an actionbar whenever a player scores.

Cooldown

A cooldown stops the event from being started again too quickly.

cooldown:
  enabled: true
  duration: 30m

Cooldowns start when the event finishes naturally.

Full event example

id: mining_rush
enabled: true
display-name: "{var:event_color}Mining Rush"
duration: 10m

metadata:
  category: "Mining"
  tags:
    - mining
    - survival
    - economy
  difficulty: "Easy"
  author: "HxZe"
  version: "1.0.1"
  description:
    - "Mine configured blocks to earn points."

variables:
  event_color: "&6"
  arena_name: "Main World"
  reward_name: "Mining 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:
  ores:
    type: MINE_BLOCKS
    display-name: "Ores"
    display-items:
      - "Coal Ore"
      - "Iron Ore"
      - "Gold Ore"
      - "Diamond Ore"
      - "Emerald Ore"
    weight: 1.0

    require-natural-blocks: true

    blocks:
      COAL_ORE: 1
      DEEPSLATE_COAL_ORE: 1
      COPPER_ORE: 1
      DEEPSLATE_COPPER_ORE: 1
      IRON_ORE: 2
      DEEPSLATE_IRON_ORE: 2
      REDSTONE_ORE: 3
      DEEPSLATE_REDSTONE_ORE: 3
      LAPIS_ORE: 3
      DEEPSLATE_LAPIS_ORE: 3
      GOLD_ORE: 4
      DEEPSLATE_GOLD_ORE: 4
      DIAMOND_ORE: 10
      DEEPSLATE_DIAMOND_ORE: 10
      EMERALD_ORE: 12
      DEEPSLATE_EMERALD_ORE: 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}Mining Rush &8| &f{time_left} &8| &eScore: {score} &8| &7Rank: #{rank}"
  color: YELLOW
  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}&lMining Rush Results"
  line: "&e#{position} &f{player} &8- &a{score} points"
  footer:
    - ""

messages:
  start:
    - "{var:event_color}&lMining Rush has started!"
    - "&eMine natural ores in &f{var:arena_name} &eto earn points."

  end:
    - "{var:event_color}&lMining Rush has ended!"
    - "&eRewards have been processed."

announcements:
  start-title:
    enabled: true
    title: "{var:event_color}&l{event_display} Started!"
    subtitle: "&eMine: &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_ingot 4"
      - "say {player} earned {var:reward_name}."

    chance-rewards:
      bonus_diamond:
        chance: 5.0
        commands:
          - "give {player} diamond 1"

  leaderboard:
    1:
      commands:
        - "give {player} diamond 3"
    2:
      commands:
        - "give {player} diamond 2"
    3:
      commands:
        - "give {player} diamond 1"

Troubleshooting

Blocks do not give points

Check:

The event is active
The material name is correct
The block is listed under blocks
The point value is greater than 0
The world condition allows the player world

Players can farm placed blocks

Enable:

require-natural-blocks: true

Then test your server setup.

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