Minerware

Install

1. Drop Minerware-1.0.6.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 <ArenaName> /minerware setup <ArenaName> # opens GUI wizard to place lobby, region, spawns /minerware enable <ArenaName> /minerware disable <ArenaName> /minerware menu # player GUI to join arenas

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 <arena> — create arena (minerware.admin.create)

/minerware setup <arena> — start setup wizard (minerware.admin.setup)

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

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

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

/leaderboard create <name> <type> — create holographic leaderboard (minerware.admin.leaderboard)

Leaderboard types

wins, points, games, winrate

Setup wizard steps (in-game)

1. /minerware create <name> — create skeleton arena

2. /minerware setlobby <name> — set waiting lobby location

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

4. /minerware setspawn <name> — set center spawn for rounds

5. /minerware setwinner <name> and /minerware setloser <name> — winner/loser platforms

6. /minerware setminplayers <name> <num> and /minerware setmaxplayers <name> <num>

7. /minerware enable <name>

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

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).

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%"

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.

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.

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.

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.

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.