BetonQuest

Merge pull request #4155 from TheosRee/dev/backpack

Create BackpackFactory to reduce dependency injection

Merge pull request #4153 from Wolf2323/releaseScriptDeploymentCheck

Release script deployment check

Merge pull request #4152 from Wolf2323/SECURETY.mdUpdate

Update SECURITY.md for major version changes during release process t…

Merge pull request #4151 from Wolf2323/releaseScriptTagFix

Enhance release script to validate specific version tag patterns.

Merge pull request #4154 from Wolf2323/CheckStyle

Update checkstyle version for IntelliJ

Merge pull request #4150 from Wolf2323/releaseTags

Prevent duplicate version tags during release process.

Merge pull request #4149 from Juyas/api/functions

Expose Functions via BetonQuestApi

Merge pull request #4146 from Juyas/fix/concurrency

Fix concurrency issues by decoupling source collections

Merge pull request #4144 from Juyas/functions/implement

Implement functions

Merge pull request #4126 from Juyas/math/function

Function parsing

Merge pull request #4115 from Juyas/bump/FastStats

Bump faststats-bukkit version to 0.27.1 in pom.xml

Merge pull request #4113 from Wolf2323/pomUpdate

Version bump of Parent pom to 2.11.0 across all POM files

Merge pull request #4127 from Juyas/bump/worldguard

Update WorldGuard and WorldEdit compatibility to newer versions

Merge pull request #4118 from BetonQuest/dependabot/github_actions/toshimaru/auto-author-assign-3.0.3

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

Bump actions/checkout from 6 to 7

Merge pull request #4114 from Wolf2323/ManualTrigger

Enable manual trigger for daily dependency check workflow

Merge pull request #4111 from Wolf2323/ReleaseBranchCheck

Add checkGitState to validate branch and sync state in release script

Merge pull request #4106 from TheosRee/feat/mmoitem

mmoitem now checks for soulbound when set

Merge pull request #4094 from Juyas/polish/action/burn

Polish burn action

Merge pull request #4109 from TheosRee/dev/subsections

Adjust QuestMigration to work with subsections

Add heal action to adjust player health (#4104)

Merge pull request #4101 from Juyas/fix/groupedFixes

Two minor fixes

Merge pull request #4097 from TheosRee/feat/translatable

Add translatable placeholder

Merge pull request #4095 from Juyas/VersionBump-3.1.0

Library Version bump to 3.1.0

Fix string concatenation in LangCommand to no longer chop off the last 2 characters (#4092)

Javadocs: Add @since 3.1.0 annotations to QuestPredicate interface methods (#4093)

Merge pull request #4085 from TheosRee/dev/nested

Allow grouping in sections for single line instruction identifiers

Merge pull request #4079 from meankitmishra/language-whitelist

add questlang language whitelist

Merge pull request #4089 from TheosRee/dev/throws

Remove the unnecessary throws in QuestBiPredicate and fix changelog

Merge pull request #4041 from Thorinwasher/feat/quest-predicate

Add QuestPredicate interface

Merge pull request #4087 from Juyas/VersionBump-3.1.0

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)

Merge pull request #4083 from Juyas/updateChangelog

Update Changelog

Merge pull request #4082 from TheosRee/fix/point-migration

fix RemoveLegacyPointModification migration from 2 to 3

Merge pull request #4081 from Juyas/gh/postReleaseUpdates

Github post release updates

Merge pull request #4078 from Juyas/gh/templates

Enhance GitHub issues templates

Merge pull request #4074 from Juyas/api/improveDocs

Improve API javadocs

Merge pull request #4073 from Juyas/fix/issueTemplates

Enhance issue templates

Merge pull request #4072 from Juyas/fix/faststats

Bump FastStats dependency to 0.27.0 in core POM

Merge pull request #4059 from Wolf2323/requirements

Refactor release script

Merge pull request #4060 from Juyas/releaseScript

Improve release script (SSH auth)

Merge pull request #4061 from Juyas/VersionBump-3.0.2

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

Fix tag verification logic in build workflow

Merge pull request #4054 from Juyas/ssh/releaseScript

Update release script for better ssh support

Remove automatic text wrapping in markdown files for IntelliJ IDEA

Merge pull request #4050 from Juyas/changelog

Update changelog to include recent fixes and deprecation notes

Merge pull request #4044 from Juyas/fix/faststats

Update faststats-bukkit.version to 0.26.1 in pom.xml

Merge pull request #4042 from Juyas/fix/unspecifiedVersionParsing

Fix version parsing for policies

Merge pull request #4043 from Juyas/missingDeprecation

Fix missing deprecation

Merge pull request #4040 from Wolf2323/VersionBump-3.0.1

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
• menus 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
• QuestItems and Journals 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

fix detection of existing tags in build workflow when a release needs to know if api and lib need a deployment

Merge pull request #4038 from Juyas/changelogCleanup

Update ChangeLog before Release

Merge pull request #4039 from TheosRee/dev-3/273

Escape quotes in simple item serializing

Merge pull request #4032 from TheosRee/dev-3/271

Check in ChestPutObjective if there is a Chest/InventoryHolder only if the location matches

Merge pull request #4036 from Juyas/update/faststas

Update faststats-bukkit.version to 0.25.2

Am I an author?

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

Fix chat format getting stripped

Merge pull request #4033 from TheosRee/dev-3/272

Move item resolving into ItemLine setLine

Merge pull request #3983 from TheosRee/dev-3/266

Add player as context for mythic item and add mcast metadata

Merge pull request #4030 from Juyas/fix/concurrentMetrics

Avoid concurrent modification exceptions

Merge pull request #4029 from Juyas/fix/offlinePlayerData

Fix offline player data access

Merge pull request #4028 from Juyas/fix/npe

Fix NPE in faulty objective ata

Merge pull request #4027 from Juyas/fix/mmocore

Fix MMOCore accepting too much offline players

Denizen script with definitions (#4022)

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

Use multi target Npcs from Identifier

Merge pull request #4024 from Juyas/improveFastStats

Do not track errors on unofficial builds

Merge pull request #4023 from TheosRee/dev-3/270

fix cancelling PlayerConversationStartEvent not interrupting

Merge pull request #4019 from Juyas/api/definable-arguments

Add option to parse a map of named arguments

Merge pull request #3999 from TheosRee/dev-3/267

Add api methods for getting multiple Npcs from an identifier

Merge pull request #4016 from Juyas/fix/stuckInConversation

Avoid getting stuck in a conversation by leaving the server.

Merge pull request #4015 from Wolf2323/ServerName

Include server name in version command output

Merge pull request #4011 from TheosRee/dev-3/289

Respect the lore line added by the quest-item argument in LoreHandler

Merge pull request #4014 from Wolf2323/MavenSetupUpdate

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

Update qodana

Add bottom_margin setting for menu display configuration (#4010)

Re-add flush method to faststats (#4009)

Update FastStats integration to v0.24.0 (#4008)

and refactor related imports and metrics handling

Merge pull request #4006 from Wolf2323/notify

Refine discord notification logic to check version presence before hi…

Merge pull request #4001 from Juyas/stats/reduceRedundancy

Remove redundant data from data collection

Exclude mkdocs.yml from causing a new build to be generated (#3996)

Merge pull request #3995 from Wolf2323/LoggerExtension

Refactor tests to decouple BetonQuest static mocking logic

Merge pull request #3993 from Juyas/feat/meta

Add metadata concept and related classes

Merge pull request #3992 from Juyas/startupErrorTracking

Add error tracker to report exceptions on startup

Merge pull request #3990 from Wolf2323/logging

Fix logger caching to pass the original nullable topic instead of the empty converted value

Merge pull request #3991 from Juyas/moreStats

Add stats for non-integrated plugins and disabled hooks

Merge pull request #3989 from Juyas/version/adjust

Update BetonQuestVersion for artifact versions

Merge pull request #3988 from Wolf2323/fix-concurrency-issue

Refactor logger caching to use ConcurrentHashMap and handle nullable topics

Add per element statistics (#3986)

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)

• 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

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

Fix concurrency issues on CachingBetonQuestLoggerFactory when used through PlayerDataFactory

Merge pull request #3980 from Juyas/feat/mythicStatAction

Add MythicLibStatAction to allow changing player stats

Fix daily dependency check failing because of missing fast stats repository (#3979)

Merge pull request #3977 from TheosRee/dev-3/265

Minor docs issues and fix for PaymentObjective "total" and LoreHandler serialize

Merge pull request #3978 from Juyas/faststats/morestats

More statistics

Merge pull request #3975 from TheosRee/dev-3/264

Fix Jobs PaymentObjective not persisting current amount

Merge pull request #3969 from Wolf2323/modrinth

Refactor game-versions to dynamically use >=${{ env.PLUGIN_API_VERSION }} in build workflow

Merge pull request #3974 from Juyas/feat/faststats/moreStats

Add stats for the Updater according to its settings and usage

Merge pull request #3973 from Juyas/feat/faststats/errortracking

Add Error-Tracking with FastStats and update it for shutdown data flushing

Add more statistics to FastStats (#3972)

• integration counts
• integration names
• loaded element counts

Merge pull request #3971 from TheosRee/dev-3/263

Correctly de-/serialize firework colors in simple item

Merge pull request #3970 from TheosRee/dev-3/262

Scale and offset item displays for FancyHolograms

Merge pull request #3968 from Juyas/feat/faststats

Integrate FastStats metrics into BetonQuest

Merge pull request #3966 from Juyas/policies/api

Add BetonQuestPolicy for version validation against BetonQuest API versions

Change integrated CraftEngine version to newest release (#3960)

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)

• 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

Add fail flag to throw if not all items could be taken in take actions

Merge pull request #3962 from Wolf2323/Modrinth

Remove unused ${{ env.PLUGIN_API_VERSION }} from game-versions in b…

Merge pull request #3952 from Wolf2323/Modrinth

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!

Added

• Integration for the Fakeblock plugin: Demo Video
• 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!
• Remastered EffectLib Integration: See Migration Guide!
• 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!

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.

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

-Fixes

• pickrandom event did not calculated chance correctly

-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.

+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

+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