QuestLogs

QuestLogs

A comprehensive quest and challenge plugin for Minecraft Spigot servers.

Features

Quest System

Create quests for your players with multiple types:

• Exploration: Travel 5000 blocks to unlock rewards
• Mining: Mine 50 diamond ore or 100 iron ore
• Combat: Kill 25 zombies or 15 skeletons
• Crafting: 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:

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:

gui_slot: 10      # Place in specific inventory slot
gui_icon: DIAMOND_PICKAXE  # Use custom item as icon

Technical Info

• Minecraft: 1.21+
• Server: Spigot or Paper
• Java: 21+
• Database: 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.