Minerware

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 (click to expand)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)

database:
enabled: true
host: localhost
port: 3306
database: minerware
username: root
password: your_password
useSSL: false

game:
countdown: 10
microgame-duration: 20
boss-game-duration: 40
min-players: 2
max-players: 16
rounds: 9

performance:
save-interval-seconds: 300
max-holograms: 10

In-game setup commands

/minerware create
/minerware setup # opens GUI wizard to place lobby, region, spawns
/minerware enable
/minerware disable
/minerware menu # player GUI to join arenas

📜 Commands & permissions (click to expand)Player commands

/minerware menu — open arena selection GUI (minerware.menu)

/minerware join [arena] — join an arena (minerware.join)

/minerware leave — leave current arena (minerware.leave)

/minerware stats [player] — show stats (minerware.stats)

/minerware list — list arenas (minerware.list)

Admin commands

/minerware create — create arena (minerware.admin.create)

/minerware setup — start setup wizard (minerware.admin.setup)

/minerware enable|disable — toggle arena (minerware.admin.enable, minerware.admin.disable)

/minerware forcestop — force stop a running game (minerware.admin.forcestop)

/minerware resetstats — reset a player’s stats (minerware.admin.resetstats)

/leaderboard create — create holographic leaderboard (minerware.admin.leaderboard)

Leaderboard types

wins, points, games, winrate

🧱 Arena configuration & setup (click to expand)Setup wizard steps (in-game)

1. /minerware create — create skeleton arena

2. /minerware setlobby — set waiting lobby location

3. /minerware setgameregion 1 and /minerware setgameregion 2 — two corners of the region

4. /minerware setspawn — set center spawn for rounds

5. /minerware setwinner and /minerware setloser — winner/loser platforms

6. /minerware setminplayers and /minerware setmaxplayers

7. /minerware enable

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 (click to expand)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 (click to expand)Common placeholders (PlaceholderAPI)

%minerware_points%
%minerware_wins%
%minerware_games%
%minerware_microgames_won%
%minerware_winrate%

%minerware_arena%
%minerware_arena_state%
%minerware_arena_players%
%minerware_arena_max_players%

%minerware_top_wins_1% ... %minerware_top_wins_10%
%minerware_top_points_1% ... %minerware_top_points_10%

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

scoreboard:
title: "&6&lMINERWARE"
lines:
- "&7Arena: &e%minerware_arena%"
- "&7Points: &e%minerware_points%"
- "&7Wins: &a%minerware_wins%"
- "&7Players: &b%minerware_arena_players%/%minerware_arena_max_players%"

📊 Stats, leaderboards & performance (click to expand)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 .

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 (click to expand)Optional integration — Minerware can award CyberLevels XP on microgame wins and full-game wins if CyberLevels is installed.

Enable in config.yml:

cyberlevels:
enabled: true
microgame-win-xp: 10
game-win-xp: 50

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 (click to expand)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 (click to expand)Common problems & fixes

Arena not complete or “missing points”: rerun /minerware setup 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 (click to expand)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.

---