SpeedRun+

SpeedRun+ (SpeedRunPlus) is a plugin for Minecraft (1.16.1) multiplayer servers which provides several speedrun-related game modes to your server. SpeedRun+ manages isolated, temporary worlds when speedrunning and supplies a range of quality of life utilities such as: In-game timers, AFK detection, leaderboards, filtered seeds, and more. Game modes include:

• Solo - A classic single-player speedrun where you aim to defeat the Ender Dragon in the shortest time possible.
• Battles - A head-to-head race between two players in identical worlds. Each player rushes to defeat the Ender Dragon first — the first to do so wins the match.
• Co-op - A cooperative speedrun for up to two players sharing the same world. The run ends when the team defeats the Ender Dragon together.

With more coming!

A great solution for providing fun and competitive game modes to a proxy-based server network (Velocity / BungeeCord) or simply on a 1.16.1-native server!

🖼️ Preview

🖥️ Installation

⚠️ SpeedRun+ does not support Minecraft Bedrock servers. SpeedRun+ works on a Bukkit server such as Spigot or Paper.

1. Download the plugin

2. Add the JAR file to your server's plugin-folder

3. Restart / Reload the server and start speedrunning by executing the provided commands!

⚙️ Prerequisites

SpeedRun+ relies on Multiverse-Core and Multiverse-NetherPortals to create isolated speedrun worlds. These plugins must be present on the server, for this plugin to work:

• GitHub - Multiverse-Core v. 4.3.16 / Modrinth - Multiverse-Core v. 4.3.16
• GitHub - Multiverse-NetherPortals v. 4.2.3 / Modrinth - Multiverse-Core v. 4.3.16

🏃️ Commands

SpeedRun+ uses the following in-game command structure:

/srp <gamemode> <action> [player]

For additional info and help, see the subsections below or use the /srp help command in-game.

🕹️ Player commands

👤 Solo

👥 Battle

🫂 Co-op

🛡️ Admin commands

Administrative commands exist for managing runs, troubleshooting issues, and performing maintenance actions. The player must have the administrative permission srp.admin (disabled by default) to allow use of these.

For the full list of admin commands, use:

/srp admin help

️🛠️ Configuration & Permissions

SpeedRun+ is highly configurable, allowing server owners to fine-tune game rules, world generation, timer behavior, AFK handling, podiums to display top leaderboard contestants, and more. All settings can be adjusted through the plugin’s config.yml, giving you control over how speedruns operate on your server.

Below is a complete example configuration file to help you understand the available options and their default values. You can use this as a reference when customizing your own setup.

# ========================================
# SpeedRunPlus (SRP) Configuration
# ========================================

# Main world names - used to teleport players back to when runs complete
main-overworld: world
main-nether: world_nether
main-end: world_the_end

# Game rule settings
game-rules:

  # Speedrun world seeds
  filtered-seeds:
    # Whether to use filtered seeds or rely on random seeds
    use-filtered-seeds: false

    # Weights for each type of seed (higher number = more likely to appear) (non-positive weights excludes the type)
    weights:
      MAPLESS: 0
      VILLAGE: 3
      TEMPLE: 1
      SHIPWRECK: 2
      RUINED_PORTAL: 1
      RANDOM: 1

  # Maximum number of players allowed to speedrun simultaneously
  # Used it to limit the toll on the server's resources
  max-players: 4

  # Maximum duration of a speedrun in minutes
  # Use it to limit the time a player can spend in a single run
  max-time-minutes: 120

  # Time before requests for BattleSpeedrun / Co-op are invalidated
  max-request-seconds: 30

# Prefix used for generated speedrun worlds
world-prefix:
  overworld: srp-overworld-
  nether: srp-nether-
  end: srp-end-

# Timer settings
timer:
  # The amount of time to countdown from, when starting a speedrun in seconds
  countdown-seconds: 10

# Podium configuration
# Use it to display the top N contestants and their times in the main world using armor-stands and player heads
podium:
  max: 10
  world: world
  positions:
    1:
      x: 0.5
      y: 80.5
      z: 0.5
      yaw: 90

# AFK configuration
afk:
  # Minutes before ending a speedrun due to inactivity
  timeout-minutes: 5

  # Intervals between each AFK check
  check-interval-seconds: 60

  # Minimum number of blocks the player needs to move
  # to be considered active between each AFK check
  min-distance: 1.0

🔑 Permissions

SpeedRun+ includes a set of permissions, that integrate seamlessly into LuckPerms, and let server owners control which features and gamemodes players can access. Most servers will likely grant solo, battle, or co-op permissions based on player ranks, while administrative permissions should be reserved for staff.

Below is a brief overview of permissions, but be sure to see the plugin.yml for the full list:

🤝 Support & Contact

If you encounter issues, have suggestions, or want to request new features, please use the official issue tracker on:

GitHub Issues

For anything else—questions, feedback, or general discussion—feel free to open an issue as well. This helps keep all support requests organized and ensures nothing gets lost.

📜 Licensing and Contributions

This project is licensed under the AGPL-3.0 License, allowing open use, modification, and redistribution under the terms of the license.

Contributions are welcome! However, all contributions must follow the rules outlined in CONTRIBUTING and are subject to the Contributor License Agreement. Only contributions approved by the project owner will be merged into the official version.