Compare commits

..

2 Commits

Author SHA1 Message Date
Andre_601
721cc30e0c Merge branch 'wiki' into feat/wiki-deluxemenus-placeholders 2024-12-04 16:38:07 +01:00
Andre_601
4df989c620 [Wiki] Add new DeluxeMenus placeholders 2024-07-21 02:48:13 +02:00
8 changed files with 182 additions and 715 deletions

View File

@@ -2,27 +2,20 @@ document$.subscribe(async => {
const api_code = document.querySelectorAll('[data-md-component="api-version"]');
function loadAPIInfo(data) {
const mcVersion = data["mcVersion"];
const hyVersion = data["hyVersion"];
const mcVersionToken = "{papiVersion}";
const hyVersionToken = "{papiHytaleVersion}"
const version = data["version"];
const versionToken = "{version}";
for (const codeBlock of api_code) {
codeBlock.innerHTML = codeBlock.innerHTML
.replace(new RegExp(mcVersionToken, 'g'), mcVersion)
.replace(new RegExp(hyVersionToken, 'g'), hyVersion);
codeBlock.innerHTML = codeBlock.innerHTML.replace(new RegExp(versionToken, 'g'), version);
}
}
async function fetchAPIInfo() {
const [mcRelease, hyRelease] = await Promise.all([
fetch("https://repo.extendedclip.com/api/maven/latest/version/releases/me/clip/placeholderapi").then(_ => _.json()),
fetch("https://repo.helpch.at/api/maven/latest/version/releases/at/helpch/placeholderapi-hytale").then(_ => _.json())
])
const release = await fetch("https://repo.extendedclip.com/api/maven/latest/version/releases/me/clip/placeholderapi").then(_ => _.json());
console.log(release)
const data = {
"mcVersion": mcRelease.version,
"hyVersion": hyRelease.version
"version": release.version
}
__md_set("__api_tag", data, sessionStorage);
@@ -31,7 +24,7 @@ document$.subscribe(async => {
if(location.href.includes("/developers/using-placeholderapi")) {
const cachedApi = __md_get("__api_tag", sessionStorage);
if ((cachedApi != null) && (cachedApi["mcVersion"])) {
if ((cachedApi != null) && (cachedApi["version"])) {
loadAPIInfo(cachedApi);
} else {
fetchAPIInfo();

View File

@@ -4,13 +4,6 @@ description: Comprehensive guide on how to create a PlaceholderExpansion for oth
# Creating a PlaceholderExpansion
/// warning | Important
These pages cover the creation of a PlaceholderExpansion for both Spigot/Paper-based and Hytale Servers!
Unless mentioned otherwise the provided code examples function for both platform types.
Please always check code blocks for :material-plus-circle: Icons with additional info!
///
This page will cover how you can create your own [`PlaceholderExpansion`][placeholderexpansion] which you can either integrate into your own plugin (Recommended) or [upload to the eCloud](expansion-cloud.md).
It's worth noting that PlaceholderAPI relies on expansions being installed. PlaceholderAPI only acts as the core replacing utility while the expansions allow other plugins to use any installed placeholder in their own messages.
@@ -44,7 +37,7 @@ In order to not repeat the same basic info for each method throughout this page,
Tab the :material-plus-circle: icons in the code block below for additional information.
///
```java { .annotate title="SomeExpansion.java" }
```{ .java .annotate title="SomeExpansion.java" }
package at.helpch.placeholderapi.example.expansion;
import me.clip.placeholderapi.expansion.PlaceholderExpansion;
@@ -52,86 +45,52 @@ import me.clip.placeholderapi.expansion.PlaceholderExpansion;
public class SomeExpansion extends PlaceholderExpansion {
@Override
@NotNull
public String getAuthor() {
return "Author"; // (1)
}
@Override
@NotNull
public String getIdentifier() {
return "example"; // (2)
}
@Override
@NotNull
public String getVersion() {
return "1.0.0"; // (3)
}
// These methods aren't overriden by default.
// You have to override one of them.
@Override
public String onRequest(OfflinePlayer player, @NotNull String params) {
// (4)
}
@Override
public String onPlaceholderRequest(Player player, @NotNull String params) {
// (5)
}
@Override
public String onPlaceholderRequest(PlayerRef player, @NotNull String params) {
// (6)
}
}
```
1. This method allows you to set the name of the expansion's author. May not be null.
1. This method allows you to set the name of the expansion's author.
2. The identifier is the part in the placeholder that is between the first `%` (or `{` for bracket placeholders) and the first `_`.
The identifier may not be null nor contain `%`, `{`, `}` or `_`.
2. The identifier is the part in the placeholder that is between the first `%` (or `{` if bracket placeholders are used) and the first `_`.
The identifier may not contain `%`, `{`, `}` or `_`.
If you still want to use them in your expansion name, override the `getName()` method.
3. This method returns the version of the expansion. May not be null.
3. This method returns the version of the expansion.
Due to it being a string are you not limited to numbers alone, but it is recommended to stick with a number pattern.
PlaceholderAPI uses this String to compare with the latest version on the eCloud (if uploaded to it) to see if a new version is available.
If your expansion is included in a plugin, this does not matter.
4. Called by PlaceholderAPI to have placeholder values parsed.
When not overriden will call `onPlaceholderRequest(Player, String)`, converting the OfflinePlayer to a Player if possible or else providing `null`.
Using this method is recommended for the usage of the OfflinePlayer, allowing to use data from a player without their presence being required.
**Parameters**:
- `player` - Nullable OfflinePlayer instance to parse placeholders against.
- `params` - Non-null String representing the part of the placeholder after the first `_` and before the closing `%` (or `}` for bracket placeholders).
You must also choose between one of these two methods for handling the actual parsing of placeholders (Exception being expansions providing [relational placeholders](#making-a-relational-expansion)):
5. Called by PlaceholderAPI through `onRequest(OfflinePlayer, String)` to have placeholder values parsed.
When not overriden will return `null`, which PlaceholderAPI will understand as an invalid Placeholder.
- `onRequest(OfflinePlayer, String)`
The first parameter is the player that the placeholders are parsed against, given as an OfflinePlayer instance. This can be null.
The second parameter is the content of the placeholder after the first `_` and before the closing `%` (or `}` if bracket placeholders are used). This String is never null.
**Parameters**:
If not explicity overriden, this will automatically call `onPlaceholderRequest(Player, String)`, passing the parameters as-is to it.
This method is recommended as it allows the usage of offline players, meaning the player does not need to be online to obtain certain certain data from them such as name or UUID.
- `onPlaceholderRequest(Player, String)`
The first parameter is the player that the placeholders are parsed against, given as a Player instance. This can be null.
The second parameter is the content of the placeholder after the first `_` and before the closing `%` (or `}` if bracket placeholders are used). This String is never null.
- `player` - Nullable Player instance to parse placeholders against.
- `params` - Non-null String representing the part of the placeholder after the first `_` and before the closing `%` (or `}` for bracket placeholders).
6. **Note:** Only exists for the Hytale Version of PlaceholderAPI!
Called by PlaceholderAPI through `onPlaceholderRequest(PlayerRef, String)` to have placeholder values parsed.
When `null` is returned will PlaceholderAPI treat it as invalid placeholder and return it unchanged.
**Parameters:**
- `player` - PlayerRef instance to parse placeholders against.
- `params` - Non-null String representing the part of the placeholder after the first `_` and before the closing `%` (or `}` for bracket placeholders).
If not set, this method will return `null` which PlaceholderAPI sees as an invalid placeholder.
/// note
Overriding `onRequest(OfflinePlayer, String)` or `onPlaceholderRequest(Player, String)` is not required if you [create relational placeholders](#making-a-relational-expansion).
PlaceholderAPI always calls `onRequest(Player, String)` in a PlaceholderExpansion.
///
----
@@ -155,18 +114,16 @@ You are also required to override and set `persist()` to `true`. This tells Plac
attrs: { id: full-example-internal }
type: example
//// note | Important Notes
- Please see the [Basic PlaceholderExpansion Structure](#basic-placeholderexpansion-structure) section for an explanation of all common methods in this example.
- The below example is for a Spigot/Paper-based setup.
For a Hytale server, replace `me.clip` imports with `at.helpch` and replace `OfflinePlayer` with `PlayerRef` (Including the import).
//// note |
Please see the [Basic PlaceholderExpansion Structure](#basic-placeholderexpansion-structure) section for an explanation of all common methods in this example.
Tab the :material-plus-circle: icons in the code block below for additional information.
////
```java { .annotate title="SomeExpansion.java" }
package com.example.plugin.expansion;
```{ .java .annotate title="SomeExpansion.java" }
package at.helpch.placeholderapi.example.expansion;
import com.example.plugin.SomePlugin;
import at.helpch.placeholderapi.example.SomePlugin;
import me.clip.placeholderapi.expansion.PlaceholderExpansion;
import org.bukkit.OfflinePlayer;
import org.jetbrains.annotations.NotNull;
@@ -230,20 +187,19 @@ public class SomeExpansion extends PlaceholderExpansion {
6. Example of accessing data of the plugin's `config.yml` file.
7. Reaching this means that an invalid params String was given, so we return `null` to tell PlaceholderAPI that the placeholder was invalid.
///
### Register your Expansion
Due to the PlaceholderExpansion being internal, PlaceholderAPI does not load it automatically, we'll need to do it manually.
This is being done by creating a new instance of your PlaceholderExpansion class and calling the `register()` method of it:
This is being done by creating a new instance of your PlaceholderExpansion class and calling the `register()` method of it.
/// tab | Spigot, Paper, ...
Here is a quick example:
```java { .annotate title="SomePlugin.java" }
package com.example.plugin;
```{ .java .annotate title="SomePlugin.java" }
package at.helpch.placeholderapi.example;
import com.example.plugin.expansion.SomeExpansion;
import at.helpch.placeholderapi.example.expansion.SomeExpansion;
import org.bukkit.Bukkit;
import org.bukkit.plugin.java.JavaPlugin;
@@ -263,37 +219,6 @@ public class SomePlugin extends JavaPlugin {
2. This registers our expansion in PlaceholderAPI. It also gives the Plugin class as dependency injection to the Expansion class, so that we can use it.
///
/// tab | Hytale
```java { .annotate title="SomePlugin.java" }
package com.example.plugin;
import com.example.plugin.expansion.SomeExpansion;
import com.hypixel.hytale.server.core.plugin.JavaPlugin;
import com.hypixel.hytale.server.core.plugin.JavaPluginInit;
import com.hypixel.hytale.common.plugin.PluginIdentifier;
import com.hypixel.hytale.server.core.HytaleServer;
public class SomePlugin extends JavaPlugin {
public SomePlugin(JavaPluginInit init) {
super(init)
}
@Override
protected void start() {
if (HytaleServer.get().getPluginManager().getPlugin(PluginIdentifier.fromString("HelpChat:PlaceholderAPI")) != null) {
new SomeExpansion(this).register();
}
}
}
```
///
----
## Making an External Expansion
@@ -313,18 +238,16 @@ Downsides include a more tedious setup in terms of checking for a required plugi
attrs: { id: full-example-external-no-dependency }
type: example
//// note | Important Notes
- Please see the [Basic PlaceholderExpansion Structure](#basic-placeholderexpansion-structure) section for an explanation of all common methods in this example.
- The below example is for a Spigot/Paper-based setup.
For a Hytale server, replace `me.clip` imports with `at.helpch` and replace `OfflinePlayer` with `PlayerRef` (Including the import).
//// note |
Please see the [Basic PlaceholderExpansion Structure](#basic-placeholderexpansion-structure) section for an explanation of all common methods in this example.
Tab the :material-plus-circle: icons in the code block below for additional information.
////
This is an example expansion without any plugin dependency.
```java { .annotate title="SomeExpansion.java" }
package com.example.expansion;
```{ .java .annotate title="SomeExpansion.java" }
package at.helpch.placeholderapi.example.expansion;
import me.clip.placeholderapi.expansion.PlaceholderExpansion;
import org.bukkit.OfflinePlayer;
@@ -372,20 +295,18 @@ public class SomeExpansion extends PlaceholderExpansion {
attrs: { id: full-example-external-dependency }
type: example
//// note | Important Notes
- Please see the [Basic PlaceholderExpansion Structure](#basic-placeholderexpansion-structure) section for an explanation of all common methods in this example.
- The below example is for a Spigot/Paper-based setup.
For a Hytale server, replace `me.clip` imports with `at.helpch` and replace `OfflinePlayer` with `PlayerRef` (Including the import).
//// note |
Please see the [Basic PlaceholderExpansion Structure](#basic-placeholderexpansion-structure) section for an explanation of all common methods in this example.
Tab the :material-plus-circle: icons in the code block below for additional information.
////
This is an example expansion with a plugin dependency.
```java { .annotate title="SomeExpansion.java" }
package com.example.expansion;
```{ .java .annotate title="SomeExpansion.java" }
package at.helpch.placeholderapi.example.expansion;
import com.example.plugin.SomePlugin;
import at.helpch.placeholderapi.example.SomePlugin;
import me.clip.placeholderapi.expansion.PlaceholderExpansion;
import org.bukkit.Bukkit;
import org.bukkit.OfflinePlayer;
@@ -443,9 +364,7 @@ public class SomeExpansion extends PlaceholderExpansion {
2. The name of the plugin this expansion depends on.
It is recommended to set this, as it would result in PlaceholderAPI reporting any missing plugin for your expansion.
3. **Note:** This only works on a Spigot/Paper-based server. A equivalent for Hytale servers is not yet known.
This does two things:
3. This does two things:
1. It sets the `plugin` instance to `SomePlugin` using Bukkit's PluginManager to retrieve a JavaPlugin instance that is cast to `SomePlugin`.
2. It checks if the retrieved instance is not null. If it is will this result in `canRegister()` returning false, resulting in PlaceholderAPI not loading our expansion.
@@ -461,9 +380,8 @@ public class SomeExpansion extends PlaceholderExpansion {
## Making a relational Expansion
/// note | Notes
- Relational Placeholders always start with `rel_` to properly identify them. This means that if you make a relational placeholder called `friends_is_friend` would the full placeholder be `%rel_friends_is_friend%`.
- For Hytale, replace any mention of `Player` with `PlayerRef` and update any Imports in the code to `at.helpch` and related Hytale ones.
/// note
Relational Placeholders always start with `rel_` to properly identify them. This means that if you make a relational placeholder called `friends_is_friend` would the full placeholder be `%rel_friends_is_friend%`.
///
Relational PlaceholderExpansions are special in that they take two players as input, allowing you to give outputs based on their relation to each other.

View File

@@ -8,7 +8,7 @@ description: Information about PlaceholderAPI's expansion cloud, including how t
PlaceholderAPI uses an expansion-cloud (A website that has all kinds of expansions stored), to download jar files, that contain the placeholders for it to use.
The expansion-cloud can be seen under https://ecloud.placeholderapi.com
The expansion-cloud can be seen under https://api.extendedclip.com/home
## How it works
@@ -28,7 +28,7 @@ In order to do that, you have to follow those steps:
1. Make sure you have created a seperate jar file as described in the [Creating a PlaceholderExpansion](creating-a-placeholderexpansion.md) page.
2. Create an account on the site, or log in, if you already have one.
3. Click on `Expansions` and then on [`Upload New`](https://ecloud.placeholderapi.com/expansions/new/).
3. Click on `Expansions` and then on [`Upload New`](https://api.extendedclip.com/manage/add/).
4. Fill out the required information. `Source URL` and `Dependency URL` are optional and would link to the source code and any dependency (plugin) of your expansion respectively.
5. Click on the button that says `Choose an file...` and select the jar of your expansion.
@@ -54,7 +54,7 @@ This feature exists since version 2.11.4 of PlaceholderAPI.
Before you update, please note the following:
Updating your expansion will automatically make it unverified, requiring a site moderator to verify it again. This was made to combat malware from being uploaded and distributed.
To update your expansion, you first have to go to the list of [your expansions](https://ecloud.placeholderapi.com/expansions/manage/).
To update your expansion, you first have to go to the list of [your expansions](https://api.extendedclip.com/manage/).
For that click on `Expansions` and select `Your Expansions`.
After that, follow those steps:

View File

@@ -6,43 +6,33 @@ description: Guide on how to use PlaceholderAPI in your own plugin.
This page is about using PlaceholderAPI in your own plugin, to either let other plugins use your plugin, or just use placeholders from other plugins in your own.
Please note, that the examples in this page are only available for **PlaceholderAPI 2.10.0 (1.0.0 for Hytale version) or newer**!
Please note, that the examples in this page are only available for **PlaceholderAPI 2.10.0 or higher**!
## First steps
### Add PlaceholderAPI to your Project
Before you can actually make use of PlaceholderAPI, you first have to import it into your project.
Use the below code example matching your project type and dependency manager.
Use the below code example matching your dependency manager.
/// tab | Minecraft (Spigot, Paper, ...)
//// tab | :simple-apachemaven: Maven
/// tab | :simple-apachemaven: Maven
```{ .xml title="pom.xml" data-md-component="api-version" }
<repositories>
<repository>
<id>placeholderapi</id>
<url>https://repo.helpch.at/releases/</url>
<url>https://repo.extendedclip.com/releases/</url>
</repository>
</repositories>
<dependencies>
<dependency>
<groupId>me.clip</groupId>
<artifactId>placeholderapi</artifactId>
<version>{papiVersion}</version>
<scope>provided</scope>
<groupId>me.clip</groupId>
<artifactId>placeholderapi</artifactId>
<version>{version}</version>
<scope>provided</scope>
</dependency>
<!-- Optional: Component support on Paper Servers (Since 2.12.0) -->
<dependency>
<groupId>me.clip</groupId>
<artifactId>placeholderapi-paper</artifactId>
<version>{papiVersion}</version>
<scope>provided</scope>
</dependencies>
```
////
///
//// tab | :simple-gradle: Gradle
/// tab | :simple-gradle: Gradle
```{ .groovy title="build.gradle" data-md-component="api-version" }
repositories {
maven {
@@ -51,68 +41,15 @@ repositories {
}
dependencies {
compileOnly 'me.clip:placeholderapi:{papiVersion}'
// Optional: Component support on Paper Servers (Since 2.12.0)
compileOnly 'me.clip:placeholderapi-paper:{papiVersion}'
compileOnly 'me.clip:placeholderapi:{version}'
}
```
////
///
/// tab | Hytale
//// tab | :simple-apachemaven: Maven
```{ .xml title="pom.xml" data-md-component="api-version" }
<repositories>
<repository>
<id>hytale</id>
<url>https://repo.codemc.io/repository/hytale/</url>
</repository>
<repository>
<id>placeholderapi</id>
<url>https://repo.helpch.at/releases/</url>
</repository>
</repositories>
<dependencies>
<dependency>
<!-- Replace {hytaleVersion} with the version you need -->
<groupId>com.hypixel.hytale</groupId>
<artifactId>Server</artifactId>
<version>{hytaleVersion}</version>
<scope>provided</scope>
</dependency>
<dependency>
<groupId>at.helpch</groupId>
<artifactId>placeholderapi-hytale</artifactId>
<version>{papiHytaleVersion}</version>
<scope>provided</scope>
</dependency>
</dependencies>
```
////
//// tab | :simple-gradle: Gradle
```{ .groovy title="build.gradle" data-md-component="api-version" }
repositories {
maven {
url = 'https://repo.codemc.io/repository/hytale/'
url = 'https://repo.helpch.at/releases/'
}
}
dependencies {
// Replace {hytaleVersion} with the version you need.
compileOnly 'com.hypixel.hytale:Server:{hytaleVersion}'
compileOnly 'at.helpch:placeholderapi-hytale:{papiHytaleVersion}'
}
```
////
///
/// details | What is `{papiVersion}`/`{papiHytaleVersion}`?
/// details | What is `{version}`?
type: question
Using Javascript, `{papiVersion}` and `{papiHytaleVersion}` is replaced with the latest available API version of PlaceholderAPI for Minecraft and Hytale respectively.
Using Javascript, `{version}` is replaced with the latest available API version of PlaceholderAPI.
Should you see the placeholder as-is does it mean that you either block Javascript, or that the version couldn't be obtained in time during page load.
You can always find the latest version matching the API version on the [releases tab](https://github.com/PlaceholderAPI/PlaceholderAPI/releases) of the GitHub Repository.
@@ -134,7 +71,7 @@ Tab the :material-plus-circle: icons in the code block below for additional info
name: ExamplePlugin
version: 1.0
author: author
main: com.example.plugin.ExamplePlugin
main: your.main.path.Here
softdepend: ["PlaceholderAPI"] # (1)
```
@@ -152,7 +89,7 @@ Tab the :material-plus-circle: icons in the code block below for additional info
name: ExamplePlugin
version: 1.0
author: author
main: com.example.plugin.ExamplePlugin
main: your.main.path.Here
depend: ["PlaceholderAPI"] # (1)
```
@@ -174,7 +111,7 @@ Tab the :material-plus-circle: icons in the code block below for additional info
name: ExamplePlugin
version: 1.0
author: author
main: com.example.plugin.ExamplePlugin
main: your.main.path.Here
dependencies:
server:
@@ -197,7 +134,7 @@ Tab the :material-plus-circle: icons in the code block below for additional info
name: ExamplePlugin
version: 1.0
author: author
main: com.example.plugin.ExamplePlugin
main: your.main.path.Here
dependencies:
server:
@@ -212,42 +149,6 @@ dependencies:
///
/// tab | manifest.json (Hytale)
//// tab | Optional dependency
```{ .json .annotate title="manifest.json" }
{
"Group": "com.example",
"Name": "ExamplePlugin",
"Version": "1.0",
"Main": "com.example.plugin.ExamplePlugin",
"OptionalDependencies": {
"HelpChat:PlaceholderAPI": ">= 1.0.2"
}
}
```
////
//// tab | Required dependency
```{ .json .annotate title="manifest.json" }
{
"Group": "com.example",
"Name": "ExamplePlugin",
"Version": "1.0",
"Main": "com.example.plugin.ExamplePlugin",
"Dependencies": {
"HelpChat:PlaceholderAPI": ">= 1.0.2"
}
}
```
////
///
## Adding placeholders to PlaceholderAPI
A full guide on how to create expansions can be found on the [Creating a PlaceholderExpansion](creating-a-placeholderexpansion.md) page.
@@ -255,23 +156,15 @@ A full guide on how to create expansions can be found on the [Creating a Placeho
## Setting placeholders in your plugin
PlaceholderAPI offers the ability, to automatically parse placeholders from other plugins within your own plugin, giving the ability for your plugin to support thousands of other placeholders without depending on each plugin individually.
To use placeholders from other plugins in your own plugin, you simply have to [(soft)depend on PlaceholderAPI](#set-placeholderapi-as-softdepend) and use the `setPlaceholders` method.
To use placeholders from other plugins in our own plugin, we simply have to [(soft)depend on PlaceholderAPI](#set-placeholderapi-as-softdepend) and use the `setPlaceholders` method.
It is also important to point out, that any required plugin/dependency for an expansion has to be on the server and enabled, or the `setPlaceholders` method will just return the placeholder itself (do nothing).
/// info | New since 2.12.0
Starting with version 2.12.0 is it now possible to provide Components from the Adventure library to have placeholders parsed in.
/// details | Example
type: example
In order to use this new feature are the following things required to be true:
- You depend on `placeholderapi-paper` and not just `placeholderapi`
- Your plugin runs on a Paper-based Server. Spigot-based servers will not work!
- You use `PAPIComponent` instead of `PlaceholderAPI` to parse Components.
///
/// tab | Spigot, Paper, ...
The following is an example plugin that sends `%player_name% joined the server! They are rank %vault_rank%` as the Join message, having the placeholders be replaced by PlaceholderAPI.
Let's assume we want to send a custom join message that shows the primary group a player has.
To achieve this, we can do the following:
//// note |
The below example assumes a **soft dependency** on PlaceholderAPI to handle PlaceholderAPI not being present more decently.
@@ -280,7 +173,7 @@ Tab the :material-plus-circle: icons in the code block below for additional info
////
```{ .java .annotate title="JoinExample.java" }
package com.example.plugin;
package at.helpch.placeholderapi;
import me.clip.placeholderapi.PlaceholderAPI;
@@ -322,50 +215,4 @@ public class JoinExample extends JavaPlugin implements Listener {
In our example are we providing a text containing `%player_name%` and `%vault_rank%` to be parsed, which require the Player and Vault expansion respectively.
Example output: `Notch joined the server! They are rank Admin`
//// info | New since 2.12.0
Using `placeholderapi-papi` and `PAPIComponents` instead of `PlaceholderAPI` allows you to parse placeholders inside Adventure Components.
////
///
/// tab | Hytale
The following is an example plugin that sends `Welcome %player_name%!` as the Join message, having the placeholders be replaced by PlaceholderAPI.
``` { .java .annotate title="JoinExample.java" }
packate com.example.plugin;
import at.helpch.placeholderapi.PlaceholderAPI;
import com.hypixel.hytale.server.core.event.events.player.PlayerReadyEvent;
import com.hypixel.hytale.server.core.Message;
import com.hypixel.hytale.server.core.plugin.JavaPlugin;
import com.hypixel.hytale.server.core.plugin.JavaPluginInit;
import com.hypixel.hytale.server.core.universe.Universe;
public class JoinExample extends JavaPlugin {
public JoinExample(JavaPluginInit init) {
super(init)
}
@Override
protected void setup() {
// (1)
Universe.get().getWorlds().keySet().forEach(name -> getEventRegistry().register(PlayerReadyEvent.class, name, this::onPlayerReady));
}
public void onPlayerReady(PlayerReadyEvent event) {
Player player = event.getPlayer();
// (2)
player.sendMessage(PlaceholderAPI.setPlaceholders(Message.raw("Welcome %player_name%!"), player))
}
}
```
1. We tell the server to call `onPlayerReady` whenever a `PlayerReadyEvent` fires.
2. PlaceholderAPI offers multiple `setPlaceholders` methods that can either return a `String` or a `Message` object, depending on your needs.
Note that these methods require input of the same type: `setPlaceholders(String, PlayerRef)` for String and `setPlaceholders(Message, PlayerRef)` for Messages.
///

View File

@@ -9,10 +9,10 @@ This page shows all commands, including with a detailed description of what ever
## Overview
- **[Parse Commands](#parse-commands)**
- [`/papi bcparse <player|me|--null> <text>`](#papi-bcparse)
- [`/papi cmdparse <player|me|--null> <text>`](#papi-cmdparse)
- [`/papi parse <player|me|--null> <text>`](#papi-parse)
- [`/papi parserel <player|me> <player|me> <text>`](#papi-parserel)
- [`/papi bcparse <player|me|--null> <string>`](#papi-bcparse)
- [`/papi cmdparse <player|me|--null> <string>`](#papi-cmdparse)
- [`/papi parse <player|me|--null> <string>`](#papi-parse)
- [`/papi parserel <player> <player> <string>`](#papi-parserel)
- **[eCloud Commands](#ecloud-commands)**
- [`/papi ecloud clear`](#papi-ecloud-clear)
@@ -52,7 +52,7 @@ Parses placeholders of a String and broadcasts the result to all players.
**Arguments**:
- `<player|me|--null>` - The Player to parse values of the placeholder (Use `me` for yourself and `--null` to force a null player (Useful for consoles)).
- `<text>` - Text with placeholders to parse.
- `<Text with placeholders>` - The text to parse.
**Example**:
```
@@ -69,7 +69,7 @@ Parses placeholders of a String and executes it as a command.
**Arguments**:
- `<player|me|--null>` - The Player to parse values of the placeholder (Use `me` for yourself and `--null` to force a null player (Useful for consoles)).
- `<text>` - Text with placeholders to parse and execute as command (Don't include the `/` for the command).
- `<Command with placeholders>` - The Text to parse and execute as command. Please leave away the `/` of the command.
**Example**:
```
@@ -86,7 +86,7 @@ Parses the placeholders in a given text and shows the result.
**Arguments**:
- `<player|me|--null>` - The Player to parse values of the placeholder (Use `me` for yourself and `--null` to force a null player (Useful for consoles)).
- `<text>` - Text with placeholders to parse.
- `<Text with placeholders>` - The text to parse.
**Example**:
```
@@ -102,9 +102,9 @@ Parses a relational placeholder.
**Arguments**:
- `<player1|me>` - The first player (Use `me` for yourself).
- `<player2|me>` - the second player to compare with (Use `me` for yourself).
- `<text>` - Text with placeholders to parse.
- `<player1>` - The first player.
- `<player2>` - the second player to compare with.
- `<Text with placeholders>` - The actual placeholder to parse.
**Example**:
```
@@ -116,8 +116,7 @@ Parses a relational placeholder.
### eCloud Commands
These commands all start with `/papi ecloud` and are used for things related about the [Expansion Cloud](../developers/expansion-cloud.md).
Only executing `/papi ecloud` without any arguments will list all commands available for it.
These commands all start with `/papi ecloud` and are used for things related about the [Expansion Cloud](../developers/expansion-cloud.md).
#### `/papi ecloud clear`
@@ -251,7 +250,7 @@ Gives you information about the specified Expansion.
/// info |
**Description**:
Lists all active/registered expansions.
This is different to [/papi ecloud list installed](#papi-ecloud-list) in the fact, that it also includes expansions that were installed through a plugin (That aren't a separate jar-file) and it also doesn't show which one have updates available.
This is different to [/papi ecloud list installed](#papi-ecloud-list) in the fact, that it also includes expansions that were installed through a plugin (That aren't a separate jar-file) and it also > doesn't show which one have updates available.
///
#### `/papi register`

View File

@@ -34,7 +34,7 @@ Further details on how to contribute to this list or the wiki as a whole can be
- **[CooldownBar](#cooldownbar)**
- **D**
- *[Distance](#distance)*
- *No Expansions*
- **E**
- **[Enchantment](#enchantment)**
@@ -81,7 +81,6 @@ Further details on how to contribute to this list or the wiki as a whole can be
- **[PlayerList](#playerlist)**
- **[Plugin](#plugin)**
- **[Progress](#progress)**
- **[PronounDB](#pronoundb)**
- **Q**
- *No Expansions*
@@ -93,7 +92,6 @@ Further details on how to contribute to this list or the wiki as a whole can be
- **[RedisBungee](#redisbungee)**
- **[RelCon](#relcon)**
- **[RNG](#rng)**
- **[Reparser](#reparser)**
- **S**
- **[ScoreboardObjectives](#scoreboardobjectives)**
@@ -110,7 +108,6 @@ Further details on how to contribute to this list or the wiki as a whole can be
- **U**
- **[Unicode](#unicode)**
- **[UnixTime](#unixtime)**
- **V**
- *No Expansions*
@@ -179,8 +176,9 @@ Further details on how to contribute to this list or the wiki as a whole can be
- **[CheckNameHistory](#checknamehistory)**
- **[ClaimChunk](#claimchunk)**
- **[Clans](#clans)**
- **[Clans](#clans)**
- **[ClansFree](#clansfree)**
- **[Clans-API for Spigot/Clan tag in chat](#clans-api-for-spigotclan-tag-in-chat)**
- **[ClansPro](#clanspro)**
- **[ClanSystem](#clansystem)**
- **[CombatLogX](#combatlogx)**
- **[Compassance](#compassance)**
@@ -227,6 +225,7 @@ Further details on how to contribute to this list or the wiki as a whole can be
- **[Factions MCore](#factions-mcore)**
- **[FactionsUUID](#factionsuuid)**
- **[Factions relation placeholders](#factions-relation-placeholders)**
- **[FunnyGuilds](#funnyguilds)**
- **G**
- **[GAListener](#galistener)**
@@ -234,7 +233,6 @@ Further details on how to contribute to this list or the wiki as a whole can be
- **[GemsEconomy](#gemseconomy)**
- **[GriefDefender](#griefdefender)**
- **[GriefPrevention](#griefprevention)**
- **[GrimAC](#grimac)**
- **[Guilds](#guilds)**
- **[GuiRedeemMCMMO](#guiredeemmcmmo)**
@@ -249,7 +247,6 @@ Further details on how to contribute to this list or the wiki as a whole can be
- **[HyacinthHello](#hyacinthhello)**
- **I**
- **[ImageFrame](#imageframe)**
- **[InteractionVisualizer](#interactionvisualizer)**
- **[InteractiveChat](#interactivechat)**
- **[Island Border (ASkyblock / BentoBox / uSkyBlock / AcidIsland)](#island-border)**
@@ -297,7 +294,6 @@ Further details on how to contribute to this list or the wiki as a whole can be
- **[MyPrefixSystem](#myprefixsystem)**
- **N**
- **[NameColor](#namecolor)**
- **[Nameless Plugin](#nameless-plugin)**
- **[NameMC-API-ServersMC Plugin](#namemc-api-serversmc)**
- **[Nicknamer](#nicknamer)**
@@ -326,7 +322,6 @@ Further details on how to contribute to this list or the wiki as a whole can be
- **[Plan](#plan)**
- **[PlayerStats](#playerstats)**
- **[PlayTime](#playtime)**
- **[PlayTimeManager](#playtimemanager)**
- **[PlaytimeRewards](#playtimerewards)**
- **[PlayerPoints](#playerpoints)**
- **[PlotSquared](#plotsquared)**
@@ -371,7 +366,6 @@ Further details on how to contribute to this list or the wiki as a whole can be
- **S**
- **[Sack](#sack)**
- **[ScreamingBedWars](#screamingbedwars)**
- **[Seasons](#seasons)**
- **[SellAll](#sellall)**
- **[SignLink](#signlink)**
@@ -424,7 +418,6 @@ Further details on how to contribute to this list or the wiki as a whole can be
- **[Two Factor Authentication](#two-factor-authentication)**
- **U**
- **[UJobs](#ujobs)**
- **[UltimateChat](#ultimatechat)**
- **[UltimateClaims](#ultimateclaims)**
- **[UltimateServerManager](#ultimateservermanager)**
@@ -731,27 +724,6 @@ More info about this expansion can be found on the [GitHub-Repository](https://g
----
### **Distance**
/// command | papi ecloud download Distance
///
This expansion provides placeholders to calculate the distance between two locations.
Supports placeholder inside placeholder, use `{}` instead of `%` for inner placeholders.
More info about this expansion can be found on the [GitHub-Repository](https://github.com/Clexus/DistanceExpansion).
`[]` is optional
```
%distance_x1,y1,z1[,x2,y2,z2][,decimals]%
%distance_player1[,player2][,decimals]%
%distance_player[,x,y,z][,decimals]%
%distance_UUID1[,UUID2][,decimals]%
```
----
### **Enchantment**
/// download | https://github.com/TeamVK/PAPI-Enchantment/releases
///
@@ -787,12 +759,10 @@ Use `{{u}}` for underscores and `{{prc}}` for percent symbols.
%formatter_number_round_<number>%
%formatter_number_round_[precision]:[roundingmode]_<number>%
%formatter_number_shorten_<number>%
%formatter_number_shorten_<rounding_mode>_<number>%
%formatter_number_time_<number>%
%formatter_number_time_<timeunit>_<number>% # Handles number as <timeunit>
%formatter_text_capitalize_<text>%
%formatter_text_capitalize_<option>_<text>%
%formatter_text_length_<text>%
%formatter_text_lowercase_<text>%
%formatter_text_replace_[target]_[replacement]_<text>%
@@ -1188,18 +1158,6 @@ More info about this expansion can be found on the [GitHub-Repository](https://g
----
### **PronounDB**
/// download | https://github.com/JasperLorelai/Expansion-PronounDB/releases
///
Shows the pronouns of a Minecraft player with a linked account on https://pronoundb.org/
```
%pronoundb%
```
----
### **RainbowColor**
/// command | papi ecloud download RainbowColor
///
@@ -1290,18 +1248,6 @@ More info about the expansion can be found on the [GitHub-Repository](https://gi
----
### **Reparser**
/// command | papi ecloud download reparser
///
Parses a provided input twice.
```
%reparser_<text>%
```
----
### **ScoreboardObjectives**
/// command | papi ecloud download ScoreboardObjectives
///
@@ -1564,18 +1510,6 @@ Example: `%unicode_1000%` would show `က`
----
### **UnixTime**
/// download | https://api.extendedclip.com/expansions/unixtime/
///
```
%unixtime_[UNIX]_[DateTimeFormat]%
```
Example: `%unixtime_1750277249389_dd.MM.yyyy-HH:mm:ss%` would show `18.06.2025 20:07:29`
----
### **World**
/// command | papi ecloud download world
///
@@ -1903,11 +1837,8 @@ For more info, visit the [wiki](https://asl.andre601.ch/placeholderapi/#own-plac
%asl_favicon%
%asl_motd%
%asl_playercount_extraplayers%
%asl_playercount_hideplayers%
%asl_playercount_hideplayershover%
%asl_playercount_hover%
%asl_playercount_maxplayers%
%asl_playercount_onlineplayers%
%asl_playercount_text%
%asl_server_playersmax%
```
@@ -2204,19 +2135,11 @@ Find examples of how the placeholders can be used on [signs](https://github.com/
/// integrated | Built into Plugin
///
Find an up-to-date list on the [SpigotMC page](https://www.spigotmc.org/resources/beautyquests.39255/field?field=documentation).
```
%beautyquests_total_amount%
%beautyquests_player_inprogress_amount%
%beautyquests_player_finished_amount%
%beautyquests_player_finished_total_amount%
%beautyquests_started_ordered%
%beautyquests_started_ordered_X%
%beautyquests_advancement_X%
%beautyquests_advancement_X_raw%
%beautyquests_player_quest_finished_X%
%beautyquests_started_id_list%
%beautyquests_total_amount%
%beautyquests_advancement_ID%
```
----
@@ -2501,32 +2424,14 @@ Please check the [wiki](https://github.com/booksaw/PlaceholderAPI) for more info
----
### **[Clans](https://www.spigotmc.org/resources/87515/)**
### **[ClansFree](https://www.spigotmc.org/resources/78415/)**
/// integrated | Built into Plugin
///
```
%clans_land_status% - Get the relation status with the current claim youre in
%clans_land_chunk_map_line#% - Get relative claim map data in placeholder form replacing # with a number 1-5 for a 5x5 grid.
%clans_clan_name% - Get the name of the clan of the player
%clans_clan_description% - Get the description of the clan of the player
%clans_clan_color% - Get the color of the clan of the player
%clans_clan_pvp_mode% - Get the pvp mode of the clan of the player
%clans_clan_balance% - Get the money balance of the clan of the player
%clans_clan_power% - Get the amount of power points the clan of the player has.
%clans_clan_top_slot_#% - Get the name of the clan within the specified placement replacing # with the desired ranking.
%clans_clan_top_slot_#_power% - Get the name of the clan within the specified placement based on clan power replacing # with the desired ranking.
%clans_clan_top_slot_#_color% - Get the name of the clan within the specified placement but colored with their clan color repalcing # with the desired ranking.
%clans_clan_war_active% - Get the current active arena status of the player.
%clans_clan_war_score% - Get the current arena score of the clan for the player.
%clans_clan_war_hours% - Get how long the players clan has been at battle in the current arena.
%clans_clan_war_minutes% - Get how long the players clan has been at battle in the current arena.
%clans_clan_war_seconds% - Get how long the players clan has been at battle in the current arena.
%clans_clan_members_online% - Get the count of online clan members for the player
%clans_member_rank% - Get the name of the rank the player currently resides in within their clan
%clans_member_rank_short% - Get the symbol for the rank the player currently resides in within their clan.
%clans_member_bio% - Get the players bio for their clan.
%clans_raidshield_status% - Get the current raidshield status
%clans_name%
%clans_raidshield%
%clans_rank%
```
----
@@ -2542,6 +2447,34 @@ Please check the [wiki](https://github.com/booksaw/PlaceholderAPI) for more info
----
### **[ClansPro](https://www.spigotmc.org/resources/87515/)**
/// integrated | Built into Plugin
///
```
%clanspro_clan_name%
%clanspro_clan_description%
%clanspro_clan_color%
%clanspro_clan_pvp_mode%
%clanspro_clan_balance%
%clanspro_clan_power%
%clanspro_clan_top_slot_#%
%clanspro_clan_top_slot_#_power%
%clanspro_clan_top_slot_#_color%
%clanspro_clan_war_active%
%clanspro_clan_war_score%
%clanspro_clan_war_hours%
%clanspro_clan_war_minutes%
%clanspro_clan_war_seconds%
%clanspro_clan_members_online%
%clanspro_member_rank%
%clanspro_member_rank_short%
%clanspro_member_bio%
%clanspro_raidshield_status%
```
----
### **[ClanSystem](https://www.spigotmc.org/resources/34696/)**
/// integrated | Built into Plugin
///
@@ -2769,13 +2702,17 @@ Please check the [wiki](https://github.com/booksaw/PlaceholderAPI) for more info
///
```
%deluxemenus_meta_<key>_<dataType>_<default_value>%
%deluxemenus_meta_<key>_<dataType>_<defaultValue>%
%deluxemenus_meta_has_value_<key>_<dataType>%
%deluxemenus_is_in_menu%
%deluxemenus_opened_menu%
%deluxemenus_last_menu%
```
- Key: The key of the meta you want to check
- Data Type: Can be `STRING`, `BOOLEAN`, `DOUBLE`, `LONG`, or `INTEGER`.
*If the given key has a different data type, an error will occur.*
- Default Value: The value returned if nothing is found.
- `<key>`: The key of the meta you want to check
- `<dataType>`: Can be `STRING`, `BOOLEAN`, `DOUBLE`, `LONG`, or `INTEGER`.
*If the given key has a different data type, an error will occur.*
- `<defaultValue>`: The value returned if nothing is found.
----
@@ -3169,6 +3106,42 @@ These placeholders work with FactionsUUID and MCore all you need is downloading
----
### **[FunnyGuilds](https://github.com/FunnyGuilds/FunnyGuilds)**
/// integrated | Built into Plugin
///
```
%funnyguilds_guilds%
%funnyguilds_users%
%funnyguilds_deaths%
%funnyguilds_kdr%
%funnyguilds_kills%
%funnyguilds_points-format%
%funnyguilds_points%
%funnyguilds_position%
%funnyguilds_g-allies%
%funnyguilds_g-deaths%
%funnyguilds_g-deputies%
%funnyguilds_g-deputy%
%funnyguilds_g-kdr%
%funnyguilds_g-kills%
%funnyguilds_g-lives%
%funnyguilds_g-members-all%
%funnyguilds_g-members-online%
%funnyguilds_g-name%
%funnyguilds_g-owner%
%funnyguilds_g-points-format%
%funnyguilds_g-points%
%funnyguilds_g-position%
%funnyguilds_g-region-size%
%funnyguilds_g-tag%
%funnyguilds_g-validity%
%funnyguilds_gtop-x%
%funnyguilds_ptop-x%
```
----
### **GAListener**
/// integrated | Built into Plugin
///
@@ -3262,26 +3235,6 @@ These placeholders work with FactionsUUID and MCore all you need is downloading
----
### **[GrimAC](https://modrinth.com/plugin/grimac/)**
/// integrated | Built into Plugin
///
```
%grim_player%
%grim_player_uuid%
%grim_player_ping%
%grim_player_brand%
%grim_player_h_sensitivity%
%grim_player_v_sensitivity%
%grim_player_fast_math%
%grim_player_tps%
%grim_player_version%
%grim_prefix%
%grim_version%
```
----
### **[Guilds](https://www.spigotmc.org/resources/48920/)**
/// integrated | Built into Plugin
///
@@ -3439,20 +3392,6 @@ You can find an up-to-date list of placeholders in the [HyacinthHello wiki](http
----
### **[ImageFrame](https://www.spigotmc.org/resources/106031/)**
/// integrated | Built into Plugin
///
```
%imageframe_imagemap_"<player>:<imagemap>"_playback_bar_<length>_[character]_[current_section_prefix]_[remaining_section_prefix]%
%imageframe_imagemap_"<player>:<imagemap>"_playback_current%
%imageframe_imagemap_"<player>:<imagemap>"_playback_total%
%imageframe_imagemap_"<player>:<imagemap>"_playback_pause%
%imageframe_player_preference_<preference>%
```
----
### **[InteractionVisualizer](https://www.spigotmc.org/resources/77050/)**
/// integrated | Built into Plugin
///
@@ -3643,7 +3582,7 @@ You can find an up-to-date list of placeholders on the [KingdomsX wiki](https://
/// integrated | Built into Plugin
///
A Description of the placeholders can be found on the [Lands Wiki](https://wiki.incredibleplugins.com/Lands/configuration/placeholderapi-placeholders).
A Description of the placeholders can be found on the [Lands Wiki](https://github.com/Angeschossen/Lands/wiki/PlaceholderAPI-Placeholders#placeholders).
```
# General
@@ -3783,7 +3722,7 @@ More info about these placeholders can be found [here](https://panoply.tech/lead
----
### **[LevelUp](https://polymart.org/resource/457/)**
/// integrated | Built into Plugin
/// command | papi ecloud download LevelUp
///
```
@@ -4208,13 +4147,12 @@ Miscellaneous placeholders:
----
### **[MineResetLite](https://polymart.org/resource/137/)**
/// integrated | Built into Plugin
/// command | papi ecloud download MineResetLite
///
```
%mineresetlite_<mine>_time%
%mineresetlite_<mine>_time_remaining%
%mineresetlite_<mine>_time_remaining_seconds%
%mineresetlite_<mine>_precentage%
%mineresetlite_<mine>_blocks_mined%
%mineresetlite_<mine>_percentage_mined%
@@ -4238,46 +4176,10 @@ Miscellaneous placeholders:
----
### **[Multiverse-Core](https://modrinth.com/plugin/multiverse-core)**
/// tab | Multiverse-Core v5
//// integrated | Built into Plugin
////
//// warning | The below Placeholders are only for Multiverse-Core v5!
////
All placeholders allow a `_<world>` to be added with `<world>` being the name of a Multiverse-loaded World.
Example: `%multiverse-core_alias_myworld%`
```
%multiverse-core_alias%
%multiverse-core_animalspawn%
%multiverse-core_autoheal%
%multiverse-core_blacklist%
%multiverse-core_currency%
%multiverse-core_difficulty%
%multiverse-core_entryfee%
%multiverse-core_environment%
%multiverse-core_flight%
%multiverse-core_gamemode%
%multiverse-core_generator%
%multiverse-core_hunger%
%multiverse-core_monstersspawn%
%multiverse-core_name%
%multiverse-core_playerlimit%
%multiverse-core_price%
%multiverse-core_pvp%
%multiverse-core_seed%
%multiverse-core_time%
%multiverse-core_type%
%multiverse-core_weather%
```
### **[Multiverse-Core](https://www.spigotmc.org/resources/390/)**
/// command | papi ecloud download multiverse
///
/// tab | Multiverse-Core v4
//// command | papi ecloud download multiverse
////
```
%multiverse_world_alias%
%multiverse_world_all_property_names%
@@ -4306,7 +4208,6 @@ Example: `%multiverse-core_alias_myworld%`
%multiverse_world_style%
%multiverse_world_type%
```
///
----
@@ -4355,16 +4256,6 @@ Example: `%multiverse-core_alias_myworld%`
----
### **[NameColor](https://modrinth.com/plugin/namecolor)**
/// integrated | Built into Plugin
///
```
%namecolor_display_name%
```
----
### **[Nameless Plugin](https://www.spigotmc.org/resources/59032/)**
/// integrated | Built into Plugin
///
@@ -4698,7 +4589,7 @@ Replace `[Type]` with the top type. Supported values: `DAILY, WEEKLY, MONTHLY, Y
----
### **[PermissionTimer](https://www.mc-market.org/resources/14050/)**
/// integrated | Built into Plugin
/// command | papi ecloud download PermissionTimer
///
```
@@ -4784,40 +4675,6 @@ For more information and usage examples, see the [PlayerStatsExpansion GitHub](h
----
### **[PlayTimeManager](https://modrinth.com/plugin/playtimemanager)**
/// integrated | Built into Plugin
///
For a detailed explanation of how to use PlayTimeManager's placeholders, you can take a look at the [PlayTimeManager Wiki](https://github.com/TheGaBr0/PlayTimeManager/wiki/Placeholders).
```
%PTM_playtime%
%PTM_afk_playtime%
%PTM_playtime_#%
%PTM_afk_playtime_#%
%PTM_playtime_<nickname>%
%PTM_afk_playtime_<nickname>%
%PTM_playtime_#_<nickname>%
%PTM_afk_playtime_#_<nickname>%
%PTM_firstjoin%
%PTM_firstjoin_<nickname>%
%PTM_lastseen_<nickname>%
%PTM_lastseen_elapsed_<nickname>%
%PTM_lastseen_elapsed_#_<nickname>%
%PTM_playtime_top_<rank>%
%PTM_playtime_top_#_<rank>%
%PTM_nickname_top_<rank>%
%PTM_lastseen_top_<rank>%
%PTM_lastseen_elapsed_top_<rank>%
%PTM_lastseen_elapsed_top_#_<rank>%
%PTM_rank%
%PTM_rank_<nickname>%
%PTM_lp_prefix_top_<rank>%
%PTM_joinstreak%
%PTM_joinstreak_<nickname>%
```
----
### **[PlaytimeRewards](https://www.spigotmc.org/resources/100231/)**
/// integrated | Built into Plugin
///
@@ -5853,7 +5710,7 @@ For a description of the placeholders please read the [PvPManager Wiki](https://
----
### **[Sack](https://polymart.org/resource/493/)**
/// integrated | Built into Plugin
/// command | papi ecloud download Sack
///
```
@@ -5865,119 +5722,7 @@ For a description of the placeholders please read the [PvPManager Wiki](https://
%sack_total_slots% : the total number of slots for all sacks in your inventory.
%sack_total_item_count% : the total number of items held in all sacks in your inventory.
```
----
### **[ScreamingBedWars](https://hangar.papermc.io/ScreamingSandals/ScreamingBedWars)**
/// integrated | Built into Plugin
///
You can find an up-to-date list of placeholders with detailed information and examples in the [ScreamingBedWars Documentation](https://docs.screamingsandals.org/BedWars/latest/placeholderapi/).
```
# Global placeholders
%bedwars_all_games_players%
%bedwars_all_games_maxplayers%
%bedwars_all_games_anyrunning%
%bedwars_all_games_anywaiting%
# Placeholders for the current game the player is in
%bedwars_current_game%
%bedwars_current_game_players%
%bedwars_current_game_minplayers%
%bedwars_current_game_maxplayers%
%bedwars_current_game_world%
%bedwars_current_game_state%
%bedwars_current_game_time%
%bedwars_current_game_timeformat%
%bedwars_current_game_elapsedtime%
%bedwars_current_game_elapsedtimeformat%
%bedwars_current_game_running%
%bedwars_current_game_waiting%
%bedwars_current_available_teams%
%bedwars_current_connected_teams%
%bedwars_current_teamchests%
# Placeholders related to the player's team in the current game
%bedwars_current_team%
%bedwars_current_team_color%
%bedwars_current_team_colored%
%bedwars_current_team_players%
%bedwars_current_team_maxplayers%
%bedwars_current_team_bed%
%bedwars_current_team_teamchests%
%bedwars_current_team_bedsymbol%
# Placeholders for a specific team within the current game
%bedwars_current_game_team_<team_name>_colored%
%bedwars_current_game_team_<team_name>_color%
%bedwars_current_game_team_<team_name>_ingame%
%bedwars_current_game_team_<team_name>_players%
%bedwars_current_game_team_<team_name>_maxplayers%
%bedwars_current_game_team_<team_name>_bed%
%bedwars_current_game_team_<team_name>_bedsymbol%
%bedwars_current_game_team_<team_name>_teamchests%
# Placeholders related to a specific game
%bedwars_game_<game>_name%
%bedwars_game_<game>_players%
%bedwars_game_<game>_minplayers%
%bedwars_game_<game>_maxplayers%
%bedwars_game_<game>_world%
%bedwars_game_<game>_state%
%bedwars_game_<game>_available_teams%
%bedwars_game_<game>_connected_teams%
%bedwars_game_<game>_teamchests%
%bedwars_game_<game>_time%
%bedwars_game_<game>_timeformat%
%bedwars_game_<game>_elapsedtime%
%bedwars_game_<game>_elapsedtimeformat%
%bedwars_game_<game>_running%
%bedwars_game_<game>_waiting%
# Placeholders related to a specific team in a specific game
%bedwars_game_<game>_team_<team_name>_colored%
%bedwars_game_<game>_team_<team_name>_color%
%bedwars_game_<game>_team_<team_name>_ingame%
%bedwars_game_<game>_team_<team_name>_players%
%bedwars_game_<game>_team_<team_name>_maxplayers%
%bedwars_game_<game>_team_<team_name>_bed%
%bedwars_game_<game>_team_<team_name>_bedsymbol%
%bedwars_game_<game>_team_<team_name>_teamchests%
# Player statistics
%bedwars_stats_deaths%
%bedwars_stats_destroyed_beds%
%bedwars_stats_kills%
%bedwars_stats_loses%
%bedwars_stats_score%
%bedwars_stats_wins%
%bedwars_stats_games%
%bedwars_stats_kd%
# Statistics of a specific player
%bedwars_otherstats_<player>_deaths%
%bedwars_otherstats_<player>_destroyed_beds%
%bedwars_otherstats_<player>_kills%
%bedwars_otherstats_<player>_loses%
%bedwars_otherstats_<player>_score%
%bedwars_otherstats_<player>_wins%
%bedwars_otherstats_<player>_games%
%bedwars_otherstats_<player>_kd%
# Leaderboard information (<position> is the desired ranking spot, starting with 1)
%bedwars_leaderboard_score_<position>_name%
%bedwars_leaderboard_score_<position>_uuid%
%bedwars_leaderboard_score_<position>_deaths%
%bedwars_leaderboard_score_<position>_destroyed_beds%
%bedwars_leaderboard_score_<position>_kills%
%bedwars_leaderboard_score_<position>_loses%
%bedwars_leaderboard_score_<position>_score%
%bedwars_leaderboard_score_<position>_wins%
%bedwars_leaderboard_score_<position>_games%
%bedwars_leaderboard_score_<position>_kd%
```
----
### **[Seasons](https://www.spigotmc.org/resources/39298/)**
@@ -6780,8 +6525,8 @@ If you add ```_long``` to the cost related placeholder, it will returne a number
%tokenenchant_<enchantment>_version%
%tokenenchant_<enchantment>_fullrefund%
%tokenenchant_<enchantment>_fullrefund_long% : Deprecated. (For formatting, use NumberFormat placeholder %nf_%.)
%tokenenchant_<enchantment>_refund_Y%
%tokenenchant_<enchantment>_refund_Y_long% : Deprecated. (For formatting, use NumberFormat placeholder %nf_%.)
%tokenenchnat_<enchantment>_refund_Y%
%tokenenchnat_<enchantment>_refund_Y_long% : Deprecated. (For formatting, use NumberFormat placeholder %nf_%.)
%tokenenchant_<enchantment>_alias%
%tokenenchant_tokenmultiplier%
%tokenenchant_<enchantment>_occurrencemultiplier%
@@ -6949,28 +6694,6 @@ You can find an up-to-date list of placeholders in the [Towny wiki](https://gith
----
### **[UJobs](https://modrinth.com/plugin/ujobs)**
/// integrated | Built into Plugin
///
Detailed explanation and example outputs of placeholders are listed on [modrinth](https://modrinth.com/plugin/ujobs).
```
ujobs_job_name_<job>
ujobs_job_displayname_<job>
ujobs_job_legacydisplayname_<job>
ujobs_player_level_<job>
ujobs_player_exp_<job>
ujobs_player_position_<job>
ujobs_player_totalmoney_<job>
ujobs_leaderboard_name_<job>_<position>
ujobs_leaderboard_level_<job>_<position>
```
----
### **[USkyBlock](https://www.spigotmc.org/resources/2280/)**
/// command | papi ecloud download uSkyBlock
///

View File

@@ -389,6 +389,9 @@ If your plugin isn't shown here and you want it to be added, [read the Wiki READ
- **[FactionsUUID](https://www.spigotmc.org/resources/1035/)**
- [x] Supports placeholders.
- [x] Provides own placeholders. [**[Link](placeholder-list.md#factionsuuid)**]
- **[FunnyGuilds](https://github.com/FunnyGuilds/FunnyGuilds)**
- [ ] Supports placeholders.
- [x] Provides own placeholders. [**[Link](placeholder-list.md#funnyguilds)**]
- **[FriendReferral](https://www.spigotmc.org/resources/21626/)**
- [x] Supports placeholders.
- [ ] Provides own placeholders. [Link]
@@ -407,9 +410,6 @@ If your plugin isn't shown here and you want it to be added, [read the Wiki READ
- **[GriefPrevention](https://www.spigotmc.org/resources/1884/)**
- [ ] Supports placeholders.
- [x] Provides own placeholders. [**[Link](placeholder-list.md#griefprevention)**]
- **[GrimAC](https://modrinth.com/plugin/grimac/)**
- [x] Supports placeholders.
- [x] Provides own placeholders. [**[Link](placeholder-list.md#grimac)**]
- **[Guilds](https://www.spigotmc.org/resources/48920/)**
- [ ] Supports placeholders.
- [x] Provides own placeholders. [**[Link](placeholder-list.md#guilds)**]
@@ -446,9 +446,6 @@ If your plugin isn't shown here and you want it to be added, [read the Wiki READ
----
## I
- **[ImageFrame](https://www.spigotmc.org/resources/106031/)**
- [ ] Supports placeholders.
- [x] Provides own placeholders. [**[Link](placeholder-list.md#imageframe)**]
- **[InteractionVisualizer](https://www.spigotmc.org/resources/77050/)**
- [ ] Supports placeholders.
- [x] Provides own placeholders. [**[Link](placeholder-list.md#interactionvisualizer)**]
@@ -492,7 +489,7 @@ If your plugin isn't shown here and you want it to be added, [read the Wiki READ
----
## L
- **[Lands](https://www.spigotmc.org/resources/53313/)**
- [x] Supports placeholders.
- [ ] Supports placeholders.
- [x] Provides own placeholders. [**[Link](placeholder-list.md#lands)**]
- **[LastLoginAPI](https://www.spigotmc.org/resources/66348/)**
- [ ] Supports placeholders.
@@ -590,9 +587,6 @@ If your plugin isn't shown here and you want it to be added, [read the Wiki READ
----
## N
- **[NameColor](https://modrinth.com/plugin/namecolor)**
- [ ] Supports placeholders.
- [x] Provides own placeholders. [**[Link](placeholder-list.md#namecolor)**]
- **[Nameless Plugin](https://www.spigotmc.org/resources/59032/)**
- [ ] Supports placeholders.
- [x] Provides own placeholders. [**[Link](placeholder-list.md#nameless-plugin)**]
@@ -674,9 +668,6 @@ If your plugin isn't shown here and you want it to be added, [read the Wiki READ
- **[PlayTime](https://www.spigotmc.org/resources/26016/)**
- [ ] Supports placeholders.
- [x] Provides own placeholders. [**[Link](placeholder-list.md#playtime)**]
- **[PlayTimeManager](https://modrinth.com/plugin/playtimemanager)**
- [x] Supports placeholders.
- [x] Provides own placeholders. [**[Link](placeholder-list.md#playtimemanager)**]
- **[PlaytimeRewards](https://www.spigotmc.org/resources/100231/)**
- [x] Supports placeholders.
- [x] Provides own placeholders. [**[Link](placeholder-list.md#playtimerewards)**]
@@ -834,9 +825,6 @@ If your plugin isn't shown here and you want it to be added, [read the Wiki READ
- **[Scoreboard Sidebar API](https://www.spigotmc.org/resources/21042/)**
- [x] Supports placeholders.
- [ ] Provides own placeholders. [Link]
- **[ScreamingBedWars](https://hangar.papermc.io/ScreamingSandals/ScreamingBedWars)**
- [ ] Supports placeholders.
- [X] Provides own placeholders. [**[Link](placeholder-list.md#screamingbedwars)**]
- **[ScrollBoard](https://www.spigotmc.org/resources/24697/)**
- [x] Supports placeholders.
- [ ] Provides own placeholders. [Link]

View File

@@ -133,5 +133,4 @@ markdown_extensions:
- pymdownx.blocks.details
- pymdownx.blocks.tab:
alternate_style: true
slugify: !!python/object/apply:pymdownx.slugs.slugify {kwds: {case: lower}}
- pymdownx.tasklist