⭐ Variables
Variables are used internally to create both advanced actions and conditions at the same time- and that much quicker! A lot of the following variables can thus be used as conditions and, in many cases, as actions as well. Not only that - they can also be used in so-called expressions. So you can even do calculations with these variables!
Default variables
❓ ActiveQuests
Condition: ✅ Action: ✅
Type: String List
Example conditions:
- /qa conditions add isWoodCutterQuestActive ActiveQuests contains woodCutter - Condition is fulfilled if the player has the woodCutter quest active
- /qa conditions add isOnlyWoodCutterQuestActive ActiveQuests equals woodCutter - Condition is fulfilled if the player has ONLY the woodCutter quest active and no other quest
- /qa conditions add hasAllWoodQuestsActive ActiveQuests contains woodCutter,saveTheWoods - Condition is fulfilled if the player has BOTH the woodCutter and saveTheWoods quests active
Example actions:
- /qa actions add giveQuestWoodCutter ActiveQuests add woodCutter - This action force-gives the woodCutter quest to the player
- /qa actions add setQuestWoodCutter ActiveQuests set woodCutter - This action force-gives the woodCutter quest to the player and fails all other quests the player currently has
- /qa actions add setQuestWoodCutter ActiveQuests set woodCutter - This action force-gives the woodCutter quest to the player and fails all other quests the player currently has
- /qa actions add giveForestQuests ActiveQuests add woodCutter,saveTheWoods - This action force-gives both the woodCutter quest and the saveTheWoods quest to the player
❓ Advancement
Condition: ✅ Action: ✅
Type: Boolean
❓ Block
Condition: ✅ Action: ✅
Type: String
❓ Chance
Condition: ✅ Action: ❌
Type: Boolean
❓ Climbing
Condition: ✅ Action: ❌
Type: Boolean
❓ CompletedObjectiveIDsOfQuest
Condition: ✅ Action: ✅
Type: String List
❓ CompletedQuests
Condition: ✅ Action: ✅
Type: String List
❓ Condition
Condition: ✅ Action: ❌
Type: Boolean
❓ ContainerInventory
Condition: ✅ Action: ✅
Type: ItemStack List
❓ CurrentBiome
Condition: ✅ Action: ❌
Type: String
❓ CurrentPositionX
Condition: ✅ Action: ✅
Type: Double
❓ CurrentPositionY
Condition: ✅ Action: ✅
Type: Double
❓ CurrentPositionZ
Condition: ✅ Action: ✅
Type: Double
❓ CurrentWorld
Condition: ✅ Action: ✅
Type: String
Reads the world the player is currently in. As an action, it teleports the player to that world's spawn.
❓ DayOfWeek
Condition: ✅ Action: ❌
Type: String
❓ DistanceToLocation
Condition: ✅ Action: ❌
Type: Double
Returns the player's distance in blocks from a fixed location. If the player is in a different world, the value is very large so “less than” checks will not pass by accident.
Arguments: <world> <x> <y> <z>
Example condition: /qa conditions add nearShrine DistanceToLocation world 120 72 -45 lessThan 8
❓ EnderChest
Condition: ✅ Action: ✅
Type: ItemStack List
❓ Experience
Condition: ✅ Action: ✅
Type: Integer
❓ ExperienceLevel
Condition: ✅ Action: ✅
Type: Integer
❓ False
Condition: ✅ Action: ❌
Type: Boolean
❓ Flying
Condition: ✅ Action: ✅
Type: Boolean
❓ FlySpeed
Condition: ✅ Action: ✅
Type: Float
❓ FoodLevel
Condition: ✅ Action: ✅
Type: Integer
Reads or changes the player's hunger bar value from 0 to 20.
Example condition: /qa conditions add isHungry FoodLevel lessThan 8
Example action: /qa actions add feedPlayer FoodLevel set 20
❓ GameMode
Condition: ✅ Action: ✅
Type: String
❓ Glowing
Condition: ✅ Action: ✅
Type: Boolean
❓ Health
Condition: ✅ Action: ✅
Type: Double
❓ InLava
Condition: ✅ Action: ❌
Type: Boolean
❓ InWater
Condition: ✅ Action: ❌
Type: Boolean
❓ Inventory
Condition: ✅ Action: ✅
Type: ItemStack List
❓ ItemInInventoryEnchantments
Condition: ✅ Action: ❌
Type: String List
❓ MaxHealth
Condition: ✅ Action: ✅
Type: Double
❓ Money
Condition: ✅ Action: ✅
Type: Double
❓ Name
Condition: ✅ Action: ✅
Type: String
❓ NearbyEntityCount
Condition: ✅ Action: ❌
Type: Integer
Counts nearby entities around the player. The player themself is not counted.
Arguments: <entityType> <radius>
Use a mob type like zombie, villager, or wolf, or use any to count all nearby entities.
Example condition: /qa conditions add crowded NearbyEntityCount any 10 moreOrEqualThan 5
❓ Op
Condition: ✅ Action: ✅
Type: Boolean
❓ Permission
Condition: ✅ Action: ✅ (only if LuckPerms is installed)
Type: Boolean
❓ Ping
Condition: ✅ Action: ❌
Type: Integer
❓ PlaytimeTicks
Condition: ✅ Action: ✅
Type: Integer
❓ PlaytimeMinutes
Condition: ✅ Action: ✅
Type: Double
❓ PlaytimeHours
Condition: ✅ Action: ✅
Type: Double
❓ QuestAbleToAccept
Condition: ✅ Action: ❌
Type: Boolean
❓ QuestOnCooldown
Condition: ✅ Action: ❌
Type: Boolean
❓ QuestPoints
Condition: ✅ Action: ✅
Type: Long
❓ QuestReachedMaxAccepts
Condition: ✅ Action: ❌
Type: Boolean
❓ QuestReachedMaxCompletions
Condition: ✅ Action: ❌
Type: Boolean
❓ QuestReachedMaxFails
Condition: ✅ Action: ❌
Type: Boolean
❓ RandomNumberBetweenRange
Condition: ✅ Action: ❌
Type: Integer
❓ ReflectionStaticBoolean
Condition: ✅ Action: ✅
Type: Boolean
❓ ReflectionStaticDouble
Condition: ✅ Action: ✅
Type: Double
❓ ReflectionStaticFloat
Condition: ✅ Action: ✅
Type: Float
❓ ReflectionStaticInteger
Condition: ✅ Action: ✅
Type: Integer
❓ ReflectionStaticString
Condition: ✅ Action: ✅
Type: String
❓ Sleeping
Condition: ✅ Action: ❌
Type: Boolean
❓ Saturation
Condition: ✅ Action: ✅
Type: Float
Reads or changes the player's hidden saturation value. This is Minecraft's extra food buffer before the visible hunger bar starts dropping.
Example condition: /qa conditions add lowSaturation Saturation lessThan 2
Example action: /qa actions add restoreSaturation Saturation set 10
❓ Sneaking
Condition: ✅ Action: ✅
Type: Boolean
❓ Sprinting
Condition: ✅ Action: ✅
Type: Boolean
❓ Swimming
Condition: ✅ Action: ✅
Type: Boolean
❓ True
Condition: ✅ Action: ❌
Type: Boolean
❓ WalkSpeed
Condition: ✅ Action: ✅
Type: Float
❓ Weather
Condition: ✅ Action: ✅
Type: String
Reads or changes the weather in the player's current world. Possible values are clear, rain, and thunder.
Example condition: /qa conditions add isStormy Weather equals thunder
Example action: /qa actions add makeItRain Weather set rain
❓ Statistic
Condition: ✅ Action: ✅
Type: Number
Required argument: the Bukkit statistic to read or change (e.g. MOB_KILLS, JUMP, DAMAGE_DEALT).
Example: /qa conditions add killedEnough Statistic MOB_KILLS moreOrEqualThan 100 - true once the player has 100+ mob kills.
Tag Variables
NotQuests has a powerful tag system: store a custom value on a player — a reputation score, a faction name, a hasMetTheKing flag — and then read or change it anywhere variables work (conditions, actions, objectives, even inside expressions).
First create a tag with /qa tags create <Type> <name> (types: Integer, Double, Float, Boolean, String). Then use the matching variable below. In commands the tag name is positional (TagInteger reputation add 10); inside an expression use the TagInteger(TagName:reputation) form instead.
For a full, practical walkthrough, see the reputation system tutorial.
❓ TagInteger
Condition: ✅ Action: ✅
Type: Number (whole numbers)
Required argument: the tag name (create it with /qa tags create Integer <name>).
Examples:
- /qa conditions add hasRep TagInteger reputation moreOrEqualThan 50 - true once the player's reputation tag is at least 50.
- /qa actions add addRep TagInteger reputation add 10 - adds 10 to the reputation tag.
❓ TagDouble
Condition: ✅ Action: ✅
Type: Number (decimals)
Required argument: the tag name (create it with /qa tags create Double <name>).
❓ TagFloat
Condition: ✅ Action: ✅
Type: Number (decimals)
Required argument: the tag name (create it with /qa tags create Float <name>).
❓ TagBoolean
Condition: ✅ Action: ✅
Type: Boolean
Required argument: the tag name (create it with /qa tags create Boolean <name>).
❓ TagString
Condition: ✅ Action: ✅
Type: String
Required argument: the tag name (create it with /qa tags create String <name>).
PlaceholderAPI Integration Variables
❓ PlaceholderAPINumber
Condition: ✅ Action: ❌
Type: Double
❓ PlaceholderAPIString
Condition: ✅ Action: ❌
Type: String
Towny Integration Variables
❓ TownyNationName
Condition: ✅ Action: ✅
Type: String
❓ TownyNationTownCount
Condition: ✅ Action: ❌
Type: Integer
❓ TownyTownPlotCount
Condition: ✅ Action: ❌
Type: Integer
❓ TownyTownResidentCount
Condition: ✅ Action: ❌
Type: Integer
Floodgate Integration Variables
❓ FloodgateIsFloodgatePlayer
Condition: ✅ Action: ❌
Type: Boolean
BetonQuest 3 Integration Variables
These variables are only available when BetonQuest 3.0.0 or newer is installed. BetonQuest 1.x and 2.x are not supported.
❓ BetonQuestCondition
Condition: ✅ Action: ❌
Type: Boolean
Checks a condition from a BetonQuest package and returns true or false for the current player.
Required arguments:
- <package> - BetonQuest package containing the condition.
- <condition> - Condition name inside that BetonQuest package.
Example command: /qa conditions add has_betonquest_permission BetonQuestCondition main permission_check equals true