Quests Plugin, First Quest Tutorial

What Is the Quests Plugin?

The Quests plugin (by PikaMug) is a free, open-source quest engine for Minecraft servers. It lets you build multi-stage quests with objectives like mining blocks, killing mobs, delivering items, and reaching locations. Players accept quests from NPCs or through a command, track their progress in a journal, and receive rewards on completion. This quests plugin tutorial minecraft guide gets you from zero to a working quest in under ten minutes.

Quests integrates natively with Citizens for NPC quest givers, Vault for money rewards, and PlaceholderAPI for quest status placeholders. It also supports custom items from plugins like Oraxen as quest objectives or rewards.

Installation

Download the Quests jar from SpigotMC and place it in your plugins/ folder. Restart the server. Quests generates its config at plugins/Quests/:

plugins/Quests/
├── config.yml
├── quests/
│   └── examples.yml
├── actions/
└── data/

The quests/ folder holds quest definitions. The actions/ folder holds reusable actions like teleporting the player or sending a message. The example file gives you a reference, but we will build a fresh quest from scratch.

Creating Your First Quest

The easiest way to create a quest is through the in-game editor. Run:

/quests editor

The editor walks you through each field in chat. However, for this quests plugin tutorial minecraft, we will write the YAML directly so you understand the structure:

# quests/starter_quest.yml
starter-quest:
  name: "Lumberjack Training"
  ask-message: "We need wood for the village. Can you help?"
  finish-message: "Excellent work! The village thanks you."
  npc-giver-uuid: null
  requirements:
    level: 0
  stages:
    ordered:
      "1":
        break-block-names:
          - OAK_LOG
        break-block-amounts:
          - 32
      "2":
        deliver-item-names:
          - OAK_PLANKS
        deliver-item-amounts:
          - 64
        deliver-npc-ids:
          - 0
  rewards:
    money: 500
    experience: 100
    items:
      - material: IRON_AXE
        amount: 1

This quest has two stages. Stage 1 requires the player to break 32 oak logs. Stage 2 requires delivering 64 oak planks to an NPC (Citizens NPC ID 0). The reward is 500 coins through Vault, 100 XP, and an iron axe.

Assigning a Quest Giver NPC

If you use Citizens, you can assign your quest to an NPC so players accept it by right-clicking:

/quests npc

Then click the NPC to link it. In the YAML, set npc-giver-uuid to the NPC's UUID, or use the in-game editor which handles this automatically. Give your quest NPC a fitting skin using the custom skins guide so players recognize quest givers visually.

Quest Requirements and Cooldowns

Control who can take the quest and how often:

  requirements:
    level: 5
    permission: quest.starter
    quest-completed:
      - "tutorial-quest"
  planners:
    cooldown: 86400

This requires level 5, a specific permission, and completion of a prerequisite quest. The cooldown (in seconds) prevents re-taking the quest for 24 hours, which is useful for daily repeatable quests that reward money or resources. Balance your quest reward values with your Vault economy to avoid creating easy money farms.

Testing Your Quest

After saving your YAML, reload with /quests reload. Accept the quest with /quests take Lumberjack Training or by clicking the assigned NPC. Complete each stage to confirm objectives track correctly and rewards distribute properly.

This quests plugin tutorial minecraft covers the fundamentals. From here you can add branching paths, timed objectives, location-based stages, and integration with BetonQuest for deeper narrative conversations.

Need full config access? Astroworld Hosting, Pterodactyl panel, NVMe SSDs.