Events

CocoEOTW includes special in-game events to make EOTW more exciting: First Kill and Bounty.

Event Types

First Kill Event

The First Kill event rewards the player who gets the first kill after the event is triggered.

Features:

• Configurable timeout
• Custom reward commands
• Automatic announcement

Start Event:

/eotw events start firstkill

Stop Event:

/eotw events stop firstkill

---

Bounty Event

The Bounty event marks a random player as a target. The player who kills the target gets rewards.

Features:

• Target player glows (configurable)
• Timeout system
• Custom rewards
• Automatic target selection

Start Event:

/eotw events start bounty

Stop Event:

/eotw events stop bounty

---

Configuration

settings:
  events:
    enabled: true  # Global enable/disable
    
    firstkill:
      enabled: true
      timeout: 200  # Seconds until event expires
      reward:
        - "[COMMAND] coin give %player% 300"
        - "[TITLE] &#08FB22First Blood!"
        - "[BROADCAST] &#FF0000%player% &fgot the first kill!"
    
    bounty:
      enabled: true
      glowing: true  # Target has glowing effect
      timeout: 200   # Seconds to kill the target
      reward:
        - "[COMMAND] coin give %player% 500"
        - "[TITLE] &#08FB22Bounty Claimed!"
        - "[BROADCAST] &#FF0000%player% &fkilled the bounty target!"

---

Event Management Commands

Enable/Disable Events Globally

/eotw events enabled <true|false>

Example:

/eotw events enabled false  # Disable all events
/eotw events enabled true   # Enable all events

Start Events

/eotw events start <firstkill|bounty>

Stop Events

/eotw events stop <firstkill|bounty>

---

Reward Actions

You can use the following actions in reward commands:

Action	Description	Example
[COMMAND]	Execute console command	[COMMAND] give %player% diamond 1
[TITLE]	Show title to winner	[TITLE] &#08FB22You won!
[SUBTITLE]	Show subtitle	[SUBTITLE] &f+500 coins
[BROADCAST]	Broadcast to server	[BROADCAST] %player% won the bounty!
[EFFECT]	Give effect	[EFFECT] speed;60;1

---

Placeholders

Placeholder	Description
%player%	Winner's name
%target%	Bounty target's name
%timeout%	Event timeout in seconds

---

Event Flow

First Kill Event

1. Admin starts event: /eotw events start firstkill
        ↓
2. Broadcast announces event start
        ↓
3. First player to kill another wins
        ↓
4. Rewards are given, event ends

Bounty Event

1. Admin starts event: /eotw events start bounty
        ↓
2. Random alive player selected as target
        ↓
3. Target glows for visibility
        ↓
4. Player who kills target gets rewards
        ↓
5. Event ends (or times out)

---

Messages

Configure event messages in messages_en.yml:

messages:
  commands:
    events:
      triggered: "%prefix% &#FF0000The {event} event has been triggered."
      no_valid_player: "%prefix% &#FF0000No valid player found for the {event} event."
      
      start:
        bounty_started: "%prefix% &#08FB22Bounty event started!"
        firstkill_started: "%prefix% &#08FB22FirstKill event started!"
        bounty_broadcast: "%prefix% &#08FB22{target} must be killed within {timeout} seconds!"
        firstkill_broadcast: "%prefix% &#08FB22Whoever gets the first kill wins!"
      
      stop:
        bounty_stopped: "%prefix% &#08FB22Bounty event stopped."
        firstkill_stopped: "%prefix% &#08FB22FirstKill event stopped."
      
      bounty_expired: "%prefix% &#FF0000Bounty expired! {target} was not killed in time."