What is GG in Minecraft?
In GunGame (GG), every player fights for themselves - no teams, no alliances, just pure PvP. Players instantly respawn, jump back into action, and compete for kills, points, rank-ups, and bragging rights. A great GunGame feels smooth, fair, and snappy. That's exactly what EasyGG is built for.


Why EasyGG?
EasyGG focuses on admin productivity and player flow:

• ✅ Zero-friction admin tools: one-command safe-zone editor, per-world spawn control, map rotation with countdowns, and map-specific kits.
• Progression & feedback: player level tracking, killstreak broadcasts, action bar messages, scoreboard and tablist.
• ⚡ Modern & lightweight: no NMS, up-to-date Spigot API support, optimized performance, simple config.

Feature Highlights

• Safe Zones — Protect spawn/areas with a simple two-point selection flow.
• Map Rotation — Automated rotation with messages, countdowns, and teleports.
• Kits & Map Kits — Create kits from inventory and assign per-world.
• Stats & Levels — Track kills, deaths, K/D, and player level.
• Killstreaks — Broadcast milestones (configurable in config.yml).
• Leaderboard — Built-in top list command.
• Powerups — World spawners with cooldown, actionbar feedback, and multiple types (speed, jump, strength, etc.).
• DeathBlocks — Optional instakill on touch for configured blocks/liquids (e.g., water, lava).
• Combat Logging — Tag timer + optional punishments/commands.
• Scoreboard & Tablist — Show player stats/rank; configurable formatting.
• Join Flow & Spawn — Spawn countdown, world-specific spawns, optional force-adventure-mode, and QoL rules (prevent drops/breaking/durability).
• Build Mode — Admins can toggle build mode for editing during GG.
• Chat Control — Quick clear your own chat or global chat via admin commands.
• Game Rule Loader — Automatically (re)applies sensible world gamerules on startup.
• Config-First — Everything is configurable in config.yml.

Requirements & Compatibility

• Spigot/Paper 1.21+
• Java 21 recommended (built for modern runtimes)
• Optional: MySQL/MariaDB if you enable database storage (driver included)

Note: EasyGG is designed for network setups. The scoreboard, join/leave handling, and related messages/mechanics are always active by design. ℹ️


Installation

1. Place the EasyGG jar into your server's plugins folder.
2. Start the server once to generate config files.
3. Open plugins/EasyGG/config.yml and adjust settings (messages, killstreaks, chat format, combat tag, powerups, leaderboard, etc.).
4. (Optional) Enable MySQL in the config and set credentials (details below).
5. Create kits, set map spawns, and (optional) define safe zones.

Quick Start ⚡

• Set spawn for your current world: /gg setspawn
• Create a kit from your inventory: /gg kit create <name> <level>
• (Optional) Define a safe zone: /gg zone set (twice to complete the two corners)
• (Optional) Choose default active world (when map rotation is off): /gg activemap <world>
• (Optional) Start map rotation: /gg mapchange start
• (Optional) Add a powerup spawn: look at a plate and run /gg powerup create <id> [cooldown]

Maps & Safe Zones

• Spawn Per World
  /gg setspawn sets the GG spawn point for the current world. Players can use /spawn; a configurable countdown prevents abuse.
  
• Safe Zone Setup
  • Stand at corner 1 and run: /gg zone set
  • Stand at the opposite corner and run: /gg zone set again
  • Done — the region is protected, with clear titles on enter/leave
  If you make a mistake: /gg zone del cancels the setup.
  Zones are saved per-world and automatically loaded on server start.
  
• Active Map (Join Behavior, No Rotation)
  If automatic map rotation is not used, the world configured under ActiveWorldName in config.yml is treated as the active GG world. All players are teleported to this world on join. For the best GG experience, make sure this world has a properly defined safe zone and spawn.
  
  Use /gg activemap <world> to update the default active world. This command immediately updates the config value and teleports all online players to the newly set world.
  
  If you do not enable map rotation and also leave ActiveWorldName unset/unused, players will join in a random/default world as defined by the server. This behavior is not controlled by EasyGG.
  
• Map Rotation
  Use /gg mapchange start to begin rotation across your configured worlds, with broadcasted countdowns and automatic teleports. Stop anytime with /gg mapchange stop. If enabled in config and at least two maps are available, rotation can auto-start on server boot.
  When map rotation is enabled, ActiveWorldName is ignored and players will always join the current rotating map.

Kits

• Create from Inventory: Equip items/armor, then run /gg kit create <name> <level>.
• List Kits: /gg kit list
• Delete Kit: /gg kit delete <name>
• Players can use assigned map kits automatically on join.

Stats, Levels & Killstreaks

• Stats GUI: /stats to view personal stats (kills, deaths, K/D, level).
• Levels: Player level increases/decreases on kills/deaths (see config keys).
• Killstreaks: Broadcast messages at configured thresholds in GG.Killstreaks.

[/list]


Combat Logging Control
Tag players in combat for a set duration. Optionally execute server commands, deduct levels, or reset stats if they log out.
Configure under GG.CombatLogging in config.yml.
Common options:
• TagDurationSeconds: how long a player stays in combat after the last hit.
• Punishments.CommandsEnabled + Punishments.Commands: run console commands (e.g., warn/kick).
• Punishments.ResetAllStatsEnabled: reset the offender's stats.
• Punishments.DeductLevelsEnabled + DeductLevels: remove levels on combat logout.


Scoreboard and Tablist

• Scoreboard: Toggle and customize titles/lines in GG.Scoreboard.
• Tablist: Show level and format names (e.g., Format: '&f[Lv %LEVEL%] %NAME%').

Storage Options

• Flatfile (Default) — Simple YAML storage; no setup required. Files: kits.yml, stats.yml, levels.yml, killstreaks.yml.
• MySQL/MariaDB (Optional) — Enable in config.yml under GG.MySQL.

Optional Chat Styling
You can optionally enable EasyGG's chat formatting and styling in config.yml:

• Path: GG.Chat
• Enabled: true/false
• Format: e.g. "%PREFIX% [Lv %LEVEL%] %PLAYER%&7: %MESSAGE%"
• DefaultPrefix: e.g. "&7"

When enabled, EasyGG will format player chat according to your Format. You can include rank/prefix placeholders.


Commands & Usage

• /stats — View your GG stats
• /spawn — Teleport to the map spawn (with optional countdown/cooldown)
  
• /gg leaderbord — Open the leaderboard GUI (top 3)
  
• /gg
  • /gg — Info & help
  • /gg tp <world> — Teleport to a world
  • /gg activemap <world> — Set the default active world (updates ActiveWorldName) and teleport all players there
  • /gg zone set — Start/complete a safe-zone selection
  • /gg zone del — Cancel a safe-zone selection
  • /gg spawn — Teleport to current world’s map spawn
  • /gg setspawn — Set/update spawn for current world (admin)
  • /gg build — Toggle build mode (admin)
  • /gg mapchange <start|stop|state> — Control map rotation
  • /gg deathblocks <on|off> — Toggle instakill blocks/liquids
  • /gg powerup create <powerupname> [cooldown] — Create a powerup spawn at the plate you are looking at (admin)
  • /gg powerup remove <powerupname> — Remove the powerup spawn at the plate you are looking at (admin)
  • /gg kit list — List kits and map assignments
  • /gg kit create <name> <level> — Create a kit for a specific level
  • /gg kit delete <name> — Delete a kit (admin)
  • /gg kit setmap <name> — Assign kit to current world (admin)
  • /gg resetstats <stats|killstreaks|level|all> — Reset stats (admin)
  • /gg cc — Clear your own chat (admin)
  • /gg ccg — Clear global chat (admin)

Note: /gg resetstats lets you target a specific category or all.


API Documentation
You can find detailed API documentation in the documentation, including event subscription examples and integration tips.


Permissions Overview

• easygg.* — Full access
• easygg.gg — Use /gg (default: true)
• easygg.world.tp — World teleport (default: op)
• easygg.kit — Use kits (default: true)
• easygg.admin.kit — Manage kits (default: op)
• easygg.admin.setspawn — Set spawn (default: op)
• easygg.admin.cc — Clear chat (default: op)
• easygg.admin.zone — Manage safe zones (default: op)
• easygg.admin.resetstats — Reset player statistics (default: op)
• easygg.admin.build — Toggle build mode (default: op)
• easygg.admin.mapchange — Control map rotation (default: op)
• easygg.admin.activemap — Use /gg activemap (default: op)
• easygg.admin.chatclear — Use /gg cc and /gg ccg (default: op)
• easygg.admin.deathblocks — Toggle instakill blocks/liquids (default: op)
• easygg.admin.powerup — Manage powerup spawns (default: op)

Configuration Tips

• Adjust killstreak broadcasts under GG.Killstreaks.
• Customize scoreboard and tablist in their respective sections.
• Use the action bar kill messages to keep feedback snappy and non-intrusive.
• Configure powerups under GG.Powerups and use admin commands to place spawns.
• Toggle instakill blocks with GG.KillPlayerOnBlockTouch and set GG.DeathBlockList.
• Tune leaderboard defaults under GG.Leaderboard.