Перейти к содержимому
Mineforgian

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.

Загрузки
98
Подписчики
2
Обновлён
31 мая 2026 г.
Лицензия
MIT

Опубликован 21 апреля 2026 г.

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

Join DC


Server Hosting

Need a server for your event?

Create your own Minecraft server:

Create 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"

Ченджлог

1.5.1Релиз1.21.9, 1.21.10, 1.21.11 · 31 мая 2026 г.

📜 Changelog v1.5.1

🚀 Added

  • Custom session limits for different days of the week.
  • Admins can now see and set other players' session time via /fgfhero timeleft.
  • Added a confirmation step for /fgfhero kit-load to prevent accidental inventory overwrites.
  • Added an explicit feedback message when using /fgfhero bypass.

🛠 Fixed

  • Fixed duplicate session limit warning messages.
  • Fixed session limit time resetting upon rejoin.
  • Improved the half-inventory system to prevent item loss on respawn.
  • Players whose daily limit has expired can no longer rejoin the active world until the next day.

❤️ Thank You

Thank you for using FGF Hero! 🚀

1.5Релиз1.21.9, 1.21.10, 1.21.11 · 29 мая 2026 г.

Changelog - Version 1.5

Added

  • Added a configurable limit for how many duel requests a player can send at the same time.
  • The duel request limit can now be changed directly in the config.

Changed

  • /fgfhero kit-load now loads the kit for all players in the active world.
  • /fgfhero kit-load <player> now loads the kit only for the specified player.
  • Renamed /fgfhero reload to /fgfhero reload-config.
  • /fgfhero reload-config now fully reloads the plugin configuration without requiring a server restart.

Fixed

  • Duels now automatically end when a player wins or loses.
  • Fixed broken duel chat messages.
  • Fixed the incorrect message key duel_death_massage.

❤️ Thank You

Thank you for using FGF Hero 

1.4Релиз1.21.9, 1.21.10, 1.21.11 · 26 мая 2026 г.

📜 FGF Hero — Version 1.4 Changelog

🚀 Major Reward System Improvements

🖥️ Console Winner Commands

The game-end reward system has been completely reworked! You can now configure reward commands to be executed directly by the Console instead of the player.

🎯 New Placeholder Support

Added support for the new placeholder:

  • {winner} → Targets the winning player directly

Perfect for commands such as:

  • Teleporting winners → /mvtp {winner} Hub
  • Economy rewards
  • Custom plugin integrations

🧹 Cleaner Configuration

Removed outdated and redundant win-command sections from config.yml to improve readability and simplify setup.


💀 Visual Enhancements

👁️ Spectator Identification

Players in Spectator Mode inside the active game world are now marked with a Skull Icon (\uE003):

  • In the TAB list
  • Above player heads

⚠️ Requires a matching character definition in your Resource Pack font (default.json).

⚠️ Important: The icon display inside the TAB list will not work if the plugin TAB is installed, as TAB overrides the default player list formatting.


🧩 PlaceholderAPI Expansion

Added powerful new placeholders for integrations with plugins like TAB, scoreboards, and custom displays.

❤️ %fgfhero_hearts_display%

Displays:

  • Purple/Gold hearts for alive players
  • Red Skull icon for spectators

📊 %fgfhero_status%

Returns the current player state:

  • Lobby
  • Spectator
  • Eliminated
  • Linked Life
  • Alive

🛠️ Bug Fixes & Maintenance

✅ Stability Improvements

Fixed a compilation issue related to team kick-vote data structures.


⬆️ How to Update

  1. Replace your old .jar file with the new version

  2. Update your config.yml with the new game_end_settings section

    • or let the plugin generate a fresh config automatically

❤️ Thank You

Thank you for using FGF Hero! 🚀

1.3Релиз1.21.9, 1.21.10, 1.21.11 · 20 мая 2026 г.

🚀 FGF Hero – Changelog 1.3

🌍 Language Updates

  • Added full translations for:
    • Italian 🇮🇹
    • Portuguese 🇵🇹

✅ Supported Languages

German      100%
English     100%
Spanish     100%
French      100%
Japanese    100%
Russian     100%
Chinese     100%
Italian     100%
Portuguese  100%

Translated 🌍


✨ New Features

🐞 Bug Report System

  • Added:
/fgfhero report-bug
  • All players can now directly send bug reports to the developer.

❤️ Linked Hearts System

  • Added a new hearts mode with extra config settings.

How it works

  • If Player A attacks a linked heart, nothing happens.
  • If Player B loses a heart, both linked players lose hearts together.
  • If both players are linked, no extra heart loss happens.

💖 Heart Display

  • Hearts can now be displayed:
    • in the TAB list behind player names
    • above player heads
    • directly inside player names using custom textures/fonts

🎒 Admin Kit System

⚠️ Only available for admins.

  • Added:
/fgfhero kit-save

Saves the current inventory.

  • Added:
/fgfhero kit-load

Loads the saved inventory for:

  • all players inside the active world
  • players who join later

🌍 Player RTP

  • Added:
/fgfhero rtp <player>
  • Executes the start RTP for a specific player.
  • Includes an additional clickable confirmation in chat before the RTP is executed.

⚔️ Duel System

Enabled by default in config.

Commands

/fgfhero duel <player>

Send a duel request.

/fgfhero duel accept <player>

Accept a duel request.

/fgfhero duel vote-stop

Stops the duel if both players vote for it.
Cannot be used while in combat.

  • Vote-stop messages are clickable in chat.
  • Duel request limit is configurable.

Duel Timeout System

  • Automatic duel stop after a configurable time.
  • Default timeout: 1 hour

Warning Countdown

Chat warnings + sounds at:

20 min
10 min
5 min
1 min
20 sec
10 sec
5
4
3
2
1
[DUEL STOPPED]

👥 Team System

Enabled by default in config.

Team Admin Commands

/fgfhero team create <name>

Create a team.

  • Every team name can only exist once.
  • Forbidden names can be configured.
/fgfhero team color <color>

Change the team color.

/fgfhero team invite <player>

Invite a player without a team.

/fgfhero team kick <player>

Starts a clickable vote kick for online team members.

  • Minimum required online players is configurable.
  • Vote system can be enabled/disabled.

Player Commands

/fgfhero team accept <team_name>

Accept a team invite.

/fgfhero team list

Shows all team members.

Team Features

  • Max team name length: 5
  • Team name length is configurable.
  • Team prefixes are displayed before player names with colors.
  • Added config option for team RTP at game start.

🤝 Partner Reveal System

  • Added a new config option to reveal teammates/partners:

    • in chat
    • in the action bar
  • Fully configurable with:

partner_reveal: true/false

⚙️ Config Additions

  • Added new settings for:
    • linked hearts
    • duel system
    • duel timeout
    • team system
    • forbidden team names
    • team RTP
    • vote kick requirements
    • partner reveal
    • heart display system

⚠️ Important

When updating to this version, it is recommended to regenerate your config files.

Some new settings may not appear correctly if old config files are still used.

1.2Релиз1.21.9, 1.21.10, 1.21.11 · 12 мая 2026 г.

🚀 Changelog – 1.2

✨ New Features

  • Added support for individual access schedule times for specific players.
    You can now create custom access schedules per player instead of using only global settings.

  • Players can now check their remaining access time with:

/fgfhero timeleft
  • Added support for custom textures/fonts using a resource pack.

Example default.json

This is only an example to show how custom textures can be configured:

{
  "providers": [
    {
      "type": "bitmap",
      "file": "minecraft:font/purpleheart.png",
      "ascent": 8,
      "height": 10,
      "chars": ["\uE001"]
    },
    {
      "type": "bitmap",
      "file": "minecraft:font/goldheart.png",
      "ascent": 8,
      "height": 10,
      "chars": ["\uE002"]
    }
  ]
}

Example Texture Pack Structure

The included example texture pack is structured like this:

📁 ResourcePack
├── pack.mcmeta
└── assets
    └── minecraft
        ├── font
        │   └── default.json
        └── textures
            └── font
                ├── purpleheart.png
                └── goldheart.png

⚠️ Custom texture packs require some knowledge about Minecraft resource packs and font providers.


🛠 Fixes

  • Fixed the prevent_join_on_start: config setting.
    Players who were already online when the server/session started can now still join correctly.

  • Fixed the join handling system for players who join after the start.

  • Fixed the hide_nametags system.
    You can now properly use:

hide_nametags: "only_through_blocks"
hide_nametags: "always"
hide_nametags: "never"

⚠️ Important

When updating to this version, you must delete your old config.yml before starting the server again.

New config settings will not appear correctly if the old config file is kept.

1.0Релиз1.21.9, 1.21.10, 1.21.11 · 26 апреля 2026 г.

📦 Version 1.0 – Initial Release

🎉 First official release of FGF Hero!

❤️ Core Features

  • 🔗 Linked Hearts system with multiple modes (Hardcore, Team, Easy Hardcore, Secret Reveal)
  • 💜 Custom life system (3 lives + 💛 linked life)
  • 📊 Actionbar HUD (hearts, combat timer, partner info)
  • 🔊 Heartbeat sound at low health

⚔️ Combat & Gameplay

  • 🚫 Combat logging punishment (lose hearts)
  • 🎒 Optional inventory protection (keep half)
  • 🕊️ Configurable killing restriction at start
  • 🧠 Backpack compatibility (no item blocking issues)

🌍 World Management

  • 📅 Access schedule system (open/close times)
  • ⚠️ Warnings & ⏳ countdown with sound
  • 🚪 Auto kick / teleport to hub
  • 🌐 World-only mode support
  • 👁️ Custom nametag visibility options

🛡️ Restrictions & Config

  • ⏳ Start phase protection (no move, no PvP, no build)
  • 🚫 Blocked items & disabled features (Totems, Enchants, etc.)
  • 🌌 Optional Nether / End lock
  • ⚙️ Fully configurable config.yml

🏆 Systems

  • 🏁 Automatic win detection (last team/player alive)
  • 🎁 Reward commands on win
  • 👻 Spectator handling on game end

📜 Commands & API

  • 🛠️ Full admin & player command system
  • 🔢 PlaceholderAPI support (%fgfhero_...%)

🌐 Misc

  • 🌍 Multi-language support (en / de / es / fr / ru / ja / zh)
  • 🔌 Integration support (PAPI, Multiverse, Vault, Backpacks)

💡 Inspired by the Minecraft Helden format
💀 Survive together… or fall together.

Комментарии

Загружаем…