Skip to main content

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
SubcommandDescription
(none)Opens the Quest Book UI
settingsOpens the Quest Tracker settings page

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>
ParameterDescription
playerPlayer display name
questIdQuest ID (e.g. tutorial_awakening, daily_mine_stone)
info

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>
ParameterDescription
playerPlayer display name
questIdQuest ID

Example:

/ksquestadmin complete Steve weekly_master_miner
warning

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>
ParameterDescription
playerPlayer display name
questIdQuest 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]
ParameterDescription
amountNumber 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]
SubcommandDescription
quest <questId>Export a single quest definition
chapter <chapterId>Export a chapter with all its quests
allExport 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]
SubcommandDescription
listShows all available files in the exports folder
<filename>Import the specified file (skip duplicates)
<filename> overwriteImport 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
warning

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.

resetme

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

/ksquestadmin resetme
warning

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]
ParameterDescription
npcTypeEntity type to spawn (default: Kweebec_Merchant)

spawntemplemerchant

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

/ksquestadmin spawntemplemerchant [npcType]

Permission Reference

PermissionCommandsDescription
(none)/ksquest, /ksquestsettingsPlayer commands, available to everyone
questbook.admin/ksquestadmin *All admin subcommands

Command Quick Reference

CommandUsageDescription
/ksquest/ksquestOpen quest book
/ksquest settings/ksquest settingsOpen tracker settings
/ksquestsettings/ksquestsettingsOpen tracker settings (direct)
/ksquestadmin reload/qadmin reloadReload config from disk
/ksquestadmin panel/qadmin panelOpen 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 debugShow quest debug info
/ksquestadmin export/qadmin export <type> [id]Export quest data
/ksquestadmin import/qadmin import <file> [overwrite]Import quest data
/ksquestadmin resetme/qadmin resetmeReset all your quest data