adventure

v4.26.1

Released on Dec 17, 2025 - 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

v4.26.0

Released on Dec 17, 2025 - 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

v4.25.0

Released on Oct 6, 2025 - 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

🌏 Adventure 4.19.0

Released on Feb 16, 2025 - GitHub

Adventure 4.19.0 is a small feature release, primarily to introduce an option controlling MiniMessage's emission of virtual components.

What's Changed

✨ Features

feature(api): Replace text ignoring hover events by @kezz in #1153
Configurable virtual component emission by @lynxplay in #1164

🐛 Fixes

fix(api): add missing ScopedComponent overrides by @zml2008 in #1161

Full Changelog: v4.18.0...v4.19.0

🌏 Adventure 4.18.0

Released on Dec 22, 2024 - GitHub

Adventure 4.18 has a few new features to improve expressiveness, plus support for the new shadow colour style attribute added in Minecraft 1.21.4.

What's Changed

✨ Features

feat(minimessage): Pride tag by @kezz in #1079
feat(nbt): add isEmpty to CompoundBinaryTag/ListBinaryTag by @RealBauHD in #1088
feat(mini-message): add Formatter#joining by @tahmid-23 in #938
feat: shadow colors by @kashike in #1124
feat(api): virtual components by @kashike in #842

🐛 Fixes

ensure numbers where we expected booleans parse correctly. by @456dev in #1108
fix(text-serializer-gson): correctly handle removed data components by @zml2008 in #1145

New Contributors

@456dev made their first contribution in #1108
@tahmid-23 made their first contribution in #938

Full Changelog: v4.17.0...v4.18.0