🗺️ Visit Regions

VISIT_REGIONS is an exploration objective.

Players earn points by entering configured regions.

It works well for:

exploration hunts
spawn tours
checkpoint events
landmark discovery
easter egg hunts
tutorial routes

---

Basic example

objective:
  type: VISIT_REGIONS
  regions:
    spawn_fountain:
      display-name: "&bSpawn Fountain"
      world: world
      x1: 10
      y1: 64
      z1: 10
      x2: 20
      y2: 72
      z2: 20
      points: 5
      once-per-player: true

When a player enters the region, they earn 5 points.

---

Region settings

Setting	Description
display-name	Name shown in messages/placeholders
world	World name
x1, y1, z1	First corner
x2, y2, z2	Second corner
points	Points awarded
once-per-player	Whether each player can score from this region once
cooldown	Optional cooldown before the player can score again

---

Multiple regions

objective:
  type: VISIT_REGIONS
  regions:
    spawn_fountain:
      display-name: "&bSpawn Fountain"
      world: world
      x1: 10
      y1: 64
      z1: 10
      x2: 20
      y2: 72
      z2: 20
      points: 5
      once-per-player: true

    market:
      display-name: "&eMarket"
      world: world
      x1: 30
      y1: 64
      z1: 30
      x2: 45
      y2: 72
      z2: 45
      points: 5
      once-per-player: true

---

Cooldowns

Use cooldowns when a region should be reusable.

objective:
  type: VISIT_REGIONS
  regions:
    checkpoint:
      display-name: "&aCheckpoint"
      world: world
      x1: 0
      y1: 64
      z1: 0
      x2: 8
      y2: 70
      z2: 8
      points: 2
      once-per-player: false
      cooldown: 30s

In this example, a player can score again after 30 seconds.

---

Region messages

You can send feedback when a player discovers a region.

objective:
  type: VISIT_REGIONS
  regions:
    spawn_fountain:
      display-name: "&bSpawn Fountain"
      world: world
      x1: 10
      y1: 64
      z1: 10
      x2: 20
      y2: 72
      z2: 20
      points: 5
      once-per-player: true
      message: "&aYou discovered &f{region_display}&a!"
      actionbar: "&e+{score_change} points &8| &7Total: &f{new_score}"

---

Region actions

Regions can also run actions.

objective:
  type: VISIT_REGIONS
  regions:
    market:
      display-name: "&eMarket"
      world: world
      x1: 30
      y1: 64
      z1: 30
      x2: 45
      y2: 72
      z2: 45
      points: 5
      once-per-player: true
      actions:
        - type: SOUND
          sound: ENTITY_PLAYER_LEVELUP
          volume: 1.0
          pitch: 1.2

---

Placeholders

Visit region messages and actions can use normal EventForge placeholders and region placeholders.

{region}
{region_display}
{score_change}
{new_score}
{score}
{player}
{event_display}

Example:

message: "&aYou visited &f{region_display}&a! &7(+{score_change})"

---

Milestone example

milestones:
  enabled: true
  thresholds:
    10:
      display-name: "&e10 Exploration Points"
      once-per-player: true
      actions:
        - type: MESSAGE
          message: "&aYou reached &f{milestone_display}&a!"
        - type: SOUND
          sound: ENTITY_PLAYER_LEVELUP

---

Testing

After adding the event file:

/eventforge reload
/eventforge validate exploration_hunt
/eventforge start exploration_hunt

Walk into one of the configured regions.

If scoring does not work, check:

/eventforge errors exploration_hunt

---

Summary

VISIT_REGIONS is used for exploration events.

Use it when players should score by discovering locations or reaching checkpoints.