🌏 Adventure 4.17.0

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

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

🌏 Adventure 4.15.0

Adventure 4.15.0 is a feature release, primarily focused around adding support for new serialization styles used in Minecraft 1.20.3, but containing some other useful changes.

The support for 1.20.3 in this release is at about a bare-minimum level of what's needed to support reading components generated in the newer version. Further parity features have been targeted for 4.16.0.

✨ Features

• feat(api): hasAnyTranslations by @kashike in #945
• feature: Add a new standard join configuration for spaces by @RedDaedalus in #962
• feat(nbt): expose size in CompoundBinaryTag by @RealBauHD in #965
• feature: Expose tags and strict mode in MiniMessage by @kezz in #951
• feat(key): add asMinimalString by @kashike in #983
• feat(api): Identity implements Identified by @kashike in #985
• feat(api): introduce ResourcePackRequest by @yusshu in #981
• feature: Cancellable FlattenerListener by @FxMorin in #996
• feat(api): Expand the supported resource pack operations for 1.20.3 by @zml2008 in #1005
• feat(api): Support representing translation args losslessly by @zml2008 in #1004
• feat(nbt): Implement nameless binary serialization by @booky10 in #968
• 1.20.3 by @zml2008 in #986
• feat(api): A feature flag system to handle version compatibility by @zml2008 in #1002

🐛 Fixes

• fix(api): Flatten ScoreComponent to empty string if score value is null by @Konicai in #954
• Fix StorageNBTComponentTest by @jpenilla in #1007

📚 Documentation

• Fix JavaDoc error by @CheeseTastisch in #980

Other

• Use EqualsTester instead of weird equality assertion by @KingOfSquares in #989

New Contributors

• @Konicai made their first contribution in #954
• @RedDaedalus made their first contribution in #962
• @RealBauHD made their first contribution in #965
• @CheeseTastisch made their first contribution in #980
• @yusshu made their first contribution in #981
• @FxMorin made their first contribution in #996
• @booky10 made their first contribution in #968

Full Changelog: v4.14.0...v4.15.0

🌏 Adventure 4.14.0

Adventure 4.14.0 is a feature release introducing some long-awaited API additions, primarily focused on component serializers.

✨ Features

• ComponentEncoder by @rymiel in #899
• feat(api): introduce a way to get viewers of a bossbar by @kashike in #894
• feat: allow custom colors in LegacyComponentSerializer by @Camotoy in #906
• ANSIComponentSerializer by @rymiel in #898
• feat(key): try to include additional information in error messages when an invalid character has been detected in a Key by @kashike in #887
• chore: rename static constructors by @powercasgamer in #923
• feat: add pattern annotations by @powercasgamer in #920
• feat: add join method that accepts JoinConfiguration.Builder by @powercasgamer in #924
• Use constants for hex character by @kashike in #929
• Added legacy show achievements by @LOOHP in #890
• feature: json component serializer by @kezz in #856

🔧 Changes

As a small programming note, the changes necessary to introduce the text-serializer-json abstraction have shifted things around in the Adventure module dependency graph. adventure-text-serializer-gson now depends on adventure-text-serializer-json. Additionally, adventure-text-serializer-gson-legacyimpl now depends on adventure-text-serializer-json-legacyimpl, and is entirely deprecated, to be replaced with the json version. In 4.15.0, we will no longer ship the deprecated submodule -- any users who need it can continue to depend on the older version. To facilitate this change, adventure-text-serializer-gson-legacyimpl has been removed from the bom to avoid improperly forcing version alignment.

🐛 Fixes

• fix: Added missing PermissionChecker nullability checks by @4drian3d in #900
• fix(key): fix combined namespace+value pattern + extract to own annotations by @kashike in #925

New Contributors

• @powercasgamer made their first contribution in #923
• @LOOHP made their first contribution in #890

Full Changelog: v4.13.1...v4.14.0

🌏 Adventure 4.13.1

Adventure 4.13.1 is a bugfix release with fixes focused around MiniMessage and translatable component fallbacks. We recommend updating at your earliest convenience.

Fixes 🐛

• fix some issues with translatable component fallback by @LemonCaramel in #885
• ComponentFlattenerImpl: translatable components check fallback first by @Camotoy in #895
• fix(text-minimessage): Correctly handle phase and multi-colour gradients by @zml2008 in #896

New Contributors

• @LemonCaramel made their first contribution in #885
• @Camotoy made their first contribution in #895

Full Changelog: v4.13.0...v4.13.1

🌏 Adventure 4.13.0

Adventure 4.13.0 is a feature release with several QOL enhancements, support for new 1.19.4 chat component features, and some bug fixes. Happy developing!

Additions ✨

• Finish adding MM tags for all Vanilla component types by @zml2008 in #843
• text-minimessage: Add a shortcut for styling tags by @Joo200 in #858
• text-minimessage: Add a TagResolver for boolean values by @Joo200 in #857
• feat(api): allow Translators to create their own Components by @qixils in #871
• feat(api): Add emulated callback click event by @zml2008 in #860
• feat(api): add support for translatable component fallbacks (#863) by @NoahvdAa in #868

Fixes 🐛

• bug(api): workaround which fixes #849 by @kashike in #861
• Make DecorationMap$KeySet and $Values follow Collection::toArray() contract by @emilyy-dev in #862
• fix(serializer-gson): Ignore empty hover event values by @zml2008 in #859
• change minimessage rainbow tag colors by @MrKinau in #882
• bug(minimessage): respect requests to include stacktraces by @kashike in 42ea3df

New Contributors

• @neziw made their first contribution in #870
• @MrKinau made their first contribution in #882

Full Changelog: v4.12.0...v4.13.0

🌏 Adventure 4.12.0

This release, at long last, adds API to help work with the 1.19(.x) chat and sound changes, including sending messages with the new chat type system.

Due to the strict lifecycle of message signing, implementing the full chat flow will be mostly left to platforms. The exposed signed message API is intended for use with out-of-band operations like signed commands.

Thank you for your patience!

Additions ✨

• feature: 1.19 chat changes by @kezz in #777
• Implement seed field on sound, and add a builder by @zml2008 in #770
• key: Make Key implement Keyed by @zml2008 in #779
• Promote decorationIfAbsent to StyleSetter and Public API by @KingOfSquares in #785
• Add convenience methods for appending a newline/space to a component by @KingOfSquares in #786
• feat(key): #773 Expose methods to check if a Key can be parsed by @kashike in #774
• api: Style#unmerge by @kashike in #793

Fixes 🐛

• api: Remove use of terminally deprecated SecurityManager api by @zml2008 in #781
• api: Fix improper stripping of colors when compacting by @zml2008 in #782
• bug(#788): disable html escaping and use uppercase hex colour codes by @kashike in #789
• minimessage: Parsing corner cases with quotes by @rymiel in #819
• fix(text-minimessage): Don't strip style of text components in gradients by @zml2008 in #835
• fix(text-minimessage): Preserve non-text components in color changing tags by @zml2008 in #834
• fix(text-minimessage): Be more lenient with input when stripping/escaping tags by @zml2008 in #833
• fix(text-minimessage): Properly handle escaped tag opens by @zml2008 in #832
• fix(api): Catch cases where empty components are not preserved by @zml2008 in #838
• bug(#792): don't throw on invalid click/hover event action by @kashike in 1c2463f
• bug(api): fix an issue when linearly building a component by @kashike in 7bb1875

Platform Changes 🔧

• Add PlatformAPI Annotation by @KingOfSquares in #778
• feat(api): bossbar platform implementation by @kashike in #836

Full Changelog: v4.11.0...v4.12.0

🌏 Adventure 4.11.0

4.11.0 is a small feature release bundling up a variety of tweaks from the past few months. It does not incorporate any of the new API for 1.19 features -- that is slated for 4.12.0, scheduled for release shortly after Mojang releases Minecraft 1.19.

Additions ✨

• Add orThrow and orDefault methods to Index by @Machine-Maker in #741
• feat(api): Add possibility of using Component#join with a root style by @KingOfSquares in #653
• Improve compaction of empty/blank TextComponents by @Moulberry in #764
• StyleImpl DRY (#392) by @emilyy-dev in #461
• text-minimessage: Add Placeholder to format Numbers and TemporalAccessors by @Joo200 in #709
• Implement MiniMessage preprocessor and cleanup parsing by @bluelhf in #749
• feat(minimessage): selector tag by @NoahvdAa in #737
• text-logger-slf4j: introduce wrapper for formatted logging by @zml2008 in #757

Fixes 🐛

• fix negative number parsing for positions by @Machine-Maker in #733
• MiniMessage: Handle arguments for PreProcessTags correctly by @Joo200 in #735
• fix: Fixed TagResolvers equality by @4drian3d in #751
• text-minimessage: Validate tag names in resolver builder by @zml2008 in #771

New Contributors

• @Machine-Maker made their first contribution in #733
• @4drian3d made their first contribution in #751
• @Moulberry made their first contribution in #764
• @bluelhf made their first contribution in #749

Full Changelog: v4.10.0...v4.11.0

🌏 Adventure 4.10.1

This is a minor bugfix release of Adventure to resolve some issues with MiniMessage tag filtering.

As a small programming note for those of you who test our snapshots, we will be moving from the (moderately overloaded) oss.sonatype.org to the newer s01.oss.sonatype.org for our snapshot repository in the near future. An announcement will be posted on Discord when this migration is complete, and the documentation will be updated.

Fixes 🐛

• #723 - minimessage: Ignore invalid tags when parsing
• #727 - minimessage: Add stacktraces and more details to legacy errors

🌏 Adventure 4.10.0

Adventure 4.10.0 is a feature release of Adventure, providing (at long last!) a stable release of the MiniMessage serialization format, as well as a variety of quality-of-life improvements.

To get started with MiniMessage, take a look at its documentation: https://docs.adventure.kyori.net/minimessage/, and try it out with the Web UI!

Thanks to everyone who contributed to making this release happen -- it's been a long time coming!

Additions ✨

• #622 - Merge minimessage
• #490 - api: add TextDecoration#withState and add missing null pointer check
• #449 - api: Rename Title.Times.of
• #444 - Add decorations(Map) to component/style builders
• #472 - Add TriState toBoolean helper methods
• #480 - extra-kotlin: Added more extensions and enabled explicit API
• #495 - Add Tristate method to TextDecoration.State
• #482 - Add standard join configurations
• #479 - extra-kotlin: Add some JoinConfiguration related methods
• #501 - Abstract out style methods to StyleWriter/Reader
• #645 - feat(key): expose a Comparator for Key
• #617 - api: Introduce Component.textOfChildren as a replacement for TextComponent.ofChildren
• #652 - chore: Rename some static constructer methods
• #650 - feat(api): Internal configuration
• #698 - New builder
• #700 - key: make Key extend Namespaced
• #488 - Component::applyFallbackStyle helper method
• #717 - text-minimessage: Limit characters allowed in tag names

MiniMessage changes since 4.2.0-SNAPSHOT

Because MiniMessage had a fairly extended development process, there have been several notable changes (some breaking) since earlier development phases that may affect any testers of the older API.

This is just a summary -- see the documentation for a full overview of the latest API.

• #635 - text-minimessage: Properly handle colour override depth reductions
• #663 - chore: Remove parse method
• #657 - Introduce a method by which to create raw replacements
• #671 - text-minimessage: Use a Consumer rather than Appendable for debug output
• #672 - minimessage: Unify transformations and placeholders
• #658 - text-minimessage: add deserialization method returning parsed tree
• #681 - fix: Require all input to be non-null
• #682 - minimessage: Add a reset tag via a parser directive
• #687 - Add a new tag for line breaks (<br>)
• #701 - Allow parsing with custom Tag Resolvers
• #703 - Rework the MiniMessage serializer to consolidate behavior into resolvers
• #708 - text-minimessage: Expose the root node type to API
• #707 - text-minimessage: Allow tags to be closed in one tag
• #662 - Warn when input contains legacy formatting codes (#515)
• #674 - Implement TransitionTag

Fixes 🐛

• #485 - Add more non-null value validations
• #451 - api: Add inVersion to all @ApiStatus.ScheduledForRemoval annotations
• #493 - Fix accidental float and double NaN parsing
• #497 - Fix premature SNBT parsing as number
• #498 - Fix unquoted string being parsed as double
• #500 - Fix return type on #decorate method in ScopedComponent
• #481 - fix #447 by allowing deserializeOr to return null
• #633 - api: Resolve duplication of children when performing text replacement
• #641 - api: Use initial style when replacement-rendering a hover event
• #647 - util: Add a range check for HSVLike

Minor changes

• Bump JetBrains annotations to 23.0.0
• serializer-configurate4: Bump Configurate dependency to 4.1.2
• #474 - Clarify Audience#filterAudience(Predicate) docs
• #642 - Add tests for Title and Title.Times
• #660 - chore: 2022

Full Changelog: v4.9.1...v4.10.0