Build Specific Changes

Breaking API Changes

• Renamed ConfigRecordBuilder to ConfigMapBuilder.
• Renamed various references to "Root" within GreenhouseInheritedConfigHolder to "Inherited".
• GreenhouseConfigLang has been slightly rewritten to add decode and encode methods.
  • The above has been done to de-hardcode the implementation from Polyamory libraries for commented configs and in preparation for legacy API support.
• The ✨.greenhouse.config.api.v3.lang.AbstractGreenhouseConfigPolyamoryLang class has been renamed to GreenhouseConfigPolyamoryLang
• Event classes have been moved to the ✨.greenhouse.config.api.v3.event package.
  • This affects GreenhouseConfigEvents and GreenhouseConfigEventPhases.
• Renamed ✨.greenhouse.config.api.v3.dfu.fix.GreenhouseConfigRelocateFieldsFix#function to ✨.greenhouse.config.api.v3.dfu.fix.GreenhouseConfigRelocateFieldsFix#data
• Removed ✨.greenhouse.config.api.v3.dfu.builder.schema.TypeTemplateBuilder#merge method from public facing API.
• Removed the configLang field from GreenhouseInheritedConfigHolderBuilder. The lang is now always inherited from the base config holder.
• Added ✨.greenhouse.config.api.v3.dfu.fix.DataFixDynamicHelper, which contains utility methods to help with data fix values.

Non-Breaking Changes

• Added more javadocs.
• Fixed configs not data fixing when a language is different but the config resolves anyways.
• Fixed Greenhouse Config meta files not deleting when the config language is changed.
• Updated to Polyamory DFU 0.1.2, which fixes the below bug.
• Fixed JSONC Codec errors log comments alongside values.

Full Changelog

This is the v3.0.0 Release of Greenhouse Config, which is additionally the first release to be hosted on the Greenhouse Forgejo instead of GitHub. Greenhouse Config has been rewritten from the ground up for a better experience.

Roadmap

• Alpha Versions may break API at any time. These should be considered unstable and not production ready. These may be incomplete with missing javadocs and implementation.
• Beta Versions will have a stable API, but may make small breaking changes if something does not work. These versions are also lacking some features such as extra config language support and backwards compatibility with the old API.
• Release 3.0.0 will be considered feature complete, but new features and minor breaking changes may come with future Minecraft versions such as 26.1.x and above.

Changes

• Updated mod icon and description.
• All package structure has been reworked to use ✨.greenhouse.config.api.v3 for API, and ✨.greenhouse.config.impl for impl.
• Greenhouse Config now operates off a builder system.
  • Methods to build configs may be found in GreenhouseConfigHolder related interfaces.
    • These interfaces are found within the ✨.greenhouse.config.api.v3 package.
  • Raw RecordCodecBuilder/StreamCodec/DataFixerUpperBuilder based operations are still supported via any Greenhouse Config Holder Builder. These are generally less encouraged in comparison to the builder.
• Added GreenhouseInheritedConfigHolder. This can be used to inherit values from a Greenhouse Config Holder or Greenhouse Config Holder Builder meant for a common client to a specifically sided environment such as the client and the server, as well as allowing for adding new values on top of these values.
  • The SPLIT side definition of the old config has been removed from the V3 API to better compatibility with split source-set based environments.
• Added GreenhouseConfigDataFixerBuilder, which can be used to create data fixers for your config to update between different schema versions.
• GreenhouseConfigDataFixerBuilder now supports defining previous config formats, these will be detected based on the config's schema version and will rewrite the file to the new format when applicable.
• LateHolder and LateHolderSet have been rewritten to better integrate into GreenhouseConfigHolderBuilder. The Late interface has been removed.
• Included built-in data fixes for ease of use when fixing config values.
  • These are GreenhouseConfigRelocateFieldsFix, GreenhouseConfigRemoveFieldsFix, and GreenhouseConfigSetFieldsFix and are found within the ✨.greenhouse.config.v3.dfu.fix package.
• Schema versions are now stored within a hidden .greenhouse_config_meta folder instead of the config's file attributes.
  • Configs with no schema version will be treated as V0, but will only ever be fixed in this case if the config has any errors.
  • A fallback for the file attribute is included to correctly load configs made with older Greenhouse Config versions.
• Events within Greenhouse Config now use Yumi for a better loader agnostic experience.
  • All config related events are within ✨.greenhouse.config.api.v3.event.GreenhouseConfigEvents.
  • Greenhouse Config specific phases are within ✨.greenhouse.config.api.v3.event.GreenhouseConfigEventPhases.
• Swapped config reading/writing to use included libraries within the Polyamory Project.
  • You will no longer need to depend on a separate project for your specific language.
  • Polyamory only supports JSONC within this current release.
• Removed Night Config support. Removing TOML, HOCON and YAML language support.
  • TOML will be re-added before release whenever I'm more ready to write it.
  • YAML might be re-added if there's enough demand. If so, it'll be a low priority change.
  • HOCON will not be re-added due to being more of a liability and generally having low demand.
• The implementation has been entirely rewritten from the ground up. It has been tested in a lot more conditions and should generally be a lot more stable and less messy.