Short description
Minerware — cubecraft minecraft server inspired plugin with 8 microgames + 1 boss round. Points-based scoring, MySQL stats support, holographic leaderboards, GUI arena setup, optional CyberLevels integration.

Requirements
Spigot / Paper (1.8.8 — 1.20+)
Java 8+
Optional: MySQL, PlaceholderAPI, HolographicDisplays, CyberLevels

Installation & basic config

Install

• 
  []1. Drop Minerware-1.0.3.jar into /plugins/.
  []2. Restart or reload server.
  []3. Edit plugins/Minerware/config.yml as needed (DB, timings, features).
  []4. Create and configure an arena in-game with the setup wizard.

Example config.yml (MySQL + core)

In-game setup commands

Commands & permissions

Player commands

Admin commands

Leaderboard types
wins, points, games, winrate

Arena configuration & setup

Setup wizard steps (in-game)

[ol]
[li]/minerware create <name> — create skeleton arena[/li]
[li]/minerware setlobby <name> — set waiting lobby location[/li]
[li]/minerware setgameregion <name> 1 and /minerware setgameregion <name> 2 — two corners of the region[/li]
[li]/minerware setspawn <name> — set center spawn for rounds[/li]
[li]/minerware setwinner <name> and /minerware setloser <name> — winner/loser platforms[/li]
[li]/minerware setminplayers <name> <num> and /minerware setmaxplayers <name> <num>[/li]
[li]/minerware enable <name>[/li]
[/ol]

Recommended settings

Arena size: 20×20 — 30×30 blocks for best balance.
Winner/Loser platforms: place ~10–15 blocks above arena for presentation.
Ensure solid floor, proper Y-levels, and void/backup floor below (void-protection built in but physical floor recommended).

Checklist before enabling an arena

Lobby location defined
Game region corners set (no gaps)
Spawn, winner and loser locations set
Min/Max players configured
Test with a small group to verify block types, pressure plates, and spawns

Microgames — full descriptions

Overview: 9 microgames (8 regular + 1 boss). Each regular microgame is short and dynamic; boss round gives more points.

1. Stand On Color — multiple colored plates/wools appear; stand on the correct color before the timer ends. (20s)
   
   
2. Break Blocks — players must “virtually” break target blocks. Tools are provided; broken-block events are tracked and restored after round. (20s)
   
   
3. Bow Spleef — players shoot arrows/snow at snow blocks under opponents to drop them into the void/fall area. (20s)
   
   
4. Jump Challenge — players must trigger all pressure plates in the arena or hit specific jump pads. (20s)
   
   
5. Hit Target — flying mobs/entities (BAT) act as moving targets — hit them with snowballs/projectiles. (20s)
   
   
6. Dodge Anvils — avoid falling anvils; platform hazards force movement and positioning. (20s)
   
   
7. Eat Food Fast — each player receives a set of food items; first to consume them all scores. (20s)
   
   
8. Slime Floor — center has gold blocks; slime makes jumps stronger — stay on designated safe blocks. (20s)
   
   
9. King of the Hill (BOSS) — shrinking platform mechanics; last player standing wins boss round (40s).
   

Scoring

Normal microgame win: 1 point
Double-points rounds: 2 points (configurable/occasional)
Boss round win: 3 points

Round behavior

Items, entity spawns, and temporary blocks are cleaned up after each round.
Virtual block-breaking ensures the world is restored; tools are temporary and removed on round end.
Void protection teleports falling players to the loser platform (configurable).

Placeholders & messages

Common placeholders (PlaceholderAPI)

messages.yml
All in-game strings are configurable via messages.yml.
Customize: join/leave messages, round announcements, win messages, tie messages, and per-microgame prompts.

Scoreboard example snippet

Stats, leaderboards & performance

Tracked metrics
Points
Wins
Games played
Microgames won
Win rate

Storage
Built-in MySQL support for persistent storage across restarts and multiple servers.
If database.enabled: false, stats are kept in-memory and persisted on server stop only.

Holographic leaderboards
Create via /leaderboard create <name> <type>.
Top-10 display for chosen metric, with automatic updates.

Performance tips
Use MySQL if you run multiple servers or keep long-term stats.
Limit holograms (recommended 5–10) to avoid FPS/lag issues.
Increase save-interval-seconds to reduce DB write frequency on busy servers.

CyberLevels integration

Optional integration — Minerware can award CyberLevels XP on microgame wins and full-game wins if CyberLevels is installed.

Enable in config.yml:

Behavior
Awards configured XP amounts when a player wins a microgame or the entire match.
Automatically detects CyberLevels plugin if present; no extra commands required.

Customization & localization

Messages & localization
messages.yml contains every player-facing string: translations are simple — copy the file, translate values, and set language key in config if desired.

Points & game rules
Core point amounts and round durations are configurable in config.yml. For more advanced behavior you can modify the plugin (source) or request features.

Scoreboard / tablist
Full PlaceholderAPI support for dynamic scoreboard/tablist text. Use placeholders from earlier section.

Troubleshooting & known issues

Common problems & fixes
Arena not complete or “missing points”: rerun /minerware setup <arena> and finish all wizard steps.
Not enough players to start: lower min-players or invite test players.
Database connection failed: verify host, port, user, password, and DB permissions; temporarily set database.enabled: false to test local runs.
Players falling through floor / block restoration issues: ensure region Y-level is correct; plugin restores blocks but initial world config matters.

If you see lag
Lower max-players, reduce number of holograms, increase save-interval-seconds, use MySQL on separate DB host.

Changelog — v1.0.3

Fixed multiple critical bugs.
Added Bow Spleef and Eat Food microgames.
Virtual block-breaking system implemented.
Improved void protection and anvil cleanup.
Improved join/leave messages and end-of-game Top-5 results table.