BlockRacing

BlockRacing includes built-in support for English and Simplified Chinese. Additional languages can also be added by translating the provided language resources and importing the translated files.

BlockRacing is a multiplayer block-collection racing minigame for Minecraft Paper servers.

Players are divided into two teams and race to collect a configurable list of target blocks. The first team to complete every target wins.

Gameplay

Before the game begins, players can open the preparation menu with Shift + F to:

• Choose a team
• Configure the number of target blocks
• Enable additional block pools
• Select the game mode
• Enable Speed Mode
• Randomly balance all online players between the two teams
• Confirm readiness and start the game

During the game, each team's current and upcoming targets are displayed on the scoreboard. Players can access team storage, teleport to teammates, reroll difficult targets, create waypoints, purchase locate commands, and use other team utilities through the menu.

Game Modes

Normal Mode

• Each team receives a different random target list.
• Collecting a target gives the opposing team 64 of that block.
• Reward blocks are placed in the opposing team's shared chests.

This mode creates additional interaction between the two teams and can help both teams continue progressing.

Racing Mode

• Both teams receive the same targets in the same order.
• Collecting a target does not give blocks to the opposing team.

This mode provides a more direct race under identical objectives.

Speed Mode

Speed Mode can be enabled together with either main game mode.

Players receive additional starting equipment and effects, including:

• Silk Touch iron pickaxe
• Cooked beef
• Damaged elytra
• Mending book
• Haste V

Each collected block is worth 3 points instead of 1.

Features

Team Utilities

• Configurable shared team chests
• Teleportation between teammates
• Shared team waypoints
• Biome and structure locating
• Target block rerolls
• Random teleportation
• Balanced random team assignment
• Purchasable Speed Mode supplies

Configurable Block Pools

BlockRacing includes five editable block pools:

• Easy blocks
• Medium blocks
• Hard blocks
• Dyed blocks
• End dimension blocks

Optional pools can be enabled before each game. Different block difficulties use dynamic generation weights as the game progresses, helping prevent difficult targets from appearing too early.

Per-Player Languages

Every player can independently use:

• English
• Simplified Chinese
• Automatic language detection based on the Minecraft client language

Menus, messages, titles, scoreboards, team prefixes, and block names are displayed using each player's selected language.

Use /language or /lang to change the display language.

Team Chat

While a game is active, normal chat is sent only to the player's team.

Players can communicate globally using:

• /shout <message>
• /all <message>
• @message
• !message

Recovery and World Reset

Unfinished games are automatically saved, including:

• Team scores
• Current targets
• Team storage
• Team waypoints
• Game progress

If the server stops unexpectedly, the game is restored when the server starts again.

After a completed game, players can vote with /restartgame. Once approved, BlockRacing safely shuts down the server and records a reset request. On the next startup, the previous worlds are moved into a dated backup directory before Paper generates new worlds.

Requirements

• Minecraft Java Edition 26.2
• Paper 26.2
• Java 25

BlockRacing directly uses Paper APIs and does not support Spigot.

Installation

1. Install Paper 26.2 and run it with Java 25.
2. Download BlockRacing.
3. Place the plugin JAR in the server's plugins directory.
4. Start the server.
5. Join the server and press Shift + F to open the game menu.

The following server.properties settings are recommended:

spawn-protection=0
pvp=false
level-seed=

• Disabling spawn protection allows players to break blocks near the world spawn.
• Disabling PvP keeps the game focused on collecting blocks.
• Leaving the seed empty allows a different world to be generated after each approved reset.

Commands

Command	Description
/menu	Open the main game menu
/menu chest [index]	Open the team chest menu
/menu waypoints	Open the waypoint menu
/menu roll	Request a target reroll
/menu locate	Purchase locate permission
/menu randomTP	Perform a random teleport
/language [auto|en_us|zh_cn]	Select the player's display language
/tp <player>	Teleport to a teammate
/randomteam [confirm]	Request or confirm balanced random teams
/shout <message>	Send a message to every player
/locatebiome <biome>	Locate a biome after purchasing permission
/locatestructure <structure>	Locate a structure after purchasing permission
/block <red|blue> <index>	Display complete information about a target block
/waypoint remove <index>	Remove a team waypoint
/restartgame	Vote to reset the game and worlds

BlockRacing replaces /tp with its teammate teleport command. Use /teleport or /minecraft:tp for Minecraft's original teleport command.

Configuration

The primary configuration files are located in:

plugins/BlockRacing/

Important files include:

config.yml
lang.yml
EasyBlocks.txt
MediumBlocks.txt
HardBlocks.txt
DyedBlocks.txt
EndBlocks.txt
zh_cn.json
en_us.json

The following options can be configured:

• Target block quantity
• Enabled block pools
• Game mode
• Speed Mode
• Number of shared chests per team
• Number of shared waypoints per team
• Maximum rerolls per team

Most game settings should be changed through the in-game preparation menu.

Updating

Replacing only the plugin JAR does not automatically update existing configuration and language files.

Before updating:

1. Back up the plugins/BlockRacing directory.
2. Delete the old generated files if they have not been customized, or manually merge custom changes into the latest default files.
3. Do not update only the version number inside an old configuration file.

Using outdated configuration or language files may cause new settings and messages to be unavailable.

Support and Source Code

• Source code
• Bug reports and feature requests
• Discord: ikarion1
• QQ: 2784628010

License

BlockRacing is licensed under the GNU Affero General Public License v3.0.