Перейти к содержимому
Mineforgian

QuestLogs

Advanced quest system for Minecraft servers with GUI quest book, SQLite stats tracking, timed challenges, and extensive reward customization.

Загрузки
519
Подписчики
5
Обновлён
1 февраля 2026 г.
Лицензия
MIT

Опубликован 29 октября 2025 г.

Исходный кодСообщить об ошибке

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.

Ченджлог

1.0.4Релиз1.21.9, 1.21.10, 1.21.11 · 1 февраля 2026 г.

What's Changed

Bug Fixes

  • Fix critical lag spikes on player quit: Player quit was saving ALL players' stats synchronously on the main thread, causing 10+ second server freezes. Now saves only the quitting player's stats, asynchronously.

New Features

  • ASCII mode for challenge broadcasts: Added use-ascii-characters config option in challenges.yml for servers where players can't see Unicode emojis/box-drawing characters. When enabled, uses [1st], [2nd], [3rd] and === instead of medals and fancy borders.

Configuration

Add to your challenges.yml under settings if needed:

use-ascii-characters: true
1.0.3Релиз1.21.9, 1.21.10, 1.21.11 · 21 декабря 2025 г.
  • Updated Spigot API to 1.21-R0.1-SNAPSHOT for Minecraft 1.21.11 compatibility
  • Fixed crafting challenge tracking bug (event cancellation check, improved recipe handling)
  • Enhanced crafting challenges with specific item targets (comma-separated support)
  • Added 5 new specific crafting challenges (tools, armor, weapons, food, redstone)
  • Removed all enchanted book rewards from challenges (they had no enchantments)
  • Added editable challenges.yml config file with all default challenges
  • Improved challenge announcements to show tracked items
1.0.2Релиз1.21.8, 1.21.9, 1.21.10 · 3 ноября 2025 г.

✨ Enchanted Book Support

QuestLogs now supports giving enchanted books with stored enchantments as rewards! Players can receive enchanted books that can be applied via an anvil, just like in vanilla Minecraft.

Example:

rewards:
  ENCHANTED_BOOK: 1
enchantments:
  ENCHANTED_BOOK:
    EFFICIENCY: 3
    FORTUNE: 2

🔄 Quest Reset Command

Admins can now reset player quest progress with a simple command:

/questadmin reset <player> <quest_id>

Works for both online and offline players, and supports all quest types (mining, mob kills, exploration, etc.).

Improvements

  • Tab completion for reset command
  • Updated examples with enchanted book configurations
  • Comprehensive documentation updates
1.0.1Релиз1.21.8, 1.21.9, 1.21.10 · 2 ноября 2025 г.

Fixed Bugs

  • Quest progress no longer exceeds target amounts
    • Affects mob kill quests, mining quests, placement quests, and crafting quests
    • Progress now properly caps at required amount
1.0.0Релиз1.21.8, 1.21.9, 1.21.10 · 29 октября 2025 г.

🎉 QuestLogs v1.0.0 - Initial Release

The first stable release of QuestLogs! A comprehensive quest and challenge system for Minecraft Spigot 1.21+.

✨ Features

Quest System

  • ✅ Multiple quest types: Exploration, Mining, Mob Kills, Crafting, Block Breaking/Placing
  • ✅ Beautiful GUI Quest Book interface
  • ✅ Quest prerequisites for sequential progression
  • ✅ Custom quest icons and GUI positioning
  • ✅ Progress tracking with configurable notifications

Player Statistics

  • ✅ SQLite database for reliable data persistence
  • ✅ Track playtime, blocks explored, quests completed
  • ✅ Detailed breakdowns: mining, crafting, combat stats
  • ✅ Leaderboard queries for all statistics
  • ✅ /queststats command with comprehensive display

Timed Challenges

  • ✅ Server-wide competitive mini-games
  • ✅ 10 balanced default challenges included
  • ✅ Automatic scheduling (configurable)
  • ✅ Top 3 players receive rewards
  • ✅ Challenge participation and win tracking

Reward System

  • ✅ Items with custom quantities
  • ✅ Enchanted books with any enchantment level
  • ✅ Experience (XP) rewards
  • ✅ Automatic inventory management
  • ✅ Rewards displayed in GUI and completion messages

📋 Requirements

  • Minecraft: 1.21+
  • Server: Spigot/Paper
  • Java: 21+

📥 Installation

  1. Download QuestLogs-1.0.0.jar
  2. Place it in your server's plugins/ folder
  3. Restart your server
  4. Configure plugins/QuestLogs/config.yml and quests.yml
  5. Reload with /questadmin reload

🎮 Quick Start

For Players:

  • /questbook - Open the quest book GUI
  • /queststats - View your statistics
  • /challenge - Check active challenge

For Admins:

  • /questadmin reload - Reload configuration
  • /questadmin complete <quest> <player> - Complete quest for player
  • /challengeadmin start <challenge> - Start a specific challenge

📚 Included Examples

  • 12+ example quest configurations
  • 10 balanced timed challenges
  • Comprehensive documentation
  • GUI customization examples

🐛 Known Issues

None at this time. Please report any issues on the Issues page.

🙏 Feedback Welcome

This is the first release! Please share your feedback, bug reports, and feature requests.

Комментарии

Загружаем…