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, /quest/questPlayer commands for NotQuests, /quests/questsPlayer commands for NotQuests, /notquests/notquestsPlayer 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, /questadmin/questadminAdmin 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 of which you want to see the progressAcceptsactive 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/failedAcceptsactive 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>Option message to continue conversationAcceptswhole number - 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>Name for the new quest profile. Profile names cannot contain spaces.Acceptstext - 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>Name of the existing profile.Acceptstext - 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 NotQuestscreatecreateCreate a new quest.<quest><quest>Unique identifier for the new quest.Acceptstext--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 NotQuestsdeletedeleteDelete an existing Quest.<quest><questName>Identifier of the quest to delete.Acceptsquest name - Delete a quest.
/qa/qaAdmin commands for NotQuestslistlistLists available NotQuests data, types, and definitions.AllQuestsAllQuestsLists every loaded quest across all categories. - List every quest you've made.
/qa/qaAdmin commands for NotQuestslistlistLists available NotQuests data, types, and definitions.ObjectiveTypesObjectiveTypesLists every available objective type. / RequirementTypes / ActionTypes / TriggerTypes / Placeholders - List the available building blocks.
/qa/qaAdmin commands for NotQuestsreloadreloadReloads NotQuests data or configuration. - Reload all config and quest files.
/qa/qaAdmin commands for NotQuestssavesaveSaves NotQuests data to disk. - Save everything to disk.
/qa/qaAdmin commands for NotQuestsversionversionShows the installed NotQuests version. - 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>Sets the new description of the Quest.Acceptstext / 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.Acceptstext / 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 in GUIs.<material><material>Material of item displayed in the Quest take GUI.Acceptsmaterial, custom item, hand, any, or comma-separated materials--glow--glowMakes the item have the enchanted glow. - 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 amount of accepts. Set to -1 for unlimited (default).Acceptswhole number - 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 amount of completions. Set to -1 for unlimited (default).Acceptswhole number - 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 amount of fails. Set to -1 for unlimited (default).Acceptswhole number - Max times a player can fail it (-1 = unlimited).
acceptCooldownacceptCooldownConfigures the cooldown before this quest can be accepted again.completecompleteApplies this setting to quest completion cooldowns.setsetSets the cooldown players must wait after completing this quest before accepting it again.<duration><duration>New accept cooldown measured by quest completion time.Acceptsduration such as 500ms, 1s, 5m, or 2h / disabledisableTurns this setting off. - Cooldown before a player can re-accept after completing.
takeEnabledtakeEnabledControls whether players may take this quest.<true|false><true|false>Enabled by default. Yes / noAcceptstrue or false - 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>Enabled by default. Yes / noAcceptstrue or false - Whether players can abort it.
objectivesobjectivesManages objectives on this quest or parent objective.addaddAdds a new objective to the selected quest.<type><type>Creates a new BreakBlocks objective.ExampleBreakBlocks...More command inputFull command/qa edit TheVirus objectives add BreakBlocks dirt 1 - Add an objective.
objectivesobjectivesManages objectives on this quest or parent objective.listlistLists every objective on the selected quest. - List the objectives.
objectivesobjectivesManages objectives on this quest or parent objective.clearclearRemoves every objective from the selected quest. - Remove all objectives.
objectivesobjectivesManages objectives on this quest or parent objective.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.unlockunlockManages conditions required before the objective can unlock.addaddAdds an unlock condition to the selected objective.<type><type>Selects the Flying variable for this action, condition, objective, or variable check.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.progressprogressManages conditions required while the objective is progressing.addaddAdds a progress condition to the selected objective.<type><type>Selects the Flying variable for this action, condition, objective, or variable check.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.completecompleteManages conditions required before the objective can complete.addaddAdds a completion condition to the selected objective.<type><type>Selects the Flying variable for this action, condition, objective, or variable check.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 a quest can be taken.addaddAdds a requirement that must pass before players can take the selected quest.<type><type>Selects the Flying variable for this action, condition, objective, or variable check.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>Numeric requirement ID shown by this quest's requirements list.Acceptswhole numberdeletedeleteRemoves the selected requirement from the quest.
Rewards — actions that run when the quest is completed. See the Actions reference.
rewardsrewardsManages rewards granted by this quest or objective.addaddAdds a reward granted by the selected quest.<type><type>GiveItem action type.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 quest reward.<id><id>Numeric reward ID shown by this quest's rewards list.Acceptswhole numberremoveremoveRemoves the selected reward from the quest.
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 triggers.Acceptssaved action name<event><event>BEGIN trigger type.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>Numeric ID of the trigger to remove from this quest.Acceptswhole number
Quest givers
npcsnpcsManages NPCs attached to this quest or conversation.addaddAttaches the selected quest to an NPC or armor stand quest giver.<npc><npc>ID of the Citizens NPC to whom the Quest should be attached.AcceptsNPC selector such as citizens:1, fancynpcs:<id>, none, or rightClickSelect--hideInNPC--hideInNPCMakes the Quest hidden from in the NPC. - Attach the quest to a Citizens or FancyNPCs NPC. Use rightClickSelect to get an item you can click an NPC with.
npcsnpcsManages NPCs attached to this quest or conversation.listlistLists every NPC and armor stand currently attached to the selected quest. · npcsnpcsManages NPCs attached to this quest or conversation.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. (alias c)
conversationsconversationsManages conversations and their NPC attachments.createcreateCreates a new conversation file.<name><name>Unique file/name for the new conversation.Acceptstext--demo--demoFills the new conversation file with demo data--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--printToConsolePrints the output to the console - 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>Unique identifier for the new saved action.Acceptstext<type><type>SendMessage action type.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 for which the action will be executedAcceptsonline player name...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 new saved condition.<name><name>Unique identifier for the new saved condition.Acceptstext<type><type>Selects the Flying variable for this action, condition, objective, or variable check.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.Acceptssaved condition namecheckcheckChecks the selected saved condition for a player.[player][player]Player for which the condition will be checkedAcceptsonline player name · /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.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>Name of your new categoryAcceptstext · listlistLists every quest category. · editeditOpens subcommands for editing a quest category.<category><category>Category to editAcceptscategory 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.AcceptsTagType value<name><name>Unique name for the tag to create.Acceptstext · listlistLists every configured player tag. · deletedeleteDeletes the selected player tag.<name><name>Name of the existing tag to delete.Acceptstext - 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 Item.<name><name>Item NameAcceptstext<material><material>Material of what this item should be based on. If you use 'hand', the item you are holding in your notQuests hand will be used.Acceptsmaterial, custom item, hand, any, or comma-separated materials · listlistLists every saved NotQuests item. · givegiveGives the selected NotQuests item to a player.<player><player>Player who should receive the itemAcceptsonline player name<amount><amount>Amount of items the player should receiveAcceptswhole number · editeditOpens subcommands for editing a saved NotQuests item.<name><name>NotQuests Item which you want to edit.AcceptsNPC selector such as citizens:1, fancynpcs:<id>, none, or rightClickSelect...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 player a quest without bypassing the Quest requirements.<player><player>Player who should start the quest.Acceptsonline player name<quest><quest>Name of the Quest the player should start.Acceptsquest name - Give a player a quest (skips requirements).
/qa/qaAdmin commands for NotQuestscompleteQuestcompleteQuestCompletes an active quest for a player.<player><player>Player name whose quest should be completed.Acceptsonline player name<activeQuest><activeQuest>Active quest which should be completed.Acceptsactive quest name / failQuestfailQuestFails an active quest for a player.<player><player>Player name whose quest should be failed.Acceptsonline player name<activeQuest><activeQuest>Active quest which should be failed.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 whose quest data should be reset and removed.Acceptsonline player name<quest><quest>Name of the Quest which should be reset and removed.Acceptsquest name / resetAndFailQuestForAllPlayersresetAndFailQuestForAllPlayersResets and fails this quest for every player.<quest><quest>Name of the Quest which should be reset and failed.Acceptsquest name - Reset and remove/fail.
/qa/qaAdmin commands for NotQuestsprogressprogressShows the progress for a quest of another player<player><player>Player progress you want to seeAcceptsonline player name<activeQuest><activeQuest>Quest name of the quest you wish to see the progress for.Acceptsactive quest name · activeQuestsactiveQuestsShows active quests for a player.<player><player>Player to display the completed quests of.Acceptsonline player name · completedQuestscompletedQuestsShows completed quests for a player.<player><player>Player to display the completed quests of.Acceptsonline player name - Inspect a player.
/qa/qaAdmin commands for NotQuestsquestpointsquestpointsShows or changes a player's quest points.<player><player>Player whose questpoints amount you want to change.Acceptsonline player nameaddaddAdds quest points to the selected player.<amount><amount>Amount of questpoints to addAcceptswhole number / removeremoveRemoves quest points from the selected player.<amount><amount>Amount of questpoints to removeAcceptswhole number / setsetSets the selected player's quest points to an exact amount.<amount><amount>New questpoints amountAcceptswhole number / 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--printToConsolePrints the output to the console - 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. · beaconBeambeaconBeamDebugs or previews a beacon beam.<player><player>Player who should see the debug beacon beam.Acceptsonline player name<name><name>Temporary debug name used to identify this beacon beam location.Acceptstext<location><location>World and coordinates where the debug beacon beam should appear.Acceptslocation as x,y,z or world,x,y,z - Misc debug helpers.
/qa/qaAdmin commands for NotQuestsdebugdebugOpens NotQuests debug utilities.loadDataManagerUnsafeloadDataManagerUnsafeDebug command that reloads the data manager unsafely. · disablePluginAndSavingdisablePluginAndSavingDebug command that disables plugin saving.<reason><reason>Reason for disabling the pluginAcceptstext · enablePluginAndSavingenablePluginAndSavingDebug command that re-enables plugin saving.<reason><reason>Reason for enabling the pluginAcceptstext - 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>]Optional command name, topic, or search text to show admin help for.Acceptstext open a searchable, clickable help menu — handy when you can't remember the exact path.