Lockout

!(https://cdn.modrinth.com/data/cached_images/52c12ba61bcbb16aeabbe1c80377256b7f367100_0.webp)

# Truffle's Minecraft Lockout !(https://img.shields.io/github/v/tag/truff1e/lockout?style=for-the-badge&label=Latest%20Version) !(https://img.shields.io/github/downloads/truff1e/lockout/total?style=for-the-badge&color=%23AA7E0F) !(https://img.shields.io/modrinth/dt/lockout?style=for-the-badge&label=Modrinth%20Downloads&color=%231CD96A)

## What is Lockout? Lockout is played on a random Minecraft world in survival mode. Two teams try to complete more than half the objectives on a board of typically 25 goals. The goals can be easy like 'Eat Apple' or as challenging as 'Enter End City'. Each goal is worth one point. Once one team completes a goal, the other team is "locked out" of that goal and can no longer earn a point for it. The first team to complete more than half the board wins.

This game was originally invented by SmallAnt and created by AtSign as a Forge mod. You can find the original mod on Curseforge (https://www.curseforge.com/minecraft/mc-mods/lockout), although it is no longer receiving updates. There is an (https://github.com/Specnr/lockout-fabric) for Fabric made by marin774 and specnr. This project recreates lockout in a data pack so that it can be played in 100% vanilla Minecraft. If you are looking for a traditional lockout experience, use one of the mods linked above. If you want to play on vanilla (or any mod loader of your choosing), read on.

Lockout was originally created by (https://www.youtube.com/@Smallant)!

I hope you enjoy!

## Installation & Setup Each data pack is one single-use lockout board. Simply download a board, (https://datapack.wiki/guide/installing-a-datapack), add players to teams, and play!

> NOTE > The current version of this project is for Java Edition version 1. 21. 8+. > Older versions provide support for 1. 21 through 1. 21. 4. > Bugrock is not supported. Data packs are a Java Edition exclusive feature.

> CAUTION > Do not install a lockout data pack on a pre-existing world. Lockout is intended to be played on a new world.

## Playing Lockout To play lockout, install the data pack on your world or on a server.

Players can use `/trigger join_team set <1 or 2>` to select their team while still in the lobby. You can manually add players to teams using `/team join 1 ` and `/team join 2 `.

> IMPORTANT > To start the game, run > ```/function lockout:game/start``` > or click the button that says "Start Lockout"

If a player joins late, and they can't see the lockout board, first add them to a team and have them relog.

> TIP > If a goal is bugged or you just want to give a player a specific goal, you can use `/execute as run function lockout:grant/name_of_goal`. Or alternatively you can revoke a goal that a player has already achieved with `/function lockout:revoke/name_of_goal`.

## Playing Blackout The data pack also allows you to start a Blackout game. Blackout is cooperative lockout. Complete the entire board to win. Everyone works together.

To play, follow the same steps as above to generate the data pack and load it into your world. Then run `/reload` and either click the button in chat that says "Start Blackout" or type ```/function lockout:game/start_blackout```

## Limitations Typically in lockout you have a compass to track players, however a compass is clunky to implement in a data pack. Instead you can use `/trigger locate` at any time to see players' coordinates during the game. In newer Minecraft versions, you can use the locator bar as well. This functionality can be disabed in the preferences menu.

There is no lockout board overlay like in the mod version. Press your advancements keybind (default is L) to see the lockout board. This is a data pack limitation.

With that being said, there are plenty of benefits to playing in vanilla. You can install any mod loader you want and your friends can join and play instantly without any tricky client-side setup.

## Resource Pack In order to make some of the goal icons more descriptive, this generator comes with an optional resource pack that utilizes some of the textures from the original lockout mod. (https://modrinth.com/resourcepack/lockout-resource-pack) I highly recommend using it, but it is not required to play.

## Known Issues Due to data pack limitations, there may be some issues with players logging off during the game, though I've done as much as I can to limit any problems from this. One such issue that may arise is if a player logs out during the game start sequence. If this happens and the player cannot move/jump after the game has started, try running `/execute as run function lockout:game/reset/attributes`

## Generator Due t