adventure

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

🌏 Adventure 4.17.0

Released on May 8, 2024 - GitHub

What's Changed

✨ Features

feat(text-minimessage): Show ANSI rendering of parsed components in tests by @zml2008 in #1042
feat(minimessage): Add target to deserialization for contextual tags by @kezz in #1051
feat(api): Pointers supplier by @kezz in #429
1.20.5 by @zml2008 in #1055

🐛 Fixes

fix(text-minimessage): Handle larger raninbow phases correctly by @zml2008 in #1041
fix: Allow for case-insensitivity in legacy serializer, closes #1043 by @kezz in #1044
fix(api): Only trigger bossbar listeners if flags actually changed by @zml2008 in #1067
fix(nbt): CompoundBinaryTag#getBoolean ignores false values when default value is true by @kashike in e0edf0f
fix(nbt): ListBinaryTag is weakly immutable by @kashike in 2e612aa

Full Changelog: v4.16.0...v4.17.0

🌏 Adventure 4.16.0

Released on Feb 20, 2024 - GitHub

Adventure 4.16.0 is a small feature release following up on the additions in 4.15.0.

Notable Changes

As Configurate 3 is more or less obsolete and seeing reduced usage, we've decided to stop distributing it with new versions of Adventure. The Configurate 4 serializers should be used instead, or for those who cannot migrate yet an older version of the adventure-serializer-configurate3 module can be used instead.

✨ Features

feat(serializer-configurate3): remove it by @zml2008 in #1016
add component decoder by @yannicklamprecht in #1035
feat(api): Add removeResourcePack overload with Iterable by @zml2008 in #1036
kissing girls by @aurorasmiles and @weaondara and @Chew

🐛 Fixes

minimessage: Fix exception with single quote as tag part by @rymiel in #1012

📚 Documentation

docs: Migrate to new wiki links, closes #1013 by @kezz in #1014

New Contributors

@yannicklamprecht made their first contribution in #1035

Full Changelog: v4.15.0...v4.16.0