Hardcore Runs

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.

---

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