3.1.0

3.1.0 (10/10/2025)

Features

• feat: Sponge commands implementation
• feat: Implement parserel subcommand
• feat: Add --null argument to parse node
• misc: Added bstats metrics

Fixes

• fix: Fixed multiple loading expansions
• fix: Added nullability checks to RelationalAudience
• fix: Fixed command formatting

API Additions

• feat: Added LoadRequirement#requiredClass and LoadRequirement#anyOf
• docs: Replaced some uses of JetBrains annotations with jspecify
• feat: Allow the use of injected constructors when creating an ExpansionProvider

3.0.1

What's Changed

• chore(deps): update actions/setup-java action to v5 by @renovate[bot] in #278
• Fixed Fabric initialization
• Updated minimun Sponge-API usage

Full Changelog: 3.0.0...3.0.1

Placeholders Refactor and Expansion Providers!

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 or directly review a practical example in the 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.

Important

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, ProxyConnection, Player, Spark, LuckPerms, PlaceholderAdapter, Vault, and more expansions...

Note

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 or GitHub Sponsors.

Commit Changelog

• chore(deps): update dependency gradle to v8.13 by @renovate[bot] in #249
• Fix expansion author and version being built backwards by @Willsr71 in #265
• Update Cloud maven repository URL by @fabianmakila in #268
• MiniPlaceholders V3: Placeholders Refactor by @4drian3d in #256
• fix(deps): update shadow to v9.0.2 by @renovate[bot] in #243
• fix(deps): update dependency org.incendo:cloud-fabric to v2.0.0-snapshot by @renovate[bot] in #244
• fix(deps): update dependency net.fabricmc.fabric-api:fabric-api to v0.132.1+1.21.9 by @renovate[bot] in #247
• fix(deps): update dependency net.kyori:adventure-platform-fabric to v6.6.0 by @renovate[bot] in #264
• chore(deps): update plugin idea-ext to v1.2 by @renovate[bot] in #272
• chore(deps): update plugin quiet-fabric-loom to v1.11.324 by @renovate[bot] in #261
• fix(deps): update cloud.minecraft to v2.0.0-snapshot - autoclosed by @renovate[bot] in #271
• fix(deps): update dependency me.lucko:fabric-permissions-api to v0.4.1 by @renovate[bot] in #273
• chore(deps): update plugin org.gradle.toolchains.foojay-resolver-convention to v1 by @renovate[bot] in #276
• chore(deps): update actions/checkout action to v5 by @renovate[bot] in #275
• fix(deps): update dependency org.junit:junit-bom to v5.13.4 by @renovate[bot] in #274
• fix(deps): update kotlin monorepo to v2.2.20-rc by @renovate[bot] in #259
• [Fix] Remove sponge plugin from the root project by @fabianmakila in #277

New Contributors

• @Willsr71 made their first contribution in #265
• @fabianmakila made their first contribution in #268

Full Changelog: 2.3.0...3.0.0

2.3.0

What's Changed

• feat(api): expansion metadata
• Add LegacyUtils methods to check if a string contains legacy characters
• misc: Updated to Java 21
• Updated to Cloud v2
• Finished Cloud 2 implementation
• 1.21.4
• build: Updated gradle to 8.12.1
• fix(docs): Fixed Dokka docs generation and updated to V2
• Added expansions subcommand

New Contributors

• @powercasgamer made their first contribution in #185
• @Stampede2011 made their first contribution in #199

Sponsors

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

Full Changelog: 2.2.4...2.3.0

2.2.4

What's Changed

• chore(deps): update dependency io.papermc.paperweight.userdev to v1.5.10 by @renovate in #156
• fix(deps): update dependency org.jetbrains.kotlin:kotlin-gradle-plugin to v1.9.21 by @renovate in #158
• chore(deps): update plugin org.jetbrains.kotlin.jvm to v1.9.21 - autoclosed by @renovate in #157
• fix(deps): update dependency net.fabricmc:fabric-loader to v0.14.25 by @renovate in #159
• chore(deps): update dependency gradle to v8.5 by @renovate in #160
• fix(deps): update dependency net.fabricmc.fabric-api:fabric-api to v0.91.2+1.20.4 - autoclosed by @renovate in #144
• fix(deps): update dependency net.fabricmc:fabric-loader to v0.15.1 by @renovate in #161
• chore(deps): update plugin fabric-loom to v1.4.5 by @renovate in #164
• chore(deps): update dependency io.papermc.paperweight.userdev to v1.5.11 by @renovate in #163
• chore(deps): update actions/setup-java action to v4 by @renovate in #162
• chore(deps): update actions/upload-artifact action to v4 by @renovate in #166
• fix(deps): update adventure to v4.15.0 by @renovate in #168
• fix(deps): update kotlin monorepo to v1.9.22 by @renovate in #169
• fix(deps): update dependency net.fabricmc:fabric-loader to v0.15.3 by @renovate in #165
• fix(deps): update dependency net.fabricmc.fabric-api:fabric-api to v0.92.0+1.20.5 by @renovate in #167
• chore(deps): update plugin org.gradle.toolchains.foojay-resolver-convention to v0.8.0 by @renovate in #173
• fix(deps): update dependency net.fabricmc.fabric-api:fabric-api to v0.93.1+1.20.5 by @renovate in #172
• chore(deps): update plugin fabric-loom to v1.5.5 - autoclosed by @renovate in #171
• chore(deps): update dependency gradle to v8.6 by @renovate in #181
• chore(deps): update nick-invision/retry action to v3 by @renovate in #180
• fix(deps): update dependency net.kyori:adventure-platform-fabric to v5.11.0 - autoclosed by @renovate in #179
• chore(deps): update plugin fabric-loom to v1.5.7 by @renovate in #178
• fix(deps): update dependency net.fabricmc:fabric-loader to v0.15.6 by @renovate in #176
• Deprecated TagsUtils#staticTag
• Updated to Fabric 1.20.3+

Full Changelog: 2.2.3...2.2.4

2.2.3

What's Changed

• fix(deps): update dependency org.junit:junit-bom to v5.10.1 by @renovate in #150
• chore(deps): update runtask to v2.2.1 by @renovate in #152
• chore(deps): update runtask to v2.2.2 by @renovate in #153
• fix(deps): update dependency net.kyori:adventure-platform-fabric to v5.10.1 by @renovate in #154
• fix: Fixed native expansion placeholders nesting
• chore: Relicensed project with Apache 2 license

Full Changelog: 2.2.2...2.2.3

2.2.2

What's Changed

• fix(deps): update dependency net.fabricmc.fabric-api:fabric-api to v0.86.1+1.20.1 by @renovate in #111
• fix(deps): update dependency org.junit:junit-bom to v5.10.0 by @renovate in #110
• fix(deps): update dependency net.fabricmc:fabric-loader to v0.14.22 by @renovate in #112
• fix(deps): update dependency net.fabricmc.fabric-api:fabric-api to v0.86.1+1.20.2 by @renovate in #113
• chore(deps): update plugin fabric-loom to v1.3.9 by @renovate in #115
• fix(deps): update dependency net.fabricmc.fabric-api:fabric-api to v0.86.3+1.20.2 - autoclosed by @renovate in #114
• chore(deps): update plugin org.gradle.toolchains.foojay-resolver-convention to v0.7.0 by @renovate in #118
• fix(deps): update dependency net.fabricmc.fabric-api:fabric-api to v0.87.1+1.20.2 by @renovate in #116
• fix(deps): update kotlin monorepo to v1.9.10 by @renovate in #119
• fix(deps): update dependency org.jetbrains.dokka:dokka-gradle-plugin to v1.9.0 by @renovate in #123
• chore(deps): update dependency org.jetbrains.dokka to v1.9.0 by @renovate in #122
• chore(deps): update actions/checkout action to v4 by @renovate in #125
• fix(deps): update indra to v3.1.3 by @renovate in #120
• fix(deps): update cloud to v1.8.4 by @renovate in #126
• fix(deps): update dependency net.fabricmc.fabric-api:fabric-api to v0.88.4+1.20.2 by @renovate in #121
• fix(deps): update dependency net.fabricmc.fabric-api:fabric-api to v0.88.5+1.20.2 by @renovate in #129
• fix(deps): update dependency net.fabricmc.fabric-api:fabric-api to v0.89.0+1.20.2 by @renovate in #130
• fix(deps): update dependency net.fabricmc.fabric-api:fabric-api to v0.89.1+1.20.2 by @renovate in #132
• fix(deps): update dependency net.kyori:adventure-platform-fabric to v5.10.0 by @renovate in #133
• chore(deps): update runtask to v2.2.0 by @renovate in #131
• fix(deps): update dependency net.fabricmc.fabric-api:fabric-api to v0.89.2+1.20.2 by @renovate in #134
• chore(deps): update plugin fabric-loom to v1.4.1 by @renovate in #135
• fix(deps): update dependency net.fabricmc.fabric-api:fabric-api to v0.89.3+1.20.2 by @renovate in #136
• fix(deps): update dependency net.fabricmc.fabric-api:fabric-api to v0.89.4+1.20.3 by @renovate in #139
• fix(deps): update dependency net.fabricmc:fabric-loader to v0.14.23 by @renovate in #138
• fix(deps): update dependency net.fabricmc.fabric-api:fabric-api to v0.90.1+1.20.3 by @renovate in #140
• chore(deps): update dependency io.papermc.paperweight.userdev to v1.5.8 - autoclosed by @renovate in #137
• chore(deps): update dependency org.jetbrains.dokka to v1.9.10 by @renovate in #141
• chore(deps): update dependency io.papermc.paperweight.userdev to v1.5.9 by @renovate in #146
• chore(deps): update dependency me.champeau.jmh to v0.7.2 by @renovate in #147
• fix(deps): update dependency net.fabricmc:fabric-loader to v0.14.24 by @renovate in #145
• fix(deps): update dependency org.jetbrains.dokka:dokka-gradle-plugin to v1.9.10 by @renovate in #143
• chore(deps): update plugin fabric-loom to v1.4.4 by @renovate in #142
• chore(deps): update dependency gradle to v8.4 by @renovate in #117
• chore(deps): update plugin org.spongepowered.gradle.plugin to v2.2.0 by @renovate in #127
• fix(deps): update dependency org.jetbrains.kotlin:kotlin-gradle-plugin to v1.9.20 - autoclosed by @renovate in #149
• chore(deps): update plugin org.jetbrains.kotlin.jvm to v1.9.20 by @renovate in #148
• fix(fabric): Fixed legacy serializer inclusion

Full Changelog: 2.2.1...2.2.2

2.2.1

What's Changed

Fixes

• fix: Check Tag equality using String#equalsIgnoreCase
• fix: Fixed legacy chars replacement in LegacyUtils
• fix(build): Fixed some deprecations

Features

• feat: Add more Legacy API parsing

Dependency Updates

• fix(deps): update dependency net.fabricmc.fabric-api:fabric-api to v0.80.3+1.20 by @renovate in #78
• fix(deps): update indra to v3.1.1 by @renovate in #79
• fix(deps): update dependency net.fabricmc:fabric-loader to v0.14.20 by @renovate in #82
• fix(deps): update dependency net.fabricmc.fabric-api:fabric-api to v0.81.2+1.20 by @renovate in #80
• fix(deps): update dependency net.fabricmc.fabric-api:fabric-api to v0.81.3+1.20 by @renovate in #83
• fix(deps): update dependency net.fabricmc.fabric-api:fabric-api to v0.82.0+1.20 by @renovate in #84
• fix(deps): update dependency net.fabricmc:fabric-loader to v0.14.21 by @renovate in #87
• fix(deps): update dependency net.fabricmc.fabric-api:fabric-api to v0.83.0+1.20 by @renovate in #88
• fix(deps): update dependency org.jetbrains.dokka:dokka-gradle-plugin to v1.8.20 by @renovate in #90
• chore(deps): update dependency org.jetbrains.dokka to v1.8.20 by @renovate in #89
• fix(deps): update adventure to v4.14.0 by @renovate in #91
• fix(deps): update kotlin monorepo to v1.8.22 by @renovate in #92
• chore(deps): update plugin fabric-loom to v1.3.1 by @renovate in #94
• fix(deps): update dependency net.fabricmc.fabric-api:fabric-api to v0.84.0+1.20.1 by @renovate in #93
• chore(deps): update dependency net.minecrell.plugin-yml.bukkit to v0.6.0 by @renovate in #95
• chore(deps): update plugin fabric-loom to v1.3.2 by @renovate in #97
• chore(deps): update dependency gradle to v8.2 by @renovate in #98
• chore(deps): update plugin fabric-loom to v1.3.4 by @renovate in #99
• chore(deps): update plugin fabric-loom to v1.3.5 by @renovate in #100
• fix(deps): update dependency net.fabricmc.fabric-api:fabric-api to v0.85.0+1.20.1 by @renovate in #101
• fix(deps): update kotlin monorepo to v1.9.0 by @renovate in #104
• fix(deps): update indra to v3.1.2 by @renovate in #103
• chore(deps): update plugin fabric-loom to v1.3.8 - autoclosed by @renovate in #102
• chore(deps): update plugin org.gradle.toolchains.foojay-resolver-convention to v0.6.0 by @renovate in #106
• fix(deps): update dependency net.kyori:adventure-platform-fabric to v5.9.0 by @renovate in #108
• fix(deps): update krypton to v7796647145 (major) by @renovate in #107
• chore(deps): update dependency gradle to v8.2.1 by @renovate in #105
• fix(deps): update dependency net.fabricmc.fabric-api:fabric-api to v0.86.0+1.20.1 by @renovate in #109

Downloads

Full Changelog: 2.2.0...2.2.1

2.2.0

What's Changed

Features

• Added Support for passing ForwardingAudience.Single instead of the actual instance by @4drian3d in #70
• Cloud Implementation by @4drian3d in #71
• Sponge Implementation by @4drian3d in #73
• Split platforms into separate files by @4drian3d in #77
• perf: Reuse empty arrays
• api: Improved conditional API methods

Dependency Updates

• chore(deps): update dependency io.papermc.paperweight.userdev to v1.5.5 by @renovate in #67
• fix(deps): update dependency org.junit:junit-bom to v5.9.3 by @renovate in #66
• chore(deps): update plugin fabric-loom to v1.2.6 by @renovate in #69
• fix(deps): update dependency net.william278:desertwell to v2.0.4 by @renovate in #72
• fix(deps): update dependency net.fabricmc.fabric-api:fabric-api to v0.80.1+1.20 by @renovate in #68
• chore(deps): update plugin fabric-loom to v1.2.7 by @renovate in #76

Downloads

Full Changelog: 2.1.0...2.2.0

2.1.0

What's Changed

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

Downloads

Full Changelog: 2.0.2...2.1.0