FGF Hero
FGF Hero is a hardcore event plugin inspired by Minecraft Helden where players are linked and share their fate. It creates an intense survival experience where you either win together or lose together.
6
Quick challenge
How far can you run before the mobs catch you?
Minecraft check
Confirm your run
Complete the quick check to get your code.
FGF Hero
❤️ 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 Linked Life (💛 golden heart) - 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
- 🚫 Killing Restriction → lose 1 heart instantly - 🎒 Killing Restriction → optional 50% drop - 🧠 Killing Restriction → heads treated as normal items - 🕊️ Killing Restriction → disable PvP for a set time
---
🌍 World & Access Management
- 📅 Nametag options (per weekday, minute-precise) - ⚠️ Warnings + ⏳ countdown (with sound) - 🚪 Auto Nametag options - 🌐 Nametag options - 👁️ 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
- 🧱 Java 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 + Vault 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 access - `fgfhero.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
<pre> ```
==========================================
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"
</pre>
