FGF Hero | Hardcore Linked Hearts Plugin

A modern hardcore event plugin inspired by Minecraft Helden.

FGF Hero links players together so every decision matters:

• ❤️ Shared lives
• 💀 Hardcore elimination
• 🔗 Secret teammates
• ⚔️ Intense PvP survival
• 🏆 Last team standing wins

Perfect for:

• Hardcore events
• PvP survival servers
• Creator events
• Community tournaments

---

Core Features

❤️ Linked Hearts System

Players are linked together and share their fate depending on the selected mode.

Available Modes

• 💀 HARDCORE
  Secret teammates. If one player is eliminated, both are out.

• 👥 TEAM
  Teammates know each other. One death does not eliminate both players.

• 💔 EASY_HARDCORE
  Visible teammates, but shared elimination.

• ❓ SECRET_REVEAL
  Teammates stay hidden until last life.

• 🔄 LINKED_TRANSFER
  Damage can transfer between linked players.

---

Life System

• Start with 3 lives
• Enter Linked Life when low
• Heartbeat warning on last life
• Actionbar HUD with live information

HUD includes:

• ❤️ Lives
• ⏱ Combat timer
• 🔗 Linked player
• ⚠ Warnings

---

PvP & Combat Features

• 🚫 Combat logging punishment
• ⚔️ PvP restrictions
• 🎒 Optional inventory protection
• 🧠 Backpack compatibility
• 🛡 Anti-exploit systems

---

Event & World Management

• 📅 Time-based world access
• 🌍 Dedicated event worlds
• 🚪 Auto kick or teleport
• ⏳ Countdown system
• 👁 Nametag visibility settings

---

Gameplay Restrictions

Disable or limit:

• Villagers
• Totems
• Enchantments
• Nether / End
• Specific items
• Commands
• Building before start

Perfect for competitive events.

---

Automatic Winner System

• 🏆 Last player or team wins
• 🎁 Automatic rewards
• 👻 Spectator handling
• ⚡ Console command support

---

PlaceholderAPI Support

Includes placeholders for:

• Lives
• Teammates
• Heart status
• Alive players
• Countdown timers
• World status

---

Requirements

Supported Versions

• Minecraft 1.21.x
• Paper / Spigot
• Java 21

Optional Dependencies

• PlaceholderAPI
• Multiverse-Core
• Vault
• EssentialsX
• Expendable Backpacks

---

Configuration

Highly customizable:

• 🌐 Multi-language support
• 🎨 Colors
• ⚙ Game modes
• 📅 Schedules
• 🚫 Restrictions
• 🎁 Rewards
• ❤️ Heart system

Supported languages:

• English
• German
• Spanish
• French
• Russian
• Japanese
• Chinese

---

Commands

Player Commands

• /fgfhero join
• /fgfhero worldopen
• /fgfhero seetime

Admin Commands

• /fgfhero start
• /fgfhero stop
• /fgfhero restart
• /fgfhero reset
• /fgfhero reload
• /fgfhero randomlink

And many more.

---

Permissions

• fgfhero.admin
• fgfhero.join

---

Community

---

Server Hosting

Need a server for your event?

Create your own Minecraft server:

💖 Using the link above helps support the project!

---

Server Pack Permission

You may:

• ✅ Use this plugin on public/private servers
• ✅ Include it in server packs
• ✅ Share server packs using this plugin

Please do not:

• ❌ Reupload the plugin itself
• ❌ Claim it as your own

Have fun and enjoy! ❤️

---

---

Config for V1.5

# ==========================================
#              FGF Hero Config
# ==========================================

# -------------------------------
# Language settings (en/de/es/fr/ru/ja/zh/it/pt)
# -------------------------------
language: en

# -------------------------------
# Bug Report System
# -------------------------------
# Enables random bug report reminders in /fgfhero commands.
# Recommended to keep enabled so players can report bugs faster.
bug-report:
  reminder-enabled: true

# -------------------------------
# Linked Heart System Mode
# -------------------------------
# HARDCORE: Secret partners. If one is eliminated, the other is out too.
# TEAM: Partners know each other. HUD shows mate. If one is out, the other stays alive.
# EASY_HARDCORE: Partners know each other. HUD shows mate. IF ONE IS OUT, BOTH ARE OUT.                                   # all are also based on eliminate_partner_on_death
# SECRET_REVEAL: Partners secret until one is on last life. Then only that player knows. The other player will not know.
# LINKED_TRANSFER: Like SECRET_REVEAL, but:
#                 - If P1 dies and would reach 1 heart (Linked Life), they stay at 1 heart and P2 loses 1 heart instead.
#                 - P1 dies again at 1 heart -> P1 is eliminated.
linked_heart_mode: SECRET_REVEAL

# General Mode Settings
# If true, when a player is fully eliminated (0 hearts), their partner is also eliminated.
# This is usually true for HARDCORE and EASY_HARDCORE, and false for TEAM, SECRET_REVEAL and LINKED_TRANSFER.
eliminate_partner_on_death: false

# If false, the partner will NEVER be revealed (HUD, Chat, etc.)
reveal_partner: true


# -------------------------------
# General Game Settings
# -------------------------------
game_started: false
max_hearts: 3
keep_half_inventory: true # If true, players keep half their inventory on normal death (not full elimination)
combat_log_window_seconds: 20
lose_heart_on_pve_death_in_combat: true # If true, players lose a heart when dying from mobs/fall/lava while in combat


# -------------------------------
# Killing Restriction Settings
# -------------------------------
killing_restriction:
  enabled: false
  duration_seconds: 2592000
  start_time: 0
  ended_notified: true
  notify_on_rtp: true
  rtp_message_sound: "ENTITY_PLAYER_LEVELUP"
  seetime_command_enabled: true
  seetime_sound: "UI_BUTTON_CLICK"
  end_sound: "UI_TOAST_CHALLENGE_COMPLETE"


# -------------------------------
# Access Schedule (Time-based server access)
# -------------------------------
access_schedule:
  enabled: true
  # Action to take when world is closed: KICK or TELEPORT
  action: TELEPORT
  # World to send players to if action is TELEPORT
  hub_world: "hub"
  # Timezone for the schedule
  timezone: "Europe/Berlin"
  # Sound played when access is denied/moved
  deny_sound: "ENTITY_VILLAGER_NO"
  # Format: "HH:mm-HH:mm" or "off" (e.g., "08:00-22:00" for 8 AM to 10 PM)
  schedule:
    Monday: "12:00-23:59"      # if you want to do e.g. 12:00-00:00 (Not working) do e.g. 12:00-23:59
    Tuesday: "12:00-23:59"
    Wednesday: "12:00-23:59"
    Thursday: "12:00-23:59"
    Friday: "18:00-23:59"
    Saturday: "18:00-23:59"
    Sunday: "18:00-23:59"

  # --- Player Session Limit ---
  # Every player gets a limited time PER DAY to be in the active world.
  session_limit:
    enabled: true
    # Maximum duration a player can be in the world (in minutes).
    max_duration_minutes: 120
    # Warning times before the session ends (in minutes).
    warning_minutes:
      - 10
      - 5
      - 1
    # Sound played shortly before kick/teleport
    warning_sound: "BLOCK_NOTE_BLOCK_PLING"

  # Message sent to players when the world is about to close (e.g., 5 minutes before) (set to 0 to disable)
  # (Messages are handled in messages_*.yml - key: closing_warning_message)
  closing_warning_minutes: 5
  closing_countdown_seconds: 25 # Countdown duration for the final closing warning
  closing_warning_sound: "BLOCK_NOTE_BLOCK_PLING"
  closing_warning_title_enabled: true # If true, a title message will be sent for the closing warning
  # Colors & Formatting for placeholders
  colors:
    label: "§7"
    status_open: "§a§l"
    status_closed: "§c§l"
    opens_in_time: "§d§l"
    closes_in_time: "§4§l"
    time_display: "§e"


# -------------------------------
# Resource Pack URLs
# -------------------------------
resource_pack_urls:
  - "https://download.mc-packs.net/pack/4ff6bce1716b82f2192166e7f3446a8f38f233ca.zip"


# -------------------------------
# HUD & Visuals
# -------------------------------
show_hearts_to_spectators: true
spectator_message_on_elimination: true
# If true, a heartbeat sound will be played when a player has only 1 heart left.
heartbeat_sound_enabled: false
show_hearts_in_tab: true
show_hearts_in_name: true


# -------------------------------
# Kit System
# -------------------------------
kits:
  enabled: true
  # The kit will be applied to all players currently in the active world when /kit-load is used.
  # Late joiners will also receive it if they join the active world.


# -------------------------------
# Duel System
# -------------------------------
duels:
  enabled: true
  # If true, players will not lose hearts when dying in a duel or combat logging during a duel.
  disable_heart_loss: true
  request_timeout_seconds: 60
  # Maximum number of outgoing duel requests a player can have active at once.
  max_requests_per_player: 1
  duel_duration_hours: 1
  # Warning times in minutes
  warnings: [20, 10, 5, 1]
  # Countdown in seconds
  final_countdown: [20, 10, 5, 4, 3, 2, 1]
  sounds:
    warning: "BLOCK_NOTE_BLOCK_PLING"
    stop: "ENTITY_WITHER_DEATH"


# -------------------------------
# Team System
# -------------------------------
teams:
  enabled: true
  max_name_length: 5
  min_online_for_kick_vote: 2
  rtp_teams_together: true
  forbidden_names:
    - "admin"
    - "staff"
    - "owner"
    - "nazi"
    - "hitler"
    - "fuck"
    - "ass"


# -------------------------------
# Spawning
# -------------------------------
save_quit_location: true


# -------------------------------
# Command Permissions
# -------------------------------
permissions:
  admin_commands: "fgfhero.admin"
  join_command: "fgfhero.join"
  join_allowed_worlds: # /fgfhero join only works in these worlds
    - "lobby"
    - "hub"
    - "Events-lobby"


# -------------------------------
# World Restrictions
# -------------------------------
world_management:
  world_only: true
  active_world: "world"
  disable_other_dimensions: true
  disable_spawn_command: true
  blocked_commands:
    - "spawn"
    - "/spawn"
    - "home"
    - "lobby"
    - "warp"
  combat_blocked_commands:
    - "/hub"
    - "/spawn"
    - "/home"
    - "/tpa"
  disable_movement: true
  disable_build: true
  disable_pvp_before_start: true
  # If true, new players cannot join a running game. Existing players can re-join.
  prevent_join_on_start: false
  # Behavior for new players who are allowed to join after start:
  allow_late_rtp: true      # Automatically RTP new players on join
  allow_late_linking: true  # Automatically link new players with free online partners
  # If true, late joiners will be RTP'd to their linked partner's location instead of a random spot.
  rtp_late_joiner_to_mate: false
  hide_nametags: "only_through_blocks"


# -------------------------------
# Gameplay Restrictions
# -------------------------------
restrictions:
  rtp_on_start: true
  rtp_tp_mate_together: false # If true, linked partners teleport to the same location
  link_all_players: true # If true, everyone gets a partner. If false, only half.
  allow_triangle_link: false # If true and link_all_players is true, an odd player will be linked in a triangle. If false, they stay alone.
  rtp_player_count: 2
  rtp_zone: 4000 x 4000
  countdown_seconds: 3
  countdown_sound: "BLOCK_NOTE_BLOCK_PLING"
  countdown_color: "§d"
  # If true, players will receive a 3-second blindness effect during the countdown before the game starts.
  apply_blindness_on_countdown: true
  disable_villagers: true
  disable_trial_chambers: true
  disable_mace: true
  disable_trident: true
  disable_spear: true
  disable_totems: true
  disable_enchanted_golden_apples: true
  # List of disabled items (Materials) - these will be removed from inventory
  disabled_items:
    - "BEDROCK"
    - "BARRIER"
  disabled_enchantments:
    - MENDING
    - KNOCKBACK
    - PUNCH


# -------------------------------
# Plugin World Restrictions
# -------------------------------
plugin_world_restrictions:
  graves: # not working
    restrict_to_fgfhero_world: true # not working
  expendable_backpacks: # https://modrinth.com/plugin/expendable-backpacks
    restrict_to_fgfhero_world: true # disable the crafting


# -------------------------------
# Win Settings & Rewards
# -------------------------------
# Available variables:
# {player} -> Replaced with EACH winner's name (run once per winner)
# {winner} -> Replaced with EACH winner's name (same as {player})
# {winners} -> Replaced with list of all winners (e.g. "FelixFGF, Mate")
# {spectator} -> Replaced with EACH spectator's name
game_end_settings:
  # Delay in seconds before teleporting players to the Hub after a win.
  wait_seconds_before_teleport: 10

  console_spectator_commands:
    - "mvtp {spectator} Hub"

  console_winner_commands:
    - "eco give {winners} 100"
    - "broadcast §d§lFGF Hero §8» §e{player} §7Winn the game!"
    - "fgfsay dark_purple all &e{player} §7Winn the game!"
    - "mvtp {winner} Hub"


# -------------------------------
# Placeholder Settings
# -------------------------------
placeholders:
  status:
    alive: "§aAlive"
    linked: "§6Linked"
    spectator: "§7Eliminated"