Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/wiiiiam278/papiproxybridge
A bridge library plugin for using PlaceholderAPI on proxy servers
https://github.com/wiiiiam278/papiproxybridge
bungeecord fabric minecraft placeholderapi spigot velocity
Last synced: 2 months ago
JSON representation
A bridge library plugin for using PlaceholderAPI on proxy servers
- Host: GitHub
- URL: https://github.com/wiiiiam278/papiproxybridge
- Owner: WiIIiam278
- License: apache-2.0
- Created: 2023-03-05T20:50:44.000Z (almost 2 years ago)
- Default Branch: master
- Last Pushed: 2024-10-17T11:34:56.000Z (2 months ago)
- Last Synced: 2024-10-19T13:50:10.349Z (2 months ago)
- Topics: bungeecord, fabric, minecraft, placeholderapi, spigot, velocity
- Language: Java
- Homepage: https://william278.net/project/papiproxybridge
- Size: 386 KB
- Stars: 37
- Watchers: 1
- Forks: 11
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Funding: .github/funding.yml
- License: LICENSE
Awesome Lists containing this project
README
**PAPIProxyBridge** is a library bridge plugin you install on both your backend and proxy servers that allows proxy plugins to format text with PlaceholderAPI placeholders.
## For server owners
This is a library plugin intended for use with plugins that implement its API. There is nothing to configure.
Install the latest version of the plugin alongside the [PlaceholderAPI plugin](https://www.spigotmc.org/resources/placeholderapi.6245/) on your Spigot (1.16.5+) or the [PlaceholderAPI mod](https://placeholders.pb4.eu/) on your Fabric (1.20) server, then install the plugin on your BungeeCord or Velocity proxy server.
Note this plugin is not a replacement for PlaceholderAPI. You still need to install PlaceholderAPI on your Spigot/Fabric server.
## For developers
PAPIProxyBridge exposes a cross-platform API to let you format text with PlaceholderAPI placeholders.
Adding the library to your project
PAPIProxyBridge is available on `repo.william278.net` ([view javadocs here](https://repo.william278.net/javadoc/releases/net/william278/papiproxybridge/latest)). First, add the maven repository to your `build.gradle`:
```groovy
repositories {
maven { url 'https://repo.william278.net/releases/' }
}
```
Then add the dependency:
```groovy
dependencies {
implementation 'net.william278:papiproxybridge:1.7
}
```
Example usage
The `PlaceholderAPI` class exposes the API for formatting placeholders. At the moment, only singleton non-bracketed placeholders are supported (more in the future).
Get an instance of the class with PlaceholderAPI.getInstance(), then use the `#formatPlaceholders` method to format a string with placeholders on a player (specified with UUID for cross-platform simplicity).
The method returns a [CompletableFuture](https://www.baeldung.com/java-completablefuture) (since we don't want to lock threads while the proxy networks with players on the backend) that you can use to accept the formatted string.
```java
// Format a string with placeholders
final PlaceholderAPI api = PlaceholderAPI.createInstance();
final UUID player = player.getUniqueId();
api.formatPlaceholders("Hello %player_name%!", player).thenAccept(formatted -> {
player.sendMessage(formatted);
});
```
Never invoke `#join()` on calls to `#formatPlaceholders`; this is unsafe.
PAPIProxyBridge caches resolved requests for 30000 milliseconds (30 seconds), to avoid causing excessive traffic over your server's network channels. You can adjust how long to cache requests for using the `PlaceholderAPI#setCacheExpiry(long)` method.
There also exists `#formatComponentPlaceholders`. This method allows you to supply a string containing placeholders and receive an adventure component containing the formatted text, which may contain formatting and chat events.