🌏 Adventure 4.10.0

[zml2008]

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 ✨

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

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

Fixes 🐛

• Add more non-null value validations #485 - Add more non-null value validations
• api: Add inVersion to all @ApiStatus.ScheduledForRemoval annotations #451 - api: Add inVersion to all @ApiStatus.ScheduledForRemoval annotations
• Fix accidental float and double NaN parsing #493 - Fix accidental float and double NaN parsing
• Fix premature SNBT parsing as number #497 - Fix premature SNBT parsing as number
• Fix unquoted string being parsed as double #498 - Fix unquoted string being parsed as double
• Fix return type on #decorate method in ScopedComponent #500 - Fix return type on #decorate method in ScopedComponent
• fix #447 by allowing deserializeOr to return null #481 - fix GsonComponentSerializer doesn't properly handle "null" string #447 by allowing deserializeOr to return null
• api: Resolve duplication of children when performing text replacement #633 - api: Resolve duplication of children when performing text replacement
• api: Use initial style when replacement-rendering a hover event #641 - api: Use initial style when replacement-rendering a hover event
• util: Add a range check for HSVLike #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
• Clarify Audience#filterAudience(Predicate) docs #474 - Clarify Audience#filterAudience(Predicate) docs
• Add tests for Title and Title.Times #642 - Add tests for Title and Title.Times
• chore: 2022 #660 - chore: 2022

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

---

This discussion was created from the release 🌏 Adventure 4.10.0.