HardcoreRuns

A Server-Side Multiplayer Roguelike Plugin for Minecraft 1.21.11

HardcoreRuns brings the tension of Hardcore Minecraft to a multiplayer environment with zero setup required for players. Just join and play!

Features

• Instant Resets: Walk through the lobby portal to instantly generate a brand new Overworld, Nether, and End with a random seed. No server restarts required.
• Two Ways to Play:
  • Linked Death Mode: True co-op. If your friend dies, you all die. Work together or fail together.
  • Elimination Mode: Survival of the fittest. If you die, you are sent to the lobby to wait/spectate. The run continues until the last player falls.
• Live HUD: Keeps track of your "Time Alive" on the action bar and tracks total Resets and Wins on the scoreboard.
• Seamless Dimensions: Custom portal logic ensures you travel to a fresh Nether and End specific to your current run.
• Win the Game: Defeat the Ender Dragon and jump through the portal to secure a Victory and increment the server-wide win counter.

---

Installation Guide

1. Prepare the Server

• Download Paper 1.21.11 (or the latest 1.21 build) from the PaperMC website.
• Put the .jar file in a folder and run it once to generate files.
• Open eula.txt and change eula=false to eula=true.

2. Install the Plugin

• Download HardcoreRuns.jar.
• Drag and drop the file into the server's plugins folder.
• Modify the server.properties file and change hardcore=false to hardcore=true
• Start the server.

3. Setup the Lobby

• When you first join, you will be in the Lobby World (the default server world).
• Switch to Creative Mode (/gamemode creative).
• Build your lobby area.
• Crucial Step: Build a standard Nether Portal and light it with Flint & Steel.
  • Note: This portal is your "Start Button." Walking into it triggers the generation of a new run.
• Switch back to Survival or Adventure mode.

4. Play!

• Walk into the portal. The server will freeze for a moment while it generates three new dimensions.
• Good luck!

---

Commands & Permissions

All commands are handled by the plugin. No complex permission plugins are strictly necessary if you are an OP, but permissions are listed below for server admins.

Command	Permission	Description
/hctoggle	hardcoreruns.admin	Toggles the game mode between Linked Death (Shared Lives) and Elimination (Last Man Standing).
/hcui	(None)	Toggles the HUD (Scoreboard & Timer) on or off for the player who runs it. Useful for taking screenshots.
/hcreset	hardcoreruns.admin	Resets the global "Resets" and "Wins" counters on the scoreboard back to 0.

---

Configuration

The plugin creates a config.yml automatically. You generally do not need to edit this manually, as the plugin saves your stats (Win/Reset counts) and settings (Game Mode) automatically when the server stops.

resetCount: 12  # Automatically tracks how many times you died
winCount: 2     # Automatically tracks how many times you beat the dragon
linkedDeath: true # Tracks your current game mode

---

Made for Minecraft 1.21.11 (Paper/Spigot) https://github.com/golietop/hardcoreRuns