[MINIGAME] GUNGAME | ARMS RACE 1.0.0

The GunGame plugin provides comprehensive functionality for arena creation, leveling, respawning, and matchmaking. It integrates with a broader "MinigameCore" plugin to facilitate these features. [THIS IS A MINIGAME]

THIS PLUGIN REQUIRES MINIGAMECORE IN ORDEN TO WORK!

Features
Arena Management: Supports creating and managing multiple arenas with specified properties such as lobby positions, spawn points, and player capacities.
Dynamic Leveling and Kits: Players can progress through levels within each match, with each level granting access to predefined kits consisting of clothing, weapons, and ammunition.
Matchmaking and Arena Status: Allows players to join or leave games, manages player counts per arena, and handles arena states (waiting, playing, stopped).
Admin Commands: Provides administrators with commands to configure and manage arenas and gameplay settings directly through in-game chat.
Gameplay Mechanics: Manages player health, inventory, respawn logistics, and teleportation to ensure fluid game progression and fair play.
UI Integration: Includes in-game user interfaces for scoreboards and winner announcements, enhancing the gameplay experience.
Event Handling: Robust event handling for player deaths, respawns, and match conclusions, including automatic arena resets and kit reassignments.
Chat: Private chat in arenas,  Players can only read the chat of players in the same arena.

Configurations
FinalLevel: Defines the final level to end the match.
TimeLimit: Defines the time limit to end the match.
Kits: Define kits for each level.

Admin Commands
/add_gg_arena <name> <radius>: Starts the creation of a new arena
/add_gg_spawnpoint: Adds a spawn point to the currently edited arena.
/add_gg_lobby: Sets the lobby position for the current arena.
/add_gg_max_players <number>: Sets the maximum player limit for the arena.
/add_gg_create <name>: Finalizes the creation of the arena and saves it.

- *  Arena Cache: Temporary storage for arena settings during creation before they are committed to the permanent configuration. * -

Files Path
GunGame Config:  /carbon/data/Minigames/GunGame/Config.json
GunGame DB:  /carbon/data/Minigames/GunGame.db


Config file

 

{
  "FinalLevel": 20,
  "TimeLimit": 300,
  "Kits": {
    "0": {
      "Clothes": [
        "hazmatsuit"
      ],
      "Weapons": [
        "pistol.revolver"
      ],
      "Ammo": {
        "ammo.pistol": 128
      }
    },
    "1": {
      "Clothes": [
        "hazmatsuit"
      ],
      "Weapons": [
        "pistol.semiauto"
      ],
      "Ammo": {
        "ammo.pistol": 128
      }
    },
    "2": {
      "Clothes": [
        "hazmatsuit"
      ],
      "Weapons": [
        "t1_smg"
      ],
      "Ammo": {
        "ammo.pistol": 128
      }
    },
    "3": {
      "Clothes": [
        "hazmatsuit"
      ],
      "Weapons": [
        "smg.2"
      ],
      "Ammo": {
        "ammo.pistol": 128
      }
    },
    "4": {
      "Clothes": [
        "hazmatsuit"
      ],
      "Weapons": [
        "shotgun.double"
      ],
      "Ammo": {
        "ammo.shotgun": 32
      }
    },
    "5": {
      "Clothes": [
        "hazmatsuit"
      ],
      "Weapons": [
        "shotgun.pump"
      ],
      "Ammo": {
        "ammo.shotgun": 32
      }
    },
    "6": {
      "Clothes": [
        "hazmatsuit"
      ],
      "Weapons": [
        "shotgun.spas12"
      ],
      "Ammo": {
        "ammo.shotgun": 32
      }
    },
    "7": {
      "Clothes": [
        "hazmatsuit"
      ],
      "Weapons": [
        "pistol.python"
      ],
      "Ammo": {
        "ammo.pistol": 128
      }
    },
    "8": {
      "Clothes": [
        "hazmatsuit"
      ],
      "Weapons": [
        "pistol.m92"
      ],
      "Ammo": {
        "ammo.pistol": 128
      }
    },
    "9": {
      "Clothes": [
        "hazmatsuit"
      ],
      "Weapons": [
        "revolver.hc"
      ],
      "Ammo": {
        "ammo.rifle": 128
      }
    },
    "10": {
      "Clothes": [
        "hazmatsuit"
      ],
      "Weapons": [
        "rifle.semiauto"
      ],
      "Ammo": {
        "ammo.rifle": 64
      }
    },
    "11": {
      "Clothes": [
        "hazmatsuit"
      ],
      "Weapons": [
        "rifle.sks"
      ],
      "Ammo": {
        "ammo.rifle": 64
      }
    },
    "12": {
      "Clothes": [
        "hazmatsuit"
      ],
      "Weapons": [
        "smg.thompson"
      ],
      "Ammo": {
        "ammo.pistol": 128
      }
    },
    "13": {
      "Clothes": [
        "hazmatsuit"
      ],
      "Weapons": [
        "smg.mp5"
      ],
      "Ammo": {
        "ammo.pistol": 128
      }
    },
    "14": {
      "Clothes": [
        "hazmatsuit"
      ],
      "Weapons": [
        "rifle.lr300"
      ],
      "Ammo": {
        "ammo.rifle": 64
      }
    },
    "15": {
      "Clothes": [
        "hazmatsuit"
      ],
      "Weapons": [
        "rifle.m39"
      ],
      "Ammo": {
        "ammo.rifle": 64
      }
    },
    "16": {
      "Clothes": [
        "hazmatsuit"
      ],
      "Weapons": [
        "rifle.ak"
      ],
      "Ammo": {
        "ammo.rifle": 64
      }
    },
    "17": {
      "Clothes": [
        "scientistsuit_heavy"
      ],
      "Weapons": [
        "lmg.m249"
      ],
      "Ammo": {
        "ammo.rifle": 128
      }
    },
    "18": {
      "Clothes": [
        "gingerbreadsuit"
      ],
      "Weapons": [
        "rifle.bolt"
      ],
      "Ammo": {
        "ammo.rifle": 64
      }
    },
    "19": {
      "Clothes": [
        "hazmatsuit.frontier"
      ],
      "Weapons": [
        "rifle.l96"
      ],
      "Ammo": {
        "ammo.rifle": 64
      }
    },
    "20": {
      "Clothes": [
        "attire.egg.suit"
      ],
      "Weapons": [
        "pistol.eoka"
      ],
      "Ammo": {
        "ammo.handmade.shell": 16
      }
    }
  }
}