NotQuests

• [+] New Actions: Chat and PlayerCommand
• [+] More color settings for console: Downsample colors or disable colors completely
• [^] Complete revamp of the integrationsmanager, making it more flexible and stable

Examples for the most major changes are below. Changes:

• [+] New item / block selector! You can specify multiple materials now.
• [+] New super powerful objective: NumberVariable objective.
• [+] Added ItemInInventoryEnchantments variable
• [^] More control over objective conditions: Unlock, progress & complete conditions
• [^] Added more customization options for the GUI
• [@] Added complete Chinese translations
• [!] Many smaller bug fixes

New Item / Block selector

One HIGHLY requested feature is finally there: a complete revamp of the item/block/material selector.

This allows you to do specify multiple materials, like this:
/qa edit questname objectives add BreakBlocks diamond_ore,deepslate_diamond_ore 20
Yes! Finally, you can make it so both kinds of diamond ore count towards the progress.
Or:
/qa edit questname objectives add PlaceBlocks hand,acacia_log,spruce_log,birch_log,dark_oak_log 15
You can see why that's super useful, right?

This even works in GiveItem actions, so you can give players multiple items at once!

It works pretty much everywhere you can enter materials - so in all objective types!

New NumberVariable Objective

This allows you to use variables in objectives relatively!

Example:

/qa edit questname objectives add NumberVariable PlaytimeMinutes moreOrEqualThan PlaytimeMinutes+2

This objective makes it, so the player needs to play 2 MORE minutes.

Unlock, progress & complete conditions

Previously, you were only able to add a condition to a quest objective which determines if it's unlocked or not (= HIDDEN).

Now, you can ALSO add objective conditions which check if you can progress, or complete the objective. Should be super useful!

Examples:
/qa edit questname objectives edit 1 conditions unlock add Flying equals false
"Default" condition. That's what you are used to. If you are flying, the objective remains locked / "Hidden".
/qa edit questname objectives edit 1 conditions progress add Flying equals false
Objective is always shown, but if you are flying, you won't get any positive progress towards it
/qa edit questname objectives edit 1 conditions progress add Flying equals false
Objective is always shown, and you always get progress, but it won't complete if you don't fulfil the condition

Practical example of NumberVariable & new progress condition combined

Say objective 1 is a BreakBlocks objective.
/qa edit questname objectives edit 1 conditions progress add ItemInInventoryEnchantments HAND containsIgnoreCase minecraft:silk_touch --allowProgressDecreaseIfNotFulfilled --negate

/qa edit questname objectives edit 1 conditions progress add ItemInInventoryEnchantments OFF_HAND containsIgnoreCase minecraft:silk_touch --allowProgressDecreaseIfNotFulfilled --negate
It stops progress from being added to the breakblocks objective if the item in the player's main or offhand is enchanted with silk touch

• [!] Fixed some errors caused by the 4.24.0 update for various objectives

• [+] Added FishItems objective

• [+] New progress system: dynamic required progress (uses expressions now)
• [^] Performance & stability improvements for string replacements in translations
• [^] Add ActiveObjective as possible argument for objective task descriptions (can break API)
• [^] Greatly improve expression suggestions for the arguments with number expressions

Examples for progress expressions:

/qa edit questname objectives add BreakBlocks dirt RandomNumberBetweenRange(min:1,max:50)

This makes it so, when you start the quest, you have to break between 1 and 50 dirt blocks. It basically randomizes the number of blocks you have to break for this objective (it gets randomized only once when you take the quest).

/qa edit questname objectives add BreakBlocks grass_block TagInteger(TagName:housestarkreputation)+1

This makes it so the amount of grass blocks you have to break is equal to what's currently saved in the player's housestarkreputation tag (more on that in the tutorials section of the docs) + 1. Yes, you can even do maths in these expressions 😄

• [+] Add /qa debug loadDataManagerUnsafe command to potentially enable database migration (SQLite => MySQL). Read the FAQ on the docs first for that
• [^] Improve various debug messages
• [!] Make sure only the correct conversation is stopped, and not just the current one. Fixes various potential bugs, for example when moving from one conversation to another conversation via actions
• [!] Potential, automatic 1.18.2 compatibility by fixing the UnsafeDisregardVersion configuration option. It did not work correctly before

ATTENTION: VERSION 3 AND OLDER ARE NOT COMPATIBLE. ⇒ [Updating from <v4 guide](https://www.notquests.com/docs/documentation/updating-from-v3-or-older/).

• [!] Fix incorrect placeholder for that projectkorra objective
• [!] Fix opening GUI on spigot throwing an error, due to apache lang package not being shaded in properly

ATTENTION: VERSION 3 AND OLDER ARE NOT COMPATIBLE. ⇒ [Updating from <v4 guide](https://www.notquests.com/docs/documentation/updating-from-v3-or-older/).

• [^] New, improved update manager.
• [^] Shitizens NPC names are now automatically converted from legacy to minimessage to prevent a warning for colored npc names
• [!] Attempt to fix incorrect handling of 'hand' argument for materials. This should fix the bug where custom items with special nbt tags / custom names did not work properly any more.

ATTENTION: VERSION 3 AND OLDER ARE NOT COMPATIBLE. ⇒ [Updating from <v4 guide](https://www.notquests.com/docs/documentation/updating-from-v3-or-older/).

• [+] Finally: Move Tag system from PersistentDataContainers to Database (MySQL / SQLite). It's now fully asynchronous, bungeecord/velocity-compatible and should work a lot better than before. Give it a try! With tags, you can save ANY kind of data for any player. Why is this useful, you ask? Well, for example, you can make an own, completely custom currency system with that. A point system. A relationship system between NPCs. Or villages. Custom nickname for a player. Anything.
• [!] Fix bug where objective rewards are not skipped-over during playerdata loading and only during plugin loading

ATTENTION: VERSION 3 AND OLDER ARE NOT COMPATIBLE. ⇒ [Updating from <v4 guide](https://www.notquests.com/docs/documentation/updating-from-v3-or-older/).

• [^] Updated to 1.19. Older versions are NOT supported anymore
• [!] Fix bug where display names of rewards of quest objectives did not save correctly and caused a startup error

ATTENTION: VERSION 3 AND OLDER ARE NOT COMPATIBLE. ⇒ [Updating from <v4 guide](https://www.notquests.com/docs/documentation/updating-from-v3-or-older/).

• [+] Add ability to add multiple NPCs to a Conversation
• [!] Fix protection plugins not being respected
• [!] Prevent ConcurrentModificationException when looping through active quests

ATTENTION: VERSION 3 AND OLDER ARE NOT COMPATIBLE. ⇒ [Updating from <v4 guide](https://www.notquests.com/docs/documentation/updating-from-v3-or-older/).

• [+] New Variables: PlayerPlaytimeTicks, PlayerPlaytimeMinutes and PlayerPlaytimeHours
• [+] Added super helpful /qa variables check command
• [^] Improved startup messages for registering stuff
• [^] Updated dependencies
• [@] New translations
• [!] Make sure QuestPlayer exists before opening GUI

ATTENTION: VERSION 3 AND OLDER ARE NOT COMPATIBLE. ⇒ [Updating from <v4 guide](https://www.notquests.com/docs/documentation/updating-from-v3-or-older/).

• [+] Add option to disable register message spam
• [^] Enable late loading of Citizens commands
• [!] Variable value arguments error checking, fixing missing tab completions
• [!] Fixed Citizens NPE at server shutdown

ATTENTION: VERSION 3 AND OLDER ARE NOT COMPATIBLE. ⇒ [Updating from <v4 guide](https://www.notquests.com/docs/documentation/updating-from-v3-or-older/).

• [+] Added MaxHealth variable
• [+] Add CompletedObjectiveIDsOfQuest Variable
• [^] Update MythicMobs API to v5
• [^] Use new configuration comments api
• [!] Fixed 'hand' argument in MaterialOrHand selector
• [!] Fixed Citizens NPE at server startup
• [!] Fix npe for terminating packetmanager
• [!] Update minimessage stuff to fix potential bugs
• [@] Updated translations

ATTENTION: VERSION 3 AND OLDER ARE NOT COMPATIBLE. ⇒ [Updating from <v4 guide](https://www.notquests.com/docs/documentation/updating-from-v3-or-older/).

For this version, please re-generate your language files by deleting the plugins/NotQuests/languages folder.

• [+] Added placeholders: %notquests_player_objective_progress_OBJECTIVEID_from_active_quest_QUESTNAME% and %notquests_player_objective_progress_percentage_OBJECTIVEID_from_active_quest_QUESTNAME%
• [^] Added %OBJECTIVEDESCRIPTION% internal placeholder and renamed other internal placeholders
• [^] Improved & optimized any kind of data loading - especially tags. Log messages should be a lot more helpful now as well
• [^] Fix update checker click message
• [^] Updated all integrations
• [!] Fixed bug where tags were saved in an invalid format

ATTENTION: VERSION 3 AND OLDER ARE NOT COMPATIBLE. ⇒ [Updating from <v4 guide](https://www.notquests.com/docs/documentation/updating-from-v3-or-older/).

• [^] Improve loading of Tags and fix bugs related to it
• [^] Check for dots in actions

ATTENTION: VERSION 3 AND OLDER ARE NOT COMPATIBLE. ⇒ [Updating from <v4 guide](https://www.notquests.com/docs/documentation/updating-from-v3-or-older/).

• [+] Added command: /qa debug showErrorsAndWarnings and /qa debug showErrorsAndWarnings --printToConsole
• [^] Improved Quest & Tag data loading. Any error messages should be a lot more helpful as well now.
• [^] Updated to adventure 4.10.1. On Paper, make sure you are at least using build #235. This will fix an error with some command completions.

ATTENTION: VERSION 3 AND OLDER ARE NOT COMPATIBLE. ⇒ [Updating from <v4 guide](https://www.notquests.com/docs/documentation/updating-from-v3-or-older/).

• [!] Fixed a bug where tags are saved in the tag container with the wrong format

ATTENTION: VERSION 3 AND OLDER ARE NOT COMPATIBLE. ⇒ [Updating from <v4 guide](https://www.notquests.com/docs/documentation/updating-from-v3-or-older/).

• [!] Fixed a bug where quests just wouldn't complete and where other stuff just broke. The error happened because notquests was unable to center messages correctly, due to changes in MiniMessage with the 1.18.2 update. It's now fixed, and the performance should be better as well ;)
• [!] Fixed rare bug where Tag loading would error on server startup

ATTENTION: VERSION 3 AND OLDER ARE NOT COMPATIBLE. ⇒ [Updating from <v4 guide](https://www.notquests.com/docs/documentation/updating-from-v3-or-older/).

• [^] Updated NotQuests for Minecraft 1.18.2. Older Minecraft versions are NOT fully compatible. Please stay on version 4.18.2 for older Minecraft versions