Compatibility
Minecraft: Java Edition
Platforms
Tags
Creators
Details
โค๏ธ 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, and teamwork into an intense gameplay experience. ๐๐ฅ
โค๏ธ Core Mechanics โ Linked Hearts
Players are linked together and (depending on the mode) share their fate.
๐ Modes
-
๐ HARDCORE
Partners are secret. If one dies permanently (0 lives), both are eliminated. -
๐ฅ TEAM
Partners know each other. If one dies, the other can continue playing. -
๐ EASY_HARDCORE
Partners know each other. If one dies permanently, both are eliminated. -
โ SECRET_REVEAL
Partners are hidden until a player reaches their last heart.
๐ Life System
- Start with 3 purple hearts
- When depleted โ fall to Linked Life (๐ golden heart)
๐ HUD (Actionbar)
- Heart count (๐ / ๐)
- โฑ๏ธ Combat timer
- ๐ Partner name (if allowed)
๐ Heartbeat sound at 1 life remaining
โ๏ธ Combat & Death
- ๐ซ Combat Logging โ lose 1 heart instantly
- ๐ Inventory Protection โ optional 50% drop
- ๐ง Backpack Compatibility โ heads treated as normal items
- ๐๏ธ Killing Restriction โ disable PvP for a set time
๐ World & Access Management
- ๐ Access Schedule (per weekday, minute-precise)
- โ ๏ธ Warnings + โณ countdown (with sound)
- ๐ช Auto kick / teleport to hub
- ๐ World-only mode
- ๐๏ธ Nametag options (hidden / visible / through blocks)
๐ก๏ธ Restrictions & Protection
- โณ Start phase disables movement, building & PvP
- ๐ซ Blocked items (e.g. Bedrock, Barrier)
- โ๏ธ Disable features (Villagers, Totems, Enchants, etc.)
- ๐ท Join restrictions (hub-only)
- ๐ Dimension lock (Nether / End)
๐ Winner System
- Game ends when 1 player or team remains
- ๐ Automatic rewards (console commands)
- ๐ป Spectators auto-teleported
๐ Commands
๐ค Player
/fgfhero join/fgfhero worldopen/fgfhero seetime
๐ ๏ธ Admin
/fgfhero start | stop | restart | reset | reload/fgfhero link | unlink | randomlink/fgfhero setlives | setlinkedlife/fgfhero killasplayer/fgfhero lang <lang>/fgfhero debug | bypass | movebypass/fgfhero tpworld | createworld
๐ข PlaceholderAPI
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
To use all features, the following requirements are needed:
โ๏ธ Requirements
- ๐งฑ Minecraft Version: 1.21.x (Paper / Spigot)
- โ Java Version: 21
๐ง Optional (Recommended Plugins)
-
๐ PlaceholderAPI
Required for all%fgfhero_...%placeholders -
๐ Multiverse-Core
Needed for world management (e.g./fgfhero createworld) -
๐ฐ Vault + EssentialsX
Required for rewards (e.g.eco give) -
๐ Expendable Backpacks
Adds special integration for backpack restrictions
โ๏ธ Configuration
- ๐ Languages supported: en / de / es / fr / ru / ja / zh
- ๐ฎ Mode selection
- ๐ Schedules
- ๐จ Colors
- ๐ซ Restrictions
- ๐ Rewards
๐ Permissions
fgfhero.adminโ full accessfgfhero.joinโ join command
๐ฏ Summary
FGF Hero delivers a fair and intense hardcore event system inspired by Minecraft Helden,
where every decision matters.
Survive togetherโฆ or fall together. ๐โค๏ธ
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"


