SpeedrunPlugin

A competitive speedrun plugin for Minecraft 1.16.1

SpeedrunPlugin lets you race against your friends in identical worlds with the same seed. Each player gets their own dimension, a live timer, and customizable win conditions. Perfect for streaming, tournaments, or casual competitions.

Features

Fair Competition — every player gets the same world seed, ensuring identical terrain and structures
Individual Worlds — each player is teleported to their own world to avoid interference
Live Timer — speedrun time displayed in the action bar in real time
Customizable Win Conditions — three modes to choose from:
- Dragon Kill — first player to kill the Ender Dragon wins
- Last Alive — last surviving player wins
- Dragon or Last — dragon kill takes priority, otherwise last alive wins
Death Options — choose between instant disqualification or respawn with a penalty
Voting System — propose a draw with /draw and skip countdown with /spstart
Bilingual Support — fully translated into Russian and English (Russian by default)
Lobby System — set a central lobby world where players gather before and after games

Commands

Command	Permission	Description
`/setlobbyworld <world>`	`speedrun.admin`	Sets the lobby world
`/setseed <seed>`	`speedrun.admin`	Sets the world seed for all players
`/start [seconds]`	`speedrun.admin`	Starts the game with an optional countdown
`/spstart`	`speedrun.player`	Votes to skip the countdown
`/draw`	`speedrun.player`	Proposes a draw to opponents
`/gup`	`speedrun.player`	Surrenders from the current game
`/sphelp`	`speedrun.player`	Displays all available commands

How It Works

Setup: An admin sets the lobby world with /setlobbyworld and the seed with /setseed
Countdown: Run /start 60 to begin a 60-second countdown. Worlds generate during this time
Game Start: When the timer hits zero, all players are teleported to their own identical worlds
Racing: Players compete based on the selected mode — kill the dragon or survive
Game End: The winner is determined according to the win condition. Players can propose a draw or surrender at any time

Win Conditions

Mode	`win-condition` Value	Description
Dragon Kill	`dragon`	First player to kill the Ender Dragon wins. If all die — draw
Last Alive	`last_alive`	The last surviving player wins
Dragon or Last	`dragon_or_last`	Killing the dragon is an instant win. If no one kills it — last alive wins

Configuration

yaml

# config.yml
language: "ru"                    # Language (ru / en)
win-condition: "dragon_or_last"   # Win mode: dragon / last_alive / dragon_or_last
death-action: "disqualify"        # disqualify or continue
countdown-time: 60                # Default countdown in seconds
world-prefix: "speedrun_"         # Prefix for player world folders

Requirements

Minecraft 1.16.1
Spigot, Paper, or any compatible server software
Java 8 or higher

Installation

Download SpeedrunPlugin-1.0-SNAPSHOT.jar
Place it in your server's plugins folder
Restart the server or use a plugin manager to load it
Configure plugins/SpeedrunPlugin/config.yml to your liking
Set up your lobby and seed, then start racing

Permissions

Permission	Default	Description
`speedrun.admin`	OP	Access to setup commands
`speedrun.player`	Everyone	Access to gameplay commands

License

Free to use and modify for personal or server use. Redistribution allowed with credit.

SpeedrunPlugin

Плагин для соревновательных спидранов в Minecraft 1.16.1

SpeedrunPlugin позволяет соревноваться с друзьями в одинаковых мирах с одним сидом. Каждый игрок получает собственное измерение, таймер реального времени и настраиваемые условия победы. Идеально подходит для стримов, турниров или просто соревнований с друзьями.

Возможности

Честная игра — все игроки получают одинаковый сид мира, что гарантирует одинаковый ландшафт и структуры
Отдельные миры — каждый игрок телепортируется в свой мир, чтобы не мешать другим
Таймер — время спидрана отображается в action bar в реальном времени
Настраиваемые условия победы — три режима на выбор:
- Убийство дракона — побеждает первый, кто убьет Эндер Дракона
- Последний выживший — побеждает тот, кто останется в живых последним
- Дракон или выживание — приоритет у убийства дракона, иначе побеждает последний выживший
Настройка смерти — выбор между мгновенной дисквалификацией или возрождением с продолжением игры
Голосования — предложение ничьей через /draw и пропуск обратного отсчета через /spstart
Два языка — полный перевод на русский и английский (русский по умолчанию)
Система лобби — установите центральный мир, где игроки собираются до и после игры

Команды

Команда	Право	Описание
`/setlobbyworld <мир>`	`speedrun.admin`	Устанавливает лобби-мир
`/setseed <сид>`	`speedrun.admin`	Устанавливает сид мира для всех игроков
`/start [секунды]`	`speedrun.admin`	Запускает игру с обратным отсчетом
`/spstart`	`speedrun.player`	Голос за пропуск обратного отсчета
`/draw`	`speedrun.player`	Предлагает ничью соперникам
`/gup`	`speedrun.player`	Сдаться в текущей игре
`/sphelp`	`speedrun.player`	Показывает все доступные команды

Как это работает

Настройка: Админ устанавливает лобби-мир через /setlobbyworld и сид через /setseed
Обратный отсчет: Введите /start 60 для запуска 60-секундного обратного отсчета. В это время генерируются миры
Старт игры: Когда таймер достигает нуля, все игроки телепортируются в свои одинаковые миры
Гонка: Игроки соревнуются в зависимости от выбранного режима — убивают дракона или выживают
Конец игры: Победитель определяется согласно условиям победы. Игроки могут предложить ничью или сдаться в любой момент

Режимы победы

Режим	Значение `win-condition`	Описание
Убийство дракона	`dragon`	Побеждает первый, кто убьет Эндер Дракона. Если все погибли — ничья
Последний выживший	`last_alive`	Побеждает последний оставшийся в живых игрок
Дракон или выживание	`dragon_or_last`	Убийство дракона — мгновенная победа. Если никто не убил — побеждает последний выживший

Настройка

yaml

# config.yml
language: "ru"                    # Язык (ru / en)
win-condition: "dragon_or_last"   # Режим победы: dragon / last_alive / dragon_or_last
death-action: "disqualify"        # disqualify — дисквалификация, continue — продолжение
countdown-time: 60                # Обратный отсчет по умолчанию в секундах
world-prefix: "speedrun_"         # Префикс для папок миров игроков

Требования

Minecraft 1.16.1
Spigot, Paper или любое совместимое серверное ПО
Java 8 или выше

Установка

Скачайте SpeedrunPlugin-1.0-SNAPSHOT.jar
Поместите его в папку plugins вашего сервера
Перезапустите сервер или загрузите плагин через менеджер плагинов
Настройте plugins/SpeedrunPlugin/config.yml под себя
Установите лобби и сид, затем начинайте гонку

Права

Право	По умолчанию	Описание
`speedrun.admin`	Операторы	Доступ к командам настройки
`speedrun.player`	Все	Доступ к игровым командам

Лицензия

Свободное использование и изменение для личных или серверных нужд. Распространение разрешено с указанием авторства.

Speedrun Plugin