🧨 Actions

Raw actions can be created using /qa/qaAdmin commands for NotQuests actionsactionsManages saved actions, inline actions, and action execution.. Those will be saved in the plugins/notquests/categoryname/actions.yml. Actions are also Quest rewards or Objective rewards. An action is, as the name says, an action. Any action. Something "happens".

To "test" an action created via /qa/qaAdmin commands for NotQuests actionsactionsManages saved actions, inline actions, and action execution., you can use /qa/qaAdmin commands for NotQuests actionsactionsManages saved actions, inline actions, and action execution. editeditOpens subcommands for editing a saved action. <action><action>Identifier of the saved action to edit; use /qa actions to list saved actions.Acceptssaved action name executeexecuteExecutes the selected action or command. [player][player]Player for which the action will be executedAcceptsonline player name. It can have the optional flag --ignoreConditions if you want to ignore any conditions attached to this action.

Command Arguments for every action:

• (flags) - Optional flags
  • --category <categoryName> - If this is a raw, actions.yml action, you are able to set its category here
  • --delay <delay> - If this is a raw, actions.yml action, you are able to set its execution delay here. If you enter, for example, 1s, it will be executed in 1 seconds and not immediately.

Default Variable Actions

These actions act as "vessels" for variables. What does that mean?

Well... for example, the NumberAction is such a variable action. In-game, it turns into as many actions as there are number variables, so it's a lot more actions than you think there are. Other than for conditions, not every variable is able to set a value. For example, the DayOfWeek can only be used as a condition, but not as an action.

Makes sense right? You can't just time-travel in real life with a Minecraft plugin. The variable "Money" however can be used as a condition AND an action, since you can see a Player's money, but also change it. In-game money of course 🥲

Please consult the Variables Section for those.

❓ Boolean

Description

What happens: The value of this Boolean variable is set to either true or false

Command Arguments:

• <variable type> Type of the Boolean variable
• <variable arguments> Additional variable arguments which may or may not exist for this specific variable
• <operator> - Valid operators are set and setNot
• <expression> - What the variable should be. Common values are true or false, but you can also set it to a different boolean variables here.

Example commands:

• /qa/qaAdmin commands for NotQuests actionsactionsManages saved actions, inline actions, and action execution. addaddCreates a new saved action. actionname<Action Identifier>Unique identifier for the new saved action.AcceptstextExampleactionname FlyingFlyingSelects the Flying variable for this action, condition, objective, or variable check. set<operator>How to set the Flying boolean variable: set or setNot.AcceptstextExampleset true<expression>Boolean expression used as the new value for Flying.Acceptstrue/false value or boolean expressionExampletrue - Flying would be a Boolean variable type. This action would make the player fly.
• /qa/qaAdmin commands for NotQuests actionsactionsManages saved actions, inline actions, and action execution. addaddCreates a new saved action. pp3<Action Identifier>Unique identifier for the new saved action.AcceptstextExamplepp3 MoneyMoneySelects the Money variable for this action, condition, objective, or variable check. add<operator>How to change the Money number variable: set, add, deduct, multiply, or divide.AcceptstextExampleadd ((TagInteger(TagName:points)>=4)*(10+30))+(!(TagInteger(TagName:points)>=4)*5)<amount>Number expression used as the value for this Money action.Acceptsnumber or numeric expression - This is just to show that very complex actions are also possible with NotQuests expression system. This action does the following: If your "points" (from the Integer tag) are bigger or equal 4, this action will give you 40$. Otherwise, it will give you 5$.

📙 List

Description

What happens: The value of this List variable is changed

Command Arguments:

• <variable type> Type of the List variable
• <variable arguments> Additional variable arguments which may or may not exist for this specific variable
• <operator> - Possible operators are add, clear, remove and set
• <expression> - What the variable should be. This depends on the variable type

Example command: /qa/qaAdmin commands for NotQuests actionsactionsManages saved actions, inline actions, and action execution. addaddCreates a new saved action. actionname<Action Identifier>Unique identifier for the new saved action.AcceptstextExampleactionname ActiveQuestsActiveQuestsSelects the ActiveQuests variable for this action, condition, objective, or variable check. add<operator>How to change the ActiveQuests list variable: set, add, remove, or clear.AcceptstextExampleadd questname<expression>List value or expression used by this ActiveQuests action.Acceptscomma-separated listExamplequestname - ActiveQuests would be a List variable.

📖 ItemStackList

Description

What happens: The value of this ItemStackList variable is changed

Command Arguments:

• <variable type> Type of the ItemStackList variable
• <variable arguments> Additional variable arguments which may or may not exist for this specific variable
• <operator> - Possible operators are add, clear, remove and set
• <expression> - What the variable should be. This depends on the variable type, but they do have to be Items

Example command: /qa/qaAdmin commands for NotQuests actionsactionsManages saved actions, inline actions, and action execution. addaddCreates a new saved action. actionname<Action Identifier>Unique identifier for the new saved action.AcceptstextExampleactionname InventoryInventorySelects the Inventory variable for this action, condition, objective, or variable check. remove<operator>How to change the Inventory item-list variable: set, add, remove, or clear.AcceptstextExampleremove hand<expression>Item or item-list expression used by this Inventory action.Acceptsmaterial, custom item, hand, or anyExamplehand 3<amount>Stack amount to apply for each item in this item-list action.Acceptswhole numberExample3 - Inventory would be an ItemStackList variable.

💯 Number

Description

What happens: The value of this Number variable is changed

Command Arguments:

• <variable type> Type of the Number variable
• <variable arguments> Additional variable arguments which may or may not exist for this specific variable
• <operator> - Valid operators are add, deduct, divide, multiply and set
• <expression> - What the result of the variable should be. This expression is cool, because it can contain any kind of math expression. And it can even contain other number variables.

Example command: /qa/qaAdmin commands for NotQuests actionsactionsManages saved actions, inline actions, and action execution. addaddCreates a new saved action. actionname<Action Identifier>Unique identifier for the new saved action.AcceptstextExampleactionname MoneyMoneySelects the Money variable for this action, condition, objective, or variable check. multiply<operator>How to change the Money number variable: set, add, deduct, multiply, or divide.AcceptstextExamplemultiply 2<amount>Number expression used as the value for this Money action.Acceptsnumber or numeric expressionExample2 - Flying would be a Number variable type. This action would make the player fly. Example command with math expression + other variables: /qa/qaAdmin commands for NotQuests actionsactionsManages saved actions, inline actions, and action execution. addaddCreates a new saved action. actionname<Action Identifier>Unique identifier for the new saved action.AcceptstextExampleactionname MoneyMoneySelects the Money variable for this action, condition, objective, or variable check. set<operator>How to change the Money number variable: set, add, deduct, multiply, or divide.AcceptstextExampleset QuestPoints*Money+500-30/2<amount>Number expression used as the value for this Money action.Acceptsnumber or numeric expressionExampleQuestPoints*Money+500-30/2 Example command with very advanced expression: /qa/qaAdmin commands for NotQuests actionsactionsManages saved actions, inline actions, and action execution. addaddCreates a new saved action. actionname<Action Identifier>Unique identifier for the new saved action.AcceptstextExampleactionname MoneyMoneySelects the Money variable for this action, condition, objective, or variable check. set<operator>How to change the Money number variable: set, add, deduct, multiply, or divide.AcceptstextExampleset 10+TagInteger(TagName:reputation)*TagInteger(TagName:level)<amount>Number expression used as the value for this Money action.Acceptsnumber or numeric expressionExample10+TagInteger(TagName:reputation)*TagInteger(TagName:level)

🆎 String

Description

What happens: The value of this String variable is changed

Command Arguments:

• <variable type> Type of the String variable
• <variable arguments> Additional variable arguments which may or may not exist for this specific variable
• <operator> - Valid operators are set and append
• <expression> - What the result of the variable should be. This depends on the variable type, but it has to be a String (= text)

Example command: /qa/qaAdmin commands for NotQuests actionsactionsManages saved actions, inline actions, and action execution. addaddCreates a new saved action. actionname<Action Identifier>Unique identifier for the new saved action.AcceptstextExampleactionname CurrentWorldCurrentWorldSelects the CurrentWorld variable for this action, condition, objective, or variable check. set<operator>How to change the CurrentWorld string variable: set or append.AcceptstextExampleset world<string>String value or expression used by this CurrentWorld action.Acceptstext valueExampleworld - CurrentWorld would be a String variable type. This action teleports the player to another world.

Default Actions

These are the default, "standalone" actions and don't depend on variables.

🤓 Action

Description

What happens: One or multiple other actions are executed. Yes, this simply executes other actions defined in the actions.yml.

Command Arguments:

• <Other Action Name> - Name of the other action(s) which needs to be executed.
• Optional: <amount> - Amount of times the other action should be executed.
• (flags) - Optional flags
  • --ignoreConditions - If you set this flag, all conditions added to the other action which should be executed will be ignored. It will be executed no matter if they are fulfilled or not.
  • --minRandom <amount> - If this is set, it will only execute a random amount of quests with this minimum
  • --maxRandom <amount> - If this is set, it will only execute a random amount of quests with this maximum
  • --onlyCountForRandomIfConditionsFulfilled - Does not count an action to the min or max random counter if its conditions are not fulfilled, if this flag is set
  • --executedActionDelay - Sets the delay for which all included actions will be executed. This overrides possible existing delays.

Example commands:

• /qa/qaAdmin commands for NotQuests actionsactionsManages saved actions, inline actions, and action execution. addaddCreates a new saved action. actionname<Action Identifier>Unique identifier for the new saved action.AcceptstextExampleactionname ActionActionAction action type. a1<Actions>Name of the actions which will be executedAcceptscomma-separated saved action namesExamplea1 2<amount>Amount of times the action will be executed.Acceptswhole numberExample2 --ignoreConditions--ignoreConditionsIgnores action conditions - This executes the action a1 two times, regardless of the conditions of action a1.
• /qa/qaAdmin commands for NotQuests actionsactionsManages saved actions, inline actions, and action execution. addaddCreates a new saved action. actionname<Action Identifier>Unique identifier for the new saved action.AcceptstextExampleactionname ActionActionAction action type. a1,a2,money10<Actions>Name of the actions which will be executedAcceptscomma-separated saved action namesExamplea1,a2,money10 1<amount>Amount of times the action will be executed.Acceptswhole numberExample1 - This executes the actions a1, a2 and money10.

Example commands for random actions: For these commands, I have pre-created the actions sm1, sm2, sm3 ... sm10 which are all different SendMessage actions.

• /qa/qaAdmin commands for NotQuests actionsactionsManages saved actions, inline actions, and action execution. addaddCreates a new saved action. sendAllMessages<Action Identifier>Unique identifier for the new saved action.AcceptstextExamplesendAllMessages ActionActionAction action type. sm1,sm2,sm3,sm4,sm5,sm6,sm7,sm8,sm9,sm10<Actions>Name of the actions which will be executedAcceptscomma-separated saved action namesExamplesm1,sm2,sm3,sm4,sm5,sm6,sm7,sm8,sm9,sm10 1<amount>Amount of times the action will be executed.Acceptswhole numberExample1 - Executes all 10 actions in the specified order
• /qa/qaAdmin commands for NotQuests actionsactionsManages saved actions, inline actions, and action execution. addaddCreates a new saved action. sendAllMessagesInRandomOrder<Action Identifier>Unique identifier for the new saved action.AcceptstextExamplesendAllMessagesInRandomOrder ActionActionAction action type. sm1,sm2,sm3,sm4,sm5,sm6,sm7,sm8,sm9,sm10<Actions>Name of the actions which will be executedAcceptscomma-separated saved action namesExamplesm1,sm2,sm3,sm4,sm5,sm6,sm7,sm8,sm9,sm10 1<amount>Amount of times the action will be executed.Acceptswhole numberExample1 --minRandom--minRandomMinimum number of referenced actions to choose when executing a random subset.Acceptswhole number 10Value for --minRandomMinimum number of referenced actions to choose when executing a random subset.Acceptswhole numberExample10 --maxRandom--maxRandomMaximum number of referenced actions to choose when executing a random subset.Acceptswhole number 10Value for --maxRandomMaximum number of referenced actions to choose when executing a random subset.Acceptswhole numberExample10 - Executes all 10 actions in a random order
• /qa/qaAdmin commands for NotQuests actionsactionsManages saved actions, inline actions, and action execution. addaddCreates a new saved action. sendRandomMessage<Action Identifier>Unique identifier for the new saved action.AcceptstextExamplesendRandomMessage ActionActionAction action type. sm1,sm2,sm3,sm4,sm5,sm6,sm7,sm8,sm9,sm10<Actions>Name of the actions which will be executedAcceptscomma-separated saved action namesExamplesm1,sm2,sm3,sm4,sm5,sm6,sm7,sm8,sm9,sm10 1<amount>Amount of times the action will be executed.Acceptswhole numberExample1 --minRandom--minRandomMinimum number of referenced actions to choose when executing a random subset.Acceptswhole number 1Value for --minRandomMinimum number of referenced actions to choose when executing a random subset.Acceptswhole numberExample1 --maxRandom--maxRandomMaximum number of referenced actions to choose when executing a random subset.Acceptswhole number 1Value for --maxRandomMaximum number of referenced actions to choose when executing a random subset.Acceptswhole numberExample1 - Sends exactly one random action ouf of the provided actions
• /qa/qaAdmin commands for NotQuests actionsactionsManages saved actions, inline actions, and action execution. addaddCreates a new saved action. sendGuaranteedRandomMessage<Action Identifier>Unique identifier for the new saved action.AcceptstextExamplesendGuaranteedRandomMessage ActionActionAction action type. sm1,sm2,sm3,sm4,sm5,sm6,sm7,sm8,sm9,sm10<Actions>Name of the actions which will be executedAcceptscomma-separated saved action namesExamplesm1,sm2,sm3,sm4,sm5,sm6,sm7,sm8,sm9,sm10 1<amount>Amount of times the action will be executed.Acceptswhole numberExample1 --minRandom--minRandomMinimum number of referenced actions to choose when executing a random subset.Acceptswhole number 1Value for --minRandomMinimum number of referenced actions to choose when executing a random subset.Acceptswhole numberExample1 --maxRandom--maxRandomMaximum number of referenced actions to choose when executing a random subset.Acceptswhole number 1Value for --maxRandomMaximum number of referenced actions to choose when executing a random subset.Acceptswhole numberExample1 --onlyCountForRandomIfConditionsFulfilled--onlyCountForRandomIfConditionsFulfilledDoes not count an action to the min or max random counter if its conditions are not fulfilled, if this flag is set - This is useful if your actions have conditions attached to them. It does exactly the same as the previous action. However, in case the action it chooses does not fulfill its condition, it will try out another action instead. The previous action however would simply send nothing
• /qa/qaAdmin commands for NotQuests actionsactionsManages saved actions, inline actions, and action execution. addaddCreates a new saved action. sendOneOrTwoRandomMessage<Action Identifier>Unique identifier for the new saved action.AcceptstextExamplesendOneOrTwoRandomMessage ActionActionAction action type. sm1,sm2,sm3,sm4,sm5,sm6,sm7,sm8,sm9,sm10<Actions>Name of the actions which will be executedAcceptscomma-separated saved action namesExamplesm1,sm2,sm3,sm4,sm5,sm6,sm7,sm8,sm9,sm10 1<amount>Amount of times the action will be executed.Acceptswhole numberExample1 --minRandom--minRandomMinimum number of referenced actions to choose when executing a random subset.Acceptswhole number 1Value for --minRandomMinimum number of referenced actions to choose when executing a random subset.Acceptswhole numberExample1 --maxRandom--maxRandomMaximum number of referenced actions to choose when executing a random subset.Acceptswhole number 2Value for --maxRandomMaximum number of referenced actions to choose when executing a random subset.Acceptswhole numberExample2 - Executes either one or two random actions out of the provided actions

🔆 Beam

Description

What happens: A beacon-style light beam is spawned (or removed) at a location. Handy for marking a quest objective spot from far away.

Command Arguments:

• <beamName> - A name for this beam, so you can remove it again later.
• spawn <world> <x> <y> <z> - Spawns the beam at these coordinates.
• remove - Removes the beam with that name instead.

Example commands:

• /qa/qaAdmin commands for NotQuests actionsactionsManages saved actions, inline actions, and action execution. addaddCreates a new saved action. showbeam<Action Identifier>Unique identifier for the new saved action.AcceptstextExampleshowbeam BeamBeamBeam action type. questbeam<beamName>Identifier to assign to the spawned beam.AcceptstextExamplequestbeam spawnspawnSpawns or displays the configured object or effect. world<world>World where the beam should be spawned.Acceptsworld nameExampleworld 100<x>X coordinate where the beam should be spawned.Acceptswhole numberExample100 64<y>Y coordinate where the beam should be spawned.Acceptswhole numberExample64 200<z>Z coordinate where the beam should be spawned.Acceptswhole numberExample200
• /qa/qaAdmin commands for NotQuests actionsactionsManages saved actions, inline actions, and action execution. addaddCreates a new saved action. hidebeam<Action Identifier>Unique identifier for the new saved action.AcceptstextExamplehidebeam BeamBeamBeam action type. questbeam<beamName>Identifier to assign to the spawned beam.AcceptstextExamplequestbeam removeremoveRemoves the named beam from the player's screen.

📢 BroadcastMessage

Description

What happens: A message is broadcast to everyone on the server. Supports MiniMessage formatting (<gold>, <bold>, ...).

Command Arguments:

• <message> - The message to broadcast.

Example command: /qa/qaAdmin commands for NotQuests actionsactionsManages saved actions, inline actions, and action execution. addaddCreates a new saved action. announce<Action Identifier>Unique identifier for the new saved action.AcceptstextExampleannounce BroadcastMessageBroadcastMessageBroadcastMessage action type. <gold>A hero has risen!<Broadcast Message>Message that should be broadcast to the server.Acceptstext

💬 Chat

Description

What happens: The player sends a chat message, exactly as if they typed it themselves.

Command Arguments:

• <message> - The message the player should say. Wrap it in quotes.

Example command: /qa/qaAdmin commands for NotQuests actionsactionsManages saved actions, inline actions, and action execution. addaddCreates a new saved action. greet<Action Identifier>Unique identifier for the new saved action.AcceptstextExamplegreet ChatChatChat action type. "Hey everyone, I'm on an adventure!"<Chat Message>Message which will be sent / chatted from the player's perspective.AcceptstextExample"Hey everyone, I'm on an adventure!"

❌ CloseInventory

Description

What happens: Closes whatever inventory or GUI the player currently has open. Useful at the end of a conversation or after opening a menu.

Command Arguments: None

Example command: /qa/qaAdmin commands for NotQuests actionsactionsManages saved actions, inline actions, and action execution. addaddCreates a new saved action. closegui<Action Identifier>Unique identifier for the new saved action.AcceptstextExampleclosegui CloseInventoryCloseInventoryCloseInventory action type.

✅ CompleteQuest

Description

What happens: Instantly completes a Quest for the player, as if they finished every objective.

Command Arguments:

• <quest> - The Quest to complete.

Example command: /qa/qaAdmin commands for NotQuests actionsactionsManages saved actions, inline actions, and action execution. addaddCreates a new saved action. finishtutorial<Action Identifier>Unique identifier for the new saved action.AcceptstextExamplefinishtutorial CompleteQuestCompleteQuestCompleteQuest action type. tutorial<quest to complete>Name of the Quest which should be completed for the player.Acceptsquest nameExampletutorial

🖥️ ConsoleCommand

Description

What happens: Runs a command from the console. Use this whenever you need elevated permissions — giving currency through another economy plugin, granting a LuckPerms group, etc. %player% is replaced with the player's name.

Command Arguments:

• <command> - The command to run (no leading slash).

Example command: /qa/qaAdmin commands for NotQuests actionsactionsManages saved actions, inline actions, and action execution. addaddCreates a new saved action. payout<Action Identifier>Unique identifier for the new saved action.AcceptstextExamplepayout ConsoleCommandConsoleCommandConsoleCommand action type. eco give %player% 500<Console Command>Command which will be executed from the console as a reward. A '/' at the beginning is not required.Acceptscommand textExampleeco give %player% 500

💥 FailQuest

Description

What happens: Fails a Quest for the player.

Command Arguments:

• <quest> - The Quest to fail.

Example command: /qa/qaAdmin commands for NotQuests actionsactionsManages saved actions, inline actions, and action execution. addaddCreates a new saved action. botched<Action Identifier>Unique identifier for the new saved action.AcceptstextExamplebotched FailQuestFailQuestFailQuest action type. heist<quest to fail>Name of the Quest which should be failed for the player.Acceptsquest nameExampleheist

🎒 GiveItem

Description

What happens: Gives an item to the player. Works with vanilla materials and items made in the NotQuests item system.

Command Arguments:

• <material> - The item to give. Vanilla material name or a NotQuests custom item.
• <amount> - How many.

Example command: /qa/qaAdmin commands for NotQuests actionsactionsManages saved actions, inline actions, and action execution. addaddCreates a new saved action. reward_diamonds<Action Identifier>Unique identifier for the new saved action.AcceptstextExamplereward_diamonds GiveItemGiveItemGiveItem action type. diamond<material>Material of the item which the player should receive. If you use 'hand', the item you are holding in your main hand will be used.Acceptsmaterial, custom item, hand, any, or comma-separated materialsExamplediamond 16<amount>Amount of items which the player will receive.Acceptswhole numberExample16

📜 GiveQuest

Description

What happens: Gives (starts) a Quest for the player.

Command Arguments:

• <quest> - The Quest to give.
• (flags) - Optional flags
  • --forceGive - Gives the quest even if the player doesn't meet its requirements or is on cooldown.

Example command: /qa/qaAdmin commands for NotQuests actionsactionsManages saved actions, inline actions, and action execution. addaddCreates a new saved action. startchapter2<Action Identifier>Unique identifier for the new saved action.AcceptstextExamplestartchapter2 GiveQuestGiveQuestGiveQuest action type. chapter2<quest to give>Name of the Quest which should be given to the player.Acceptsquest nameExamplechapter2 --forceGive--forceGiveForce-gives the Quest to the player, disregarding most Quest requirements/cooldowns/...

🪟 OpenGui

Description

What happens: Opens one of NotQuests' GUIs for the player.

Command Arguments:

• <guiName> - The GUI to open.
• (flags) - Optional flags
  • --targetPlayer <player> - Open it for a different player.
  • --quest <quest> - Pass a quest to the GUI (for quest-specific GUIs like the preview).
  • --npc <npcID> - Pass an NPC to the GUI.
  • --category <category> - Pass a category to the GUI.

Example command: /qa/qaAdmin commands for NotQuests actionsactionsManages saved actions, inline actions, and action execution. addaddCreates a new saved action. showquests<Action Identifier>Unique identifier for the new saved action.AcceptstextExampleshowquests OpenGuiOpenGuiOpenGui action type. questsoverview<guiName>Name of the NotQuests GUI file to open.AcceptstextExamplequestsoverview

🔊 PlaySound

Description

What happens: Plays a sound for the player — or for everyone, at a location.

Command Arguments:

• <sound> - The sound to play (e.g. entity.player.levelup).
• (flags) - Optional flags
  • --volume <0-1> - How loud.
  • --pitch <float> - How high/low.
  • --SoundCategory <category> - Sound category (master, music, ...).
  • --stopOtherSounds - Stops all other sounds first.
  • --playForEveryoneAtSetLocation - Everyone hears it, coming from a fixed location.
  • --playForEveryoneAtTheirLocation - Everyone hears it, at their own location.
  • --world, --locationX, --locationY, --locationZ - The fixed location to play it at.

Example command: /qa/qaAdmin commands for NotQuests actionsactionsManages saved actions, inline actions, and action execution. addaddCreates a new saved action. levelup<Action Identifier>Unique identifier for the new saved action.AcceptstextExamplelevelup PlaySoundPlaySoundPlaySound action type. entity.player.levelup<Sound>Name of the sound which should be playedAcceptstextExampleentity.player.levelup --volume--volumeSound volume, usually between 0 and 1.Acceptsnumber 0.8Value for --volumeSound volume, usually between 0 and 1.AcceptsnumberExample0.8 --pitch--pitchSound pitch multiplier used when playing the sound.Acceptsnumber 1.2Value for --pitchSound pitch multiplier used when playing the sound.AcceptsnumberExample1.2

✨ SpawnParticle

Description

What happens: Spawns a visual particle effect at the player's location or at fixed coordinates.

Only particles that do not need extra Bukkit data are supported by this action. Examples include happy_villager, flame, heart, cloud, and end_rod.

Command Arguments:

• <particle> - Particle effect to spawn.
• <count> - Number of particles.
• PlayerLocation or Location <world> <x> <y> <z> - Where to spawn the particles.
• (flags) - Optional flags
  • --offsetX <number>, --offsetY <number>, --offsetZ <number> - Random spread around the particle location.
  • --speed <number> - Particle speed value.
  • --forEveryone - Show the particles to every online player instead of only the target player.

Example command: /qa/qaAdmin commands for NotQuests actionsactionsManages saved actions, inline actions, and action execution. addaddCreates a new saved action. sparkle<Action Identifier>Unique identifier for the new saved action.AcceptstextExamplesparkle SpawnParticleSpawnParticleSpawns a particle effect at the target player or a fixed location. happy_villager<particle>Particle effect to spawn. Only particles that do not require extra data are supported.AcceptstextExamplehappy_villager 12<count>Number of particles to spawn.Acceptswhole numberExample12 PlayerLocationPlayerLocationSpawns the particles at the target player's current location. --offsetY--offsetYRandom Y spread around the particle location.Acceptsnumber 0.5Value for --offsetYRandom Y spread around the particle location.AcceptsnumberExample0.5

🧑 PlayerCommand

Description

What happens: Runs a command as the player (with their permissions). %player% is replaced with their name.

Command Arguments:

• <command> - The command to run (no leading slash).

Example command: /qa/qaAdmin commands for NotQuests actionsactionsManages saved actions, inline actions, and action execution. addaddCreates a new saved action. gohome<Action Identifier>Unique identifier for the new saved action.AcceptstextExamplegohome PlayerCommandPlayerCommandPlayerCommand action type. home<Player Command>Command which will be executed from the player's perspective. A '/' at the beginning is not required.Acceptscommand textExamplehome

✉️ SendMessage

Description

What happens: Sends a private message to the player. Supports MiniMessage formatting.

Command Arguments:

• <message> - The message to send.

Example command: /qa/qaAdmin commands for NotQuests actionsactionsManages saved actions, inline actions, and action execution. addaddCreates a new saved action. congrats<Action Identifier>Unique identifier for the new saved action.AcceptstextExamplecongrats SendMessageSendMessageSendMessage action type. <green>Nice work — the village is safe again!<Sending Message>Message that should be sent to the target player.Acceptstext

🖥️ ShowActionBar

Description

What happens: Shows a short message above the player's hotbar. Supports MiniMessage formatting and NotQuests placeholders.

Command Arguments:

• <message> - The action-bar message to show.

Example command: /qa/qaAdmin commands for NotQuests actionsactionsManages saved actions, inline actions, and action execution. addaddCreates a new saved action. hint<Action Identifier>Unique identifier for the new saved action.AcceptstextExamplehint ShowActionBarShowActionBarShows a short message above the target player's hotbar. <yellow>Look for the smoke above the ruins<message>Action-bar message shown above the target player's hotbar. Supports MiniMessage formatting and NotQuests placeholders.Acceptstext

🏷️ ShowTitle

Description

What happens: Shows a big title in the middle of the player's screen.

Put | between the title and subtitle if you want both. Use the timed form when you want custom fade and stay durations.

Command Arguments:

• <title> - The title text. Supports MiniMessage formatting and NotQuests placeholders.
• timed <fadeIn> <stay> <fadeOut> <title> - Optional form with custom title timings. Durations can be 250ms, 2s, 1m, and so on.

Example commands:

• /qa/qaAdmin commands for NotQuests actionsactionsManages saved actions, inline actions, and action execution. addaddCreates a new saved action. chapterTitle<Action Identifier>Unique identifier for the new saved action.AcceptstextExamplechapterTitle ShowTitleShowTitleShows a title overlay in the center of the target player's screen. <gold>Chapter 2|<gray>The Old Mine<title>Title text shown in the center of the target player's screen. Supports MiniMessage formatting and NotQuests placeholders. Use a vertical bar (`|`) to add a subtitle.Acceptstext
• /qa/qaAdmin commands for NotQuests actionsactionsManages saved actions, inline actions, and action execution. addaddCreates a new saved action. fastTitle<Action Identifier>Unique identifier for the new saved action.AcceptstextExamplefastTitle ShowTitleShowTitleShows a title overlay in the center of the target player's screen. timedtimedCreates a title action with custom fade-in, stay, and fade-out durations. 250ms<fadeIn>How long the title should fade in. Examples: 250ms, 1s.Acceptsduration such as 500ms, 1s, 5m, or 2hExample250ms 2s<stay>How long the title should stay fully visible. Examples: 3s, 1500ms.Acceptsduration such as 500ms, 1s, 5m, or 2hExample2s 500ms<fadeOut>How long the title should fade out. Examples: 500ms, 1s.Acceptsduration such as 500ms, 1s, 5m, or 2hExample500ms <green>Quest Complete<title>Title text shown in the center of the target player's screen. Supports MiniMessage formatting and NotQuests placeholders. Use a vertical bar (`|`) to add a subtitle.Acceptstext

🧟 SpawnMob

Description

What happens: Spawns mobs — either right on the player, or at fixed coordinates.

Command Arguments:

• <entityType> - The mob to spawn (e.g. ZOMBIE).
• <amount> - How many.
• PlayerLocation or Location <world> <x> <y> <z> - Where to spawn them. PlayerLocation is dynamic (wherever the player is when the action runs).
• (flags) - Optional flags
  • --spawnRadiusX <n>, --spawnRadiusY <n>, --spawnRadiusZ <n> - Scatter the mobs randomly within this radius around the spawn point.

Example command: /qa/qaAdmin commands for NotQuests actionsactionsManages saved actions, inline actions, and action execution. addaddCreates a new saved action. ambush<Action Identifier>Unique identifier for the new saved action.AcceptstextExampleambush SpawnMobSpawnMobSpawnMob action type. ZOMBIE<entityType>Type of Entity which should be spawned.Acceptsentity type or anyExampleZOMBIE 5<amount>Amount of mobs which should be spawnedAcceptswhole numberExample5 PlayerLocationPlayerLocationUses the target player's current location. --spawnRadiusX--spawnRadiusXHorizontal X radius, in blocks, to randomize the spawn location around the target.Acceptswhole number 3Value for --spawnRadiusXHorizontal X radius, in blocks, to randomize the spawn location around the target.Acceptswhole numberExample3 --spawnRadiusZ--spawnRadiusZHorizontal Z radius, in blocks, to randomize the spawn location around the target.Acceptswhole number 3Value for --spawnRadiusZHorizontal Z radius, in blocks, to randomize the spawn location around the target.Acceptswhole numberExample3

🗨️ StartConversation

Description

What happens: Starts a conversation for the player.

Command Arguments:

• <conversation> - The conversation to start.
• (flags) - Optional flags
  • --endPrevious - If the player is already in a conversation, end it first.

Example command: /qa/qaAdmin commands for NotQuests actionsactionsManages saved actions, inline actions, and action execution. addaddCreates a new saved action. talktoking<Action Identifier>Unique identifier for the new saved action.AcceptstextExampletalktoking StartConversationStartConversationStartConversation action type. king_intro<conversation to start>Name of the Conversation which should be started.Acceptsconversation nameExampleking_intro --endPrevious--endPreviousEnds the previous conversation furst if the player is already in another conversation

🎯 TriggerCommand

Description

What happens: Fires a named TriggerCommand objective. This is how you complete one of those "do something, then we mark it done" objectives from an action — for example after a player flips a lever or reaches a region.

Command Arguments:

• <triggerName> - The name of the trigger to fire (matches the name on the TriggerCommand objective).

Example command: /qa/qaAdmin commands for NotQuests actionsactionsManages saved actions, inline actions, and action execution. addaddCreates a new saved action. pulllever<Action Identifier>Unique identifier for the new saved action.AcceptstextExamplepulllever TriggerCommandTriggerCommandTriggerCommand action type. lever1<Trigger Name>Name of the trigger which should be triggered.AcceptstextExamplelever1

🧭 Teleport

Description

What happens: Teleports the target player to a fixed location.

Command Arguments:

• <world> - World to teleport to.
• <x> <y> <z> - Coordinates to teleport to.
• (flags) - Optional flags
  • --yaw <number> - Direction the player should face after teleporting.
  • --pitch <number> - Up/down look angle after teleporting.

Example command: /qa/qaAdmin commands for NotQuests actionsactionsManages saved actions, inline actions, and action execution. addaddCreates a new saved action. sendToDungeon<Action Identifier>Unique identifier for the new saved action.AcceptstextExamplesendToDungeon TeleportTeleportTeleports the target player to a fixed world location. world<world>World where the target player should be teleported.Acceptsworld nameExampleworld 120<x>X coordinate where the target player should be teleported.AcceptsnumberExample120 65<y>Y coordinate where the target player should be teleported.AcceptsnumberExample65 -34<z>Z coordinate where the target player should be teleported.AcceptsnumberExample-34 --yaw--yawOptional yaw rotation after teleporting.Acceptsnumber 90Value for --yawOptional yaw rotation after teleporting.AcceptsnumberExample90

BetonQuest 3 Integration Actions

These actions are only available when BetonQuest 3.0.0 or newer is installed. BetonQuest 1.x and 2.x are not supported.

BetonQuest 3 calls these "actions"; older BetonQuest docs may call the same thing "events". NotQuests keeps the old FireEvent names so existing setups are easier to recognize.

ℹ️ BetonQuestFireEvent

Description

What happens: Runs a named BetonQuest action from a BetonQuest package.

Use this when the BetonQuest action is already defined in a package and you want NotQuests to trigger it as a reward, saved action, trigger, or objective reward.

Command Arguments:

• <package> - BetonQuest package containing the action.
• <action> - Action name inside that BetonQuest package.

Example command: /qa actions add run_betonquest_action BetonQuestFireEvent main reward_player

ℹ️ BetonQuestFireInlineEvent

Description

What happens: Runs a BetonQuest action instruction written directly in the NotQuests command.

Use this for small one-off BetonQuest actions. If the instruction gets long or reused often, define it in a BetonQuest package and use BetonQuestFireEvent instead.

Command Arguments:

• <action> - Full inline BetonQuest action instruction.

Example command: /qa actions add notify_from_betonquest BetonQuestFireInlineEvent notify Hello from BetonQuest