# \ud83d\udd2b Arms Race (Mini-Game Mod)
\n**\u26a0\ufe0f EARLY ALPHA \/ EXPERIMENTAL:** *This mod is currently in early development. Core mechanics work, but full compatibility with other mods is still being tested. Bug reports and feedback are highly appreciated!*<\/p>\n
Welcome to **Arms Race** \u2014 a fully customizable, server-side friendly mini-game mod for NeoForge! <\/p>\n
Bring the classic “Gun Game” experience to your Minecraft server. Players battle each other to upgrade their weapons. The first player to get a kill with the final weapon on the list wins the match!<\/p>\n
This mod is an independent core. It relies on vanilla mechanics, meaning it can technically issue ANY item as a weapon (Vanilla swords, bows, etc.). <\/p>\n
### \u2728 Current Features
\n* **Customizable Arenas:** Create multiple arenas via a simple JSON config.
\n* **Team Support:** Set up Free-For-All or Team Deathmatch modes.
\n* **Custom Weapon & Armor Ladders:** Define your own progression list using item IDs. You can configure automatic armor equipping and extra items (like ammo or shields) for each level!
\n* **Dynamic UI:** Built-in clean Scoreboard to track kills, lobby status, and warmup timers.
\n* **Safe Environment:** Configurable block-breaking protection and spawn point management.<\/p>\n
### \ud83d\ude80 Roadmap \/ Planned Features
\nSince the mod is in its early stages, here is what is planned for the future updates:
\n* **\ud83d\udd2b Weapon Mods Compatibility:** Thorough testing and guaranteed support for heavy gun mods like **Timeless and Classics Zero (TaC:Z)** and **Vic’s Point Blank**.
\n* **\ud83c\udf10 Cross-Loader Support:** Porting the mod to **Fabric** (potentially using Architectury API) and updating to other Minecraft versions.
\n* **\ud83d\udd0c Plugin Compatibility:** Ensuring seamless work with popular server plugins (e.g., LuckPerms, economy, and anti-cheats).
\n* **\ud83c\udfc6 End-Game Polish:** Fancy victory screens, post-match statistics, and rewards.<\/p>\n
### \ud83d\udcdc Commands (Requires OP \/ Permission Level 2 for setup) ### \ud83d\udee0\ufe0f Configuration Guide The config allows deep customization of weapons, team spawns, armor progression, and even specific inventory slots!<\/p>\n **Example Configuration:** #### Advanced Parameters Explained:<\/p>\n `lobbyCoord` – The waiting area where players spawn before the match starts or after they leave.<\/p>\n `weapons` – The progression ladder. You can now define additionalItems for specific weapon levels (e.g., giving 30 rounds of ammo only when a player reaches the AK-47 level!).<\/p>\n `armor` – Equip players with specific armor pieces at specific levels.<\/p>\n `additionalItems` (Global) – Items given to all players at the start of the match and on every respawn (like building blocks or food). Define the count and the exact inventory slot.<\/p>\n","protected":false},"excerpt":{"rendered":" A fully customizable, standalone Arms Race \/ Gun Game mini-game for your server. Works perfectly with vanilla items or any weapon mods like TaC:Z! ALPHA VERSION OF MOD!!!<\/p>\n","protected":false},"featured_media":19685,"template":"","meta":{"_minecraft_slug":"armsrace","_minecraft_project_id":"XsBwbtLQ","_minecraft_author":"AleksTi","_minecraft_license":"MPL-2.0","_minecraft_downloads":20,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"armsrace.zip","_minecraft_size_bytes":125339,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-16T13:06:10.020897Z","_minecraft_date_created":"2026-05-06T23:50:21.231470Z","_minecraft_date_modified":"2026-05-10T07:57:29.933995Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/armsrace","_minecraft_icon_attachment_id":19685,"_minecraft_imported_at":"2026-05-31T20:35:54+00:00","_minecraft_import_hash":"6fefb828e92c737d541366a4ceb0ca91","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,89,866,158],"mod_loader":[160],"minecraft_version":[37],"class_list":["post-19684","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-game-mechanics","mod_category-minigame","mod_category-neoforge","mod_loader-neoforge","minecraft_version-1-21-1"],"yoast_head":"\n
\n* `\/armsrace create
\n* `\/armsrace join` – Joins an available lobby.
\n* `\/armsrace leave` – Leaves the current lobby.
\n* `\/armsrace start` – Force starts the game (bypasses the warmup).
\n* `\/armsrace setteam
\n* `\/armsrace reload` – Reloads the JSON config without restarting the server!<\/p>\n
\nWhen you run the mod for the first time, it will generate an advanced default configuration file located at `config\/armsrace_arenas.json`. <\/p>\n
\n“`json[
\n {
\n “templateId”: “vanilla”,
\n “lobbyCoord”: { “x”: 137.0, “y”: -54.0, “z”: 0.0 },
\n “maxPlayers”: 10,
\n “warmupTime”: 60,
\n “teams”:[
\n {
\n “teamId”: “1”,
\n “colorCode”: “\u00a7b”,
\n “spawns”:[ { “x”: 143.0, “y”: -57.0, “z”: 28.0 } ]
\n },
\n {
\n “teamId”: “2”,
\n “colorCode”: “\u00a7a”,
\n “spawns”:[ { “x”: 80.0, “y”: -60.0, “z”: 8.0 } ]
\n }
\n ],
\n “weapons”:[
\n {
\n “item”: “minecraft:wooden_sword”
\n },
\n {
\n “item”: “minecraft:iron_sword”,
\n “additionalItems”:[
\n { “item”: “minecraft:grass_block”, “count”: 3, “slot”: 2 }
\n ]
\n },
\n {
\n “item”: “minecraft:diamond_sword”
\n }
\n ],
\n “armor”:[
\n { “helmet”: “minecraft:iron_helmet”, “level”: 0 },
\n { “chestplate”: “minecraft:iron_chestplate”, “level”: 1 }
\n ],
\n “additionalItems”:[
\n { “item”: “minecraft:cobblestone”, “count”: 54, “slot”: 7 }
\n ]
\n }
\n]
\n“`<\/p>\n