TreasureRun

TreasureRun

TreasureRun is an early-alpha treasure-hunt mini-game for Spigot 1.20.1. Players start a run, search for treasure chests, follow proximity-based audio and visual cues, earn points, and view ranking results.

Alpha status

This release is intended for testing on Spigot 1.20.1. Test it on a non-production server first and keep a current world backup.

Features

• Easy, normal, and hard treasure runs
• Treasure-proximity audio and visual cues
• Staged effects and score feedback
• Weekly, monthly, and all-time ranking views
• Special Emerald crafting and trader interaction
• Favorite quote management
• Optional database-backed storage
• Versioned ResourcePack delivery with a fixed URL and SHA-1

Requirements

• Java 17
• Spigot 1.20.1
• No required plugin dependencies
• ProtocolLib is an optional soft dependency
• MySQL is optional and disabled by default
• Client access to the versioned GitHub Release asset used for the ResourcePack

Installation

1. Stop the server.
2. Place TreasureRun-0.1.9-alpha-all.jar in the server's plugins directory.
3. Start the server with Java 17.
4. Join with Minecraft Java Edition 1.20.1.
5. Accept the offered ResourcePack to use the complete presentation. The request is not forced.

The default configuration starts without MySQL. Database-backed behavior remains available when database mode is enabled.

Quick start

Core player commands

• /gamestart [easy|normal|hard] — starts a run
• /gameMenu — opens the game menu
• /gameRank [weekly|monthly|all] — shows ranking data
• /craftspecialemerald — crafts a Special Emerald using three diamonds
• /checktreasureemerald — checks the held Special Emerald
• /quoteFavorite <latest|list|remove|reread|book> — manages saved quotes

Core operator commands

• /game start and /game end
• /gameEnd
• /gameReload
• /treasureReload
• /clearStageBlocks
• /givespecialemerald
• /heartbeatTest

The complete command and permission reference is available in the project documentation.

Default permission boundary

• Gameplay, menu, ranking, crafting, item-check, and quote-favorite commands are available to players by default.
• Reload, game-control, cleanup, item-grant, and test commands are operator-restricted.

v0.1.9-alpha runtime boundary

• The default runtime starts without requiring MySQL.
• Database-backed behavior remains available when explicitly enabled.
• The ResourcePack uses the versioned v0.1.9-alpha Release asset.
• ResourcePack force remains disabled.
• Fallback delivery remains disabled by default.

Verification

The published JAR was downloaded from the v0.1.9-alpha Release and checked by SHA-256. It completed a clean isolated Spigot 1.20.1 first start and restart under Java 17 with database mode disabled.

Documentation and support

• Release: https://github.com/flowmari/TreasureRun/releases/tag/v0.1.9-alpha
• Player quick start: https://github.com/flowmari/TreasureRun/blob/v0.1.9-alpha/docs/playtest/PLAYER_QUICKSTART.md
• Commands and permissions: https://github.com/flowmari/TreasureRun/blob/v0.1.9-alpha/docs/COMMANDS.md
• Source code: https://github.com/flowmari/TreasureRun
• Issue tracker: https://github.com/flowmari/TreasureRun/issues