Commands

The Quest System provides three command groups: player commands, admin commands and settings commands.

Player Commands

/ksquest

Opens the Quest Book UI for the player. No permissions required.

/ksquest
/ksquest settings

Subcommand	Description
(none)	Opens the Quest Book UI
`settings`	Opens the Quest Tracker settings page
`config`	Alias for `settings`

Aliases: ksquests, ksquestbook, kqb, questbook, qb

/ksquestsettings

Opens the Quest Tracker settings page directly. Same as /ksquest settings.

/ksquestsettings

Permission: None (available to all players)

Admin Commands

All admin subcommands require the questbook.admin permission.

/ksquestadmin

The main admin command collection. Alias: qadmin

/ksquestadmin <subcommand> [arguments]

Configuration & Data

reload

Reloads all quest configuration files from disk.

/ksquestadmin reload

Use this after editing any JSON config files to apply changes without a server restart.

panel

Opens the graphical Quest Admin Panel UI.

/ksquestadmin panel

The admin panel provides a visual interface for managing quests, pools and chapters.

debug

Displays detailed quest debug information for the executing player.

/ksquestadmin debug

Shows:

Active quests with objective progress
Completed quests
Story facts and chapter progress
Streak status
Registered trigger and chapter counts

debugmode

Toggles live tracking debug output in the server console for your player.

/ksquestadmin debugmode

When enabled, all tracking events (block breaks, kills, crafts, etc.) are logged with matching quest information. Run the command again to disable.

Quest Management

start

Starts a specific quest for a player.

/ksquestadmin start <player> <questId>

Parameter	Description
`player`	Player display name
`questId`	Quest ID (e.g. `tutorial_awakening`, `daily_mine_stone`)

This command can also be executed from the server console, which is useful for NPC dialog macros that start quests.

Example:

/ksquestadmin start Steve tutorial_first_steps

complete

Force-completes a quest for a player, setting all objectives to their target values and granting rewards.

/ksquestadmin complete <player> <questId>

Parameter	Description
`player`	Player display name
`questId`	Quest ID

Example:

/ksquestadmin complete Steve weekly_master_miner

This sets all objective progress to 100% and triggers the completion flow including reward distribution. Use with caution.

reset

Resets a specific quest for a player, removing it from both active and completed lists.

/ksquestadmin reset <player> <questId>

Parameter	Description
`player`	Player display name
`questId`	Quest ID

Example:

/ksquestadmin reset Steve story_forest_voice

resetdaily

Forces a server-wide daily quest reset for all players.

/ksquestadmin resetdaily

resetweekly

Forces a server-wide weekly quest reset for all players.

/ksquestadmin resetweekly

Economy

tokens

Gives quest tokens to yourself. Default amount is 100 if no number is specified.

/ksquestadmin tokens [amount]

Parameter	Description
`amount`	Number of tokens to add (default: 100)

Examples:

/ksquestadmin tokens
/ksquestadmin tokens 500

Export & Import

export

Exports quest data as JSON files to the exports/ folder.

/ksquestadmin export <quest|chapter|all> [id]

Subcommand	Description
`quest <questId>`	Export a single quest definition
`chapter <chapterId>`	Export a chapter with all its quests
`all`	Export a full backup of all quest data

Examples:

/ksquestadmin export quest daily_mine_stone
/ksquestadmin export chapter chapter_0_tutorial
/ksquestadmin export all

import

Imports quest data from a JSON file in the exports/ folder.

/ksquestadmin import <filename|list> [overwrite]

Subcommand	Description
`list`	Shows all available files in the exports folder
`<filename>`	Import the specified file (skip duplicates)
`<filename> overwrite`	Import and overwrite existing quests with same IDs

Examples:

/ksquestadmin import list
/ksquestadmin import quest_daily_mine_stone_2026-02-09.json
/ksquestadmin import full_backup_2026-02-09.json overwrite

Using overwrite mode will replace existing quest definitions with matching IDs. Always create a backup with /ksquestadmin export all before importing with overwrite.

Testing & Development

These commands are intended for development and testing purposes.

test

Force-starts a quest in test mode for yourself or another player. Ignores prerequisites and sets all objective progress to target - 1, so a single action completes each objective.

/ksquestadmin test <quest_id> [player]

Parameter	Description
`quest_id`	Quest ID to start in test mode
`player`	Target player (optional, defaults to yourself)

Example:

/ksquestadmin test tutorial_first_steps
/ksquestadmin test daily_mine_stone Steve

resetme

Resets all quest data for the executing player (active quests, completed quests, facts, chapters, streak, first-join status).

/ksquestadmin resetme

This completely wipes your quest progress. There is no undo. Only use this for testing.

setstreak

Sets a player’s streak day count.

/ksquestadmin setstreak <player> <days>

testfirstjoin

Simulates the first-join trigger for yourself, resetting your first-join status and re-executing the first-join quest chain.

/ksquestadmin testfirstjoin

teststart

Starts the tutorial_welcome quest for yourself (quick test shortcut).

/ksquestadmin teststart

testzone

Simulates entering a zone, triggering zone-discovery objectives and triggers.

/ksquestadmin testzone <zoneName>

Example:

/ksquestadmin testzone Forgotten_Temple

testnpc

Simulates interacting with an NPC, triggering NPC-interaction objectives and triggers.

/ksquestadmin testnpc <npcId>

Example:

/ksquestadmin testnpc merchant_aldric

spawnmerchant

Spawns an NPC at your current location.

/ksquestadmin spawnmerchant [npcType]

Parameter	Description
`npcType`	Entity type to spawn (default: `Kweebec_Merchant`)

spawntemplemerchant

Spawns an NPC at the fixed Forgotten Temple position (5034, 159, 4986).

/ksquestadmin spawntemplemerchant [npcType]

Permission Reference

Permission	Commands	Description
(none)	`/ksquest`, `/ksquestsettings`	Player commands, available to everyone
`questbook.admin`	`/ksquestadmin *`	All admin subcommands

Command Quick Reference

Command	Usage	Description
`/ksquest`	`/ksquest`	Open quest book
`/ksquest settings`	`/ksquest settings`	Open tracker settings
`/ksquestsettings`	`/ksquestsettings`	Open tracker settings (direct)
`/ksquestadmin reload`	`/qadmin reload`	Reload config from disk
`/ksquestadmin panel`	`/qadmin panel`	Open admin panel UI
`/ksquestadmin start`	`/qadmin start <player> <quest>`	Start quest for player
`/ksquestadmin complete`	`/qadmin complete <player> <quest>`	Force-complete quest
`/ksquestadmin reset`	`/qadmin reset <player> <quest>`	Reset quest for player
`/ksquestadmin tokens`	`/qadmin tokens [amount]`	Give yourself tokens
`/ksquestadmin debug`	`/qadmin debug`	Show quest debug info
`/ksquestadmin export`	`/qadmin export <type> [id]`	Export quest data
`/ksquestadmin import`	`/qadmin import <file> [overwrite]`	Import quest data
`/ksquestadmin test`	`/qadmin test <quest> [player]`	Start quest in test mode
`/ksquestadmin debugmode`	`/qadmin debugmode`	Toggle live debug output
`/ksquestadmin resetme`	`/qadmin resetme`	Reset all your quest data