Fayaz's Lockout

Fayaz's Lockout

Multiplayer - 2+ Players (no limit)

Fayaz's Lockout is a competitive lockout-style game mode with multiple play modes where players race to claim unique objectives before their opponents.

Set a goal (for example, 5) and race against other players to reach that number first. Once a specific objective is claimed by any player, no one else can score points with that same objective again.

---

🎯 Game Modes

💀 Death Mode

Die in as many unique ways as possible before your opponents do.

Deaths can be matched by two methods:

• SOURCE: Matches by damage type + entity type
  • Burned to death while fighting Zombie is the same as burned to death.
• MESSAGE: Matches by death message text with player names removed
  • Burned to death while fighting Zombie is DIFFERENT from burned to death.

Examples of unique deaths:

• Killed by Iron Golem
• Fell from a high place
• Burned to death
• Blown up by Creeper
• Drowned

⚔️ Kills Mode

Kill as many unique mob types as possible before your opponents do.

Each different mob type counts as one objective:

• Zombie, Creeper, Skeleton, Iron Golem, Warden, etc.

❤️ Breed Mode

Breed as many unique mob types as possible before your opponents do.

🛡️ Armor Mode

Wear complete armor sets or individual pieces before your opponents do.

Two submodes:

• SET: Claim a material by wearing a complete matching armor set (helmet, chestplate, leggings, boots)
• PIECE: Claim a material by wearing any single piece of that armor type

Available materials:

• Leather, Chainmail, Iron, Gold, Diamond, Netherite (6 total)

🏆 Advancements Mode

Unlock unique advancements before your opponents do.

Race to complete advancements like:

• Stone Age, Acquire Hardware, Diamonds!, We Need to Go Deeper, etc.
• 125 advancements available in vanilla Minecraft
• Recipe unlocks are excluded

🍖 Foods Mode

Eat unique food types before your opponents do.

Claim foods by consuming them:

• Apples, Bread, Cooked Beef, Golden Carrots, etc.
• 40+ food items in vanilla Minecraft
• Includes drinks like Milk and Honey

🎯 Game Settings

Switch!

• Switch mode is a unique new mode where everytime anyone gets a goal, everyone in the game switches places with another player on the server. But it's not just switching place, you also switch inventories, effects, health/hunger, and respawn point!
  • Enable it with:

  /lockout switch true
  

Mixed

• Mixed mode has all the other modes enabled by default, but you can enable or disable them using:
  • /lockout configure mixed include <mode>
  • /lockout configure mixed exclude <mode>

---

🎮 How It Works

• Each player earns 1 point per unique objective
• An objective can only be scored once per game, globally
• The first player to reach the target goal wins
• Supports 2+ players competing simultaneously. No limit.
• Each player has a unique custom color to track their progress on the HUD

---

▶️ Commands

Setting up a game:

1. Set the goal:

/lockout configure goal <number>

Example: /lockout configure goal 5
Default is 5. No upper limit.

2. Choose the game mode:

/lockout configure mode kills
/lockout configure mode armor set          (full matching sets required)
/lockout configure mode armor piece        (any single piece claims that material)
/lockout configure mode advancements
/lockout configure mode foods
/lockout configure mode death source       (matches by damage type)
/lockout configure mode death message      (matches by death message text)
/lockout configure mode mixed              (All modes combined)

3. Add players:

/lockout player add <player> <color>

Color options:

• Named colors: red, orange, yellow, lime, green, cyan, blue, purple, magenta, pink, white, gray, black
• Hex codes: #FF5555, 0xAABBCC, or FF5555
• Optional: If no color is specified, a default color is assigned
• Unique: Each player must have a different color

Examples:

/lockout player add @p red
/lockout player add Fayaz
/lockout player add Kristaugh #00FF00
/lockout player add Dream 0xFFAA00

4. (Optional) Set a custom spawn point:

/lockout spawnpoint <x> <y> <z>
/lockout spawnpoint

• With coordinates: Sets spawn to those coordinates
• Without coordinates: Sets spawn to your current location
• If not set: Defaults to world spawn

5. Start the game:

/lockout start

When the game starts:

• All players are teleported to the spawn point
• Inventories are cleared
• Health and hunger are restored to full
• Players are frozen during a 3-second countdown (3, 2, 1, GO!)
• After countdown, players can move and the game begins

⚠️ Requires at least 2 players added and a goal set (> 0)

---

Managing players:

Modify a player's color:

/lockout player modify <player> <color>

Remove a player:

/lockout player remove <player>

---

During gameplay:

Pause the game manually:

/lockout pause

Unpause the game:

/lockout unpause

Auto-pause on disconnect:

• If a participating player disconnects, the game automatically pauses
• All remaining players are frozen
• A title message displays: "|| PAUSED - Waiting for [player] to reconnect"
• When the player reconnects, the game automatically resumes

Stop the current match:

/lockout stop

Ends the current match but keeps all configuration (goal, mode, players, spawn point)

Reset everything:

/lockout reset

Completely resets: stops the game and clears all configuration

View current status:

/lockout status

Shows:

• Active/paused status
• Current mode and submode
• Goal
• Player count
• Each player's score and color

---

🎮 Example Game Setups

Death Mode:

/lockout configure goal 5
/lockout configure mode death source
/lockout spawnpoint
/lockout player add Player1 red
/lockout player add Player2 blue
/lockout start

Kills Mode:

/lockout configure goal 10
/lockout mode kills
/lockout player add Steve
/lockout player add Alex
/lockout start

Armor Mode (Set):

/lockout goal 3
/lockout configure mode armor set
/lockout player add Player1 red
/lockout player add Player2 blue
/lockout start

Armor Mode (Piece):

/lockout configure goal 6
/lockout configure mode armor piece
/lockout player add Player1 red
/lockout player add Player2 blue
/lockout start

Advancements Mode:

/lockout configure goal 15
/lockout configure mode advancements
/lockout player add Player1 red
/lockout player add Player2 blue
/lockout start

Foods Mode:

/lockout configure goal 10
/lockout configure mode foods
/lockout player add Player1 red
/lockout player add Player2 blue
/lockout start

Mixed Mode:

/lockout configure goal 15
/lockout configure mode mixed
/lockout configure mixed exclude foods
/lockout player add Player1 red
/lockout player add Player2 blue
/lockout start

---

📊 HUD Display

During an active game, the HUD shows:

• Each player's progress boxes in their custom color
• Icons for each claimed objective:
  • Death mode: Shows the item/mob that killed them
  • Kills mode: Shows spawn eggs for killed mobs
  • Armor mode: Shows the chestplate of claimed armor types
  • Advancements mode: Shows related items (knowledge book default)
  • Foods mode: Shows the food item that was eaten

In mixed mode, an icon overlay shows the mode of each goal, such as a sword for kills or a skull for deaths

When paused, a large title appears in the center showing which player is being waited for.

---

📦 Installation

⚠️ Required on both client and server

All players must have the mod installed for lockout to function correctly. The mod must be present on both the server and all clients.

Install all dependencies in both places too.

---

📦 Dependencies

⚠️ Fabric API is required

---

🧠 Strategy Tips

Death Mode:

• Think outside the box — environmental deaths matter
• Race to claim common deaths early (falling, fire)
• Seek out caves if it's not night time!
• Creative death combinations can secure victory

Kills Mode:

• Plan efficient mob hunting routes
• Caves are once again your friend during the day!
• Consider biomes where rare mobs spawn
• Don't waste time on already-claimed mobs

Armor Mode:

• Don't just focus on one material at a time - you need to stop your opponents!
• Rush cheap materials (leather, gold) for easy early points
• In SET mode, aim for 27.
• In PIECE mode, just make boots!

Advancements Mode:

• Prioritize quick, easy advancements early (stone/tools)
• Plan advancement chains (some unlock others)
• Check the advancement tree to see what's possible
• Or try to speedrun the game!

Foods Mode:

• No need for farms, you just need one!
• Fishing can provide multiple unique foods quickly
• Golden foods and suspicious stews count
• Villages are your best bet for crops
• Remenber to eat both raw and cooked meats!

General:

• Watch what objectives others have claimed on the HUD
• The pause system means you don't lose progress if someone disconnects
• Different modes reward different playstyles - choose based on your strengths

---

Good luck, and may the best player win! 🏆