Every NotQuests command lives under one of two roots:
/q/qPlayer commands for NotQuests — the player command (needs the notquests.use permission, which everyone has by default). Aliases: /q/qPlayer commands for NotQuests, /notquests/notquestsPlayer commands for NotQuests, /nquests/nquestsPlayer commands for NotQuests, /nquest/nquestPlayer commands for NotQuests, /notquest/notquestPlayer commands for NotQuests, /quest/questPlayer commands for NotQuests, /quests/questsPlayer commands for NotQuests, /qg/qgPlayer commands for NotQuests.
/qa/qaAdmin commands for NotQuests — the admin command for building and managing quests (needs notquests.admin, OP by default). Aliases: /qa/qaAdmin commands for NotQuests, /nquestsadmin/nquestsadminAdmin commands for NotQuests, /nquestadmin/nquestadminAdmin commands for NotQuests, /notquestadmin/notquestadminAdmin commands for NotQuests, /qadmin/qadminAdmin commands for NotQuests, /questadmin/questadminAdmin commands for NotQuests, /qag/qagAdmin commands for NotQuests, /notquestsadmin/notquestsadminAdmin commands for NotQuests.
tip
You don't have to memorise any of this — just start typing and the tab-completion will guide you the whole way. This page is here for when you want the big picture.
For every generated command shape, including nested objective/action/condition commands and flag
details, see the Generated Command Reference.
In the lists below: <required> is a required argument, [optional] is optional, and (flags) are optional --flags.
Duration arguments accept short and readable formats. For example, 500ms, 1s, 5m, 2h, and 1d all work. A bare number is treated as milliseconds.
🎮 Player commands (/q/qPlayer commands for NotQuests)
/q/qPlayer commands for NotQuests - Opens the quest GUI (or shows clickable text, depending on your config).
/q/qPlayer commands for NotQueststaketakeTakes or accepts a quest.<quest><questName>Identifier of the quest you want to start.Acceptsquest name - Accept/start a quest.
/q/qPlayer commands for NotQuestsactiveQuestsactiveQuestsShows active quests for a player. - List your active quests.
/q/qPlayer commands for NotQuestsprogressprogressShows progress for an active quest.<activeQuest><activeQuest>Name of the active quest which should be aborted or inspected.Acceptsactive quest name - Show your progress on an active quest.
/q/qPlayer commands for NotQuestspreviewpreviewPreviews a quest without accepting it.<quest><questName>Identifier of the quest preview to open.Acceptsquest name - Preview a quest (description, requirements, rewards) before taking it.
/q/qPlayer commands for NotQuestsabortabortAborts an active quest. - List the quests you can abort.
/q/qPlayer commands for NotQuestsabortabortAborts an active quest.<activeQuest><activeQuest>Name of the active quest which should be aborted or inspected.Acceptsactive quest name - Abort (give up) an active quest.
/q/qPlayer commands for NotQuestsquestPointsquestPointsShows the command sender's quest points. - Show how many Quest Points you have.
/q/qPlayer commands for NotQuestscategorycategoryOpens the quest browser for a specific category.<category><Category>Quest category to browse in the quest GUI.Acceptscategory name - Open the quest view for a category.
/q/qPlayer commands for NotQuestscontinueConversationcontinueConversationContinues a conversation with the chosen option.<optionID><optionID>Conversation option number to select.Acceptsconversation option - Pick an answer in an open conversation. (You normally just click the option instead.)
/q/qPlayer commands for NotQuestsprofilesprofilesManages player quest profiles. - Show your current profile and list the others.
/q/qPlayer commands for NotQuestsprofilesprofilesManages player quest profiles.createcreateCreates a new quest profile for the current player.<name><profile-name>Quest profile name. Profile names cannot contain spaces.Acceptsprofile name - Create a new profile (a separate, fresh save of your quest progress).
/q/qPlayer commands for NotQuestsprofilesprofilesManages player quest profiles.changechangeSwitches the active player profile.<name><profile-name>Quest profile name. Profile names cannot contain spaces.Acceptsprofile name - Switch to another profile.
Profiles
A profile is a self-contained save of a player's quest progress (active/completed quests, Quest Points, tags, cooldowns). Switching profiles is like having multiple save files. Managing profiles needs the notquests.user.profiles permission.
🛠️ Admin commands (/qa/qaAdmin commands for NotQuests)
/qa/qaAdmin commands for NotQuestscreatecreateCreates a new quest.<quest><quest>Unique quest identifier.Acceptsquest name--category--categoryQuest category used to store or look up the created NotQuests object.Acceptscategory name<category>Value for --categoryQuest category used to store or look up the created NotQuests object.Acceptscategory nameExampledefault - Create a new quest, optionally in a category.
/qa/qaAdmin commands for NotQuestsdeletedeleteDeletes an existing quest.<quest><questName>Unique quest identifier.Acceptsquest name - Delete a quest.
/qa/qaAdmin commands for NotQuestslistlistLists NotQuests data, type registries, and useful placeholders.AllQuestsAllQuestsLists every loaded quest across all categories. - List every quest you've made.
/qa/qaAdmin commands for NotQuestslistlistLists NotQuests data, type registries, and useful placeholders.ObjectiveTypesObjectiveTypesLists every available objective type. / RequirementTypes / ActionTypes / TriggerTypes / Placeholders - List the available building blocks.
/qa/qaAdmin commands for NotQuestsreloadreloadReloads selected NotQuests files without restarting the server. - Reload all config and quest files.
/qa/qaAdmin commands for NotQuestssavesaveSaves NotQuests configuration and player data to disk. - Save everything to disk.
/qa/qaAdmin commands for NotQuestsversionversionShows the installed NotQuests version and server environment. - Show the plugin version.
Editing a quest — /qa/qaAdmin commands for NotQuestsediteditOpens subcommands for editing a specific quest.<quest><quest>Identifier of the quest to edit; use /qa list to see available quests.Acceptsquest name
Everything about a single quest lives under /qa/qaAdmin commands for NotQuestsediteditOpens subcommands for editing a specific quest.<quest><quest>Identifier of the quest to edit; use /qa list to see available quests.Acceptsquest name.
Basics
descriptiondescriptionQuest description shown in quest previews, GUIs, and chat. Supports MiniMessage formatting.setsetSets the selected quest's description text shown to players.<text><text>New quest description. Supports spaces and MiniMessage formatting.Acceptsquest description / showshowShows the selected quest's current description text. / removeremoveRemoves the selected quest's custom description text. - The quest's description (supports MiniMessage).
displayNamedisplayNameQuest display name shown in quest lists, quest previews, GUIs, and chat messages. Supports MiniMessage formatting.setsetSets the selected quest's display name shown in GUIs, previews, and chat.<text><text>New quest display name. Supports spaces and MiniMessage formatting.Acceptsquest display name / showshowShows the selected quest's current display name. / removeremoveRemoves the selected quest's custom display name. - The quest's display name.
guiItemguiItemShows or changes the item displayed for this quest in GUIs.<material><material>Material, custom NotQuests item, hand item, any, or comma-separated material list for this quest's GUI item.Acceptsitem selection--glow--glowAdds the enchanted glow effect to the quest GUI item. - The item shown for this quest in GUIs.
categorycategoryShows or changes the category assigned to the selected quest.setsetMoves the selected quest into another category.<category><category>New category for this quest.Acceptscategory name / showshowShows the category currently assigned to the selected quest. - Move the quest to a category.
Limits & cooldowns
limitslimitsConfigures quest accept, completion, and fail limits.acceptsacceptsConfigures how many times players may accept this quest.<amount><amount>Maximum accepts allowed. Use -1 for unlimited.Acceptsmaximum accepts - Max times a player can accept this quest (-1 = unlimited).
limitslimitsConfigures quest accept, completion, and fail limits.completionscompletionsConfigures how many times players may complete this quest.<amount><amount>Maximum completions allowed. Use -1 for unlimited.Acceptsmaximum completions - Max times a player can complete it (-1 = unlimited).
limitslimitsConfigures quest accept, completion, and fail limits.failsfailsConfigures how many times players may fail this quest.<amount><amount>Maximum failures allowed. Use -1 for unlimited.Acceptsmaximum fails - Max times a player can fail it (-1 = unlimited).
acceptCooldownacceptCooldownConfigures the cooldown before this quest can be accepted again.completecompleteApplies this cooldown after quest completion.setsetSets the cooldown players must wait after completing this quest before accepting it again.<duration><duration>New cooldown duration, such as 30s, 500ms, 10m, or 2h.Acceptsduration / disabledisableDisables the complete-accept cooldown. - Cooldown before a player can re-accept after completing.
takeEnabledtakeEnabledControls whether players may take this quest.<true|false><true|false>Whether players can accept this quest with /notquests take.Acceptstake enabled - Whether players can take the quest via /q/qPlayer commands for NotQueststaketakeTakes or accepts a quest..
abortEnabledabortEnabledControls whether players may abort this quest.<true|false><true|false>Whether players can abort this quest with /notquests abort.Acceptsabort enabled - Whether players can abort it.
objectivesobjectivesManages objectives on the selected quest.addaddAdds a new objective to the selected quest.<type><type>Counts matching blocks broken by the player.ExampleBreakBlocks...More command inputFull command/qa edit TheVirus objectives add BreakBlocks dirt 1 - Add an objective.
objectivesobjectivesManages objectives on the selected quest.listlistLists every objective on the selected quest. - List the objectives.
objectivesobjectivesManages objectives on the selected quest.clearclearRemoves every objective from the selected quest. - Remove all objectives.
objectivesobjectivesManages objectives on the selected quest.editeditOpens subcommands for editing a specific objective on the selected quest.<id><id>Objective ID shown by this quest's objectives list.Acceptsobjective id...More command inputFull command/qa edit TheVirus objectives edit 1 description show - Edit one objective (see below).
Inside objectives edit <id> you can set a description, displayName, taskDescription, a location (set/enable/disable), a completionNPC, add rewards, and add objective conditions in three slots:
conditionsconditionsManages conditions attached to the selected objective.unlockunlockConfigures conditions required before the objective can unlock.addaddAdds a condition to this objective condition group.<type><type>Reads or changes whether the target player is flying.ExampleFlying...More command inputFull command/qa edit TheVirus objectives edit 1 conditions unlock add Flying equals true - must be met for the objective to unlock.
conditionsconditionsManages conditions attached to the selected objective.progressprogressConfigures conditions required while the objective is progressing.addaddAdds a condition to this objective condition group.<type><type>Reads or changes whether the target player is flying.ExampleFlying...More command inputFull command/qa edit TheVirus objectives edit 1 conditions progress add Flying equals true - must be met for progress to count.
conditionsconditionsManages conditions attached to the selected objective.completecompleteConfigures conditions required before the objective can complete.addaddAdds a condition to this objective condition group.<type><type>Reads or changes whether the target player is flying.ExampleFlying...More command inputFull command/qa edit TheVirus objectives edit 1 conditions complete add Flying equals true - must be met for the objective to finish.
requirementsrequirementsManages requirements that must pass before the selected quest can be taken.addaddAdds a requirement that must pass before players can take the selected quest.<type><type>Reads or changes whether the target player is flying.ExampleFlying...More command inputFull command/qa edit TheVirus requirements add Flying equals true · listlistLists every requirement on the selected quest. · clearclearRemoves every requirement from the selected quest. · editeditOpens subcommands for editing a specific quest requirement.<id><id>Requirement ID shown by this quest's requirements list.Acceptsrequirement iddeletedeleteRemoves the selected requirement from the quest.
Rewards — actions that run when the quest is completed. See the Actions reference.
rewardsrewardsManages rewards granted by the selected quest.addaddAdds a reward granted by the selected quest.<type><type>Gives one or more materials or NotQuests custom items to the target player.ExampleGiveItem...More command inputFull command/qa edit TheVirus rewards add GiveItem stone 1 · listlistLists every reward granted by the selected quest. · clearclearRemoves every reward from the selected quest. · editeditOpens subcommands for editing a specific reward.<id><id>Reward ID shown by the reward list.Acceptsreward idremoveremoveRemoves the selected reward.
Triggers — run actions on quest events (begin/complete/fail/death/etc.). See the Triggers reference.
triggerstriggersManages triggers attached to this quest.addaddAdds a trigger that runs an action when the selected quest changes state.<action><action>Action which will be executed when the trigger runs.Acceptssaved action name<event><event>Runs the selected action when the quest starts or an objective unlocks.ExampleBEGIN...More command inputFull command/qa edit TheVirus triggers add MyAction BEGIN --applyOn O1 --world_name ALL
triggerstriggersManages triggers attached to this quest.listlistLists every trigger attached to the selected quest. · clearclearRemoves every trigger from the selected quest. · removeremoveRemoves the selected trigger from the quest.<id><id>Trigger ID shown by this quest's trigger list.Acceptstrigger id
Quest givers
npcsnpcsManages NPCs attached to this quest.addaddAttaches the selected quest to an NPC or armor stand quest giver.<npc><npc>Citizens NPC, FancyNPC, armor stand, or right-click selector to attach this quest to.AcceptsNPC selector--hideInNPC--hideInNPCAttach the quest to the NPC without showing quest-giver particles or preview hints there. - Attach the quest to an NPC. Citizens and FancyNPCs selectors are available on Paper; armor stands are available on both platforms. rightClickSelect gives you a selector item.
npcsnpcsManages NPCs attached to this quest.listlistLists every NPC and armor stand currently attached to the selected quest. · npcsnpcsManages NPCs attached to this quest.clearclearDetaches the selected quest from every NPC and armor stand quest giver.
armorstandsarmorstandsManages armor stands attached as quest givers.addaddGives a player the tool used to attach this quest to an armor stand. - Get an item, then right-click an armor stand to attach the quest to it.
armorstandsarmorstandsManages armor stands attached as quest givers.listlistLists armor stands attached to the selected quest. · armorstandsarmorstandsManages armor stands attached as quest givers.clearclearClears all armor-stand quest-giver attachments for this quest.
Conversations — /qa/qaAdmin commands for NotQuestsconversationsconversationsManages conversations and their NPC attachments.
conversationsconversationsManages conversations and their NPC attachments.createcreateCreates a new conversation file.<name><name>Unique file/name for the new conversation.Acceptsconversation name--demo--demoFill the new conversation file with the demo conversation instead of an empty template.--category--categoryQuest category used to store or look up the created NotQuests object.Acceptscategory name<category>Value for --categoryQuest category used to store or look up the created NotQuests object.Acceptscategory nameExampledefault - Create a conversation. --demo fills it with a working example to learn from.
conversationsconversationsManages conversations and their NPC attachments.listlistLists every saved conversation. - List conversations.
conversationsconversationsManages conversations and their NPC attachments.analyzeanalyzeRuns conversation analysis checks.<conversation><conversation>Name of the conversation.Acceptsconversation name--printToConsole--printToConsolePrint the command output to the server console instead of only chat. - Sanity-check a conversation's structure.
conversationsconversationsManages conversations and their NPC attachments.startstartStarts the selected conversation.<conversation><conversation>Name of the conversation.Acceptsconversation name - Start a conversation.
conversationsconversationsManages conversations and their NPC attachments.editeditOpens subcommands for editing a saved conversation.<conversation><conversation>Name of the conversation.Acceptsconversation name...More command inputFull command/qa conversations edit Intro npcs add rightClickSelect - Attach NPCs/armor stands and manage speakers/categories. Conversation lines are edited in the .yml file.
Reusable actions and conditions you can refer to by name from anywhere.
/qa/qaAdmin commands for NotQuestsactionsactionsManages saved actions, inline actions, and action execution.addaddCreates a new saved action.<name><name>Name used to save this action.Acceptsaction name<type><type>Sends a private chat message to the target player.ExampleSendMessage...More command inputFull command/qa actions add MyAction SendMessage Hello --category default - Create a named action.
/qa/qaAdmin commands for NotQuestsactionsactionsManages saved actions, inline actions, and action execution.listlistLists every saved action. · /qa/qaAdmin commands for NotQuestsactionsactionsManages saved actions, inline actions, and action execution.editeditOpens subcommands for editing a saved action.<name><name>Identifier of the saved action to edit; use /qa actions to list saved actions.Acceptssaved action nameexecuteexecuteExecutes the selected action or command.[player][player]Player who should be used as the target when executing the selected action; defaults to the sender when possible.Acceptsplayer...More command inputFull command/qa actions edit MyAction execute Steve --ignoreConditions --silent · /qa/qaAdmin commands for NotQuestsactionsactionsManages saved actions, inline actions, and action execution.editeditOpens subcommands for editing a saved action.<name><name>Identifier of the saved action to edit; use /qa actions to list saved actions.Acceptssaved action name...More command inputFull command/qa actions edit MyAction category show
/qa/qaAdmin commands for NotQuestsconditionsconditionsManages saved conditions that can be reused by quests, objectives, and actions.addaddCreates a saved condition.<name><name>Name used to save this condition.Acceptscondition name<type><type>Reads or changes whether the target player is flying.ExampleFlying...More command inputFull command/qa conditions add MyCondition Flying equals true --category default - Create a named condition.
/qa/qaAdmin commands for NotQuestsconditionsconditionsManages saved conditions that can be reused by quests, objectives, and actions.listlistLists every saved condition. · /qa/qaAdmin commands for NotQuestsconditionsconditionsManages saved conditions that can be reused by quests, objectives, and actions.editeditOpens subcommands for editing a saved condition.<name><name>Identifier of the saved condition to edit; use /qa conditions list to see saved conditions.Acceptssaved condition namecheckcheckChecks the selected saved condition for a player.[player][player]Player for which the saved condition should be checked; defaults to the sender when possible.Acceptsplayer · /qa/qaAdmin commands for NotQuestsconditionsconditionsManages saved conditions that can be reused by quests, objectives, and actions.editeditOpens subcommands for editing a saved condition.<name><name>Identifier of the saved condition to edit; use /qa conditions list to see saved conditions.Acceptssaved condition name...More command inputFull command/qa conditions edit MyCondition category show
/qa/qaAdmin commands for NotQuestscategoriescategoriesManages quest categories.createcreateCreates a new quest category.<name><name>Category identifier to create.Acceptscategory name · listlistLists every quest category. · editeditOpens subcommands for editing a quest category.<category><category>Category to edit.Acceptscategory name...More command inputFull command/qa categories edit ExampleCategory displayName show - Organise quests into (nestable) categories.
/qa/qaAdmin commands for NotQueststagstagsManages player tags.createcreateCreates a new player tag with the selected value type.<type><type>Value type for the new tag: BOOLEAN, INTEGER, FLOAT, DOUBLE, or STRING.Acceptstag type<name><name>Unique name for the tag to create.Acceptstag name · listlistLists every configured player tag. · deletedeleteDeletes the selected player tag.<name><name>Name of the tag.Acceptstag name - Custom per-player data you can read/write with conditions, actions and placeholders. See the reputation tutorial.
/qa/qaAdmin commands for NotQuestsitemsitemsManages custom NotQuests items.itemsitemsManages custom NotQuests items.createcreateCreates a new saved NotQuests item.<name><name>Unique saved NotQuests item name.Acceptsitem name<material><material>Material or held item used as the saved item's base.Acceptsitem selection · listlistLists every saved NotQuests item. · givegiveGives the selected NotQuests item to a player.<player><player>Player who should receive the item.Acceptsplayer<amount><amount>Amount of items the player should receive.Acceptsitem amount · editeditOpens subcommands for editing a saved NotQuests item.<name><name>Saved NotQuests item to edit.Acceptsitem name...More command inputFull command/qa items items edit ExampleItem displayName show · removeremoveDeletes the selected saved NotQuests item.<name>Displayed shortcutFull command/qa items items edit ExampleItem remove - Reusable custom items.
/qa/qaAdmin commands for NotQuestsgivegiveGives a quest to a player.<player><player>Player affected by this quest command.Acceptsplayer<quest><quest>Quest the player should start.Acceptsquest name - Give a player a quest (skips requirements).
/qa/qaAdmin commands for NotQuestscompleteQuestcompleteQuestCompletes one active quest for a player.<player><player>Player affected by this quest command.Acceptsplayer<activeQuest><activeQuest>Active quest on the selected player.Acceptsactive quest name / failQuestfailQuestFails one active quest for a player.<player><player>Player affected by this quest command.Acceptsplayer<activeQuest><activeQuest>Active quest on the selected player.Acceptsactive quest name - Force-complete or fail a player's active quest.
/qa/qaAdmin commands for NotQuestsresetAndRemoveQuestresetAndRemoveQuestRemoves a quest from player progress data.<player><player>Player affected by this quest command.Acceptsplayer<quest><quest>Quest the player should start.Acceptsquest name / resetAndFailQuestForAllPlayersresetAndFailQuestForAllPlayersFails a quest for every loaded player and removes completed progress.<quest><quest>Quest the player should start.Acceptsquest name - Reset and remove/fail.
/qa/qaAdmin commands for NotQuestsprogressprogressShows progress for one active quest of another player.<player><player>Player affected by this quest command.Acceptsplayer<activeQuest><activeQuest>Active quest on the selected player.Acceptsactive quest name · activeQuestsactiveQuestsShows active quests for a player.<player><player>Player affected by this quest command.Acceptsplayer · completedQuestscompletedQuestsShows completed quests for a player.<player><player>Player affected by this quest command.Acceptsplayer - Inspect a player.
/qa/qaAdmin commands for NotQuestsquestpointsquestpointsShows or changes a player's quest points.<player><player>Player whose quest points should be shown or changed.AcceptsplayeraddaddAdds quest points to the selected player.<amount><amount>Quest point amount used by this command.Acceptsquest point amount / removeremoveRemoves quest points from the selected player.<amount><amount>Quest point amount used by this command.Acceptsquest point amount / setsetSets the selected player's quest points to an exact amount.<amount><amount>Quest point amount used by this command.Acceptsquest point amount / showshowShows the selected player's current quest points. - Manage a player's Quest Points.
/qa/qaAdmin commands for NotQuestsdebugdebugOpens NotQuests debug utilities. - Toggle debug mode (lots of extra info in chat).
/qa/qaAdmin commands for NotQuestsdebugdebugOpens NotQuests debug utilities.showErrorsAndWarningsshowErrorsAndWarningsShows collected NotQuests errors and warnings.--printToConsole--printToConsolePrint the command output to the server console instead of only chat. - Show collected errors/warnings.
/qa/qaAdmin commands for NotQuestsdebugdebugOpens NotQuests debug utilities.worldInfoworldInfoShows debug information about the current world. · clearOwnChatclearOwnChatClears the command sender's chat for debugging. · beaconBeambeaconBeamSpawns a debug beacon beam for one player.<player><player>Player who should see the debug beacon beam.Acceptsplayer<name><name>Temporary debug name used to identify this beacon beam location.Acceptslocation name<location><location>World and coordinates where the debug beacon beam should appear.Acceptsworld and coordinates - Misc debug helpers.
/qa/qaAdmin commands for NotQuestsdebugdebugOpens NotQuests debug utilities.loadDataUnsafeloadDataUnsafeUnsafely reloads all NotQuests configuration and runtime data for debugging. · disablePluginAndSavingdisablePluginAndSavingDisables NotQuests saving and loading.<reason><reason>Reason recorded for enabling or disabling NotQuests.Acceptsreason · enablePluginAndSavingenablePluginAndSavingRe-enables NotQuests saving and loading.<reason><reason>Reason recorded for enabling or disabling NotQuests.Acceptsreason - Advanced/risky (used for things like database migrations). Back up first!
Lost? Use the in-game help
/qa/qaAdmin commands for NotQuestshelphelpShows command help. and /qa/qaAdmin commands for NotQuestshelphelpShows command help.<search><query>Command name, topic, or search text to show admin help for.Acceptshelp query open a searchable, clickable help menu — handy when you can't remember the exact path.