# Placeholders

This page lists all placeholders available in EventController, organized by category. The PlaceholderAPI identifier is eventcontroller.

# PlaceholderAPI (external)

Use these in any PlaceholderAPI-compatible plugin:

# Team

  • %eventcontroller_team_name% — Player's team name
  • %eventcontroller_team_prefix% — Player's team formatted prefix
  • %eventcontroller_team_color% — Player's team color
  • %eventcontroller_team_color_code% — Team color code (e.g., &c)
  • %eventcontroller_team_member_count% — Team member count
  • %eventcontroller_team_number% — Team number
  • %eventcontroller_team_display_name% — Team display name
  • %eventcontroller_team_has_team% — Player has a team (true/false)

# KOTH (per zone)

Use the zone name in place of <zone>:

  • %eventcontroller_koth_<zone>_progress% — 0-100
  • %eventcontroller_koth_<zone>_progress_bar%
  • %eventcontroller_koth_<zone>_progress_percent%
  • %eventcontroller_koth_<zone>_active% — true/false
  • %eventcontroller_koth_<zone>_being_captured% — true/false
  • %eventcontroller_koth_<zone>_completed% — true/false
  • %eventcontroller_koth_<zone>_contested% — true/false
  • %eventcontroller_koth_<zone>_capturer_team%
  • %eventcontroller_koth_<zone>_winner_team%
  • %eventcontroller_koth_<zone>_contesting_team%
  • %eventcontroller_koth_<zone>_capture_time% — seconds
  • %eventcontroller_koth_<zone>_time_remaining% — seconds
  • %eventcontroller_koth_<zone>_radius%
  • %eventcontroller_koth_<zone>_center_x%
  • %eventcontroller_koth_<zone>_center_y%
  • %eventcontroller_koth_<zone>_center_z%
  • %eventcontroller_koth_<zone>_world%
  • %eventcontroller_koth_<zone>_status%
  • %eventcontroller_koth_<zone>_status_color% — color code

# Events

  • %eventcontroller_event_active_events%
  • %eventcontroller_event_thunder_death% — true/false
  • %eventcontroller_event_spec_death% — true/false
  • %eventcontroller_event_death_ban% — true/false
  • %eventcontroller_event_nether_disabled% — true/false
  • %eventcontroller_event_end_disabled% — true/false
  • %eventcontroller_event_freeze_enabled% — true/false
  • %eventcontroller_event_player_death_count%
  • %eventcontroller_event_player_death_banned% — true/false

# Player

  • %eventcontroller_player_in_koth_zone% — true/false
  • %eventcontroller_player_koth_zone_name%
  • %eventcontroller_player_death_count%
  • %eventcontroller_player_is_death_banned% — true/false

# Internal placeholders (plugin messages/config)

These are used inside EventController messages and configs.

# Message placeholders (%var%)

  • %player%, %duration%, %time%, %count%, %events%, %enabled%, %status%, %location%
  • Pedestals: %id%, %location%, %recipe%, %output%, %limit%, %cooldown%, %seconds%, %min%
  • Cornucopia: %location%, %count%, %min%, %seconds%

# Command placeholders ({var})

  • KOTH: {player}, {team}, {zone}, {world}, {x}, {y}, {z}
  • Combat: {time}, {player}
  • Teams: {team}
  • Message Templates module: {player}, {player-uuid}, {player-world}, {player-x}, {player-y}, {player-z}, {server-online}, {server-max}, {server-time}, {variable_name}

# Examples

%eventcontroller_team_name% -> "Team Red"
%eventcontroller_koth_arena_progress% -> "75"
%eventcontroller_event_active_events% -> "3"
%eventcontroller_player_in_koth_zone% -> "true"
# messages.yml
death-ban-kick: "&cYou have been death banned for %duration% seconds!"