WiFlow’s PlaceholderAPI

Sistema de marcadores centralizado para Hytale. Analiza marcadores, crea expansiones, comparte datos entre plugins.

Piense en PlaceholderAPI pero para Hytale.

Características

• Marcadores Universales – Usa la sintaxis {identifier_placeholder} en todos los plugins compatibles
• Expansiones Integradas – Marcadores de jugador y servidor incluidos desde el principio
• Mercado de Expansiones – Descarga expansiones en el juego con /WPAPI marketplace
• Recarga Rápida – Carga y descarga expansiones sin reiniciar el servidor
• Alto Rendimiento – Caché de plantillas y reflexión de MethodHandle para un mínimo sobrecarga
• API Pública – Otros plugins pueden analizar marcadores y crear expansiones personalizadas

Inicio Rápido

/WPAPI list                           - Lista todas las expansiones cargadas
/WPAPI parse {player_name}            - Prueba el análisis de marcadores
/WPAPI marketplace list               - Navega por las expansiones disponibles
/WPAPI marketplace download luckperms - Instala una expansión
/WPAPI reload                         - Recarga todas las expansiones

Marcadores Integrados

Jugador

Marcador
Descripción

{player_name}
Nombre de usuario del jugador

{player_uuid}
UUID del jugador

{player_world}
Nombre del mundo actual

{player_x}
Coordenada X

{player_y}
Coordenada Y

{player_z}
Coordenada Z

{player_online}
“true” o “false”

Servidor

Marcador
Descripción

{server_online}
Cantidad de jugadores en línea

{server_max}
Máximo de espacios para jugadores

{server_tps}
TPS del servidor

{server_memory_used}
Memoria utilizada (MB)

{server_memory_max}
Máxima memoria (MB)

{server_memory_percent}
Porcentaje de uso de memoria

Expansiones del Mercado

Descarga expansiones adicionales directamente en el juego:

Expansión
Marcadores
Plugin Requerido

LuckPerms
prefix, suffix, group
LuckPerms

OrbisGuard
region, region_owners, region_members, flag_*
OrbisGuard

Economy
balance, balance_formatted
EconomySystem

Hyfaction
name, power, members, claims, role
Hyfaction

Essentials
homes, homes_max, warps
Essentials

CombatLog
active, time, attacker, attacker_type
CombatLog

KillingSpree
current, best, kills, deaths, kdr
KillingSpree

OrbisMines
name, reset_time, resetting, blocks_broken
OrbisMines

SimpleClaims
claim_owner, is_claimed, can_build, party_*
SimpleClaims

/WPAPI marketplace download all  - Instala todas las expansiones disponibles

Todos los Comandos

Comando
Descripción

/WPAPI list
Lista las expansiones cargadas

/WPAPI info <id>
Muestra los detalles de la expansión

/WPAPI parse <text>
Analiza marcadores en el texto

/WPAPI reload
Recarga todas las expansiones

/WPAPI marketplace list [page]
Navega por el mercado

/WPAPI marketplace info <id>
Muestra la información de la expansión

/WPAPI marketplace download <id|all>
Descarga la(s) expansión(es)

/WPAPI marketplace update <id|all>
Actualiza la(s) expansión(es)

/WPAPI marketplace status
Muestra el estado del mercado

/WPAPI marketplace refresh
Actualiza la lista de expansiones

/WPAPI marketplace search <query>
Busca expansiones

Alias: /placeholderapi, /papi, /wfpapi

Instalación

Hytale/
└── mods/
    ├── WiFlowPlaceholderAPI-1.0.0.jar  <- Plugin principal
    └── WiFlowPlaceholderAPI/
        └── expansions/                  <- Las expansiones descargadas van aquí
            ├── luckperms-1.1.0.jar
            └── orbisguard-1.1.0.jar

Para Desarrolladores

Usando Marcadores

import com.wiflow.placeholderapi.WiFlowPlaceholderAPI;
import com.wiflow.placeholderapi.context.PlaceholderContext;

// Crear contexto para un jugador
PlaceholderContext context = PlaceholderContext.builder()
    .player(player)
    .playerUuid(player.getPlayerRef().getUuid())
    .playerName(player.getPlayerRef().getUsername())
    .worldName(player.getWorld().getName())
    .build();

// Analizar marcadores
String result = WiFlowPlaceholderAPI.setPlaceholders(context, "¡Hola {player_name}!");
// resultado: "¡Hola Steve!"

Creando una Expansión Personalizada

public class MyExpansion extends PlaceholderExpansion {

    @Override
    public String getIdentifier() { return "myplugin"; }

    @Override
    public String getAuthor() { return "YourName"; }

    @Override
    public String getVersion() { return "1.0.0"; }

    @Override
    public String onPlaceholderRequest(PlaceholderContext context, String params) {
        return switch (params) {
            case "score" -> getScore(context.getPlayerUuid());
            case "level" -> getLevel(context.getPlayerUuid());
            default -> null;
        };
    }
}

Regístrate a través de ServiceLoader: META-INF/services/com.wiflow.placeholderapi.expansion.PlaceholderExpansion

Documentación completa de la API →

Soporte

¿Preguntas o problemas? Únete al servidor de Discord o contacta a w1fl0w.