🏆 Cores Minigame

An ultra-configurable, high-performance Cores minigame plugin. Bring the classic, fast-paced tactical PvP experience to your network or community server with modular arena setups, automated rollbacks, and full PlaceholderAPI support!

---

🎮Game Mechanics

Players are split into two teams: Team Red and Team Blue.

• The Cores: Each team has 2 cores (beacon blocks). The primary objective is to mine the opposing team's cores!
• Defense & Alarm: Whenever an opponent approaches a core (within a 4-5 block radius), an unmistakable audible alarm sounds for the defending team.
• Respawns & Loot: Players can respawn indefinitely; however, upon death, they lose their temporary equipment and immediately receive their configurable default kit. Valuable iron and diamond blocks are scattered across the map for upgrades.
• Victory Conditions: The game ends immediately if both of a team's cores are destroyed or the time limit expires. The team that still possesses at least one core wins.

---

✨ Features

• 🛠️ 100% Configurable: Every message, sound, item layout, and GUI element can be customized in the config files.
• 🏟️ Multi-Arena System: Create an unlimited number of arenas using simple in-game admin commands.
• 🔄 Automatic Map Reset: After every game, the arena is completely restored to its original state (block rollback, chest refill).
• 🛡️ Spawn Protection: A configurable protection radius (default: 15 blocks) around team spawns prevents the map from being mined in this area.
• 📦 Modern GUIs (Spectator & Join System):
  • Quickly join the most active arena.
  • Dynamic arena overview: Displays name, status (Waiting, Playing, Ending), and player count. Ongoing games are automatically moved to the end of the list and marked as accessible to spectators.
• 📊 Integrated Statistics (Stats): Tracks Games Played, Wins, and Losses per player.
• 📢 Isolated Chat & Tab List: Each arena has its own chat and tab list. Spectators have a separate, private chat. Teams are color-coded throughout!
• 🚀 PlaceholderAPI Support: Uses external placeholders in all configurations and provides custom placeholders for player stats and arena states.
• 💎 Cosmetic Particles: Exclusive particle effects for players with special permissions.
• 💰 Reward System: Execute custom console commands at the end of the game (e.g., awarding coins via your economy system for wins and kills).
• 👑 Rank support: Display the prefix or suffix of your players' ranks in every plugin message using PlaceholderAPI.

---

📋 Commands & Permissions

All commands run through the main /cores command.

👥 Player commands

• /cores join - Opens the join gui.
• /cores leave - Leaves the game.
• /cores stats - Shows the player stats in chat.

⚡ VIP / Premium commands

• /cores start - Shortens the countdown in the waiting lobby to 5 seconds. (cores.command.start).
• /cores forcestart - Start the game immediately in the waiting lobby. (cores.command.forcestart).

🛠️ Admin commands (cores.admin)

• /cores setlobby - Sets the main lobby for the game.
• /cores createarena <name> - Creates an arena.
• /cores deletearena <name> - Deletes an arena.
• /cores setwaiting <arena> - Sets the spawn on the waiting lobby.
• /cores setspectator <arena> - Sets the spectator spawn.
• /cores setspawn <arena> <red/blue> - Sets the team spawnpoint.
• /cores setcore <arena> <red/blue> <1/2> - Sets a beacon at the position standing on.
• /cores setmaxplayers <arena> <maxProTeam> - Defines maximum players per team.
• /cores setminplayers <arena> <minProTeam> - Defines minimum players per team to start game.
• /cores setmaxtime <arena> <seconds> - Sets max playtime.
• /cores enable <arena> - Enables arena.
• /cores disable <arena> - Disables arena.
• /cores info <arena> - Shows info about given arena in chat.
• /cores reload - Reloads the plugin.

---

🧩 Placeholders (PlaceholderAPI)

• %cores_stats_games_played% - Number of played games.
• %cores_stats_wins% - Number of won games.
• %cores_stats_losses% - Number of lost games.
• %cores_in_arena% - Is player in arena (true | false).
• %cores_arena_name% - Name of arena.
• %cores_arena_state% - State of arena.
• %cores_arena_players% - Current players in arena.
• %cores_arena_max_players% - Max players of arena.
• %cores_arena_time_left% - Playtime left in arena.
• %cores_arena_red_players% - Count of players in red team.
• %cores_arena_blue_players% - Count of players in blue team.
• %cores_player_kills% - Kill count.
• %cores_player_cores_destroyed% - Cores destroyed count.
• %cores_player_team% - Name if team.
• %cores_player_team_color% - Color of team.
• %cores_player_spectator% - Is spectator (true | false).
• %cores_arena_<arena>_state% - Status of specified arena.
• %cores_arena_<arena>_players% - Playercount of specified arena.
• %cores_arena_<arena>_max_players% - Max players of specified arena.
• %cores_arena_<arena>_name% - Clean name of specified arena.

📃Config

# Cores Plugin - Main Configuration
# You can use PlaceholderAPI placeholders in most messages.

# General settings
lobby-location: null  # Set via /cores setlobby

prefix-placeholder: "%luckperms_prefix%"
suffix-placeholder: "%luckperms_suffix%"

# Default kit items given to every player on spawn (format: MATERIAL:AMOUNT:DAMAGE or MATERIAL:AMOUNT)
default-kit:
  - "STONE_SWORD:1"
  - "BOW:1"
  - "OAK_LOG:64"
  - "ARROW:16"
  - "GOLDEN_APPLE:16"
  - "BREAD:32"
  - "IRON_AXE:1"
  - "IRON_PICKAXE:1"

# Commands executed at game end. Placeholders: {winner_player}, {loser_player}, {kills}
# Use {winners} for all winners, {losers} for all losers
end-commands:
  per-winner:
    - "eco give {player} 100"
  per-kill:
    - "eco give {player} 10"

# Spectator settings
spectator-fly: true

# Particle cosmetic settings, permission: cores.cosmetic.particles
cosmetic-particle: FLAME
cosmetic-particle-radius: 1.0

# Alarm sound when core is attacked
core-alarm:
  enabled: true
  sound: "BLOCK_NOTE_BLOCK_PLING"
  volume: 1.0
  pitch: 0.5

core-mining-fatigue:
  amplifier: 0   # 0 = Fatigue I, 1 = II, 2 = III

# Spawn protection – enemies cannot enter this radius around the team spawns during a game.
# Block-breaking protection uses a separate radius (15 blocks, hardcoded above).
spawn-protection-radius: 10.0

# How many blocks around the two team-spawns to scan for chests when /cores enable runs.
# Increase if your map extends further than 200 blocks from the spawns.
chest-scan-padding: 200


# Messages (supports color codes with & and PlaceholderAPI)
messages:
  prefix: "&8[&6Cores&8] &r"
  no-permission: "&cYou don't have permission to do this."
  player-only: "&cThis command can only be used by players."
  chat-format: "{team}{prefix} {player}: &r{message}"
  arena-not-found: "&cArena '{arena}' not found."
  arena-already-exists: "&cAn arena with the name '{arena}' already exists."
  arena-created: "&aArena '{arena}' created successfully."
  arena-deleted: "&aArena '{arena}' deleted."
  arena-enabled: "&aArena '{arena}' has been enabled."
  arena-disabled: "&cArena '{arena}' has been disabled."
  lobby-set: "&aLobby location set."
  spawn-set: "&aSpawn for team {team} in arena '{arena}' set."
  waiting-spawn-set: "&aWaiting lobby spawn for arena '{arena}' set."
  spectator-spawn-set: "&aSpectator spawn for arena '{arena}' set."
  core-set: "&aCore for team {team} in arena '{arena}' set at your location."
  max-players-set: "&aMax players per team for arena '{arena}' set to {amount}."
  min-players-set: "&aMin players per team for arena '{arena}' set to {amount}."
  max-time-set: "&aMax game time for arena '{arena}' set to {seconds} seconds."
  join-arena: "{suffix}{player} &ejoined the game."
  leave-arena: "{suffix}{player} &eleft the game."
  not-in-arena: "&cYou are not in an arena."
  already-in-arena: "&cYou are already in an arena."
  arena-full: "&cThis arena is full."
  arena-not-enabled: "&cThis arena is not enabled or not set up yet."
  game-started: "&aThe game has started!"
  game-ended-winner: "&6Game Over! Team {team} has won!"
  game-ended-time: "&6Game Over! Time ran out! Team {team} wins!"
  game-ended-draw: "&6Game Over! It's a draw!"
  countdown-start: "&eThe game starts in &6{seconds} &eseconds!"
  countdown-waiting: "&eWaiting for more players... &7({current}/{min} per team)"
  countdown-waiting-scoreboard: "&eWaiting for players"
  player-killed: "{victimTeamColor}{victim} &7was killed by {killerTeamColor}{killer}&7." # Avaliable Placeholders: {victim}, {killer}, {victimTeamColor}, {killerTeamColor}, {victimPrefix}, {victimSuffix}, {killerPrefix}, {killerSuffix}
  team-joined: "&aYou joined team &r{team}&a."
  team-full: "&cThis team is already full. Teams must stay balanced."
  enemy-spawn-enter: "&cYou can`t enter an enemys spawn!"
  core-under-attack: "&c⚠ Your core is under attack!"
  core-destroyed: "&4☠ A core of team {team} has been destroyed!"
  core-destroyed-subtitle: "&rwas destroyed by {player}&r!"
  core-destroyed-enemy: "&aYou destroyed a core of team {team}!"
  spectator-join: "&7You are now spectating arena '{arena}'."
  game-already-started-spectator: "&7The game already started. You joined as spectator."
  start-countdown-set: "&aCountdown set to 5 seconds."
  forcestart: "&aForce starting the game..."
  not-enough-players: "&cNot enough players to start the game."
  invalid-usage: "&cUsage: {usage}"
  stats-header: "&6=== Your Cores Stats ==="
  stats-games-played: "&7Games Played: &f{value}"
  stats-wins: "&7Wins: &a{value}"
  stats-losses: "&7Losses: &c{value}"
  end-summary-header: "&6&l=== Game Summary ==="
  end-summary-winner: "&aWinner: Team {team}"
  end-summary-top-cores: "&7Top Core Destroyers:"
  end-summary-top-kills: "&7Top Killers:"
  end-summary-entry: "&7{rank}. {prefix} {player}&7: &e{value}"
  teleport-lobby-in: "&7Teleporting to lobby in &f{seconds} &7seconds..."
  leave-item-name: "&c&lLeave Game"
  leave-item-lore: "&7Click to leave the arena"
  team-selector-name: "&6&lTeam Selector"
  team-selector-lore: "&7Click to choose your team"
  team-red-name: "&c&lTeam Red"
  team-blue-name: "&9&lTeam Blue"
  team-red-lore: "&7Players: &f{current}/{max}"
  team-blue-lore: "&7Players: &f{current}/{max}"

# Scoreboard settings
scoreboard:
  waiting-title: "&6&lCores"
  waiting-lines:
    - "&7&m-----------"
    - "&fArena: &6{arena_name}"
    - ""
    - "&fPlayers: &e{player_count}&7/&e{max_players}"
    - ""
    - "&fCountdown:"
    - " &e{countdown}"
    - "&7&m-----------"
  game-title: "&6&lCores"
  game-lines:
    - "&7&m-----------"
    - "&fArena: &6{arena_name}"
    - ""
    - "&cTeam Red:"
    - " {red_core_1} &rLeft Core"
    - " {red_core_2} &rRight Core"
    - ""
    - "&1Team Blue:"
    - " {blue_core_1} &rLeft Core"
    - " {blue_core_2} &rLeft Core"
    - ""
    - "&fPlayers alive: &e{alive_count}"
    - "&fYour kills: &e{player_kills}"
    - ""
    - "&fTime left: &e{time_left}"
    - "&7&m-----------"
  core-status-intact: "&a✔"
  core-status-attacked: "&e⚠"
  core-status-destroyed: "&c✘"

# GUI settings
gui:
  main-title: "&6&lCores - Play"
  main-quick-join-name: "&a&lQuick Join"
  main-quick-join-lore:
    - "&7Join the arena with the most"
    - "&7players currently waiting."
  main-quick-join-material: "COMPASS"
  main-arena-select-name: "&6&lSelect Arena"
  main-arena-select-lore:
    - "&7Browse all available arenas"
    - "&7and choose one to join."
  main-arena-select-material: "BOOK"
  arena-select-title: "&6&lSelect Arena"
  arena-button-waiting-material: "GREEN_CONCRETE"
  arena-button-playing-material: "RED_CONCRETE"
  arena-button-name: "&f{arena_name}"
  arena-button-lore:
    - "&7Status: {status}"
    - "&7Players: &f{players}/{max_players}"
    - ""
    - "{join_hint}"
  arena-button-join-hint: "&aClick to join!"
  arena-button-spectate-hint: "&7Click to spectate."
  arena-status-waiting: "&aWaiting"
  arena-status-starting: "&eStarting"
  arena-status-playing: "&cPlaying"
  arena-status-disabled: "&8Disabled"
  back-button-name: "&c&lBack"
  back-button-material: "ARROW"