PlaceholderLib

Una API de marcador de posición ligera para plugins de Hytale. Proporciona un sistema de registro simple para la sustitución dinámica de texto.

Quick Start

1. Agregar Dependencia

dependencies {
    implementation(files("libs/PlaceholderLib.jar"))
}

2. Registrar Marcadores de Posición

public class MyPlugin extends JavaPlugin {
    @Override
    public void setup() {
        // Marcador de posición estático
        PlaceholderLib.getRegistry().register(
            new SimplePlaceholder("server_name", "MyServer")
        );

        // Marcador de posición dinámico
        PlaceholderLib.getRegistry().register(
            new Placeholder() {
                @Override
                public String getIdentifier() { return "online_count"; }

                @Override
                public String resolve(PlaceholderContext ctx) {
                    return String.valueOf(getServer().getOnlinePlayers().size());
                }
            }
        );
    }
}

Cómo Funciona

Registro: Los plugins registran marcadores de posición con identificadores únicos (sin símbolos %)

Coincidencia de Patrones: PlaceholderLib encuentra automáticamente patrones %placeholder_id% en el texto

Resolución: Los marcadores de posición registrados reemplazan sus patrones con valores reales

Fallback: Los marcadores de posición no registrados permanecen sin cambios en el texto

Reglas de Marcadores de Posición

• Espacio de Nombres: pluginid_identifier (por ejemplo, rep_eat_food_level)
• Jerarquía opcional: pluginid_category_identifier (por ejemplo, frog_team_health, frog_team_score)
• Caracteres permitidos: a-z, 0-9, _
• Distinguir Mayúsculas y Minúsculas: %rep_eat_food_level% ≠ %Rep_Eat_Food_Level%
• Envolver en % al usar: %pluginid_identifier%

Ejemplo de Implementación

public class CustomPlaceholder implements Placeholder {
    @Override
    public String getIdentifier() {
        return "my_custom_value";
    }

    @Override
    public String resolve(PlaceholderContext context) {
        // Acceder al jugador, mundo, etc. a través del contexto
        return "custom_value";
    }
}

Marcadores de posición soportados integrados: (próximamente)

• LuckPerms %luckperms_prefix% %luckperms_suffix% %luckperms_group%

📚 ¿Necesitas Ayuda?

• Soporte en Discord: https://discord.gg/U4mH3weTsw