MiniPlaceholders

3.1.0 (10/10/2025)

Features

- [feat: Sponge commands implementation](https://github.com/MiniPlaceholders/MiniPlaceholders/comm… - [feat: Implement parserel subcommand](https://github.com/MiniPlaceholders/MiniPlaceholders/comm… - [feat: Add --null argument to parse node](https://github.com/MiniPlaceholders/MiniPlaceholders/comm… - [misc: Added bstats metrics](https://github.com/MiniPlaceholders/MiniPlaceholders/comm…

Fixes

- [fix: Fixed multiple loading expansions](https://github.com/MiniPlaceholders/MiniPlaceholders/comm… - [fix: Added nullability checks to RelationalAudience](https://github.com/MiniPlaceholders/MiniPlaceholders/comm… - [fix: Fixed command formatting](https://github.com/MiniPlaceholders/MiniPlaceholders/comm…

API Additions

- [feat: Added LoadRequirement#requiredClass and LoadRequirement#anyOf](https://github.com/MiniPlaceholders/MiniPlaceholders/comm… - [docs: Replaced some uses of JetBrains annotations with jspecify](https://github.com/MiniPlaceholders/MiniPlaceholders/comm… - [feat: Allow the use of injected constructors when creating an ExpansionProvider](https://github.com/MiniPlaceholders/MiniPlaceholders/comm…

What's Changed

* Fixed Fabric initialization * Updated minimun Sponge-API usage Full Changelog: https://github.com/MiniPlaceholders/MiniPlaceholders/comp…

Hi! In this new version, which has been in development since February of this year, several changes have been implemented that modernize the MiniPlaceholders code base, as well as improving performance for both regular and advanced use. In addition to adding ExpansionProvider, a new convention for creating expansions in MiniPlaceholders, without the need to rely on a specific platform.

Expansion Provider

As mentioned above, ExpansionProviders have been added, which are a type of independent project that can provide an Expansion according to the configured requirements. In addition, it is multiplatform and does not require an individual initializer for each platform you want to support. If you want to see an example of its use, you can check out its [wiki page](https://github.com/MiniPlaceholders/MiniPlaceholders/wiki… or directly review a practical example in the [Template Expansion](https://github.com/MiniPlaceholders/Template-Expansion).

Rewritted API Usage

From now on, an audience will not be required when obtaining placeholders. This allows for greater efficiency, as it avoids creating multiple unnecessary objects by delegating the function of providing the required audience to the parsing phase. For this reason, to use MiniPlaceholders Audience placeholders, you must include the Audience in the target field of the MiniMessage#deserialize method so that it can be recognized by the corresponding placeholders. In addition, you now have the ability to create type-safe placeholders by including the target class as the first argument. You can find more information about this in the [wiki](https://github.com/MiniPlaceholders/MiniPlaceholders/wiki… Due to these changes, most projects created for MiniPlaceholders v2 are incompatible with MiniPlaceholders v3. Please be patient while your favorite projects are updated to the new version. At the time of writing this changelog, there are more than a dozen expansions already available for MiniPlaceholders v3, such as the [PlatformInfo](https://github.com/MiniPlaceholders/PlatformInfo-Expansio… [ProxyConnection](https://github.com/MiniPlaceholders/ProxyConnection-Expan… [Player](https://github.com/MiniPlaceholders/Player-Expansion/rele… [Spark](https://github.com/MiniPlaceholders/Spark-Expansion/relea… [LuckPerms](https://github.com/MiniPlaceholders/LuckPerms-Expansion/r… [PlaceholderAdapter](https://github.com/MiniPlaceholders/LuckPerms-Expansion/r… [Vault](https://github.com/MiniPlaceholders/Vault-Expansion/relea… and [more expansions](https://github.com/MiniPlaceholders/MiniPlaceholders/wiki… These new expansions, as mentioned above, are no longer installed as separate plugins/mods. Now, you simply need to place them inside the MiniPlaceholders folder in the expansions folder. If you liked this update and would like to contribute in some way, we have pull requests available so you can contribute to this project. You can also contribute financially via [PayPal](http://paypal.me/4drian3d) or [GitHub Sponsors](https://github.com/sponsors/4drian3d). Full Changelog: https://github.com/MiniPlaceholders/MiniPlaceholders/comp…

What's Changed

* [feat(api): expansion metadata](https://github.com/MiniPlaceholders/MiniPlaceholders/comm… * [Add LegacyUtils methods to check if a string contains legacy characters](https://github.com/MiniPlaceholders/MiniPlaceholders/comm… * [misc: Updated to Java 21](https://github.com/MiniPlaceholders/MiniPlaceholders/comm… * [Updated to Cloud v2](https://github.com/MiniPlaceholders/MiniPlaceholders/comm… * [Finished Cloud 2 implementation](https://github.com/MiniPlaceholders/MiniPlaceholders/comm… * [update to 1.21.1](https://github.com/MiniPlaceholders/MiniPlaceholders/comm… * [1.21.4](https://github.com/MiniPlaceholders/MiniPlaceholders/comm… * [build: Updated gradle to 8.12.1](https://github.com/MiniPlaceholders/MiniPlaceholders/comm… * [fix(docs): Fixed Dokka docs generation and updated to V2](https://github.com/MiniPlaceholders/MiniPlaceholders/comm… * [Added expansions subcommand](https://github.com/MiniPlaceholders/MiniPlaceholders/comm…

Sponsors

Now you can support the development of MiniPlaceholders with your sponsor! https://github.com/sponsors/4drian3d Full Changelog: https://github.com/MiniPlaceholders/MiniPlaceholders/comp…

* Deprecated TagsUtils#staticTag * Updated to Fabric 1.20.3+ Full Changelog: https://github.com/MiniPlaceholders/MiniPlaceholders/comp…

What's changed

* fix: Fixed native expansion placeholders nesting * chore: Relicensed project with Apache 2 license Full Changelog: https://github.com/MiniPlaceholders/MiniPlaceholders/comp…

What's Changed

- fix(fabric): Fixed legacy serializer inclusion - Updated dependencies Full Changelog: https://github.com/MiniPlaceholders/MiniPlaceholders/comp…

Fixes

* [fix: Check Tag equality using String#equalsIgnoreCase](https://github.com/MiniPlaceholders/MiniPlaceholders/comm… * [fix: Fixed legacy chars replacement in LegacyUtils](https://github.com/MiniPlaceholders/MiniPlaceholders/comm… * [fix(build): Fixed some deprecations](https://github.com/MiniPlaceholders/MiniPlaceholders/comm…

Features

* [feat: Add more Legacy API parsing](https://github.com/MiniPlaceholders/MiniPlaceholders/comm… Full Changelog: https://github.com/MiniPlaceholders/MiniPlaceholders/comp…

What's Changed

Features

* Added Support for passing ForwardingAudience.Single instead of the actual instance in https://github.com/MiniPlaceholders/MiniPlaceholders/pull/70 * Cloud Implementation in https://github.com/MiniPlaceholders/MiniPlaceholders/pull/71 * Sponge Implementation in https://github.com/MiniPlaceholders/MiniPlaceholders/pull/73 * Split platforms into separate files in https://github.com/MiniPlaceholders/MiniPlaceholders/pull/77 * [perf: Reuse empty arrays](https://github.com/MiniPlaceholders/MiniPlaceholders/comm… * [api: Improved conditional API methods](https://github.com/MiniPlaceholders/MiniPlaceholders/comm…

Dependency Updates

* chore(deps): update dependency io.papermc.paperweight.userdev to v1.5.5 in https://github.com/MiniPlaceholders/MiniPlaceholders/pull/67 * fix(deps): update dependency org.junit:junit-bom to v5.9.3 in https://github.com/MiniPlaceholders/MiniPlaceholders/pull/66 * chore(deps): update plugin fabric-loom to v1.2.6 in https://github.com/MiniPlaceholders/MiniPlaceholders/pull/69 * fix(deps): update dependency net.william278:desertwell to v2.0.4 in https://github.com/MiniPlaceholders/MiniPlaceholders/pull/72 * fix(deps): update dependency net.fabricmc.fabric-api:fabric-api to v0.80.1+1.20 in https://github.com/MiniPlaceholders/MiniPlaceholders/pull/68 * chore(deps): update plugin fabric-loom to v1.2.7 in https://github.com/MiniPlaceholders/MiniPlaceholders/pull/76 Full Changelog: https://github.com/MiniPlaceholders/MiniPlaceholders/comp…

* chore(deps): update dependency gradle to v8.1 in https://github.com/MiniPlaceholders/MiniPlaceholders/pull/50 * feat(api): Added some utils methods to Expansions and MiniPlaceholders in https://github.com/MiniPlaceholders/MiniPlaceholders/pull/52 * chore(deps): update dependency me.champeau.jmh to v0.7.1 in https://github.com/MiniPlaceholders/MiniPlaceholders/pull/55 * chore(deps): update dependency gradle to v8.1.1 in https://github.com/MiniPlaceholders/MiniPlaceholders/pull/56 Fabric Implementation* in https://github.com/MiniPlaceholders/MiniPlaceholders/pull/53 * chore(deps): update plugin fabric-loom to v1.2.2 in https://github.com/MiniPlaceholders/MiniPlaceholders/pull/58 * fix(deps): update dependency net.fabricmc.fabric-api:fabric-api to v0.78.1+1.20 in https://github.com/MiniPlaceholders/MiniPlaceholders/pull/57 * chore(deps): update plugin fabric-loom to v1.2.4 in https://github.com/MiniPlaceholders/MiniPlaceholders/pull/59 * chore(deps): update plugin fabric-loom to v1.2.5 in https://github.com/MiniPlaceholders/MiniPlaceholders/pull/60 * fix(deps): update dependency net.fabricmc.fabric-api:fabric-api to v0.79.0+1.20 in https://github.com/MiniPlaceholders/MiniPlaceholders/pull/63 * chore(deps): update plugin org.gradle.toolchains.foojay-resolver-convention to v0.5.0 in https://github.com/MiniPlaceholders/MiniPlaceholders/pull/64 * chore(deps): update runtask to v2.1.0 in https://github.com/MiniPlaceholders/MiniPlaceholders/pull/62 * fix(deps): update kotlin monorepo to v1.8.21 in https://github.com/MiniPlaceholders/MiniPlaceholders/pull/65 Full Changelog: https://github.com/MiniPlaceholders/MiniPlaceholders/comp…

- Added Folia Support Full Changelog: https://github.com/MiniPlaceholders/MiniPlaceholders/comp…

* chore(deps): update dependency io.papermc.paperweight.userdev to v1.5.2 in https://github.com/MiniPlaceholders/MiniPlaceholders/pull/32 * fix(deps): update dependency com.mojang:brigadier to v1.0.500 in https://github.com/MiniPlaceholders/MiniPlaceholders/pull/29 * chore(deps): update dependency gradle to v8.0.2 in https://github.com/MiniPlaceholders/MiniPlaceholders/pull/34 * chore(deps): update dependency io.papermc.paperweight.userdev to v1.5.3 in https://github.com/MiniPlaceholders/MiniPlaceholders/pull/35 * chore(deps): update dependency org.jetbrains.dokka to v1.8.10 in https://github.com/MiniPlaceholders/MiniPlaceholders/pull/36 * fix(deps): update dependency org.jetbrains.dokka:dokka-gradle-plugin to v1.8.10 in https://github.com/MiniPlaceholders/MiniPlaceholders/pull/37 * fix(deps): update adventure to v4.13.0 in https://github.com/MiniPlaceholders/MiniPlaceholders/pull/39 * fix(deps): update dependency net.kyori:adventure-text-serializer-legacy to v4.13.0 in https://github.com/MiniPlaceholders/MiniPlaceholders/pull/40 * fix(deps): update dependency net.kyori:adventure-text-serializer-plain to v4.13.0 in https://github.com/MiniPlaceholders/MiniPlaceholders/pull/41 * feat: Improved command platform registration fix: Updated to 1.19.4*, this version will only work with Paper 1.19.4+ Full Changelog: https://github.com/MiniPlaceholders/MiniPlaceholders/comp…

This update breaks hooks that have other plugins because it changes the groupId, those plugins have to be updated to work with MiniPlaceholders again Starting with this update a new API module, miniplaceholders-kotlin-ext, is included. This module provides useful extensions when developing kotlin plugins with the MiniPlaceholders API. It can only be used on a platform that provides it natively, such as krypton or through a plugin that provides it, such as [MCKotlin](https://modrinth.com/plugin/mckotlin)

What's Changed

* Implement Kotlin Extensions in https://github.com/MiniPlaceholders/MiniPlaceholders/pull/14 * Configure Renovate in https://github.com/MiniPlaceholders/MiniPlaceholders/pull/15 * chore(deps): update actions/setup-java action to v3 in https://github.com/MiniPlaceholders/MiniPlaceholders/pull/24 * chore(deps): update actions/checkout action to v3 in https://github.com/MiniPlaceholders/MiniPlaceholders/pull/23 * fix(deps): update dependency org.junit:junit-bom to v5.9.2 in https://github.com/MiniPlaceholders/MiniPlaceholders/pull/22 * chore(deps): update plugin io.papermc.paperweight.userdev to v1.5.1 in https://github.com/MiniPlaceholders/MiniPlaceholders/pull/21 * chore(deps): update plugin com.github.johnrengelman.shadow to v8 in https://github.com/MiniPlaceholders/MiniPlaceholders/pull/19 * chore(deps): update plugin org.jetbrains.kotlin.jvm to v1.8.10 in https://github.com/MiniPlaceholders/MiniPlaceholders/pull/16 * chore(deps): update dependency gradle to v8 in https://github.com/MiniPlaceholders/MiniPlaceholders/pull/25 * chore(deps): update plugin me.champeau.jmh to v0.7.0 in https://github.com/MiniPlaceholders/MiniPlaceholders/pull/26 * chore(deps): update plugin xyz.jpenilla.run-paper to v1.1.0 in https://github.com/MiniPlaceholders/MiniPlaceholders/pull/27 * chore(deps): update plugin xyz.jpenilla.run-paper to v2 in https://github.com/MiniPlaceholders/MiniPlaceholders/pull/20 * feat: Migrated to Paper plugin * fix: fixed permission check on paper Full Changelog: https://github.com/MiniPlaceholders/MiniPlaceholders/comp…

What's Changed

- feat: Implement Krypton Platform - fix: Fixed subcommand missing permissions

API Only Change

This allows the MiniPlaceholders API to be used in a modular project

What's Changed

feat(paper): Support more Minecraft versions by Sliman4 in https://github.com/4drian3d/MiniPlaceholders/pull/4* * feat: Make gradlew executable by @Sliman4 in https://github.com/4drian3d/MiniPlaceholders/pull/5 * [perf: Ignore resolvers if empty](https://github.com/4drian3d/MiniPlaceholders/commit/0bb6f… * api: Implement Resolvers utility class * [misc: Use DecimalFormat instead of NumberFormat](https://github.com/4drian3d/MiniPlaceholders/commit/01bb1… Full Changelog: https://github.com/4drian3d/MiniPlaceholders/compare/1.1.…