QuestLogs

QuestLogs

A comprehensive quest and challenge plugin for Minecraft Spigot servers.

Features

Quest System

Create quests for your players with multiple types: - Building: Travel 5000 blocks to unlock rewards - Building: Mine 50 diamond ore or 100 iron ore - Building: Kill 25 zombies or 15 skeletons - Building: Craft 64 sticks or 32 torches - Building: Place 500 cobblestone blocks

Quests are displayed in a chest GUI interface. Players track progress with `/questbook` and get notifications as they progress.

Quest Prerequisites

Set up quest chains where players must complete one quest before accessing the next. For example: ``` Novice Miner → Apprentice Miner → Expert Miner → Master Miner ```

Player Statistics

All player activity is tracked in a local SQLite database: - Total playtime (current session + lifetime) - Blocks explored, mined, broken, placed - Items crafted by type - Mobs killed by type - Quests completed - Challenges won and participated in

View stats with `/queststats` or check other players with `/queststats <player>`.

Timed Challenges

The plugin runs server-wide competitive events automatically. Default setup includes 10 challenges that run every hour for 5 minutes each:

- Stone Mining Sprint: Mine the most stone - Diamond Dash: Mine the most diamond ore - Zombie Hunt: Kill the most zombies - Speed Builder: Place the most blocks - And 6 more...

Top 3 players get rewards. Rewards include items, enchanted books (Fortune III, Silk Touch, Mending, etc.), and experience points.

Rewards

Configure rewards in YAML format: ```yaml rewards: DIAMOND: 5 IRON_INGOT: 16 ENCHANTED_BOOK: enchantments: FORTUNE: 3 xp_reward: 500 ```

Supports any item, any enchantment at any level, and XP rewards.

Commands

For Players: - `/questbook` - Opens the quest GUI - `/queststats [player]` - Shows statistics - `/challenge` - Shows active challenge info

For Admins: - `/questadmin reload` - Reloads config files - `/questadmin complete <quest> <player>` - Completes a quest for a player - `/challengeadmin start <challenge>` - Starts a specific challenge - `/challengeadmin list` - Lists all available challenges

All commands have tab completion.

Configuration

The plugin uses YAML files for everything: - `config.yml` - Main settings and notification intervals - `quests.yml` - All quest definitions - `challenges.yml` - Challenge pool and scheduling - `progress.yml` - Player quest progress (auto-generated)

Includes 12+ example quest files to help you get started.

GUI Customization

Set custom positions and icons for quests: ```yaml gui_slot: 10 # Place in specific inventory slot gui_icon: DIAMOND_PICKAXE # Use custom item as icon ```

Technical Info

- Dependencies: 1.21+ - Dependencies: Spigot or Paper - Dependencies: 21+ - Dependencies: SQLite (bundled, no setup required) - Dependencies: None

That's it. The plugin creates all necessary files on first run with working examples.

For more information, documentation, and source code, check out the GitHub repository.