---

ReckonQuests – Ultimate Quest System

Version: 1.0-SNAPSHOT
Minecraft: 1.21.3+ (Paper/Spigot)
Developer: ReckonSoul
Website: reckonsoul.com

---

OVERVIEW

ReckonQuests is a lightweight, powerful, and fully customizable quest system for Minecraft servers.

• 18+ Quest Types
• Stage-based progression
• Per-stage + global rewards
• GUI Menu (/quests)
• No database required (YAML files)
• 100% Configurable via Web Builder

---

FEATURES

Feature	Description
18 Task Types	Kill, Craft, Break, Place, Fish, Tame, Trade, Reach Location, etc.
Stage Rewards	Items, XP, Commands per stage
Global Rewards	Final completion rewards
GUI Menu	/quests → Clean inventory GUI
Web Quest Builder
Prerequisites	Chain quests
Color Support	&a, &l, &6 in names/desc
Player Progress	Saved in playerdata.yml

---

INSTALLATION

1. Download ReckonQuests.jar
2. Place in plugins/ folder
3. Restart server
4. Done! Use /rq help

---

COMMANDS

Command	Permission	Description
/quests	reckonquests.use	Open quest GUI
/rq reload	reckonquests.admin	Reload all quests
/rq give <player> <quest>	reckonquests.admin	Force-start quest
/rq reset <player> <quest>	reckonquests.admin	Reset progress
/rq list	reckonquests.admin	List loaded quests

---

PERMISSIONS

reckonquests.use: true        # /quests
reckonquests.admin: false     # reload, give, reset

---

FOLDER STRUCTURE

plugins/ReckonQuests/
├── quests/                  ← Your quest files
│   ├── demo.yml
│   └── ultimate.yml
├── playerdata.yml           ← Player progress
└── config.yml               ← Plugin settings

---

QUEST FILE FORMAT (demo.yml)

name: "&6&lUltimate Quest"
icon: DIAMOND_SWORD
description: "&7Slay zombies, craft, explore!"
prerequisite: starter_quest

stages:
  1:
    task:
      type: KILL_MOB
      entity: ZOMBIE
      amount: 10
      description: "&7Kill &c10 Zombies"
    rewards:
      items:
        - IRON_SWORD:1
      xp: 50
      commands:
        - "msg %player% &aYou got a sword!"

  2:
    task:
      type: CRAFT_ITEM
      item: BREAD
      amount: 5
      description: "&7Craft &f5 Bread"
    rewards:
      items:
        - APPLE:3

  14:
    task:
      type: TAME_ANIMAL
      entity: WOLF
      amount: 1
      description: "&7Tame a &6Wolf"
    rewards:
      items:
        - BONE:10

  17:
    task:
      type: REACH_LOCATION
      x: 100
      y: 64
      z: 200
      world: world
      radius: 5
      amount: 1
      description: "&7Reach &b(100, 64, 200)"

rewards:
  items:
    - DIAMOND:5
    - ENCHANTED_GOLDEN_APPLE:1
  xp: 500
  commands:
    - "broadcast &e%player% completed the Ultimate Quest!"

---

TASK TYPES (18 TOTAL)

Type	Fields	Example
KILL_MOB	entity, amount	Kill 10 Zombies
KILL_ENTITY_TYPE	entity, amount	Kill 8 Skeletons
DAMAGE_ENTITY	entity, amount	Deal 50 damage to Creepers
INTERACT_ENTITY	entity, amount	Talk to 3 Villagers
BREED_ANIMAL	entity, amount	Breed 2 Cows
TAME_ANIMAL	entity, amount	Tame 1 Wolf
CRAFT_ITEM	item, amount	Craft 5 Bread
SMELT_ITEM	item, amount	Smelt 8 Iron Ingots
CONSUME_ITEM	item, amount	Eat 3 Cooked Beef
COLLECT_ITEM	item, amount	Collect 5 Emeralds
DROP_ITEM	item, amount	Drop 10 Rotten Flesh
USE_ANVIL	item, amount	Use anvil with Iron Sword
ENCHANT_ITEM	item, enchantment?	Enchant Diamond Pickaxe
BREAK_BLOCK	block, amount	Break 20 Oak Logs
PLACE_BLOCK	block, amount	Place 15 Torches
TRADE_VILLAGER	amount	Trade 5 times
FISH_ITEM	item?, amount	Catch 3 fish
REACH_LOCATION	x,y,z,world,radius	Reach (100,64,200)

---

WEB QUEST BUILDER

• Fill form → Generate YAML
• Download → Drop in plugins/ReckonQuests/quests/
• Reload: /rq reload

No coding needed!

---

DEVELOPER API

QuestManager qm = ReckonQuests.getQuestManager();

// Start quest
qm.startQuest(player, "demo");

// Check progress
int stage = qm.getCurrentStage(player, "demo");

// Complete stage
qm.completeStage(player, "demo");

---

CONFIG.YML

gui:
  title: "&6&lAvailable Quests"
  size: 27
  filler: GRAY_STAINED_GLASS_PANE

messages:
  started: "&aQuest started: &f{quest}"
  completed: "&6&lQUEST COMPLETED!"
  stage-complete: "&eStage {stage} complete!"

---

TROUBLESHOOTING

Issue	Fix
unknown task type: TAME_ANIMAL	Update plugin + use builder
/quests crashes	Delete playerdata.yml
Quest not loading	Check YAML syntax (use yamlchecker.com)
No GUI	Run /rq reload

---

CHANGELOG

v1.0-SNAPSHOT

• Initial release
• 18 task types
• Web builder
• GUI + rewards
• Prerequisites

---

SUPPORT

• Discord: discord.gg/reckonsoul
• Issues: github.com/reckonsoul/ReckonQuests
• Docs: docs.reckonsoul.com/quests

---

MADE WITH LOVE BY RECKONSOUL

“Questing, but make it epic.”

---

BRO — YOUR PLUGIN IS NOW FULLY DOCUMENTED.
Print it, share it, ship it.

Want:

• PDF version?
• In-game /quest help?
• Auto-updater?
• Quest chains UI?

Just say the word.