EasyGG - Easiest GunGame yet 0.1.2

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:

1. ✅ Zero-friction admin tools: two-point safe-zone editor, per-world spawn control, map rotation with countdowns, and level-based kits.
2. 🔥 Progression & feedback: player level tracking, killstreak broadcasts, action bar messages, scoreboard and tablist.
3. ⚡ Modern & lightweight: no NMS, Spigot API-based, optimized performance, simple config.

Feature Highlights

1. Safe Zones — Prevent PvP inside a configurable two-point area, with enter/leave titles.
2. Map Rotation — Automated rotation with messages, countdowns, and teleports.
3. Kits — Create kits from inventory and assign one kit to each player level.
4. Stats & Levels — Track kills, deaths, K/D, player level, and highest killstreak.
5. Killstreaks — Broadcast milestones with configurable thresholds.
6. Leaderboard — Built-in top-three GUI leaderboard using flatfile or MySQL data.
7. Powerups — World spawners with cooldowns, actionbar/title feedback, visual and sound effects, and multiple effect/item types.
8. DeathBlocks — Optional instakill behavior for configured blocks/liquids (for example, water or lava).
9. Combat Logging — Combat tag timer with optional commands, level deductions, and stat resets.
10. Scoreboard & Tablist — Show player stats and level-formatted names with independent toggles.
11. Join Flow & Spawn — World-specific spawns, configurable countdown, movement cancellation, combat restriction, optional force-adventure-mode, and item protection rules.
12. Build Mode — Admins can toggle build mode for editing during GG.
13. Chat Control — Clear personal or global chat through admin commands.
14. Game Rule Loader — Automatically applies sensible world gamerules on startup.
15. Config-First — Gameplay, messages, feedback, storage, and behavior are configured in config.yml.

Requirements & Compatibility

1. Verified compatible with Spigot/Paper 1.21 through 26+.
2. Built against Spigot API 1.16.5 and tested on modern server versions.
3. Current build targets Java 16 bytecode.
4. Optional MySQL/MariaDB storage. The MariaDB JDBC driver is declared as a server-downloaded plugin library.

Note: Join/leave handling and core GG mechanics are active by design. Scoreboard, tablist header/footer, and tablist level display have configuration toggles.

Installation
[list=1]Place the EasyGG jar into your server's plugins folder.Start the server once to generate config files.Open plugins/EasyGG/config.yml and adjust messages, killstreaks, chat, combat logging, powerups, leaderboard, and gameplay rules.(Optional) Enable MySQL in the config and set credentials.Create level kits, set map spawns, and (optional) define safe zones.
[/list]

Quick Start ⚡

1. Set spawn for your current world: /gg setspawn
2. Create a level kit from your inventory: /gg kit create
3. (Optional) Define a safe zone with /gg zone set twice, once at each corner.
4. (Optional) Choose the default active world when rotation is off: /gg activemap
5. (Optional) Start map rotation: /gg mapchange start
6. (Optional) Look at a plate and add a powerup spawn: /gg powerup create [cooldown]

Maps & Safe Zones

1. Spawn Per World
   /gg setspawn sets the GG spawn for the current world. Players can use /spawn. The countdown is configurable, movement cancels the teleport, and the post-teleport cooldown is currently fixed at 10 seconds.
2. Safe Zone Setup
   Stand at corner 1 and run /gg zone set, then stand at the opposite corner and run it again. The zone prevents player damage and shows enter/leave titles. Use /gg zone del to cancel an unfinished selection. Zones are saved per world and loaded on startup.
3. Active Map (No Rotation)
   When rotation is off, ActiveWorldName in config.yml is the default GG world and online players can be moved there with /gg activemap . When rotation is enabled, ActiveWorldName is ignored and players join the current rotating map.
4. Map Rotation
   /gg mapchange start begins rotation across configured maps with broadcasts, countdowns, and teleports. Stop it with /gg mapchange stop. Automatic startup requires rotation to be enabled and at least two maps to be available.

Kits

1. Create from Inventory: Equip items/armor, then run /gg kit create .
2. Delete Kit: /gg kit delete (a numeric level can also be targeted).
3. Each level can have one kit. The kit for a player's current level is applied automatically during the join/respawn flow.

Stats, Levels & Killstreaks

1. Stats GUI: /stats shows personal kills, deaths, K/D, and level. /stats views an online player's stats; the declared permission controls tab suggestions in the current build.
2. Levels: Levels increase on kills and decrease on deaths according to the configured values.
3. Killstreaks: Broadcast messages and record highest streaks at configured thresholds.
4. Combat tracking: Projectile kills and projectile combat tagging are supported.

Powerups
Powerup spawns can be created on the plate you are looking at. Configure cooldowns, feedback, effects, and definitions under GG.Powerups. Built-in IDs are: speed, jump, resistance, strength, regeneration, invisibility, absorption, freeze_grenade, double_level_next_kill, temp_kit_upgrade, night_vision, instant_heal, cleanse_negatives, levitation, and short_teleport.

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 include TagDurationSeconds, Punishments.CommandsEnabled with Punishments.Commands, Punishments.ResetAllStatsEnabled, and Punishments.DeductLevelsEnabled with DeductLevels.

Scoreboard and Tablist

1. Scoreboard: Toggle with GG.UseScoreboard and customize its title/lines in GG.Scoreboard.
2. Tablist: Independently toggle the header/footer and level-formatted names using GG.Tablist.

Storage Options

1. Flatfile (Default) — YAML files: kits.yml, stats.yml, level.yml, maps.yml, and killstreaks.yml. Safe-zone and combat-log managers may generate their own YAML data files.
2. MySQL/MariaDB (Optional) — Enable under GG.MySQL in config.yml.

Optional Chat Styling
EasyGG can format player chat through the chat listener. Configure Chat.Enabled and Chat.Format in config.yml. The prefix is read from GG.Prefix. Supported placeholders include %PREFIX%, %LEVEL%, %PLAYER%, and %MESSAGE%.

Commands & Usage

1. /stats — View your GG stats
2. /stats — View an online player's stats (online targets only)
3. /spawn — Teleport to the current world's map spawn
4. /gg leaderbord — Open the top-three leaderboard GUI
5. /gg — Show context-sensitive help
6. /gg tp — Teleport to a world
7. /gg activemap — Set the default active world and teleport online players there
8. /gg zone — Create or cancel a safe-zone selection
9. /gg setspawn — Set the current world's spawn (admin)
10. /gg build — Toggle build mode (admin)
11. /gg mapchange — Control map rotation
12. /gg deathblocks — Toggle death blocks (admin)
13. /gg powerup create [cooldown] — Create a powerup spawn (admin)
14. /gg powerup remove — Remove a powerup spawn (admin)
15. /gg kit create — Create a level kit (admin)
16. /gg kit delete — Delete a kit (admin)
17. /gg resetstats — Reset stored data (admin)
18. /gg cc — Clear your own chat (admin)
19. /gg ccg — Clear global chat (admin)

API Documentation
EasyGG exposes Bukkit events for integrations. Available events include EasyGGKillEvent, EasyGGDeathEvent, LevelChangeEvent, KillstreakStartEvent, KillstreakChangeEvent, KillstreakEndEvent, and PowerupActivateEvent. See the documentation for subscription examples and event details.

Permissions Overview

1. easygg.* — Full access
2. easygg.gg — Use /gg (default: true)
3. easygg.world.tp — World teleport (default: op)
4. easygg.kit — Use kits (default: true)
5. easygg.stats.others — Controls suggestions for other players in /stats (default: op)
6. easygg.admin.kit — Manage kits (default: op)
7. easygg.admin.setspawn — Set spawn (default: op)
8. easygg.admin.cc and easygg.admin.chatclear — Clear chat (default: op)
9. easygg.admin.zone — Manage safe zones (default: op)
10. easygg.admin.resetstats — Reset player statistics (default: op)
11. easygg.admin.build — Toggle build mode (default: op)
12. easygg.admin.mapchange — Control map rotation (default: op)
13. easygg.admin.activemap — Use /gg activemap (default: op)
14. easygg.admin.deathblocks — Toggle death blocks (default: op)
15. easygg.admin.powerup — Manage powerup spawns (default: op)

Configuration Tips

1. Adjust killstreak broadcasts under GG.Killstreaks.
2. Customize scoreboard and tablist in their respective sections.
3. Use action bar and title feedback to keep combat information clear.
4. Configure powerups under GG.Powerups and use admin commands to place spawns.
5. Toggle death blocks with GG.KillPlayerOnBlockTouch and set GG.DeathBlockList.
6. Tune leaderboard defaults under GG.Leaderboard.

Performance & Quality

1. Optimized for modern Spigot APIs; no NMS.
2. Asynchronous operations where appropriate.
3. Lightweight runtime footprint and clean config defaults.

Support & Updates

1. Regular updates to track Spigot and Paper compatibility.
2. Clear, commented config with sensible defaults.
3. Bug reports and compatibility issues can be reported through Spigot messages.