All Mods Resource Packs Data Packs Shaders Modpacks Plugins
MiniPlaceholders
Projects / Plugins

MiniPlaceholders

by Unknown • Downloads: 0 • Followers: 0
Install / Download
Description
Gallery
Changelog
Versions

MiniPlaceholders

WorkFlow Latest Version Modrinth Downloads GitHub Downloads

MiniMessage Component-based Placeholders API for Minecraft Platforms

Compatibility

  • Paper 1.21+
  • Velocity 3.4.0+
  • Fabric 1.21.4+
  • Sponge API 12+

User Usage

Check our user usage wiki

API

Check the available Javadocs

Or check the Developer Wiki

Java

class Main {
    public static void registerExpansion() {
        final Expansion expansion = Expansion.builder("my-expansion")
                .audiencePlaceholder(Player.class, "name", (player, ctx, queue) -> {
                    return Tag.selfClosingInserting(player.getName());
                })
                .globalPlaceholder("tps", (ctx, queue) ->
                    Tag.selfClosingInserting(Component.text(Bukkit.getTps()[0]))
                ).build;

        expansion.register();

        Player player;
        final TagResolver playerResolver = MiniPlaceholders.audiencePlaceholders();
        player.sendMessage(miniMessage().deserialize("Player Name: <my-expansion_name>", player, playerResolver));
    }
}

Kotlin

fun register() {
    val expansion = expansion("my-expansion") {
        audience<Player>("name") { aud, _, _ -> aud.getName().asClosingTag() }
        global("tps") { _, _ -> Component.text(Bukkit.getTps()[0]).asInsertingTag() }
    }

    expansion.register()

    val player: Player
    val playerResolver = MiniPlaceholders.audiencePlaceholders()
    player.sendMessage(miniMessage().deserialize("Player Name: <my-expansion_name>", player, playerResolver))
}

All Versions

+ Add Version
Name Game version Platforms Published Downloads Actions
26.2
Fabric Quilt
23h ago 1
26.1.x
Fabric Quilt
23h ago 1
26.2 26.1.x 1.21.x
Folia Paper Purpur
23h ago 1
26.2 26.1.x 1.21.x
Sponge
23h ago 1
26.2 26.1.x 1.21.x +14
Velocity
23h ago 1
1.21.11
Fabric Quilt
23h ago 1
1.21.x
Fabric Quilt
23h ago 1
1.21.x
Fabric Quilt
23h ago 1
1.21.x
Folia Paper Purpur
23h ago 1
26.1 1.21.x
Sponge
23h ago 1
26.1 1.21.x 1.20.x +13
Velocity
23h ago 1
1.21.x
Fabric Quilt
23h ago 1
1.21.x
Folia Paper Purpur
23h ago 1
1.21.x
Sponge
23h ago 1
1.21.x 1.20.x 1.19.x +12
Velocity
23h ago 1
1.21.x
Fabric Quilt
23h ago 1
1.21.x
Folia Paper Purpur
23h ago 1
1.21.x
Sponge
23h ago 1
1.21.x 1.20.x 1.19.x +12
Velocity
23h ago 1
1.21.x
Fabric Quilt
23h ago 1
1.21.x
Folia Paper Purpur
23h ago 1
1.21.x 1.20.x 1.19.x
Sponge
23h ago 1
1.21.x 1.20.x 1.19.x +12
Velocity
23h ago 1
1.20.x
Fabric
23h ago 1
1.20.x 1.19.4
Folia Paper Purpur
23h ago 1
1.20.x 1.19.x 1.18.x +2
Sponge
23h ago 1
1.21 1.20.x 1.19.x +12
Velocity
23h ago 1
1.20.2
Fabric Quilt
23h ago 1
1.20.x 1.19.4
Folia Paper Purpur
23h ago 1
1.20.x 1.19.x 1.18.x +2
Sponge
23h ago 1
1.20.x 1.19.x 1.18.x +11
Velocity
23h ago 1
1.20.2
Fabric Quilt
23h ago 1
1.20.x 1.19.x
Folia Paper Purpur
23h ago 1
1.20.x 1.19.x 1.18.x +2
Sponge
23h ago 1
1.20.x 1.19.x 1.18.x +11
Velocity
23h ago 1
23w33a 23w32a 23w31a +2
Fabric Quilt
23h ago 1
1.20.x 1.19.x
Folia Paper Purpur
23h ago 1
1.20.x 1.19.x 1.18.x +2
Sponge
23h ago 1
1.20.x 1.19.x 1.18.x +11
Velocity
23h ago 1
23w18a 23w17a 1.20.x +1
Fabric Quilt
23h ago 1
1.20.x 1.19.x
Folia Paper Purpur
23h ago 1
1.20.x 1.19.x 1.18.x +2
Sponge
23h ago 1
1.20.x 1.19.x 1.18.x +11
Velocity
23h ago 1
23w18a 23w17a 1.20-pre1 +1
Fabric Quilt
23h ago 1
1.19.4
Folia Paper Purpur Velocity
23h ago 1
1.19.4
Fabric
23h ago 1
1.19.4
Folia Paper Purpur Velocity
23h ago 1
1.19.4
Paper Purpur Velocity
23h ago 1
1.19.3
Paper Purpur Velocity
23h ago 1
1.19.x 1.18.2
Paper Purpur Velocity
23h ago 1
1.19.x 1.18.2
Paper Purpur Velocity
23h ago 1
1.19.x 1.18.2
Paper Purpur Velocity
23h ago 1
# 3.2.1 (07/09/2026)

### Fixes

  • Fixed Fabric 26.2 support
## 3.2.0 (27/03/2026)

### Features


## 3.2.0 (27/03/2026)

### Features


## 3.2.0 (27/03/2026)

### Features


## 3.2.0 (27/03/2026)

### Features


Added support for Fabric 1.21.11
  • Added support to Fabric 1.21.9+
## 3.1.0 (10/10/2025)

### Features


### Fixes



### API Additions


## 3.1.0 (10/10/2025)

### Features


### Fixes



### API Additions


## 3.1.0 (10/10/2025)

### Features


### Fixes



### API Additions


## 3.1.0 (10/10/2025)

### Features


### Fixes



### API Additions


## What's Changed
  • Fixed Fabric initialization
  • Updated minimun Sponge-API usage


## What's Changed
  • Fixed Fabric initialization
  • Updated minimun Sponge-API usage


## What's Changed
  • Fixed Fabric initialization
  • Updated minimun Sponge-API usage


## What's Changed
  • Fixed Fabric initialization
  • Updated minimun Sponge-API usage


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/Expansion-Providers) 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/Integration).

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-Expansion/releases), [ProxyConnection](https://github.com/MiniPlaceholders/ProxyConnection-Expansion/releases), [Player](https://github.com/MiniPlaceholders/Player-Expansion/releases), [Spark](https://github.com/MiniPlaceholders/Spark-Expansion/releases), [LuckPerms](https://github.com/MiniPlaceholders/LuckPerms-Expansion/releases), [PlaceholderAdapter](https://github.com/MiniPlaceholders/LuckPerms-Expansion/releases), [Vault](https://github.com/MiniPlaceholders/Vault-Expansion/releases), and [more expansions](https://github.com/MiniPlaceholders/MiniPlaceholders/wiki/Placeholders)...

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).

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/Expansion-Providers) 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/Integration).

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-Expansion/releases), [ProxyConnection](https://github.com/MiniPlaceholders/ProxyConnection-Expansion/releases), [Player](https://github.com/MiniPlaceholders/Player-Expansion/releases), [Spark](https://github.com/MiniPlaceholders/Spark-Expansion/releases), [LuckPerms](https://github.com/MiniPlaceholders/LuckPerms-Expansion/releases), [PlaceholderAdapter](https://github.com/MiniPlaceholders/LuckPerms-Expansion/releases), [Vault](https://github.com/MiniPlaceholders/Vault-Expansion/releases), and [more expansions](https://github.com/MiniPlaceholders/MiniPlaceholders/wiki/Placeholders)...

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).

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/Expansion-Providers) 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/Integration).

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-Expansion/releases), [ProxyConnection](https://github.com/MiniPlaceholders/ProxyConnection-Expansion/releases), [Player](https://github.com/MiniPlaceholders/Player-Expansion/releases), [Spark](https://github.com/MiniPlaceholders/Spark-Expansion/releases), [LuckPerms](https://github.com/MiniPlaceholders/LuckPerms-Expansion/releases), [PlaceholderAdapter](https://github.com/MiniPlaceholders/LuckPerms-Expansion/releases), [Vault](https://github.com/MiniPlaceholders/Vault-Expansion/releases), and [more expansions](https://github.com/MiniPlaceholders/MiniPlaceholders/wiki/Placeholders)...

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).

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/Expansion-Providers) 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/Integration).

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-Expansion/releases), [ProxyConnection](https://github.com/MiniPlaceholders/ProxyConnection-Expansion/releases), [Player](https://github.com/MiniPlaceholders/Player-Expansion/releases), [Spark](https://github.com/MiniPlaceholders/Spark-Expansion/releases), [LuckPerms](https://github.com/MiniPlaceholders/LuckPerms-Expansion/releases), [PlaceholderAdapter](https://github.com/MiniPlaceholders/LuckPerms-Expansion/releases), [Vault](https://github.com/MiniPlaceholders/Vault-Expansion/releases), and [more expansions](https://github.com/MiniPlaceholders/MiniPlaceholders/wiki/Placeholders)...

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).

## What's Changed

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

## What's Changed

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

## What's Changed

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

## What's Changed

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

  • Deprecated TagsUtils#staticTag
  • Updated to Fabric 1.20.3+


  • Deprecated TagsUtils#staticTag
  • Updated to Fabric 1.20.3+


  • Deprecated TagsUtils#staticTag
  • Updated to Fabric 1.20.3+


  • Deprecated TagsUtils#staticTag
  • Updated to Fabric 1.20.3+


## What's changed

  • fix: Fixed native expansion placeholders nesting
  • chore: Relicensed project with Apache 2 license


## What's changed

  • fix: Fixed native expansion placeholders nesting
  • chore: Relicensed project with Apache 2 license


## What's changed

  • fix: Fixed native expansion placeholders nesting
  • chore: Relicensed project with Apache 2 license


🌟 Related Projects

Similar modifications and resources you might like

View all →
PacketEvents
P

PacketEvents

by retrooper

PacketEvents is a protocol library tailored to Minecraft Java Edition, designed to facilitate the processing and transmission of packets.

0
plugin
BetterHud
B

BetterHud

by toxicity188

Make a beautiful HUD in Minecraft!

0
plugin
MiniMOTD
M

MiniMOTD

by jpenilla

Minecraft plugin/mod to set the server list MOTD using MiniMessage for formatting, supporting RGB colors.

0
plugin
OtterLib
O

OtterLib

by Oth3r

A cool new simple library mod that everyone can use!

0
plugin
MiniPlaceholders Icon
Download MiniPlaceholders
Select game version
Select platform