Citizens Integration

QuestForge integrates with the Citizens plugin to let players accept and turn in quests by right-clicking NPCs.

Citizens is a soft dependency — see Compatibility on the Home page. If Citizens is missing or fails to load, every other QuestForge feature still works.

Requirements

Citizens 2.0.35+ installed and enabled.
A Paper 1.21.x server (tested on 1.21.10).

If Citizens is absent or incompatible, command-based quest management remains fully functional — the plugin self-isolates and logs a warning, then continues without registering the questgiver trait or NPC interaction listener.

Setting Up an NPC Questgiver

Step 1 — Create the NPC

/npc create "Guard Bob" --type PLAYER

Note the NPC's ID (shown in the creation message or via /npc list).

Step 2 — Link the NPC in Your Quest

# quests/bounty_hunter.yml
id: bounty_hunter
display-name: "<red>Bounty Hunter"
npc-start-id: 1       # NPC ID for accepting the quest
npc-turnin-id: 1      # NPC ID for turning in the quest

You can use different NPCs for start and turn-in:

npc-start-id: 1       # Quest Giver at spawn
npc-turnin-id: 5      # Quest Collector at the dungeon

Step 3 — Reload

/quest reload

Player Experience

Player right-clicks the NPC.
A dialogue opens showing available quests from that NPC.
Player clicks a quest to accept — the action is confirmed with QuestForge: ... in chat.
After completing objectives, the player returns and right-clicks the turn-in NPC.
Rewards are granted automatically.

Best Practices

Place NPCs at meaningful locations (quest giver at village, turn-in at dungeon exit).
Use Citizens' --location-look so NPCs face players when they spawn.
Give NPCs quest-themed names using MiniMessage: /npc rename "<gold>Quest Master".
Use INTERACT_NPC objectives mid-quest to send players on a route between NPCs.

No-Citizens Fallback

Without Citizens, players use the regular quest log:

/quest                 # Open the GUI
/quest active          # Active quests tab
/quest track <id>      # Track in action bar

All objective types except INTERACT_NPC are fully usable.

_{QuestForge is part of the TTS-Studio Minecraft plugin suite.}

Home | Commands & Permissions | Quest Format