Machiavellian Minigames

(This Mod is still in its Alpha Stage; You may use it and send me Issues if found) Discord: https://discord.gg/APaDjvR7zY

Overview

Machiavellian Minigames is a modular minigame system for Minecraft 1.20.1 Forge that allows server administrators to create and manage various competitive minigames. The core system provides arena management, team management, and inventory isolation to ensure fair gameplay.

Currently, the mod includes the "Storm the Front" minigame, which features checkpoint capturing and Bossbar Management.

Setup Guide

Arena Setup

1. Create an Arena: /mm arena create <arena_name>

2. Set Arena Boundaries: /mm arena setbounds <arena_name> <pos1> <pos2>

Use coordinates or stand at the positions when running this command.

1. View Arena Information: /mm arena info <arena_name> /mm arena list

Team Setup

1. Create Teams: /mm team create <arena_name> <team_name> <color> Available colors: red, blue, green, yellow, purple, aqua, white, gray, black

2. Add Players to Teams:

/mm team addplayer <arena_name> <team_name> <player>

1. Set Team Spawns (inside arena): /mm team setspawn <arena_name> <team_name> <position>

2. List Teams: /mm team list <arena_name>

Checkpoint Setup (for Storm the Front)

1. Add a Checkpoint: /mm arena checkpoint <arena_name> <checkpoint_name> <pos1> <pos2> <type> Types: money, upgrade Example: /mm arena checkpoint myarena checkpoint1 100 64 100 110 70 110 money

How to Play: Storm the Front

Game Objective

Storm the Front is a team-based minigame where teams compete to control checkpoints across the arena and eliminate the opposing team's king.

Starting a Game

1. Start the Game: /mm game start <arena_name> storm

2. End the Game: /mm game end <arena_name>

3. Check Game Status: /mm game status

Gameplay Mechanics

1. Checkpoint Control: - Stand in a checkpoint zone to begin claiming it for your team - A boss bar will appear showing claim progress - Once captured, your team controls the checkpoint - Money checkpoints (gold) award diamonds every minute - Upgrade checkpoints (green) award emeralds every 5 minutes

2. Initial Capture Rewards: - Money Checkpoints: 3 diamonds - Upgrade Checkpoints: 2 emeralds

3. Resources: - Teams earn 5 resource points per checkpoint capture - Additional resources accumulate over time - The team with the most resources at game end wins

4. King Mechanics: - Each team has a designated king - If a king is eliminated, their team loses - Protect your king while trying to eliminate enemy kings

Game End

The game ends when:

• The time limit is reached
• A king is eliminated
• An admin forces game end with /mm game end <arena_name>

The team with the most resources wins!

Configuration

Configuration is stored in the config/machiavellianminigames.toml file.

Key settings include:

• Claim time for checkpoints
• Resource intervals
• Arena protection settings
• Anti-cheat settings

Commands Reference

Arena Commands

/mm arena create <arena_name>
/mm arena delete <arena_name>
/mm arena list
/mm arena info <arena_name>
/mm arena setcorner1 <arena_name>
/mm arena setcorner2 <arena_name>
/mm arena setlobby <arena_name>
/mm arena setspectator <arena_name>

Team Commands

/mm team create <team_name> <color>
/mm team delete <team_name>
/mm team list
/mm team setspawn <team_name> <arena_name>

Player Commands

/mm player addteam <player_name> <team_name>
/mm player removeteam <player_name>
/mm player list <team_name>

Game Commands

/mm game start stormthefront <arena_name> <duration_minutes>
/mm game end <arena_name>
/mm game status <arena_name>

Checkpoint Commands

/mm checkpoint create <checkpoint_name> <arena_name> <type>
/mm checkpoint delete <checkpoint_name> <arena_name>
/mm checkpoint list <arena_name>
/mm checkpoint setcorner1 <checkpoint_name> <arena_name>
/mm checkpoint setcorner2 <checkpoint_name> <arena_name>

Credits

Developed by mchivelli

Mod ID: machiavellianminigames