🌏 Adventure 5.2.0

Adventure 5.2.0 is primary a bugfix update to restore a break in binary compatibility for users compiling against 4.x but running against 5.x.

This issue was caused by the removal of BuildableComponent, which would cause a MethodNotFoundException for those using component builders. BuildableComponent will remain deprecated and will be fully removed in 6.0 with no replacement. The only use of BuildableComponent in 4.x was to turn a component into a builder (which involved casting to BuildableComponent), but this is now solved by the promotion of the toBuilder method to the root Component class.

The fix for this restores the interface to the component hierarchy and adds another compile-time synthetic bridge to fix code compiling against 4.x. The bridge methods will be removed in 6.x so we still encourage everyone to update to 5.x.

What's Changed

✨ Features

• Easier way to create object components by @kezz in #1421

🐛 Fixes

• Add back BuildableComponent by @jpenilla in #1432
• Change gpg key by @MiniDigger in #1423

Full Changelog: v5.1.1...v5.2.0

🌏 Adventure 5.1.1

Adventure 5.1.1 is a bug-fix update to correct the publishing setup for Maven consumers.

Full Changelog: v5.1.0...v5.1.1

🌏 Adventure 5.1.0

Adventure 5.1.0 is primarily a bug-fix update for some unintentional breaks caused by the 5.0 release.

This update also includes stricter validation for key namespaces and click event construction, and also adds new methods to check the validity of click event payloads. Although the validation added is generally stricter than older Minecraft versions, the validation is still correct for all versions. If you have issues with the validation added, please open an issue!

What's Changed

✨ Features

• Add pages-only constructor to BookImpl by @Privatech38 in #1372
• Add intersex inclusive pride flag to PrideTag by @me4502 in #1405
• Add validation for player head name by @kezz in #1417
• Disallow .. as a namespace by @kezz in #1416
• Simple validation click events on creation by @kezz in #1418
• Add validation for invalid change page click events by @kezz in #1419

🐛 Fixes

• Restore legacy NBT hover events in MiniMessage by @Privatech38 in #1403
• Fix SPI when using modules by @kermandev in #1396
• Restore missing negated shorthand decoration tags by @kezz in #1413
• Emit value for event payloads when using camel case by @kezz in #1414
• Fix ComponentBuilder#build ABI compatibility by @kezz in #1407

🏃 Performance

• Speedup *Color#asHexString by @kermandev in #1386

📚 Documentation

• chore: replace wiki.vg links by @RealBauHD in #1402

New Contributors

• @me4502 made their first contribution in #1405

Full Changelog: v5.0.1...v5.1.0

🌏 Adventure 5.0.1

5.0.1 is a bugfix update containing a fix for leftover checker annotations and some minor edits to the Javadocs. We are now publishing an aggregate Javadoc for all core Adventure libraries (in this repo) available on the standard PaperMC Javadoc portal at https://papermc.io/javadocs/.

What's Changed

🐛 Fixes

• chore(configurate-4): replace checkerframework annotations by @Strokkur424 in #1398

📚 Documentation

• chore(build): Publish aggregate javadoc jar by @kezz in #1399
• chore(docs): Fix incorrect docs for ShadowColor#alpha by @kezz in #1400
• chore(docs): Remove incorrect annotations from ForwardingAudience.Single methods by @kezz in #1401

Full Changelog: v5.0.0...v5.0.1

🌏 Adventure 5.0.0

Adventure 5.0.0 is a major update to the Adventure library, including an updated Java version, removal of deprecations, and other breaking changes. The 5.0.0 update represents a major milestone in the development of the Adventure library, with 7,000+ additions and 12,000+ deletions across over 500 files.

Important

Although we have tried our hardest to avoid unnecessary breaking changes, we do expect this update to contain bugs or unintentional breaking changes and the Adventure team is prepared to release hotfixes as needed. Please report any issues that you find and reach out for help in the #adventure-help channel of the PaperMC Discord if you need to.

Please read the migration information on the Adventure documentation for full information about the changes made in this update and notes about migrating from the 4.x series to 5.x.

For development information about the 5.0 update, check out the following links:

• Adventure 5.0 info issue
• Adventure 5.0 PR

What's Changed

There are also some additional features and fixes unrelated to the major breaking changes introduced in 5.0.0. These are documented below.

✨ Features

• Add BookLike interface by @kezz in #1346
• Minecraft 26.1 update changes by @kezz in #1390
• MiniMessage presets system by @kezz in #1388
• Add femboy flag to pride tag by @RabbitTV22 in #1357

🐛 Fixes

• Support all UUID versions in head tag by @Emilxyz in #1375

New Contributors

• @RabbitTV22 made their first contribution in #1357
• @Privatech38 made their first contribution in #1373

Thanks to everyone who helped out along the way with the 5.0.0 update, and special thanks to the following for their hard work on the update:

• @kezz
• @zml2008
• @Strokkur424

Full Changelog: v4.26.1...v5.0.0

🌏 Adventure 4.26.1

Adventure 4.26.1 is hopefully the final release before the full release of 5.0. This release solely contains final changes and deprecations in preparation of the 5.0.

For full information about the 5.0 update, check out the following links:

• Adventure 5.0 info issue
• Adventure 5.0 PR
• Migration docs PR

Note: 4.26.0 was released on GitHub but never deployed and should be considered non existant.

What's Changed

✨ Features

• Pre-5.0 update changes/deprecations by @kezz in #1329

📚 Documentation

• docs: Update documentation, discord and snapshot links by @kezz in #1323

Full Changelog: v4.25.0...v4.26.1

🌏 Adventure 4.26.0

Adventure 4.26.0 is hopefully the final release before the full release of 5.0. This release solely contains final changes and deprecations in preparation of the 5.0.

For full information about the 5.0 update, check out the following links:

• Adventure 5.0 info issue
• Adventure 5.0 PR
• Migration docs PR

What's Changed

✨ Features

• Pre-5.0 update changes/deprecations by @kezz in #1329

📚 Documentation

• docs: Update documentation, discord and snapshot links by @kezz in #1323

Full Changelog: v4.25.0...v4.26.0

🌏 Adventure 4.25.0

What's Changed

✨ Features

• Update for 1.21.9 by @jpenilla in #1291
• Add option to prepend https to click event urls by @Emilxyz in #1290
• Allow passing parentStyle to Component#compact by @indyteo in #1288
• Allow creation of a ClickEvent from an Action and Payload by @Phoenix616 in #1322
• Add CompoundBinaryTag contains methods by @tal5 in #1265
• Add sequential (simple) head tag by @Strokkur424 in #1320
• Allow creating builders with an initial capacity by @tal5 in #1264
• ObjectComponent serialization by @Emilxyz in #1293

🐛 Fixes

• Provide the property directly in the properties DefaultOverideProvider by @kezz in #1279
• Correct defaultValue nullability by @tal5 in #1263
• Fix invalid url extraction in legacy component serializer by @derklaro in #1280

📚 Documentation

• Alongside this release, the old adventure-docs repo has been archived and the documentation has been migrated to the PaperMC docs repo.

Other

• Check TagResolver#has in more places by @kezz in #1297

New Contributors

• @tal5 made their first contribution in #1263
• @derklaro made their first contribution in #1280
• @indyteo made their first contribution in #1288
• @Phoenix616 made their first contribution in #1322
• @Strokkur424 made their first contribution in #1291

Full Changelog: v4.24.0...v4.25.0

🌏 Adventure 4.24.0

What's Changed

✨ Features

• feature(api): Add a method to close an open dialog by @kezz in #1246
• Implement #canTranslate in GlobalTranslatorImpl and call #canTranslate of its sources by @ivi-kiwi in #1252
• Add a less verbose way of creating titles by @LaserSlime in #1272
• feature(api): Property default override SPI and flattener nesting limit property by @kezz in #1250
• Uppercase hex colors created by asHexColor to avoid item desyncs in Minecraft by @MrPowerGamerBR in #1277

🐛 Fixes

• Add equals to VirtualComponent by @Seggan in #1247
• fix: component flattener not popping styles in correct order by @diogotcorreia in #1255
• fix(api): fix removing mutated source from GlobalTranslator by @Emilxyz in #1276
• Avoid interpreting the "byte" suffix as a binary radix by @IllusionTheDev in #1241

📚 Documentation

• docs: Remove wiki.vg link from NBT javadoc by @kezz in #1251

Other

• chore: Deprecate non-named UTF8ResourceBundleControl getter by @kezz in 00ebf2e

New Contributors

• @Seggan made their first contribution in #1247
• @diogotcorreia made their first contribution in #1255
• @Emilxyz made their first contribution in #1276
• @ivi-kiwi made their first contribution in #1252
• @LaserSlime made their first contribution in #1272
• @IllusionTheDev made their first contribution in #1241
• @MrPowerGamerBR made their first contribution in #1277

Full Changelog: v4.23.0...v4.24.0

🌏 Adventure 4.23.0

This is a hotfix release to resolve some issues in the recently released v4.22.0.

What's Changed

🐛 Fixes

• fix: Ensure TagStringIO accepts hetergeneous lists in all reader methods by @kezz in #1244
• fix: Make custom click events hold NBT payloads by @kezz in #1243
• fix(key): Ensure keys with invalid namespaces throw the correct exception by @kezz in #1245

Full Changelog: v4.22.0...v4.23.0