BetonQuest

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