ВЕРСИИ (247)

[__**Keep the dialog conversation IO open between answers (#4297)**__](https://github.com/BetonQuest/BetonQuest/commit/dc0d3f295eff2f077829ddebd972a97d0d673a38)

[__**Merge pull request #4306 from TheosRee/feat/override**__](https://github.com/BetonQuest/BetonQuest/commit/5ebfa82ded6837788cc8246e4def342f1180d2a2) Add `itemOverride` action to update existent items

[__**Merge pull request #4325 from TheosRee/feat/brew-ingredient**__](https://github.com/BetonQuest/BetonQuest/commit/f2b6fc1ec5d623608817d1fad4521f7fcb025c27) Add optional `ingredient` check for `brew` objective

[__**Merge pull request #4326 from TheosRee/fix/nested-section**__](https://github.com/BetonQuest/BetonQuest/commit/e64dc2f1ac44166e3ed5ba2032972587b4bd338e) Fix `section` placeholder could not address nested sections

[__**fix brew objective checks old item for valid brew instead newly brewed one (#4324)**__](https://github.com/BetonQuest/BetonQuest/commit/2e50571a0c347394fe3d8883463f4c62a9fda7b8)

[__**Merge pull request #4319 from BetonQuest/dependabot/maven/org.apache.commons-commons-lang3-3.21.0**__](https://github.com/BetonQuest/BetonQuest/commit/9ffda90fe1b365816401ea7f1f077ba9d6735410) Bump org.apache.commons:commons-lang3 from 3.20.0 to 3.21.0

[__**Merge pull request #4320 from BetonQuest/dependabot/github_actions/crowdin/github-action-3**__](https://github.com/BetonQuest/BetonQuest/commit/2ebbe6fc2e939892ce26f11edd197c0541137028) Bump crowdin/github-action from 2 to 3

[__**Merge pull request #4318 from Wolf2323/StageIllegalState**__](https://github.com/BetonQuest/BetonQuest/commit/9993de6d940b60a3527ca12eb930e29b6dc3fce8) Remove redundant exception handling in `StageCondition` methods to simplify logic

[__**Merge pull request #4317 from Wolf2323/MemLeak**__](https://github.com/BetonQuest/BetonQuest/commit/ec4ba6763fbda34ac445eaadd11343f89b8021a0) Fix memory leak when a player quits the server

[__**Merge pull request #4316 from Juyas/update/faststats**__](https://github.com/BetonQuest/BetonQuest/commit/d967a09c70388afe72ffba3f0cbbf99e61b31e96) Update faststats-bukkit version to 0.30.2 in pom.xml

[__**Allow to selective cache results of argument chains (#4304)**__](https://github.com/BetonQuest/BetonQuest/commit/9ae1b480997f6785036c9f5904039357e88cd26b) * add cache for immutable values * properly deprecate old constructors and add caching to sections * use inner class for cached argument * add docs for instruction caching Co-authored-by: TheosRee <theosree@users.noreply.github.com>

[__**Merge pull request #4315 from Wolf2323/PlayerQuitPlacerData**__](https://github.com/BetonQuest/BetonQuest/commit/78c1e333bf1dc3d0ed06d6804e41f99d5b82798a) Change event priority to MONITOR in JoinQuitListener to have the data…

[__**allow to skip interceptor delay and starting new conversations while in the delay (#4307)**__](https://github.com/BetonQuest/BetonQuest/commit/318ea6e6561114935f51b20c8e70e847e3fd1d6e) as well as passing their history to a new one to show it "bundled" at the end

[__**Merge pull request #4312 from Wolf2323/itemsadder**__](https://github.com/BetonQuest/BetonQuest/commit/2f8d842d29027775fffe1a043505e8f380fb86e1) Fix daily dependency check by using the maven central dependency of itemsadder-api

[__**Fix DefaultNpcHider logic: switch to alternating hide conditions instead of combining them (#4310)**__](https://github.com/BetonQuest/BetonQuest/commit/f084bd7062d9dd3d30464b4a4745b3ba96ff29cd)

[__**Merge pull request #4313 from TheosRee/feat/effect**__](https://github.com/BetonQuest/BetonQuest/commit/262ccd16d359527cee080919048796ef0f7cb726) Add `target` location for EffectLib's `particle` action

[__**Merge pull request #4311 from TheosRee/fix/lore**__](https://github.com/BetonQuest/BetonQuest/commit/39bd70643e23028be31962db8643278b0ba22fbd) Add removed none-check for simple item lore

[__**cahnge event priority to MONITOR in JoinQuitListener (#4309)**__](https://github.com/BetonQuest/BetonQuest/commit/16c36b659265221b1953c1ca315801c4e09f1df1) to not trigger when the event is cancelled in the HIGHEST priority

[__**fix PlayerHider could override each other resulting in unexpected behavior (#4308)**__](https://github.com/BetonQuest/BetonQuest/commit/894b7ee8965451dd57fd78500326c7a1ce06ee0a) when using the same source player conditions

[__**Merge pull request #4303 from Juyas/docs/changelog**__](https://github.com/BetonQuest/BetonQuest/commit/2633d6d509d32670fe742c7bc378b70b7f6755df) [DOCS] Update changelog documentation

[__**Merge pull request #4302 from TheosRee/dev/dependency**__](https://github.com/BetonQuest/BetonQuest/commit/3706e38093849f4d5b8561109f2d41e9108a21e0) Fix build module dependency resolving

[__**Merge pull request #4298 from TheosRee/feat/pdc**__](https://github.com/BetonQuest/BetonQuest/commit/4960c57a833fda08dcd5b531cfceb62f6d646b10) Add PersistentDataContainerHandler to `simple` item

[__**update checkstyle-idea.xml to new plugin version (#4291)**__](https://github.com/BetonQuest/BetonQuest/commit/83280eb8f971c4fc23f656266ffdc8e14f44d9cc)

[__**Merge pull request #4285 from Juyas/docs/apply-syntax**__](https://github.com/BetonQuest/BetonQuest/commit/c3d49cf0dcc1ee9c9f9e7f0487b506fc8e58d177) Apply more new syntax to Actions-List.md

[__**Merge pull request #4255 from Juyas/docs/api-changelog**__](https://github.com/BetonQuest/BetonQuest/commit/3ac80861dc3dbdae095e92b35e94dbce9f9be426) [DOCS] Add API-Changelog and its CI

[__**Rework `simple` item to allow usage of placeholders (#4262)**__](https://github.com/BetonQuest/BetonQuest/commit/719a7f9c57a365c17e194f45ed0c621e45447001) In the progress the whole handler structure is changed and modifications can now simply be done via the SimpleQuestItemHandlerRegistry instead of re-creating all Handlers for every change. Also the `simple` item now uses the instruction for parsing which means placeholders can now only be used for values and not over multiple parts.

[__**Add offset support for menu item slots (#4269)**__](https://github.com/BetonQuest/BetonQuest/commit/ad231138489f527c820a1a06544b85db667163cd)

[__**Merge pull request #4282 from Juyas/optimize/asyncsaver**__](https://github.com/BetonQuest/BetonQuest/commit/040d021fcffc7ed6638b878a2c8398be38d0fe58) Remove unused database connection validation logic in AsyncSaver

[__**Merge pull request #4279 from BetonQuest/dependabot/maven/com.google.guava-guava-33.7.1-jre**__](https://github.com/BetonQuest/BetonQuest/commit/a58ef2675b19f8bee8e09ed47131b8ffa6f5730e) Bump com.google.guava:guava from 33.6.0-jre to 33.7.1-jre

[__**Merge pull request #4280 from BetonQuest/dependabot/github_actions/toshimaru/auto-author-assign-3.1.0**__](https://github.com/BetonQuest/BetonQuest/commit/e55666f26fd9fa0ced1f30b35b593e34c5cafd86) Bump toshimaru/auto-author-assign from 3.0.3 to 3.1.0

[__**Merge pull request #4278 from Wolf2323/ParentUpdate**__](https://github.com/BetonQuest/BetonQuest/commit/dada343e57a4392290a1ee88366f4b68cc18538e) Updated parent project version to 2.13.0 and updated all related PMD violations

[__**Merge pull request #4277 from Wolf2323/PlayerDataStorage**__](https://github.com/BetonQuest/BetonQuest/commit/e652922a376482b7967f05c40fd6250eed1bfe3b) Remove FutureTask usage in PlayerDataStorage to simplify player data handling

[__**Merge pull request #4276 from BetonQuest/CommonProjectFiles-Sync**__](https://github.com/BetonQuest/BetonQuest/commit/8e35f85409c0e4784daf643c2784f6c270afbd44) Sync common files

[__**Merge pull request #4275 from Wolf2323/BetonQuestRelease**__](https://github.com/BetonQuest/BetonQuest/commit/2efec9f996a06f47adefc90761ee145108d2e1b1) Fix env variable usage in GitHub Actions build script for versioned artifacts during GitHub release

[__**Merge pull request #4272 from TheosRee/fix/block-selector**__](https://github.com/BetonQuest/BetonQuest/commit/b7740debfd85d83efb68862749ab070f0e09bec7) Fix block selector with regexes

[__**Merge pull request #4271 from TheosRee/fix/section-placeholder**__](https://github.com/BetonQuest/BetonQuest/commit/0d1f0d6b89e733aa7d175ef472e4054cbea64582) Fix section placeholder's missing base path

[__**Merge pull request #4270 from Juyas/feat/objective/trade**__](https://github.com/BetonQuest/BetonQuest/commit/33e71f5d1eccc47d6793837b0884b3db2c27f7ce) Add trade objective

[__**Merge pull request #4266 from Wolf2323/DatabaseDebug**__](https://github.com/BetonQuest/BetonQuest/commit/ddfc1fa624eca3cbc1fd2474bdfa016933a78eeb) Add more debug logging to database operations

[__**Merge pull request #4263 from Juyas/db/hikari2**__](https://github.com/BetonQuest/BetonQuest/commit/5644d63f004f9fa0d5268d23eb5d548985d979db) Add HikariCP support

[__**Introduce `ConnectionProvider` abstraction for database connections (#4261)**__](https://github.com/BetonQuest/BetonQuest/commit/9f692fbe813a594f0066c2d0ddf5cee148a06d69)

[__**Merge pull request #4258 from TheosRee/dev/countingdata**__](https://github.com/BetonQuest/BetonQuest/commit/9c58e027fd6eac0104659cc7e9dc550b05ad0207) Fix wrong handling of non-existent objective data

[__**Add `redstonepower` condition to check block power at specific locations (#4257)**__](https://github.com/BetonQuest/BetonQuest/commit/b8f1da8bb347cc3662d7ff32e68ef5434a1cef8f)

[__**Merge pull request #4256 from Juyas/feat/statistic-ph**__](https://github.com/BetonQuest/BetonQuest/commit/09b631172bd033b313b79004dc3e2614ce4aa25b) Add statistic placeholder

[__**Merge pull request #4252 from TheosRee/dev/command**__](https://github.com/BetonQuest/BetonQuest/commit/3bdee56f4d9da98fbab5092edf4544424f9fd973) Refactor Quest Command into sub commands

[__**Replace `getOffline` method with `get` for player data access and refactor related code (#4249)**__](https://github.com/BetonQuest/BetonQuest/commit/85ce8ff7ccd1fa454651f562972b456c4a7f5857)

[__**Validate module versioning in CI to enforce version bump for module changes since last tag (#4250)**__](https://github.com/BetonQuest/BetonQuest/commit/3eed4f8211b21d5349f8729c39f5f795b6550c3f)

[__**Merge pull request #4247 from Wolf2323/JobsReborn**__](https://github.com/BetonQuest/BetonQuest/commit/a02e27e0f19905098501f8756ffb918cbc4c05e5) Add null-check for JobsPlayer in JobsReborn compatibility to prevent potential null pointer exceptions

[__**Merge pull request #4248 from TheosRee/feat/update-interval**__](https://github.com/BetonQuest/BetonQuest/commit/2466151343bc68f20c15da96df917c7b31019f17) Treat non-positive update intervals as deactivated

[__**`chat` notify io now only sends messages during a conversation if `bypassInterceptor` is set to `true` (#4244)**__](https://github.com/BetonQuest/BetonQuest/commit/d5b97e0ff88094b8f2f03ed788060cd8fa4777c7)

[__**Merge pull request #4243 from Wolf2323/ReleaseScript**__](https://github.com/BetonQuest/BetonQuest/commit/152f63f25ebbe9a49416d5c3e9c957732018b878) Specify repository in `gh release view` command within release script…

[__**Merge pull request #4246 from TheosRee/feat/item-lore**__](https://github.com/BetonQuest/BetonQuest/commit/66e9f86f535530ca8f8354f562711cfbfb507498) Allow retrieving all lore lines from item

[__**Merge pull request #4242 from Juyas/feat/dropObj**__](https://github.com/BetonQuest/BetonQuest/commit/a2eafd12205665a51e497ba2a1a2d59a5db33185) Add `drop` objective

[__**Merge pull request #4241 from Juyas/fix/scripts**__](https://github.com/BetonQuest/BetonQuest/commit/02370dc9f8bf937cf24ffc060be236e8d1101835) Remove unused bash headers from release scripts

[__**Merge pull request #4239 from Juyas/VersionBump-3.3.0**__](https://github.com/BetonQuest/BetonQuest/commit/2154ad870f242e14881f1e1cf14a45d809b52c8c) Version bump to 3.3.0

### Changed - `worldguard` integration version requirement to 7.0.0 - `worldedit` integration version requirement to 7.3.0 - counting objective related translations in the lang files were moved in an own `objective` section and use `{absoluteleft}` instead of `{amount}` - `citizens` returns the stored `location` instead of nothing when not spawned - Skript Condition and Effect now handle if no player is present and check like they are independent - `deleffect` action no longer accepts an omitted first argument as `any` - `chestgive` action no longer drops excess items without newly added `dropExcess` flag - `mythic` item no longer shows square brackets ### Added - counting objective related translations in the lang files can now use all counting objective related placeholders - `fallback` argument to point conditions to use a default value when category has no value at all - `dialog` conversation IO - `patterns` argument for adding and matching pattern layers on `simple` banner items - `slots` to `armor` condition to only check specific slots - More functionality for subsections - `section` (and implicit `section`) condition to allow usage of subsections as list of (conjugated) conditions - implicit `section` action to allow usage of subsections as list of actions to execute - `section` placeholder to list all subsections as identifiers - New elements - `haspoint` and `hasglobalpoint` conditions to check if a point is set - `damage` objective to track dealt and taken damage - `updateHologram` action to force updates to (specific) holograms for a player ### Fixed - `freeze` action and `packetevents` conversation io as well as `Journal` and `simple` books on MC 26.2+ - NPE in PacketEvents Interceptor when resending messages to offline players - `mmoskill` objective trigger are not parsed correctly - error handling for items when the amount is less than 1 - `interact` objective handling broken loaded data wrongly - NPE in `brew` objective when used null instead air item stack - Quest Items handling when clicking outside the inventory frame - `FancyHolograms` holograms not updating placeholders without hiding - `null` item in `simple` item is now treated as equal to air - MobKillNotifier that handles neutral mob kills for example with skills now work probably when called async - item implementations `magic` and `mmoitem` ignoring the given amount for item stacks - `itemdurability` action throws exception when the new durability is negative - ItemsAdder objective block break/place not working properly

[__**Bump version of api to 3.2.0 (#4238)**__](https://github.com/BetonQuest/BetonQuest/commit/9086ef813ed8c805357865ef8e51631d74e312ac)

[__**Merge pull request #4234 from Wolf2323/Compatibility**__](https://github.com/BetonQuest/BetonQuest/commit/9ed6c43bd125329a8774fa49d0776d1f257bac41) Ensure distinct plugin entries in Compatibility mapping

[__**Fix ItemsAdder objectives (#4233)**__](https://github.com/BetonQuest/BetonQuest/commit/7d59f1eaba5c052970aa5f66501b75198bba3afe) by adding missing player retrievers to it

[__**Add exception handling for invalid player UUID in HeadHandler (#4235)**__](https://github.com/BetonQuest/BetonQuest/commit/07d686aa418f77ab66c6563ded4764063bc5821a)

[__**Merge pull request #4232 from TheosRee/feat/mythic-item-name**__](https://github.com/BetonQuest/BetonQuest/commit/6590abe610bcb00da80e3e75a9458969fed29aaf) No longer show square brackets for `mythic` item

[__**Fix `itemdurability` action setting negative durability values (#4237)**__](https://github.com/BetonQuest/BetonQuest/commit/97b76bc22d60d0651d18d8adabcb5c41693cbd02)

[__**Add exception handling for invalid Denizen task script casting (#4236)**__](https://github.com/BetonQuest/BetonQuest/commit/9e989e0ac45ed795871f171fd3bae524b31dd511)

[__**Merge pull request #4231 from Juyas/section/count**__](https://github.com/BetonQuest/BetonQuest/commit/6e32be0f0448fd465ce3257770f39cce8ca9c391) Add `count` flag to section placeholder for element counting

[__**Merge pull request #4229 from TheosRee/bookmeta**__](https://github.com/BetonQuest/BetonQuest/commit/b20aca4ee274efafa89cc98f3920c0f7fefbe5f1) Use different method to add pages to books

[__**Fix amounts below 1 errors when checking for item amount (#4228)**__](https://github.com/BetonQuest/BetonQuest/commit/7cfa64df27f78188cafb2811ff9f92d1ca1387b7) and actually use the given amount for MMOItem and MagicItem when givin them.

[__**Add section placeholder (#4227)**__](https://github.com/BetonQuest/BetonQuest/commit/1701cc69d5988a52cd60784babb1a97321a56531) to list all subsections as identifiers

[__**Make `section` condition more than just an `and`. (#4223)**__](https://github.com/BetonQuest/BetonQuest/commit/96a84619954976d2b1b7084354ee1472f0c301c2) with adding a `min` and `max` of conditions that must be met

[__**Merge pull request #4221 from TheosRee/feat/armor**__](https://github.com/BetonQuest/BetonQuest/commit/c10a91d69cea2cb56b0c91499791e789b661530b) Add slots to check in ArmorCondition

[__**Fix `MobKillNotifier` to properly handle neutral mob kills when called asynchronously (#4220)**__](https://github.com/BetonQuest/BetonQuest/commit/083bd7750f4f98f8c711bfc2fba382d32155941d)

[__**Merge pull request #4192 from Juyas/placeholder/improve**__](https://github.com/BetonQuest/BetonQuest/commit/7e10ab3e5fe2e88c837b9458726d7e8674e0a345) Further improve tokenizer

[__**Add equip action (#4210)**__](https://github.com/BetonQuest/BetonQuest/commit/df42ab942275b9b19db5c6d459665b475a1246c8)

[__**Merge pull request #4218 from TheosRee/feat/section-action**__](https://github.com/BetonQuest/BetonQuest/commit/b863a7cd3bcd5a960d406a3c716734cd755ebfde) Add implicit folder action for action nodes

[__**Add banner pattern handler for simple items (#4214)**__](https://github.com/BetonQuest/BetonQuest/commit/7fc3b18942c0da67c7491dc39509f95be8079c90)

[__**Merge pull request #4217 from TheosRee/fix/notify**__](https://github.com/BetonQuest/BetonQuest/commit/7f51b3236742cd7d3b17189b7dc3305d1265b1e6) fix AdvancementNotifyIO when used from main thread

[__**Add dialog conversation IO (mc_1_21_8) (#4037)**__](https://github.com/BetonQuest/BetonQuest/commit/39aa8ee8bba26aadf318134f5cb112d86b2cf780) --------- Co-authored-by: TheosRee <theosree@users.noreply.github.com>

[__**Merge pull request #4216 from TheosRee/fix/item-null**__](https://github.com/BetonQuest/BetonQuest/commit/9663563b647043985df0e9f47f47997fb342efbb) Treat null as equal to air in `simple` item

[__**Introduce `InstructionReaderStrategy` and use it to refactor argument parsing in instructions to simplify (#4209)**__](https://github.com/BetonQuest/BetonQuest/commit/5e4011053ad179a7451de91b63abe757f7a3b930)

[__**Add `dropExcess` flag to `chestgive` action (#4205)**__](https://github.com/BetonQuest/BetonQuest/commit/582929fec8bb09fd6da22c2978878840a8ae87b4) instead of dropping items unconditional and use new docs format

[__**Merge pull request #4194 from TheosRee/feat/holo-update**__](https://github.com/BetonQuest/BetonQuest/commit/181e1ccfbfb88be3beb37286accfdc9bb209e48b) Add `updateHologram` action to force updates

[__**Require an argument for the deleffect action (#4201)**__](https://github.com/BetonQuest/BetonQuest/commit/244c3f27a588953635dbec904569955d9ec53c0a)

[__**Merge pull request #4203 from Wolf2323/BlockSelectorIllegalArgument**__](https://github.com/BetonQuest/BetonQuest/commit/3237e7df414ac9cfd119aedededa9820d63b2248) Add exception handling for invalid registry in `DefaultBlockSelector` to improve error reporting

[__**Skript Condition and Effect now handle if no player is present (#4204)**__](https://github.com/BetonQuest/BetonQuest/commit/b69d19d52278e83694d349e0c168201cb120a9ce) and check like they are independent

[__**Renamed all the Integration Tests to their actual name 'IT' (#4202)**__](https://github.com/BetonQuest/BetonQuest/commit/20783d21125be33897606786ad31aa3ad146c794) So that they are actually get executed when they should be. Previously, they were executed during the normal testing phase because the test names still ended with 'Test'.

[__**feature: add DamageObjective and factory (#4167)**__](https://github.com/BetonQuest/BetonQuest/commit/fe4e772a61ec891a3f7c12eaa4471598527d1503)

[__**Add null-check for clicked inventory in QuestItemHandler to prevent potential NPE (#4197)**__](https://github.com/BetonQuest/BetonQuest/commit/3506ffc168a58dbb47cf76e68be51bde06a90e79)

[__**Merge pull request #4196 from TheosRee/fix/brew**__](https://github.com/BetonQuest/BetonQuest/commit/fef2b2bc42494542d4e429da20c854118631a4c8) Fix npe on custom BrewEvent with null instead of air item stacks

[__**Merge pull request #4195 from Wolf2323/AdvancementLoading**__](https://github.com/BetonQuest/BetonQuest/commit/7ce2d49a9bc2e7f170c396f6d6ba235473471619) Handle JSON parsing errors and improve advancement loading with prope…

[__**Merge pull request #4188 from TheosRee/feat/section**__](https://github.com/BetonQuest/BetonQuest/commit/d07d143fcf21c4b1c1a3aec38ff7d2e1ede68167) Add section condition as well as implicit section conjunction

[__**Fix `interact` objective handling for broken loaded data (#4179)**__](https://github.com/BetonQuest/BetonQuest/commit/0799edbbcd295a664b838c7cf0c41b407a18de2a)

[__**Fix item parsing to enforce positive amounts and improve handling for invalid values (#4191)**__](https://github.com/BetonQuest/BetonQuest/commit/f966fec200a276e005c6c717b81a5e2f1560d1b2)

[__**Bump parent POM version to 2.12.0 and add null-check for ingredient amount in `IngredientsUtil` (#4190)**__](https://github.com/BetonQuest/BetonQuest/commit/8e8185dc465b7640b12a34a383caf5f64f08238e)

[__**Merge pull request #4184 from BetonQuest/dependabot/github_actions/JetBrains/qodana-action-2026.2**__](https://github.com/BetonQuest/BetonQuest/commit/fcc21cbd561684e5b3f4fde0730ae7653162cc63) Bump JetBrains/qodana-action from 2026.1 to 2026.2

[__**Bump version of lib to 3.2.0 (#4186)**__](https://github.com/BetonQuest/BetonQuest/commit/26cc2f8168b47ffff73713c69ddacb2a2e6b8d01)

[__**Merge pull request #4185 from TheosRee/feat/point-fallback**__](https://github.com/BetonQuest/BetonQuest/commit/9a07e3822a6be9c2b5ddf86713285a74c639866a) Add `fallback` to point conditions

[__**Validate nested quoting (#4181)**__](https://github.com/BetonQuest/BetonQuest/commit/5ddb389d96fd872fdb5880adcb7bbe141e80aa50) * Introduce nested quoting support in tokenizer and refine placeholder handling mechanisms * Add unit tests for placeholder tokenizer to validate tokenization and error handling

[__**Add null-checks for keys and values in `QuestProcessor` values map put (#4180)**__](https://github.com/BetonQuest/BetonQuest/commit/61bad5d012a44bf11a3a13fbf330c060390ef5e0)

[__**Fix `mmoskill` objective trigger parsing (#4178)**__](https://github.com/BetonQuest/BetonQuest/commit/aa762968eee20cdf8d0cf32d09755a03b681c844)

[__**Fix NPE in PacketEventsInterceptor when resending messages to offline players (#4177)**__](https://github.com/BetonQuest/BetonQuest/commit/8a27a672ab1d20d5d1255637d48716133a0e6c52)

[__**Merge pull request #4176 from TheosRee/feat/npc-location**__](https://github.com/BetonQuest/BetonQuest/commit/b0598a5bbfd6841c9ec2ddafa9e3b52fd2278074) `citizens` npcs now return stored location when not spawned

[__**Merge pull request #4175 from Juyas/tokenizer/settings**__](https://github.com/BetonQuest/BetonQuest/commit/e2261ae89e0965da89bc8e3909b53806cd27beac) Refactor tokenization process

[__**Merge pull request #4172 from Wolf2323/CountingObjectiveProperties**__](https://github.com/BetonQuest/BetonQuest/commit/cc83f745e5b601685bc9bca306d95e5e9bdd4a78) Refactor localization keys in objectives to improve structure and replace placeholders for alignment across languages

[__**Merge pull request #4170 from TheosRee/fix/version**__](https://github.com/BetonQuest/BetonQuest/commit/02d780e1d5f3c0851f1e81c06e8cb128151ab51d) Fix `freeze` action and `packetevents` conversation io on MC 26.2+

[__**Refactor objective classes to replace `UUID` keys with `ProfileKeyMap` for improved player profile management (#4173)**__](https://github.com/BetonQuest/BetonQuest/commit/3e5996330d9bb7b1787cdfed212d64dff617c477)

[__**Merge pull request #4169 from TheosRee/feat/has-point**__](https://github.com/BetonQuest/BetonQuest/commit/add2638177d21c746dbccad334dc028d7550b0af) Add `HasPoint` conditions

[__**Merge pull request #4171 from TheosRee/fix/ddc**__](https://github.com/BetonQuest/BetonQuest/commit/cfad9ab047bca4c9288a85c4ee66398d8d017914) Fix daily dependency check

[__**Merge pull request #4168 from TheosRee/wg-we-versions**__](https://github.com/BetonQuest/BetonQuest/commit/fcbe6dd06f32ff486fda9df282216c7b713f3443) Reduce required version of worldguard and worldedit

[__**Merge pull request #4166 from TheosRee/VersionBump-3.2.0**__](https://github.com/BetonQuest/BetonQuest/commit/d1670a832834c224ebefce4d690498c638066fbc) Version bump to 3.2.0

### Changed - `language` config option is now a section; the default language moved to `language.default` - `burn` action to no longer require its duration argument to specify its name `duration` - `mmoitem` now checks for soulbound when set - `worldguard` integration version requirement to 7.0.16 - `worldedit` integration version requirement to 7.3.19 ### Added - `language.questlang_whitelist` to restrict which languages players can select via `/questlang` - nesting in quest packages for single line instruction types - `unit` optional argument in `burn` action to specify the time unit for the duration - `translate` placeholder parsing languages from `constants` section - `heal` action to change the current health of a player - `functions` section to define mathematical functions - `function` condition to evaluate a function as a condition - `TheBrewingProject` integration as modern alternative to Brewery - `base_speed` option to menu conv io to avoid zooming effect at risk of permanent modification ### Fixed - `/questlang` command error message listing the available languages incorrectly - ConcurrentModificationException in statistics calculation

[__**Merge pull request #4163**__](https://github.com/BetonQuest/BetonQuest/commit/04a7b7182e1ebf82b049a76f98876306a5338b14) Only warn that no hologram integration is present when trying to load holograms

[__**Allow to set base speed to not "zoom" (#4160)**__](https://github.com/BetonQuest/BetonQuest/commit/02d2de0261db1806b29ac8e2008935e8968235b8) * set base speed instead of movement speed modifier * only delay InputEventSession end if not on main thread to properly reset speed on logout * add toggle for base speed setting in menu conv io --------- Co-authored-by: TheosRee <theosree@users.noreply.github.com>

[__**Merge pull request #4158 from Juyas/docs/roadmap**__](https://github.com/BetonQuest/BetonQuest/commit/728b735d954b40cb1e5c32cf89b1bdd11209acf2) [DOCS] added a Roadmap to the documentation

[__**Preserve Comments during migrations when sections are renamed (#4157)**__](https://github.com/BetonQuest/BetonQuest/commit/5c6a04d680a6a2eb1d0f6492b6bdcac053c719ab) * Preserve comments and inline comments during section renames, and add tests to show that they are still missing when files are merged together * Refactor `QuestMigration` to streamline comment preservation during section renaming.

[__**Merge pull request #4155 from TheosRee/dev/backpack**__](https://github.com/BetonQuest/BetonQuest/commit/94f289587991ade2c10e651b4730a2666676a8b2) Create BackpackFactory to reduce dependency injection

[__**Merge pull request #4153 from Wolf2323/releaseScriptDeploymentCheck**__](https://github.com/BetonQuest/BetonQuest/commit/25258758be92877ddcdabafe7bcb29a4666bca7a) Release script deployment check

[__**Merge pull request #4152 from Wolf2323/SECURETY.mdUpdate**__](https://github.com/BetonQuest/BetonQuest/commit/ca76bce2676e5d6c495a1948e1d81240f8007705) Update SECURITY.md for major version changes during release process t…

[__**Merge pull request #4151 from Wolf2323/releaseScriptTagFix**__](https://github.com/BetonQuest/BetonQuest/commit/d76e675c28cc9a6b841a4d45a01b13bfbe86ac2b) Enhance release script to validate specific version tag patterns.

[__**Merge pull request #4154 from Wolf2323/CheckStyle**__](https://github.com/BetonQuest/BetonQuest/commit/c266d3e9c4608f4523a73021224300d8804c1ce8) Update checkstyle version for IntelliJ

[__**Merge pull request #4150 from Wolf2323/releaseTags**__](https://github.com/BetonQuest/BetonQuest/commit/e46d92d19e2fadf336f65baa3b8cd45ea1132c99) Prevent duplicate version tags during release process.

[__**Merge pull request #4149 from Juyas/api/functions**__](https://github.com/BetonQuest/BetonQuest/commit/d0a381b4e89d0a47ebc137bbe247a88025f2177b) Expose Functions via BetonQuestApi

[__**Merge pull request #4146 from Juyas/fix/concurrency**__](https://github.com/BetonQuest/BetonQuest/commit/44a07b1b7710907befa25aa19057f6662452c87a) Fix concurrency issues by decoupling source collections

[__**Merge pull request #4144 from Juyas/functions/implement**__](https://github.com/BetonQuest/BetonQuest/commit/d6de638918ac57b57444b0001614a40ff2ae9deb) Implement functions

[__**Merge pull request #4126 from Juyas/math/function**__](https://github.com/BetonQuest/BetonQuest/commit/400e6b89bea8c06bb54821ce5a01bf41cc45d8a9) Function parsing

[__**Merge pull request #4115 from Juyas/bump/FastStats**__](https://github.com/BetonQuest/BetonQuest/commit/6cec9dcf18a6c038d49fd96f83e93cd53f381e4e) Bump `faststats-bukkit` version to 0.27.1 in `pom.xml`

[__**Merge pull request #4113 from Wolf2323/pomUpdate**__](https://github.com/BetonQuest/BetonQuest/commit/86005b726b0027130a9eb7dde3e94007a45a6901) Version bump of Parent pom to 2.11.0 across all POM files

[__**Merge pull request #4127 from Juyas/bump/worldguard**__](https://github.com/BetonQuest/BetonQuest/commit/bdd1f91a148695e47b6026ff104d600e7ac2fe43) Update WorldGuard and WorldEdit compatibility to newer versions

[__**Merge pull request #4118 from BetonQuest/dependabot/github_actions/toshimaru/auto-author-assign-3.0.3**__](https://github.com/BetonQuest/BetonQuest/commit/5311e2ac2cf295be5975d69ace031d23ea957a3c) Bump toshimaru/auto-author-assign from 3.0.2 to 3.0.3

[__**Merge pull request #4117 from BetonQuest/dependabot/github_actions/actions/checkout-7**__](https://github.com/BetonQuest/BetonQuest/commit/6eb0eaff68d4752f87bd0b065ea63d1d7962bfaa) Bump actions/checkout from 6 to 7

[__**Merge pull request #4114 from Wolf2323/ManualTrigger**__](https://github.com/BetonQuest/BetonQuest/commit/00dc8b95ce73e41da01701b439f6c38b9bb35d02) Enable manual trigger for daily dependency check workflow

[__**Merge pull request #4111 from Wolf2323/ReleaseBranchCheck**__](https://github.com/BetonQuest/BetonQuest/commit/dfe76653cf048cde9fe8719b9e8508d408c9fd5a) Add `checkGitState` to validate branch and sync state in release script

[__**Merge pull request #4106 from TheosRee/feat/mmoitem**__](https://github.com/BetonQuest/BetonQuest/commit/fbbbf3287cb2b9121de25b366c90720983fb922b) mmoitem now checks for soulbound when set

[__**Merge pull request #4094 from Juyas/polish/action/burn**__](https://github.com/BetonQuest/BetonQuest/commit/822bba0a76ce69cfe6b2eb280a5060893bc1a7e4) Polish `burn` action

[__**Merge pull request #4109 from TheosRee/dev/subsections**__](https://github.com/BetonQuest/BetonQuest/commit/0a30cc3ce6d40c731a290f957c88506efdab85e3) Adjust QuestMigration to work with subsections

[__**Add `heal` action to adjust player health (#4104)**__](https://github.com/BetonQuest/BetonQuest/commit/1294a894b248d63dfec7c1f8a10cada767b89ab6)

[__**Merge pull request #4101 from Juyas/fix/groupedFixes**__](https://github.com/BetonQuest/BetonQuest/commit/d3a9ba179bac8f9053b5cd28c57357c5282138b2) Two minor fixes

[__**Merge pull request #4097 from TheosRee/feat/translatable**__](https://github.com/BetonQuest/BetonQuest/commit/c26f96d51a49d51b244c61e34576ddf30c86569a) Add translatable placeholder

[__**Merge pull request #4095 from Juyas/VersionBump-3.1.0**__](https://github.com/BetonQuest/BetonQuest/commit/d7f593a4976c594cee9c2b3158b1d28e9a240bda) Library Version bump to 3.1.0

[__**Fix string concatenation in LangCommand to no longer chop off the last 2 characters (#4092)**__](https://github.com/BetonQuest/BetonQuest/commit/a78916d43830999084f1b8fcb14e99800fab7152)

[__**Javadocs: Add `@since 3.1.0` annotations to QuestPredicate interface methods (#4093)**__](https://github.com/BetonQuest/BetonQuest/commit/1269586ff4bb6eea0b67d4bf4c695e4cf4ea0316)

[__**Merge pull request #4085 from TheosRee/dev/nested**__](https://github.com/BetonQuest/BetonQuest/commit/55fb5fa75b63f7ef5cee3f619aa23e17cc957600) Allow grouping in sections for single line instruction identifiers

[__**Merge pull request #4079 from meankitmishra/language-whitelist**__](https://github.com/BetonQuest/BetonQuest/commit/4926e9c20af7399c354b26f1d31e324e78f43fd8) add questlang language whitelist

[__**Merge pull request #4089 from TheosRee/dev/throws**__](https://github.com/BetonQuest/BetonQuest/commit/83f447ec650c8157717d9d12ae75c2a4d5967c3c) Remove the unnecessary throws in QuestBiPredicate and fix changelog

[__**Merge pull request #4041 from Thorinwasher/feat/quest-predicate**__](https://github.com/BetonQuest/BetonQuest/commit/f8ddff2ca446ad2fef1a259aedfa58b3d9d607cd) Add QuestPredicate interface

[__**Merge pull request #4087 from Juyas/VersionBump-3.1.0**__](https://github.com/BetonQuest/BetonQuest/commit/39efc6fe2160bf5233792e2e8a066c49a3f8f148) Version bump to 3.1.0

### Changed - release script to simplify the release process of coming versions ### Added - new GitHub issue templates to allow for better issue reporting and feature requests ### Fixed - `FastStats` error tracker not working properly - Javadocs of the api module missing the `@since` tag

[__**move NpcHologramLoop and HologramProvider listener into own class (#4084)**__](https://github.com/BetonQuest/BetonQuest/commit/aa56e092b384ebc8a134b4a266196115cbb470c7)

[__**Merge pull request #4083 from Juyas/updateChangelog**__](https://github.com/BetonQuest/BetonQuest/commit/bf75faaa96bbc79ab4bca2d278c0bff67d060183) Update Changelog

[__**Merge pull request #4082 from TheosRee/fix/point-migration**__](https://github.com/BetonQuest/BetonQuest/commit/169c609f1eeaae2318996df8cf246f6cce560b1a) fix RemoveLegacyPointModification migration from 2 to 3

[__**Merge pull request #4081 from Juyas/gh/postReleaseUpdates**__](https://github.com/BetonQuest/BetonQuest/commit/0a3f92ef5f05d1f0de449417cbedce653381d2bf) Github post release updates

[__**Merge pull request #4078 from Juyas/gh/templates**__](https://github.com/BetonQuest/BetonQuest/commit/a8e33fae1fc6992b5b6ff72fb2c5a303a78b5e8b) Enhance GitHub issues templates

[__**Merge pull request #4074 from Juyas/api/improveDocs**__](https://github.com/BetonQuest/BetonQuest/commit/9add9867632ce44a0fef19d45b02aeedf47dc005) Improve API javadocs

[__**Merge pull request #4073 from Juyas/fix/issueTemplates**__](https://github.com/BetonQuest/BetonQuest/commit/1bc78c99f42f11ad6fa5b12bd306cbdeaf284436) Enhance issue templates

[__**Merge pull request #4072 from Juyas/fix/faststats**__](https://github.com/BetonQuest/BetonQuest/commit/e217f6f7183091091953760e5ba238d8e5f4ee38) Bump FastStats dependency to 0.27.0 in core POM

[__**Merge pull request #4059 from Wolf2323/requirements**__](https://github.com/BetonQuest/BetonQuest/commit/6bc591932367d82d7e10131f18f646f2d1954d36) Refactor release script

[__**Merge pull request #4060 from Juyas/releaseScript**__](https://github.com/BetonQuest/BetonQuest/commit/0efec025499053b3d5a39ec7664bb31d8e3419ab) Improve release script (SSH auth)

[__**Merge pull request #4061 from Juyas/VersionBump-3.0.2**__](https://github.com/BetonQuest/BetonQuest/commit/4a35f7a6dd425b482b69c5b67fe39ed98a559159) Version bump to 3.0.2

### Fixed - FastStats metrics would always be collected on the first start - integrations with non-semver versions caused errors ### Deprecated - `InstructionParts` as part of the API that should have been deprecated for 3.0.0 already

[__**Merge pull request #4057 from Juyas/fix/release**__](https://github.com/BetonQuest/BetonQuest/commit/021a17abd667fd8cdd5f589f4cffc8491278c2c8) Fix tag verification logic in build workflow

[__**Merge pull request #4054 from Juyas/ssh/releaseScript**__](https://github.com/BetonQuest/BetonQuest/commit/fc465d38285ed0918d189080af0c18f9a7e62988) Update release script for better ssh support

[__**Remove automatic text wrapping in markdown files for IntelliJ IDEA**__](https://github.com/BetonQuest/BetonQuest/commit/cf1d292f6df01182db0f08f6fdac30b470dad4f9)

[__**Merge pull request #4050 from Juyas/changelog**__](https://github.com/BetonQuest/BetonQuest/commit/ea5510b24a8ab2ccdafe64dbea0f381f32718258) Update changelog to include recent fixes and deprecation notes

[__**Merge pull request #4044 from Juyas/fix/faststats**__](https://github.com/BetonQuest/BetonQuest/commit/ce490d91cfb54e1f9346b4c482b80e090c838215) Update `faststats-bukkit.version` to 0.26.1 in pom.xml

[__**Merge pull request #4042 from Juyas/fix/unspecifiedVersionParsing**__](https://github.com/BetonQuest/BetonQuest/commit/42ea76ca31632e731bbb0395f9e82fcc44fea978) Fix version parsing for policies

[__**Merge pull request #4043 from Juyas/missingDeprecation**__](https://github.com/BetonQuest/BetonQuest/commit/4f482abdaa1d49e4f10285165fa583c2ca275dcd) Fix missing deprecation

[__**Merge pull request #4040 from Wolf2323/VersionBump-3.0.1**__](https://github.com/BetonQuest/BetonQuest/commit/fa371a1dbb503b50b9dab53dbe2706696db4bbf3) Version bump to 3.0.1

### Changed - previous maven artifact repository nexus `https://nexus.betonquest.org/repository/betonquest/` replaced with reposilite available at `https://repo.betonquest.org/betonquest/` - Bukkit API events are now called sync/async depending on the tread context they are called in - actions, objectives, and conditions do not replace underscores anymore. quoting syntax needs to be used now - `brew` objective now checks brewed items in a more accurate way - `simple` quest items now resolve placeholders one time on reload to support `constant` placeholders - `owner:%player%` was changed to `owner:` to allow constant pre-parsing - `npc_conversations` show the combat message only if there is a bound conversation - `Journal` and `Quest Item` are checked with PersistentDataContainer instead of lore - `hologram`'s `top:` line to customizable format - LoadDataEvent is now called before and after the data is loaded with a new enum `LoadDataEvent.State` that indicates the state - configuration structure and naming - reworked the entire config.yml file - renamed `max_npc_distance` to `max_conversation_distance` - renamed `acceptNPCLeftClick` to `npcs.accept_left_click` - renamed `npcInteractionLimit` to `npcs.interaction_limit` - `message.yml` file was deleted, and instead the lang folder now contains all translations - `menuConfig.yml` file was deleted, translations are in the lang folder, and the config is part of config.yml - `item.backpack.cancel_button` and `item.backpack.compass_button` do not have a `DEFAULT` value anymore, instead you need to specify an item - terminology and naming - renamed `Variables` to `Placeholders` in the entire project - renamed `Events` to `Actions` in the entire project - renamed `global` property for objectives to `auto-once` - cross-packages now use `>` instead of `.` to solve conflicts in placeholders - in objectives - `event` and `condition` are now `actions` and `conditions` - in actions - `condition` is now `conditions` - in menus - `condition` is now `conditions` - in conversations - options `condition`, `event`, `pointer` and `extend` are now `conditions`, `actions`, `pointers` and `extends` - commands - `item` command now requires the specification of serializer - `variable` command allows setting and getting data now for offline players - `objectives` can now be removed from the database via command even when it does not exist - conversations and conversation IOs - conversations now always print their start and stop conversation message - `menu` conversation IO settings are now defined the `config.yml` file in the `conversation.io.menu` section - `menu` conversation IO based on packetevents renamed to `packetevents` - `menu` conversation IO displaying and scroll behavior rework - `menu` conversation IO no longer ignores canceled bukkit events to process as input - `packet` chat interceptor was renamed to `packetevents` - custom items in the chest conversation IO are now defined in the `properties` section as an option - `%quester%` placeholder is used instead of `%npc%` for the quester's name in conversations; `%npc` placeholder is now used for the new npc system - `chest` conversation IO now actually ends when there is to npc option left or the player closes the inventory - integrations - `ProtocolLib` was replaced with `PacketEvents` - `MMOCore` integration updated to `1.13.1-SNAPSHOT` - menus and menu items - menu item's name and lore are no longer italic by default, name can be overridden while keeping original lore - `bound_item` now finds the first menu allowed to open instead aborting after the first check - npcs - `citizens` npcs to use the npc identifiers of BetonQuest instead of those from Citizens - `citizens` npcs hiding now uses the inbuilt player filter trait - `npcs` in the `npc_holograms` and `npcs`, `conditions` and `locations` in the `effectlib` section now use comma-separated lists - element behavior - the actions in quest cancelers to be now executed before the teleport - `items` now have a type like other elements - `math` placeholder now gives a better exception message and does not return 0 instead - `cancel` action now respects by default canceler conditions - `fish` objective use block selector instead of a quest item - `actions`, `objectives`, `conditions` and co. are now case-insensitive - `interact` objective now accepting `any` as an option for the entity type argument - `pickrandom` action now use tilde instead of percentage - `mooncycle` condition is now `moonphase` and uses a list of the phases instead of numbers - `mmobkill` objective now uses the killer (if present) to resolve names and distances ### Added - `package.version` for quest packages and quest templates - `constants` can be addressed with the new constant placeholder - `bypass` keyword to `cancel` action to ignore conditions in quest cancelers - `eval` action and condition to resolve a string and interpret it again as action/condition - `sync` placeholder offering identical evaluation as `eval` but forcing the execution on the main thread - `mainhand` selection order to `take` action - `abort` flag and `fail` actions to (chest) take action - `debug dump` command to only dump the history to the log file - `unit` as optional argument to the `folder` action to define the time unit for ticks, seconds, and minutes - defaults to seconds - support for `itemModel` for the totem NotifyIO (MC 1.21.4+) - optional ingame message for plugin updates (previously removed in 2.1.0) - `FastStats` to provide better statistics for BetonQuest - all of Minecraft's default font widths are now used to calculate the width of a string for line wrapping - support for text parsing formatter allowing for minimessage, minedown, and other formats for texts - support for placeholders in all actions, objectives, conditions, and more - list arguments allow for placeholders to be used in each element or all elements - menu features - menu items are now in the `menu_items` section, allowing references from multiple menus - `title` allows defining different messages - `bind` item for specific clicks - `check` flag to `menu` action to respect the menu's open conditions - `menu` action now supports the `update` action to update the currently opened menu - item types and item system improvements - `mmoitem`, `nexo`, `craftEngine`, `itemsAdder`, `mythic`, `brew`, `magic` item types - `simple` item type - `item-name` argument (MC 1.20.6+) - `item-model` & `no-item-model` arguments (MC 1.21.4+) - `custom-model-data` support for data lists (MC 1.21.4+) - `quest-item` argument for Mythic(-Mobs) and MMOItems item types - integrations and features to existing integrations - `FancyNpcs`, `ZNPCsPlus` and `MythicMobs` as new options for npcs - `FancyHolograms` as compatible hologram plugin - `citizens` npcs are now used only from default registry - `mcast` action to cast a Mythic(Mobs) skill with skill parameters for a player - `mmostat` action to modify the player's stats using the MythicLib (MmoLib) integration - `brew` action/condition `mode` parameter to select by name or id - `mode` to `mmobkill` to allow checking for faction instead of name - new conversation features - notification categories `conversation_start` and `conversation_end` - `menu` conversation IO settings to configure the scroll down and up buttons - native `menu` io implementation which sets the player's speed to zero instead mounting it on an arrow (MC 1.21.4+) - `invincible` config option to disable conversation invincibility - `conversation.block_item_transfer` option with per-conversation override to prevent item moving while in a conversation - new notification category `conversation_nothing_to_start` - config option `conversation.interceptor.display_history` to allow the interceptor to send the chat history after a conversation - config option `conversation.interceptor.delay` to configure a delay between the end of a conversation and the moment the interceptor is ended - new objectives - `timer` to track ingame time - `point` to track point changes ### Removed - spigot support entirely, now paper is required - undocumented prefix feature in conversation - `citizens_npcs_by_name` config option, which is now part of the id - start and stop sound in the configuration for conversations were removed in favor of the notification system that now also has the two new build in categories `conversation_start` and `conversation_end` - `menu reload` command which did not work - `variables` section - `MMOItems` conditions, actions, and the `mmoitemcraft` objective in favor of the built-in ones - `journal.chars_per_page` was deleted from the config.yml - undocumented way of addressing packages in some placeholders - `journal.show_separator` option deleted - `display_missed` config option, as the `none` interceptor should be used instead - legacy multiply with `*` for points - dependency `PaperLib` since its discontinued - aliases `/q`, `/j` and `/b` to improve compatibility with other plugins by actively reducing conflicts on command names - `Brewery` item condition and actions, in favor of the built-in ones ### Fixed - plugin did not reload menu config correctly - potions generated have not been extended/upgraded since 2.2.1 - biome condition on Minecraft 1.21.4 could not parse the biome from the instruction anymore - `randomnumber` placeholder now correctly returns lower bound - `stage` objective `index` property not working and now also starts at 0 - betonquest command without arguments did not work anymore - `Fabled` hook not working properly - `quest canceler` did not resolve global placeholders - `quest canceler` used `loc` instead of `location` key for teleportation - `journal` language only changed after rejoin when changing player language - `journal` entry renaming or deleting via command now affects all specified pointers and not only one - `ride` objective did only count vehicles, not all entities - scrolling the mouse in the menu conversation IO did not work - `MMOCore` attribute loading with MMOCore 1.13 - missing messages `animals_to_tame` and `times_to_jump` in language files by adding them - `menu` item parsing with newlines caused missing lines in some cases - `menu`s throwing exception on reload when bound commands are used - `mmoitemcraft` objective NoSuchMethodError with MMOItems 6.10+ - `menu` conversation IO exception in one edge case - `interact` objective's documentations used hookLocation instead of loc for the location - `randomnumber` placeholder using locale/eventually comma instead of dots breaking further using like math - `interact` objective now blocks the interaction with an item frame properly if cancel is set - `brewery` null pointer exception when a brew has no recipe - `npcrange` objective did count player without it valid for `outside` action - `global objective` error on join when it was added with the command or the tag got removed - `tellraw` conversation IO showed pop-up for unknown command - `simple` item `flags` crashed plugin when invalid - disabling the plugin no longer causes hardly expected zip errors - `mspawnmob` exception when spawning the mob is canceled/forbidden - conversations could cause deadlocks when too many conditions are checked - `itemdurability` placeholder parsed differently than intended in docs - database connection is now more stable and reconnect probably works better now - `QuestItem`s and `Journal`s could be put into bundles (MC 1.21.4+) - hologram integration with the lowest priority was selected instead of with the highest - broken conversation states no longer trap players - `firework` colors de-/serializing in `simple` item when there is no color - `nujobs_payment` objective wrongly using target amount for everything - `MMOCore` actions and conditions now no longer wrongly accept offline players - offline player data access in multiple elements supporting offline context - code in `npcmove` action effecting the end of a navigation to may return to a previous location in some cases

[__**fix incorrect repository reference in release script**__](https://github.com/BetonQuest/BetonQuest/commit/0517842d25cee16ccd8e1412535efa735666b6ef)

[__**fix detection of existing tags in build workflow when a release needs to know if api and lib need a deployment**__](https://github.com/BetonQuest/BetonQuest/commit/70866235f6c43c37e16bb9c0b55d1a95c7ab630e)

[__**Merge pull request #4038 from Juyas/changelogCleanup**__](https://github.com/BetonQuest/BetonQuest/commit/9f723ede2b81ec74a6335df407f7a67d0e401735) Update ChangeLog before Release

[__**Merge pull request #4039 from TheosRee/dev-3/273**__](https://github.com/BetonQuest/BetonQuest/commit/16af4f52f73e6ffbbe1fd3df06eecfb112ab03c7) Escape quotes in simple item serializing

[__**Merge pull request #4032 from TheosRee/dev-3/271**__](https://github.com/BetonQuest/BetonQuest/commit/dc223a5bbcad1060d5f59476132bf71ca946b69b) Check in ChestPutObjective if there is a Chest/InventoryHolder only if the location matches

[__**Merge pull request #4036 from Juyas/update/faststas**__](https://github.com/BetonQuest/BetonQuest/commit/b73d49a5583124b576e1e64de9e8875fa375de4c) Update `faststats-bukkit.version` to 0.25.2

[__**Am I an author?**__](https://github.com/BetonQuest/BetonQuest/commit/3eb3aa62e6ac14110b326b4eeadcc059a54a5385) Am I worthy of calling myself a co-author? Juyas has officially become a BetonQuest author by adding his name to the plugin.yml file himself. Now, everyone who looks at the authors list will know who to ask for help.

[__**Merge pull request #4034 from Juyas/fix/chatFormat**__](https://github.com/BetonQuest/BetonQuest/commit/7ced724684ad984e9b2a3f7737398b22c47df157) Fix chat format getting stripped

[__**Merge pull request #4033 from TheosRee/dev-3/272**__](https://github.com/BetonQuest/BetonQuest/commit/b72ba148bc6afb7da919557e4ff32e8342ee58ea) Move item resolving into ItemLine setLine

[__**Merge pull request #3983 from TheosRee/dev-3/266**__](https://github.com/BetonQuest/BetonQuest/commit/8fc0c2b97623c1a890f8d08c26b7d01f9db90884) Add player as context for mythic item and add mcast metadata

[__**Merge pull request #4030 from Juyas/fix/concurrentMetrics**__](https://github.com/BetonQuest/BetonQuest/commit/b478af3ac47fafeacf0a22e35e13ffdfcb7a0e74) Avoid concurrent modification exceptions

[__**Merge pull request #4029 from Juyas/fix/offlinePlayerData**__](https://github.com/BetonQuest/BetonQuest/commit/eee37b97641bb1f64fa57d694e3d2fe78e666515) Fix offline player data access

[__**Merge pull request #4028 from Juyas/fix/npe**__](https://github.com/BetonQuest/BetonQuest/commit/705c8dae1c0ab211c527bcbda98aa999f8ee1c6f) Fix NPE in faulty objective ata

[__**Merge pull request #4027 from Juyas/fix/mmocore**__](https://github.com/BetonQuest/BetonQuest/commit/633909fad84b02dc86250e13482d83c0eff57fb9) Fix MMOCore accepting too much offline players

[__**Denizen script with definitions (#4022)**__](https://github.com/BetonQuest/BetonQuest/commit/8a21cf949f555fcd82ad7d8689ababef6a490b28) Add option to define values passed to Denizen as tag definitions for script execution

[__**Merge pull request #4018 from TheosRee/dev-3/268 - bypassed on tasklist stuck**__](https://github.com/BetonQuest/BetonQuest/commit/b6aa5838b03613c42fcb5e3183f51c51c06ff37b) Use multi target Npcs from Identifier

[__**Merge pull request #4024 from Juyas/improveFastStats**__](https://github.com/BetonQuest/BetonQuest/commit/62974107b9e036b9ca7e18933a35decaef982809) Do not track errors on unofficial builds

[__**Merge pull request #4023 from TheosRee/dev-3/270**__](https://github.com/BetonQuest/BetonQuest/commit/e0ebe96851d049dfc5908d212498ed194daf230f) fix cancelling PlayerConversationStartEvent not interrupting

[__**Merge pull request #4019 from Juyas/api/definable-arguments**__](https://github.com/BetonQuest/BetonQuest/commit/d1e579ae496c616dc21d3fab4eeeaa2d7ee76d9c) Add option to parse a map of named arguments

[__**Merge pull request #3999 from TheosRee/dev-3/267**__](https://github.com/BetonQuest/BetonQuest/commit/4e21c29b4c8ccf82a0b5a514ddce47998a946a91) Add api methods for getting multiple Npcs from an identifier

[__**Merge pull request #4016 from Juyas/fix/stuckInConversation**__](https://github.com/BetonQuest/BetonQuest/commit/d56821849f64ec99abd34f25fb189b5643d0731a) Avoid getting stuck in a conversation by leaving the server.

[__**Merge pull request #4015 from Wolf2323/ServerName**__](https://github.com/BetonQuest/BetonQuest/commit/075ec4028a45ad853065375ba25eed55203f3636) Include server name in version command output

[__**Merge pull request #4011 from TheosRee/dev-3/289**__](https://github.com/BetonQuest/BetonQuest/commit/9f02167544767238084e1e9a09647f62f40f1c37) Respect the lore line added by the quest-item argument in LoreHandler

[__**Merge pull request #4014 from Wolf2323/MavenSetupUpdate**__](https://github.com/BetonQuest/BetonQuest/commit/cae2eb16dc2b258629d4097b8cf122c9254f72e6) Update for project structure, test suite and parent version - Update suppression rules for PMD warnings - Update all test classes to align with the suppression rule PMD.JUnitJupiterTestShouldBePackagePrivate. - Migrate AsyncSaver from extending Thread to implementing Runnable. Adjusted associated logic to use Thread objects for execution. - Update project POM files to use parent version 2.10.0.

[__**Merge pull request #4013 from Juyas/qodana**__](https://github.com/BetonQuest/BetonQuest/commit/333504737180fcc54908a075090f83fa3f25821a) Update qodana

[__**Add `bottom_margin` setting for menu display configuration (#4010)**__](https://github.com/BetonQuest/BetonQuest/commit/66f3b3092bebfc2d9d3601b3833130423e5d3730)

[__**Re-add flush method to faststats (#4009)**__](https://github.com/BetonQuest/BetonQuest/commit/d903b0ef8de27de59bed433ae918d557ad43cf51)

[__**Update FastStats integration to v0.24.0 (#4008)**__](https://github.com/BetonQuest/BetonQuest/commit/9bd33cec54bad2a7e698fdf10c01ac8ab20d400b) and refactor related imports and metrics handling

[__**Merge pull request #4006 from Wolf2323/notify**__](https://github.com/BetonQuest/BetonQuest/commit/b1488387cb1cf3f605105d9b207f449546bfd099) Refine discord notification logic to check version presence before hi…

[__**Merge pull request #4001 from Juyas/stats/reduceRedundancy**__](https://github.com/BetonQuest/BetonQuest/commit/fdcbcd67a05ca4b872b43f779f7da738d8aeddf5) Remove redundant data from data collection

[__**Exclude mkdocs.yml from causing a new build to be generated (#3996)**__](https://github.com/BetonQuest/BetonQuest/commit/b6dbeb7c4997e156a1917f442b14baf12e96d671)

[__**Merge pull request #3995 from Wolf2323/LoggerExtension**__](https://github.com/BetonQuest/BetonQuest/commit/d4fba31edeac4d74d1051417010458d369f02a9a) Refactor tests to decouple `BetonQuest` static mocking logic

[__**Merge pull request #3993 from Juyas/feat/meta**__](https://github.com/BetonQuest/BetonQuest/commit/4b76517cfd3ca0aa43aab5d1e8582c7c116ce09e) Add metadata concept and related classes

[__**Merge pull request #3992 from Juyas/startupErrorTracking**__](https://github.com/BetonQuest/BetonQuest/commit/b0c326181fac621f7dcd75178a36661102e3f6e8) Add error tracker to report exceptions on startup

[__**Merge pull request #3990 from Wolf2323/logging**__](https://github.com/BetonQuest/BetonQuest/commit/a9bc13e00f215f345c77adb37a54891f798cbc7c) Fix logger caching to pass the original nullable topic instead of the empty converted value

[__**Merge pull request #3991 from Juyas/moreStats**__](https://github.com/BetonQuest/BetonQuest/commit/35160cff0fe363bd22701deda5f6c16eb565f721) Add stats for non-integrated plugins and disabled hooks

[__**Merge pull request #3989 from Juyas/version/adjust**__](https://github.com/BetonQuest/BetonQuest/commit/5e2256620192710ce0cac5b60ba804c9e4308454) Update BetonQuestVersion for artifact versions

[__**Merge pull request #3988 from Wolf2323/fix-concurrency-issue**__](https://github.com/BetonQuest/BetonQuest/commit/4dedc20987cf884ae6816421dc61eb84dace19fb) Refactor logger caching to use `ConcurrentHashMap` and handle nullable topics

[__**Add per element statistics (#3986)**__](https://github.com/BetonQuest/BetonQuest/commit/527404373d160d10523b20a61a21012094211bca) Update to newer FastStats version to include mapped statistics for elements with readable identifiers Also fix statistics issue in BStatsMetrics with PlaceholderInstructions

[__**Update integration versions (#3985)**__](https://github.com/BetonQuest/BetonQuest/commit/39a8189acc1182029587e774737619208798da78) - WorldEdit and FastAsyncWorldEdit actually have separate versioning - FAWE version guessed by release timing of WorldEdit to be around 2.10.0 with some overshooting buffer for safety - Skript version was just wrong - adjusted to version stated in pom.xml

[__**Merge pull request #3984 from Juyas/fix/loggerInit**__](https://github.com/BetonQuest/BetonQuest/commit/1a5e7574eb6cd99c7dee77f1e3385430b085f1aa) Fix null pointer exception introduced with previous version. Previous fix to concurrency issues lead to even more issues with null pointers - now fixing the root cause: the method call that happened out of sync.

[__**Merge pull request #3981 from Juyas/fix/concurrencyHotfix**__](https://github.com/BetonQuest/BetonQuest/commit/6f4c4af1a4b88c5e8637327002182d3958591c09) Fix concurrency issues on CachingBetonQuestLoggerFactory when used through PlayerDataFactory

[__**Merge pull request #3980 from Juyas/feat/mythicStatAction**__](https://github.com/BetonQuest/BetonQuest/commit/3ea2c5bea89ec3b20f723f363f8910243cee43a2) Add MythicLibStatAction to allow changing player stats

[__**Fix daily dependency check failing because of missing fast stats repository (#3979)**__](https://github.com/BetonQuest/BetonQuest/commit/16db8f0d01110cb77c6cea2cd0e25f0217af9247)

[__**Merge pull request #3977 from TheosRee/dev-3/265**__](https://github.com/BetonQuest/BetonQuest/commit/3ae8b4a29f66f34393e2da2d35de027a76f0a8d6) Minor docs issues and fix for PaymentObjective "total" and LoreHandler serialize

[__**Merge pull request #3978 from Juyas/faststats/morestats**__](https://github.com/BetonQuest/BetonQuest/commit/b9a0d858bc7b6f67fcde81216dda50bf1f93a577) More statistics

[__**Merge pull request #3975 from TheosRee/dev-3/264**__](https://github.com/BetonQuest/BetonQuest/commit/2550426d288d060fa54dd8be6a64b4cf68d232e5) Fix Jobs PaymentObjective not persisting current amount

[__**Merge pull request #3969 from Wolf2323/modrinth**__](https://github.com/BetonQuest/BetonQuest/commit/03bdf7b3d102a34325c88f249cddd2a9b9f1da15) Refactor game-versions to dynamically use `>=${{ env.PLUGIN_API_VERSION }}` in build workflow

[__**Merge pull request #3974 from Juyas/feat/faststats/moreStats**__](https://github.com/BetonQuest/BetonQuest/commit/8808c12413d6d7de03b16f4b01048bf42940ff4b) Add stats for the Updater according to its settings and usage

[__**Merge pull request #3973 from Juyas/feat/faststats/errortracking**__](https://github.com/BetonQuest/BetonQuest/commit/7b639d128e12c279371d42b68456cb501f297072) Add Error-Tracking with FastStats and update it for shutdown data flushing

[__**Add more statistics to FastStats (#3972)**__](https://github.com/BetonQuest/BetonQuest/commit/51d9cb56302995fa9ecaf96bafc02f471d68bf26) - integration counts - integration names - loaded element counts

[__**Merge pull request #3971 from TheosRee/dev-3/263**__](https://github.com/BetonQuest/BetonQuest/commit/5fbf1911296cb919cb115fd7d9608c2c10088943) Correctly de-/serialize firework colors in simple item

[__**Merge pull request #3970 from TheosRee/dev-3/262**__](https://github.com/BetonQuest/BetonQuest/commit/254a0400af8e4a44a09557378a8669ae7dec4b44) Scale and offset item displays for FancyHolograms

[__**Merge pull request #3968 from Juyas/feat/faststats**__](https://github.com/BetonQuest/BetonQuest/commit/339fdc49d8e79215fa8edaa1b6323e5e2b203a71) Integrate FastStats metrics into BetonQuest

[__**Merge pull request #3966 from Juyas/policies/api**__](https://github.com/BetonQuest/BetonQuest/commit/d0eca157ccbb59ec4d9325447c2122ad8e42d9aa) Add BetonQuestPolicy for version validation against BetonQuest API versions

[__**Change integrated CraftEngine version to newest release (#3960)**__](https://github.com/BetonQuest/BetonQuest/commit/233ce276faf93ef3100a2cf6edd6ada7aee55df9) namely 26.5 and update the download link to modrinth. The previous CraftEngine version is no longer supported with that change.

[__**Add Magic Items Integration (#3964)**__](https://github.com/BetonQuest/BetonQuest/commit/0ed0f50e2a80202743aef1850793141e147fc66e) * Add MagicItemFactory and MagicQuestItemSerializer * Add documentation to Items sections of the integration list and reference to already existing page * Add CHANGELOG.md entry

[__**Merge pull request #3953 from TheosRee/dev-3/261**__](https://github.com/BetonQuest/BetonQuest/commit/90e766ae685a5c6ab3c8324ff6973767d2115f90) Add fail flag to throw if not all items could be taken in take actions

[__**Merge pull request #3962 from Wolf2323/Modrinth**__](https://github.com/BetonQuest/BetonQuest/commit/81833ea4f552b1015a6034b58725892b5c3d179d) Remove unused `${{ env.PLUGIN_API_VERSION }}` from game-versions in b…

[__**Merge pull request #3952 from Wolf2323/Modrinth**__](https://github.com/BetonQuest/BetonQuest/commit/c1fad1dfe54eb73ea994b49745913e85d4f573b9) Add Modrinth publishing step to build workflow

### Added - A Bukkit event which fires when a player's points change - `folder` event now has an argument `cancelConditions` to cancel a running folder - `action` objective now supports configuring the hand used for the interaction, preventing multiple objective completions at the same time on right click ### Fixed - fixed NPC navigation by giving better error messages and handling the stuck action correctly - custom sounds from resourcepacks could not be used in conversation start and end sound - `chestput` objective caused that no chest could be opened on the server when `multipleaccess` was forbidden(default) - providing wrong commit sha to the download command now gives a proper error message - no longer set damage in `QuestItem` if none set - loading of a backup file has the wrong order of applying the statements, causing exceptions and a broken migration

### Added - new conversation options - `start_new_lines` the amount of new lines that should be printed before the conversation starts - `npc_text_fill_new_lines` should lined be filled between the NPC text and the player answer options - `world` condition now supports variables for the world name - underscores are now escapable in item names and lore via `\_` - `weather` condition now allows to define a world, which can be a variable and can now be used in static context - `time` condition now allows to define a world, which can be a variable and can now be used in static context - `time` condition now supports minutes - `paste` event can now rotate schematics - `permission` condition now supports variables - `moonCycle` condition now allows to define a world, which can be a variable and can now be used in static context - global variable support for npc ids and condition ids in `effectlib` section - `and` condition can now be static - missing tab-completion and documentation for globalpoints and globaltags command - `party` condition now supports a location variable, to be used in a static context - `enitity` condition now supports variables for the entity name - `mmochangeclass` objective for MMOCore that listens for a player changing their class - `removeentity` event now supports variables for the entity name - `variable` condition can now be used in a static context - TrainCarts integration - `traincartslocation` objective that executes when the player passed a location - `traincartsride` objective that executes when the player is riding a train - `traincartsexit` objective that executes when the player exited a train - `traincartsride` condition to check if the player is riding a specific named train - `scoretag` event and condition - `action` objective now supports configuring the hand used for the interaction, preventing multiple objective completions at the same time ### Changed - `spawn` event now only spawn mobs and no other entities - ProSkillAPI rename to Fabled - this includes the class and level condition ### Fixed - broken title check in book `QuestItem` - BlockSelector did not match exact block matches and started regex matching causing performance issues during load and reload - wrong order of arguments in fire work effects - non-static `variables` causing cross conversation validation to break - LuckPerms integration not pushing the permission update to the connected servers correctly. - `crafting` objective where complex recipes are not recognized - `hieght` condition where variable locations threw an exception - `globalpoint` condition where not initialized global points where 0 - `point` condition where not initialized points where 0 - `QuestItem` Potions cannot be saved in 1.20.5+ - Schedules could run twice on some systems by an inaccurate time returned java's Instant.now() - `Journal` interaction with blocks like lecterns - sections that are created in templates by write operations, where no edits should actually be done - this caused a lot of "ghost" sections that could not be loaded like schedules, menus and manny more - Conversations work in 1.21.3 again

### Added - BreweryX compatibility ### Changed - `mspawnmob` can now be used in static context ### Fixed - LuckPerms integration not sending the permission updates via the messaging service to connected Servers in the same network. - LuckPerms TagCalculator trying to use PlayerData even if player is offline - Memory Leak in CombatTagger - AdvancementIO not working in mc 1.20.5/6 and 1.21 - chaining of movenpc events did trigger fail events - effect event duration -1 did not result in infinite duration - translation in conversation got stored in default language - incorrect calculation of the width of strings when using characters with certain accents when doing pagination

### Added - LuckPerms permission events - `addPermission` event adds a permission to a player - `removePermission` event removes a permission from a player - Location Vectors can now be chained - `eval` variable to resolve a variable string as variable ### Changed - `AureliumSkills` was renamed to `AuraSkills` the following was changed in BQ - `aureliumskillslevel` condition was renamed to `auraskillslevel` - `aureliumstatslevel` condition was renamed to `auraskillsstatslevel` - `aureliumskillsxp` event was renamed to `auraskillsxp` - prevent reply when the text is not completely displayed for the SlowTellRaw conversation IO - `resourcepack` objective is now paper only - `die` objective now support respawns without canceling the actual death of the player - `ph` variable can now be used static ### Fixed - NPE if a player replies to a SlowTellRaw conversation IO when the text is not completely displayed - head `QuestItem` matches even if they are distinct - modulo operator in math variable can now be used by escaping the percent sign - `weather` event not static callable even when providing a world

### Fixed - math variable with dots (since 2.1.0)

### Changed - player variable - `%player%` is now the same as `%player.name%` - `%player.name%` will display the name of the player - `%player.display%` will use the display name used in chat - `%player.uuid%` will display the UUID of the player - marking of mobs now uses variables in all contexts of spawning killing and removing - marking of mobs is now stored in the persistent data container of the entity to prevent loss on server restart - default `default_conversation_IO` in config from `menu,chest` to `menu,tellraw` - corrected Russian messages in `messages.yml` file ### Added - `block` objective now supports parameters `loc` and `region` to limit the area - `block` objective now supports the parameter `ignorecancel` allow counting breaking / placing blocks in protected regions - command `variable` to list and modify variables on a variable objective - config option `conversation_IO_config.slowtellraw.message_delay` to set the delay between messages in the SlowTellRaw conversation IO - `resourcepack` objective - to allow checking when the player accepts, denies, downloads, or fails to download a resource pack - `region` objective now supports variables as region name - `location` objective now allows `entry` and `exit` keywords to track entering and leaving the location - allowing adjustment of maximum hologram display radius - support to execute BetonQuest commands from command blocks ### Fixed - `variable` objective loads newlines correctly - exception in `lookAtBlock` condition when omitting the type - MMOCoreClassCondition, MMOItemsGiveEvent, MMOItemsHandCondition and MMOItemsItemCondition now work with numeric identifiers - yaml multiline instructions could lead to partly working events, conditions and objectives - creation of advancement tab when an advancement NotifyIO is sent - `burn` event throwing unexpected error when omitting duration - added missing firework meta to string representation of QuestItem - required flags in `QuestItem` were not relevant in equals check - `folder` event did not respect the sync / async context that it is executed in - incorrectly measuring the distance between player and hologram if they are in different worlds - incorrect calculation of the width of strings when using some special characters when doing pagination - previously undocumented quoting in instructions

### Added - `hunger` event now supports variables - `time` event now supports variables and new `ticks` argument ### Changed - Quests by PikaMug got updated from version 4.X to 5.X - The ProtocolLib dependency was downgraded from 5.2.0-SNAPSHOT-679 to 5.0.0-SNAPSHOT-636 ### Fixed - `weather` event did not use `duration` - `lever` event does not work with redstone - papers future remove of CB package relocation

### Added - Logging - Ingame logging - Logging during `/q reload` - New command `/q debug ingame` - Debug logging to separate file - Log history length can be freely configured - Quest Templates - A new folder `QuestTemplates` can now be used to define templates for packages - templates can also extend templates - add AureliumSkills Compatiblity - added AureliumSkillsLevelCondition - All existing users must add aureliumskills: 'true' to their config.yml's hook section. - added AureliumStatsLevelCondition - added AureliumSkillsLevelExperienceEvent - add DecentHolograms Compatibility - holograms from DecentHolograms are a direct alternative to HolographicDisplays - add LuckPerms context integration for tags - All existing users must add luckperms: 'true' to their config.yml's hook section. - add FakeBlock Compatibility - added `fakeblock` event that has the arguments `showgroup` and `hidegroup` to show and hide FakeBlock groups - added `hook.fake-block` config option, default: `true` - add RedisChat Compatibility - added `redischat` chat interceptor - added Event Schedules to replace old static-events system - static events from schedulers now respect static conditions - events called by schedules are always called player independent - `runForAll` event can now be used to run events for all players that match a condition - `runIndepent` event can be used to run events static (player independent) from player dependent contexts - added support for Base64 encode custom heads - can be created from items in inventory using the BetonQuest `item` command (Paper only, Bukkit/Spigot can be configured manually) - can be given to players using the BetonQuest `give` command - NotifyIO "totemIO" - Support for MythicLib - player attribute to QuestCompassTargetChangeEvent - added PlayerObjectiveChangeEvent, PlayerJournalAddEvent, PlayerJournalDeleteEvent - Allow %player% variable for PLAYER_HEAD quest items - allow access to objective variable properties from other packages - allow point variables from other packages - API method in objective API that starts and stops it per player - config option `default_hologram` to set hologram priority if multiple hologram plugins are loaded at once - config option `journal.show_in_backpack` to remove the journal from the backpack - config option `journal.lock_default_journal_slot` to lock the journal to the `default_journal_slot` - config option `journal.give_on_respawn` to add the journal to the inventory after the player respawns - config option `journal.custom_model_data` to give the journal a ressource pack based skin - config option `mysql.reconnect_interval` to set the reconnect interval if the connection to the database gets lost - compass now supports items from other packages - new messages.yml entries `inventory_full_backpack` and `inventory_full_drop` to have more specific messages, when the inventory of the player is full - `menu` conversationIO option `npc_name_newline_separator` - added `q download` command - variable support for menu titles - configurable cooldown to menu conversation IO - holograms - variable support - top lists ordered by point values of players - `npcs` list now supports global variables as NPC ID in NPC Holograms - menus now support global variables - exposed the Citizen variable and enhanced location capabilities - menus now support string with newline or string list text values for lore - amount of objectives now support variables - added quest item flag recording and restore - Conversations now support cross conversation pointers to conversations in other packages - QuestCancelers can now be referenced across packages - Chat Interceptor `packet` is now 1.20.4 compatible - `freeze` event - ProtocolLib compatibility feature: Blocks the player from moving for the specified amount of ticks - `block` objective - properties: `absoluteAmount`, `absoluteLeft` and `absoluteTotal` - `command` objective - `equip` objective - `delay` objective - now support variables - `sudo` event - now supports variables - `opsudo` event - now supports variables - `variable` condition - now supports variables - `bossbar` notify style now supports variables for the `progress` and `stay` arguments - `delay` objective property: `rawSeconds` - `fish` objective now has `hookLocation` and `range` settings. - `consume` objective now has `amount` argument. - `mmoprofessionlevelup` objective can now check the main character level as well - `burning` condition - `inconversation` condition - `language` condition - `heroesattribute` condition - Heroes compatibility feature: Checks a player's level for a particular attribute against a value - `variable` condition - regex can now also be a variable - `mmspawn` event now has argument `target` Makes the spawned mob target the player - `mmspawn` event now has argument `private` Visually hides the spawned mob from other players. Does not stop sound or particles - `mmspawn` event now supports the `marked` argument - `objective` event now supports a comma separated list of objectives - `mmobkill` objective now supports the `marked` and `deathRadiusAllPlayers` argument - `marked` argument now supports %player% variable - `globaltag` and `globalpoint` variables - `burn` event - ignites player for given seconds, supports variables - `velocity` event - throws the player by a vector (can be variable) with a direction and modification - `block` objective - added argument `noSafety` which disables removing progress when the player does the opposite of what the objective asks for - `block` objective - added property variables `absoluteLeft`, `absoluteTotal`, `absoluteAmount` that always return absolute values - `hunger` condition and event - `variable` condition - forceSync argument forces the condition to be checked on the main thread - `variable` condition - now supports variables as both the input and the regular expression - `command` event - now suppress console output - `cancelconversation` event - `time` event - now supports subtraction and world selection, which made it persistent and static - `globalpoint` event - new syntax for manipulating global points - `experience` event - it's now possible to change xp, change and set levels and set the xp bar - `deleteglobalpoint` event - `score` event - more options for manipulating the scoreboard - `item` variable - new `name` and `lore` argument and now supports items from other packages - `randomnumber` variable added - supports variables - `give` event - new `backpack` argument to place items in the backpack (if a valid QuestItem) - `party` event - new optional `amount` of maximal affected players - `drop` event - `itemdurability` event, condition and variable - `numbercompare` condition - `cancelOnLogout` argument for `folder` event - `npcinteract` objective - now supports the argument `interaction` to choose between left, right or both clicks - `log` event - `party` event - new range 0 and -1 to select players in the same world or server wide - `stage` objective, condition and event - `first` event - attempts to run a list of events until one successfully runs, like a compressed `if` event ### Changed - Java 17 is now required - changed package names from `pl.betoncraft.betonquest` to `org.betonquest.betonquest` - Changed quest package structure - Quest packages are now searched and loaded from the folder `BetonQuest/QuestPackages/` - Quest packages can now contain more quest packages in sub folders - Relative paths can now navigate downwards and not only upwards - `main.yml` was renamed to `package.yml` - Any file and folder structure with any file and folder names is now allowed, except `package.yml`, as that file indicates a quest package - `events`, `objectives`, `conditions`, `journal` and `items` are now defined in a config section matching their names - `conversations` and `menus` are now defined in a config section matching their names and a unique identifier like the file name before - The `enabled` boolean is now defined in the `package` section - all objectives that can be advanced without directly completing now support notify - all objectives that can be advanced without directly completing now support `left`, `amount` and `total` variables - the `left` and `amount` variables of some objectives were swapped and have been corrected: `left` is the amount left, `amount` is the amount done - NPC Holograms are reworked - individual refresh rate for each hologram - the boolean follow is now set per hologram - the vector offset origin has been changed. The hologram is now directly above the NPCs head by default. This means all previously custom vectors are now increased by 3 blocks on the y-axis. - npc_effects are reworked - the section changed its naming from `npc_effects` to `effectlib` - the section `disabled` got removed - the section `check_interval` is now an inner section of the effect and now called `checkinterval` - next to the `npcs` section there is now an `locations` section - effects will now follow npcs if they're pathing to another spot - AureliumSkills updated to version Beta1.2.5 - PikaMug Quests updated to version 4.1.3 - Items now support AIR - Menus now support new `click` options `shiftLeft`, `shiftRight` and `middleMouse` to execute events on item clicks - Therefore `left` and `right` in the `click` section no longer include shift clicks - `folder` event - now executes events immediately if no delay is set - `weather` event - now has an optional variable duration (in seconds) and an optional world param - `paste` event - can now be static - `chestput` objective - can now block other players from accessing a chest while someone is putting items inside - The location and region objectives now register movement of players inside a vehicle - written book is now readable as a quest item - HolographicDisplays updated to 3.0.0 - Added staticness indicator to variables that can be executed without a direct player connection - written book quest items can now be read - `experience` objective event and condition were reworked - condition and objective do not support raw experience anymore - all allow decimal level and variables now - changed backpack configuration. "" will hide the compass or canceler - `smelt` objective - now requires a QuestItem instead of a BlockSelector - `cancelquest` command - has its own permission now - `compass` command - has its own permission now - `language` command - is now persistent - `point` command - list can now be filtered by beginning letters - `tag` command - list can now be filtered by beginning letters - `globalpoint` command - list can now be filtered by beginning letters - `globaltag` command - list can now be filtered by beginning letters - `journal` command - list can now be filtered by beginning letters - `objective` command - list can now be filtered by beginning letters - `variable` condition supports escapable underscores to avoid replacement - `kill` event - now kills the player, instead of dealing damage, which is more reliable - `lightning` event - now has a new noDamage argument - `clear` and `killmob' events - got replaced by new `removeentity` event - the line length of `SlowTellRaw` conversation IO from 60 to 50 to fit the actual minecraft chat - Item enchantments was changed to include zero as a legal value, not just positive numbers - the objectives mmocorecastskill and mmoitemcastability were merged into the mmoskill objective - `command` event no longer runs for all players on the server if a variable is used - `math` and `version` variables - now static - `alternative` and `check` condition - now static - `open_events` in a menu are now called before the menu actually opens - `conversation` event now support a start option ### Removed - deprecated internals, code and old features - Support for MMOLib - `message` event - `title` event - `playsound` event ### Fixed - added missing spaces to time left property of delay objective - catchup now works even if schedule was never executed before - q version now works again - RPGMenu error when teleport events are used as click events - RPGMenu bound items not always working - npc_holograms do now show errors during reload and not one tick later - first slot in backpack stays empty when journal is in player inventory - npc_holograms are not shown correctly with multiple defined npcs - spectator mode is now disabled for chest conversation io to prevent being stuck in the conversation - packet chat interceptor does not catch action bar anymore - time event does not work with floating point values - global variable recursive resolution cross packages - inaccurate location variable decimal rounding - NPC holograms from Citizens are not hidden correctly - `location` objective - is now more robust if the player changes a world - `brew` objective - now counts newly brewed potions even if there were already some potions of the desired type in - `chestput` objective - did now work with double chests other slots present - `menu`(open) event - showed the previous menu again - non .yml files causing errors when loading quest packages - `pickrandom` event - did not calculated chance correctly - `pickrandom` event - did not allowed dashes in event names - `action` objective - ignored offhand at all - `enchant` objective - did not work at all, now has `amount` and `requirementMode` parameters - Hologram topX line not working with profiles - the craft objective could be completed without consuming materials - LocationObjective resolves variable for a player who does not have the objective, and so maybe also dont have the variable - performance when using many conditions / events / ... repeatedly - `/q journal` command allowed invalid journal pointers - AsyncSaver will shut itself down if the database connection is lost, resulting in data loss - Journal entries did count color codes as line length, affecting the formatting of pages - Notification categories could be modified during runtime with the notify event - Leading spaces are now preserved in conversation messages and journal entries - giving `air` with the give command or the give event crashes the server - duplication of holograms when reloading BetonQuest and the hologram is hidden - `menu` conversation IO kicked players when conversation started in the air caused by flying detection - `menu` conversation IO did not stopped scrolling at the bottom and began to scroll from the top again - removed the hearts of the Armorstand in the Menu Conversation IO - journal entries now keep their leading whitespaces - exceptions in `sudo` and `command` events leading to broken conversations that could not be exited - the NPC's head could be stolen from conversations with the `chest` style ### Security - it was possible to put a QuestItem into a chest - bump log4j dependency 2.15.0 to fix CVE-2021-44228 - `take` event - is now threadsafe

**This is the last long term support update for BetonQuest 1.12.X. Soon BetonQuest 2.0 will be released.** ### Changed - the MythicMobs integration was updated to MythicMobs 5.3.5 - the MythicLib integration was updated to MythicLib 1.6-SNAPSHOT - the objectives mmocorecastskill and mmoitemcastability were merged into the mmoskill objective - the MMOCore-API integration was updated to MMOCore-API 1.12-SNAPSHOT - the MMOItems-API integration was updated to MMOItems-API 6.9.4-SNAPSHOT ### Fixed - conversation could have a deadlock and a player can get stuck in a conversation - conversation could not be canceled due to a race condition - JobsReborn ObjectivePaymentEvent couldn't be used - ProtocolLib warning for Minecraft 1.20.2

## Added * `drop` event * `itemdurability` event, condition and variable * `numbercompare` condition * RedisChat integration: A new chat interceptor * `sudo` event now has variable support * Russian translation ## Changed * The MythicMobs integration to MM 5.3.5+ ## Fixed * ObjectivePaymentEvent (JobsReborn Integration) * `craft` objective did not consume materials * `location` objective variable resolving * `variable` objective data storage * Concurrency issue problems with conversations * Performance issues * Database issues

## Fixed * An issue with some MySQL implementation that did not allow default values for new table columns.

A lot of time has passed since we lasted updated Modrinth, so these are just the most important changes. **A few manual migration steps are required. They are documented on the [migration page](https://docs.betonquest.org/2.0-DEV/Documentation/Configuration/Version-Changes/Migration/#200-dev-538-smelt-objective)!** ## Added * Integration for the [Fakeblock](https://github.com/toddharrison/BriarCode/releases/tag/fake-block-2.0.3) plugin: [Demo Video](https://www.youtube.com/watch?v=OgHvBoQr3dY&feature=youtu.be) * Support for heads with custom textures * Support for global variables in menus * The `deleteglobalpoint` event * The `cancelconversation` event * ItemVariable `name` and `lore` options * Support for global variables in holograms * Backpack argument to the give-event * An optional maximum amount to the party event * Every objective with an `amount` argument now supports variables for the amount. ## Changed * Citizens 2.0.31-SNAPSHOT is now required and fixed hiding of hologram lines above NPCs * Remastered NPC Holograms: [See Migration Guide!](https://docs.betonquest.org/2.0-DEV/Documentation/Configuration/Version-Changes/Migration/#200-dev-538-smelt-objective) * Remastered EffectLib Integration: [See Migration Guide!](https://docs.betonquest.org/2.0-DEV/Documentation/Configuration/Version-Changes/Migration/#200-dev-538-smelt-objective) * The experience event can now change the player's xp, change and set levels and set the xp bar. * Static events now respect conditions, if they are static aswell * Permission seperation for `betonquest.cancelquest` and `betonquest.compass` * QuestItems can now require now enchantments * Improved french translations with the help of @JeremyDarbellay * The smelt objective now requires a QuestItem instead of a BlockSelector: [See Migration Guide!](https://docs.betonquest.org/2.0-DEV/Documentation/Configuration/Version-Changes/Migration/#200-dev-538-smelt-objective) ## Fixed * PacketInterceptor did not work in every Minecraft version * NPC holograms from Citizens were not hidden correctly * Creation of ghost items when menus closed themselfs * The legacy §x HEX color format not working in some context * Eating of items when entering the `chest` conversation style actually consumed the item * Many more...

### Fixed - ProtocolLib's based `packet` interceptor was fixed for MC 1.19, now ProtocolLib 5.0.0 is required - conversation IO chest did not show the correct NPC heads - `objective` event - static calls did not remove the objective for online players - legacy `§x` HEX color format not working in some contexts - eating of items when entering the chest conversation io actually consumed the item

## Added * Global Variables can now be used in NPCHolograms ## Changed * The `command` event now suppresses it's console output * The Quests integration now uses Quests 4.6.2 * The ProtocolLib integrations now require v5.0.0+ ## Fixed * `journal delete` did not work * ProtocolLib based packet interceptor for MC 1.19

## Added - Language condition - Option to hide the compass and quest cancelers from the backpack - DecentHolograms support alongside HolographicDisplays ## Changed - Experience objective event and condition where reworked - condition and objective do not support raw experience anymore - all allow decimal level and variables now - Improved error message when running incompatible integrated plugins - Automated conversion of invalid CountingObjective data to the new format - Caused by the objective data that was previously saved by the objective before they became CountingObjectives - This is logged with a warning ## Fixed - ChestPut objective does not work with double chests - Action objective ignoring offhand - Pickrandom event did not allowed dashes in event names - Inaccurate location variable decimal rounding - Exception when reloading an integration that did not hooked during startup - Global variable resolution - Correctly handle failure of parsing a double as value of a VariableNumber

A few bug fixes have been made: * fixed the purge command not working because of the journal * fixed the BrewObjective * fixed a concurrency issue with folder event, when a single event takes too long to execute

📰 **Big 2.0 News** Hello, we have a bunch of changes and new features for you: __**IMPORTANT**__ The package `enabled` boolean was moved to the new `package` section. If you have disabled packages you need to move this setting to it's new place under `package.enabled`. Otherwise all disabled QuestPackages will now be loaded. ```yaml package: enabled: false ``` 🆕 __**Quest Templates**__ Thanks to Wolf2323's efforts, we are finally able to release **Quest Templates** **What is a Quest Template?** Do you have quest parts that need to be repeated all over again? Therefore, you just copy and paste them? Or do you have something like a utility quest package? Then Templates are perfect for you. With Templates you now have a `QuestTemplates` folder beside your `QuestPackages` folder. In this folder you can write quests, as you are used to. But they will not get loaded as a quest. Instead you can reference them from any quest package. Then this template will be merged together with the quest package as if it's contents were defined in the quest package. This does not modify the files but happens in the background (Similar to how inheritance works in object oriented programming). With this concept it is possible to centralise quest code in one place. You can also override specific values from the template per quest package. Additionally, you can use other templates inside a template. And of course a quest package can also inherit from multiple templates! ➡️ https://docs.betonquest.org/2.0.0-DEV/Documentation/Packages-%26-Templates/#templates 📋 __**Additional Updates**__ ```diff -Fixes ``` - `pickrandom` event did not calculated chance correctly ``` diff -Changes ``` - `tag remove` is no longer allowed. Only `tag delete` works in order to ensure a consistent syntax. Use search and replace to easily update your configs. ```diff +Additions ``` - `objective` event now supports a comma separated list of objectives - The journal can now have a custom skin based on the `journal.custom_model_data` setting. - The objective `mmoprofessionlevelup` can now check the main character level as well. - `consume` objective now has `amount` argument. - `mmobkill` objective now supports the `marked` and `deathRadiusAllPlayers` argument - A written book quest item can now be read. - The BlockObjective now has native absolute properties (e.g. `absoluteLeft`) so that math.calc is no longer needed for well-formatted output. - The variable condition now supports variables as both the input and the regular expression. - `bossbar` notify style now supports variables for the `progress` argument ```diff +New Documentation ``` - Yuyukey added a tutorial for quest packages: https://docs.betonquest.org/2.0.0-DEV/Tutorials/Syntax/Quest-Packages/ - SaltyAimbOtter added a guide for common regular expression use cases: https://docs.betonquest.org/2.0.0-DEV/Documentation/Reference/#regex-regular-expressions If you like our changes consider helping the project by **funding future updates**: https://opencollective.com/betonquest

## Fixed * Weather event - storm did not work * 1.19 ProtocolLib warnings about deprecated packages