SoapsQuest

The quest system that brings Minecraft adventures to life

SoapsQuest turns every moment in Minecraft into an adventure. Collect and hold real quest papers, complete fun challenges, and earn rewards as you play. Whether you love exploring, fighting mobs, or building, there's always a new quest waiting for you!

🧾 SoapsQuest lets you hold your quests in your hands - no menus, no commands, just pure Minecraft immersion.

🌟 Key Features

• Physical Quest Papers: Quests appear as in-game items you can hold, trade, or drop.
• Exciting Objectives: Take on combat, collection, crafting, exploration, building, and survival quests.
• Multiple Goals: Some quests have several tasks you can complete in any order.
• Live Progress: Track progress through BossBar, ActionBar, and chat updates.
• Reward Variety: Earn XP, money, special items, or unlock more quests as you play.
• Quest Conditions: Some quests require certain levels or progress before starting.
• Endless Quests: Enjoy automatically generated quests that keep the game fresh.
• Loot Drop Quests: Find quests as drops from mobs, chests, or events.
• In-Game Editor: Admins can create or edit quests directly in Minecraft - no file editing needed.
• Difficulties and Tiers: Quests have different challenge levels and rarities.
• Leaderboards: Compete with friends or players across the server for top questing ranks.

📋 Requirements

• Server: Paper 1.21.8+ (Spigot/Bukkit compatible)
• Java: 21 or higher

Optional Integrations

• Vault - enables money-based rewards and costs
• PlaceholderAPI - adds progress displays and leaderboard data
• MythicMobs - lets quests involve custom mobs and encounters
• MMOItems - adds custom quest rewards (material: HAND when held)

🚀 Getting Started

1. Download SoapsQuest.jar
2. Place it in your server's /plugins/ folder.
3. Restart the server to generate the setup files.
4. Start earning or finding quests right in-game!
5. Admins can use /sq give <player> <quest> to share specific quests.

⚡ Quick Example

zombie_slayer:
  display: "&aZombie Slayer"
  tier: common
  difficulty: easy
  objectives:
    - type: kill
      target: ZOMBIE
      amount: 10
  reward:
    xp: 100
    money: 50
  

Players can receive this quest and start slaying zombies instantly!

/sq give Steve zombie_slayer

💡 Tip: Quests can also drop as loot or appear automatically during gameplay.

📚 Learn More

• Commands & Permissions
• Configuration
• Quest Creation
• PlaceholderAPI Integration
• Changelog