Compatibility
Minecraft: Java Edition
1.21–1.21.7
1.20.x
1.19.x
1.18.x
Platforms
Creators
Details
Description
GunGame is a fast-paced, free-for-all, competitive minigame where players level up by eliminating opponents. It’s inspired by similar modes in shooter games like Call of Duty, but adapted for Minecraft’s mechanics.
Core Gameplay
- Start with basic gear: Everyone begins with low-tier weapons and armor.
- Level up with kills: Each kill upgrades your equipment; better swords and armor.
- Watch your step: Falling into water or dying resets your level, adding a high-stakes twist.
Features
- Level Progression: Players advance through levels by getting kills, unlocking new kits and weapons.
- Configurable Kits: Define kits for each level in
levels.json
. - Shop System: Players can buy effects and items using in-game currency (Vault required).
- Statistics: Tracks kills, deaths, and highest level for each player (SQLite backend).
- Admin Commands: Manage player stats and reset data.
- Sounds & Messages: Customizable via
config.json
andlang.json
.
Installation
- Install Vault (required), some plugin utilizing Vault's economy (like EssentialsX, required) and Placeholder API (optional)
- Place the plugin JAR in your server's
plugins
folder. - Start the server to generate default config files.
- Edit
config.json
,levels.json
, andlang.json
in the plugin's data folder to customize. - Reload the plugin.
Configuration
config.json
: General settings, shop items, sounds, and worlds.levels.json
: Define kits for each level (armor, weapons, enchants).lang.json
: Customize all plugin messages.
Commands
/gungame <reset|stats> <player> <set|add> <number> <kills|deaths|levels>
Requiresgungame.admin
permission.
Data
- Player stats are stored in
stats.db
(SQLite) in the plugin folder. MySQL support is planned