Home

Welcome to the Swapocalypse Wiki! Here on the Home page, you'll find a simple overview of everything—similar to the README, but with more depth. For additional details, use the sidebar or follow hyperlinks to relevant sections. If you still have questions or need help, open a GitHub Discussion.

📥 Installation

You can install the datapack through Modrinth (recommended) or via GitHub Releases.

If you install through the Modrinth app, the datapack may automatically be placed in the instance’s datapacks folder (if using Fabric/Forge, etc.). Unless you're using a global datapack loader, you'll need to manually move it to the world’s saves/[world]/datapacks folder.

When you download the .zip file, unzip the contents as a folder into the saves/[world]/datapacks folder of the world you want to run it in. If you don't know where to find this folder, follow the Installation page guide.

Once in-game, just run /reload to see the title and [New Game] button popup.

⚙️ Settings

By default, the [New Game] will be greyed out to all users. Whoever is an operator of the world can run /tag [player_name] add op, which will allow that player to change any settings and start the game. The reason this system exists is so only one or a few players can change the settings at a time, since this datapack supports unlimited players. Players that do not have the op tag will still be able to see what settings are set to.

The settings the datapack currently supports are below. Note that under the Recommended may not be super recommended, but are made as a guideline to keep settings being set to the extreme without realising.

Setting	Description	Options	Recommended
Worldborder Size	Sets the world border size. Automatic sets it to player_count * 1500.	Automatic or 1 – 1,000,000,000	Automatic, 100 – 1,000,000
Max Deaths	Number of deaths before a player is eliminated and is set to spectator mode. The gamerule doImmediateRespawn is turned on so that players cannot cheat by sitting on the death screen.	1 – 10,000	1 – 20
Nether Travel	Allows players to enter the Nether. If set to false, any portal that a player walks into will automatically be broken. However, mobs and items can still go through portals.	true / false	(User preference)
Swap Interval	Time (in seconds) between swaps. Currently, there is no way to have swaps at a random time.	10 – 50,000	20 – 10,000
Swap Announcement	If alerts before swapping should appear.	Never, 5-Second Countdown	(User preference)
Timer Display	How the game timer appears. Using this, players can theoretically know when the next swap will be. Starts counting when the game starts.	No Display, Show in Actionbar	(User preference)
Max Health	Sets player health limit, in half-hearts. Minecraft's max is 1024, which is 512 hearts. Anything over 60 hearts will cover the player's screen, and may interfere with their experience.	1 – 1024	1 – 100
Hunger	Enables or disables hunger mechanics. If false, players have infinite Saturation II. Having no hunger can cause players to constantly regenerate.	true / false	true

To start a new game, select the [New Game] button in chat. A random player will be chosen to center the worldborder around, and all other players will be spread around that area. Any currently running game will terminate. All settings will be ratined and are saved into the data storage swap:settings.

Number-based settings change in different step sizes. For instance, changing small numbers may only change them by 1 at a time, but larger number may change in step sizes of 1000. You can always set a custom value by clicking on the actual number. You will then be prompted to run a /trigger command to get input. Only values within the Options part of the table above will be accepted. Anything outside of the Recommended part will ask you if you are sure you would like to change it to this - for instance a swap interval of 50,000 seconds is almost 14 hours, which is definitely way too high - unless maybe you turn up the tick speed.

Boolean settings will just switch from true to false and vice-versa when clicked.

Dropdown settings allow to change them, or reset to the default.

To set players as spectators, or remove them from being spectators, just run /tag [player_name] [add/remove] spectator.

Once all settings are configured, click [Start Game] at the top to begin!

🎮 Playing the Game

All players (excluding spectators) will be randomly teleported within the worldborder. The distance between each player, and the distance between the worldborder edge and players will be automatically calculated based on the player count and worldborder size.

At each swap time, each player will be swapped with a different random player using the Fisher-Yates shuffle.

When there is one player left, the game will end and they will be awarded with the win.