🌍 Need a Server for This Plugin?

🚀 Create your own Minecraft server in minutes!

Play with friends, install mods/plugins easily, and get started fast ⚡️

💖 Support the project by using the link above!

❤️ FGF Hero – Hardcore Linked Hearts Plugin

FGF Hero is a unique hardcore event plugin inspired by the format of Minecraft Helden, where players are linked together and share their fate.
It combines survival, strategy, teamwork, and intense PvP into one challenging gameplay experience 💀🔥

❤️ Linked Heart System

Players are linked together and share consequences depending on the selected game mode 🔗

🔗 Available Modes

💀 HARDCORE

Partners are secret.
If one player is permanently eliminated, both players lose the game.

👥 TEAM

Partners know each other.
If one dies, the other player can continue surviving.

💔 EASY_HARDCORE

Partners know each other.
If one player is eliminated, both players are eliminated.

❓ SECRET_REVEAL

Partners stay hidden until a player reaches their final heart.

💛 LINKED_TRANSFER

If one partner would enter Linked Life, the other partner loses 1 heart instead.

💜 Life System

• Start with 3 purple hearts

• When all hearts are lost → enter Linked Life 💛

• Heartbeat sound effects at 1 remaining life 🔊

📊 HUD Features

The actionbar can display:

• 💜 Remaining hearts

• 💛 Linked Life status

• ⏱️ Combat timer

• 🔗 Linked partner name (if enabled)

⚔️ Combat & Death System

• 🚫 Combat logging instantly removes 1 heart

• 🎒 Optional 50% inventory keep system

• 🧠 Backpack compatibility support

• 🕊️ Temporary PvP protection / kill restriction system

🌍 World & Access Management

• 📅 Weekday-based access schedules

• ⏳ Automatic countdown warnings with sounds

• 🚪 Auto kick or teleport to hub

• 🌐 World-only gameplay mode

• 👁️ Configurable nametag visibility system

🛡️ Restrictions & Protection

• ⏳ Start phase disables movement, PvP, and building

• 🚫 Disabled items and enchantments

• ⚙️ Disable villagers, totems, mace, tridents, and more

• 🚷 Join restrictions

• 🌌 Nether / End dimension lock support

🏆 Winner System

• Game ends when only 1 player or team remains

• 🎁 Automatic reward commands

• 👻 Spectators are automatically teleported

📜 Commands

👤 Player Commands

• /fgfhero join

• /fgfhero worldopen

• /fgfhero seetime

🛠️ Admin Commands

• /fgfhero start

• /fgfhero stop

• /fgfhero restart

• /fgfhero reset

• /fgfhero reload

• /fgfhero link

• /fgfhero unlink

• /fgfhero randomlink

• /fgfhero setlives

• /fgfhero setlinkedlife

• /fgfhero killasplayer

• /fgfhero lang <lang>

• /fgfhero debug

• /fgfhero bypass

• /fgfhero movebypass

• /fgfhero tpworld

• /fgfhero createworld

🔢 PlaceholderAPI Support

👤 Player

• %fgfhero_lives%

• %fgfhero_mate%

• %fgfhero_hearts%

🌍 World

• %fgfhero_world_status%

• %fgfhero_world_next_event_time%

• %fgfhero_world_countdown%

📊 Stats

• %fgfhero_alive_count%

• %fgfhero_eliminated_count%

🔌 Dependencies

⚙️ Requirements

• 🧱 Minecraft Version: 1.21.x (Paper / Spigot)

• ☕ Java Version: 21

🔧 Optional Plugins

📊 PlaceholderAPI

Required for all %fgfhero_...% placeholders.

🌍 Multiverse-Core

Required for world management features.

💰 Vault + EssentialsX

Required for reward systems and economy support.

🎒 Expendable Backpacks

Adds compatibility for backpack restrictions.

⚙️ Configuration Features

• 🌐 Multi-language support
  en / de / es / fr / ru / ja / zh

• 🎮 Multiple game modes

• 📅 Access schedules

• 🎨 Custom colors

• 🚫 Restrictions

• 🎁 Reward systems

🔐 Permissions

• fgfhero.admin → Full admin access

• fgfhero.join → Allows players to join events

🎯 Summary

FGF Hero delivers an intense and fair hardcore linked-hearts experience inspired by Minecraft Helden.
Every decision matters, every death has consequences, and teamwork becomes essential 💀❤️

Survive together… or fall together.

❓ Can I use these plugins in a server pack? 📦

Of course! Please feel free to include these plugins in your server packs! 💜✨

You may:

• ✅ Use these plugins on public and private servers
• ✅ Include them in server packs
• ✅ Share server packs containing these plugins

Just please:

• ❌ Do not reupload the plugins themselves
• ❌ Do not claim them as your own

Have fun and enjoy! 🌟

Config:

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

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

# -------------------------------
# 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_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 and SECRET_REVEAL.
eliminate_partner_on_death: false

# -------------------------------
# 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: true
  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"
  # 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/11807d242a7b07260bbb1e6fe53ef06704539882.zip"

# -------------------------------
# HUD & Visuals
# -------------------------------
show_hearts_to_spectators: true
spectator_message_on_elimination: true

# -------------------------------
# Spectator Chat Protection
# -------------------------------
spectator_chat:
  block_spoilers: true
  keywords:
    - "herz"
    - "heart"
    - "corazón"
    - "cœur"
    - "сердц"
    - "心"
    - "leben"
    - "life"
    - "vida"
    - "vie"
    - "жизн"

# -------------------------------
# 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
  prevent_join_on_start: false # Prevent players from joining the active world if the game has started
  # Nametag visibility options:
  # always: Nametags are always hidden.
  # never: Nametags are never hidden (Vanilla).
  # only_through_blocks: Nametags are hidden when behind blocks.
  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"
  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)
# {winners} -> Replaced with list of all winners (e.g. "FelixFGF, Mate")
# {spectator} -> Replaced with EACH spectator's name
game_end_settings:
  console_win_commands:
    - "eco give {player} 100" # give money to the winner
    - "broadcast §d§lFGF Hero §8» §e{player} §7Winn the game!" # broadcast a message to all players
    - "fgfsay dark_purple all &e{player} §7Winn the game!" # you can remove this (only with a nother plugin (comming soon) )
    - "mvtp {winners} Hub"
  console_spectator_commands:
    - "mvtp {spectator} Hub"
  player_win_commands:
    - "hub"