adventure

🌏 Adventure 5.0.1

Released on Apr 16, 2026 - GitHub

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

Released on Apr 16, 2026 - GitHub

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:

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:

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

🌏 Adventure 4.26.1

Released on Apr 16, 2026 - GitHub

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:

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

Released on Apr 16, 2026 - GitHub

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:

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

Released on Apr 16, 2026 - GitHub

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

Released on Jul 30, 2025 - GitHub

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

Released on Jun 18, 2025 - GitHub

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

🌏 Adventure 4.22.0

Released on Jun 17, 2025 - GitHub

What's Changed

✨ Features

feature(api): Rewrite ComponentFlattener to remove recursion and add a configurable maximum nesting depth by @kezz in #1237
1.21.6 by @kezz in #1238
feat(nbt): TagStringIO Enhancements by @kermandev in #1239
Improved support for hetergeneous lists by @mworzala in #1242

🐛 Fixes

fix(api): Always fire bossBarNameChanged by @kezz in #1230
Typo fix in PrideTag.java by @Stxellxa in #1233
fix(api): Don't throw an exception if a PointersSupplier has no parent by @kezz in #1232

📚 Documentation

chore(audience): update javadoc for playSound by @Timongcraft in #1235

Other

Render translatable arguments and children by @TonytheMacaroni in #1226

New Contributors

@Stxellxa made their first contribution in #1233
@Timongcraft made their first contribution in #1235
@kermandev made their first contribution in #1239
@mworzala made their first contribution in #1242

Full Changelog: v4.21.0...v4.22.0

🌏 Adventure 4.21.0

Released on Apr 30, 2025 - GitHub

Adventure 4.21.0 adds preliminary support for new component features in 1.21.5, and some minor bugfixes. We recommend all users update.

What's Changed

✨ Features

Use DecorationMap for style builder by @TonytheMacaroni in #1209
Add NumberBinaryTag#numberValue by @GliczDev in #1188
feat(nbt): Add stream API for compound/list tags by @zml2008 in #1208
1.21.5 component changes by @Gerrygames in #1168
feature(minimessage): Set the target to hold the locale of the translation by default by @kezz in #1216
feat(nbt): update number parsing for 1.21.5 by @kennytv in #1167
feature(api): Skip style builder creation on merge by @kezz in #1219
feat(nbt): Initial implementation of heterogeneous list handling by @zml2008 in #1218

🐛 Fixes

fix(minimessage): rename numeric to string by @tjalp in #1211

New Contributors

@TonytheMacaroni made their first contribution in #1209
@tjalp made their first contribution in #1211
@Gerrygames made their first contribution in #1168

Full Changelog: v4.20.0...v4.21.0

🌏 Adventure 4.20.0

Released on Apr 5, 2025 - GitHub

Adventure 4.20.0 is a feature release focused on translation improvements. The MiniMessage translator allows easily expressing translation values in the MiniMessage format, and the whole translation system has had a revamp to be more flexible.

What's Changed

✨ Features

feature(api): Silly micro optimisations for the mm color tag by @kezz in #1177
feature(minimessage): Check for colors before parsing phases by @kezz in #1180
feature(api): Improve handling of component children and component translating by @kezz in #1181
feature: MiniMessageTranslator by @kezz in #972
feature(api, minimessage): Replace TranslationRegistry with a generic TranslationStore by @kezz in #1182
feature(minimessage): Add context argument and unit tests by @kezz in #1185
Add TagStringIO#asString for any tag by @GliczDev in #1192
feat(text-serializer-commons): split into new module by @zml2008 in #1193

⚙️ Fixes

fix(minimessage): Carry over target into context deserialize calls by @kezz in #1179

New Contributors

@GliczDev made their first contribution in #1192

Full Changelog: v4.19.0...v4.20.0