hypsum

hypsum es una forma sencilla de añadir marcadores de posición a los servidores de Hytale. Te permite mostrar información dinámica en mensajes y textos. Este plugin es útil tanto para administradores de servidores como para desarrolladores.

🚀 Características

• ⚡ Rápido: Funciona rápidamente sin ralentizar tu servidor.
• 🛡 Seguro: Sin bucles infinitos ni mensajes rotos.
• 👤 Nombres de Jugadores: Puede mostrar diferentes cosas para diferentes jugadores.
• ⚙️ Personalizable: Cambia cómo se ven tus marcadores de posición (como usar {} en lugar de %%).

💻 Guía para Desarrolladores

La última versión de la API de Hypsum es 1.1.
Añade la API de Hypsum a tu proyecto utilizando la herramienta de construcción de tu elección.

🐘 Gradle

Añade esto a tu build.gradle o build.gradle.kts:

Kotlin

dependencies {
    compileOnly("com.craftlyworks.hypsum:api:1.1")
}

Groovy

dependencies {
    compileOnly 'com.craftlyworks.hypsum:api:1.1'
}

🦢 Maven

Añade esto a tu pom.xml:

<dependency>
    <groupId>com.craftlyworks.hypsum</groupId>
    <artifactId>api</artifactId>
    <version>1.1</version>
    <scope>provided</scope>
</dependency>

📝 Crear un Marcador de Posición

Aquí tienes cómo añadir un nuevo marcador de posición:

import com.craftlyworks.hypsum.api.HypsumProvider;
import com.craftlyworks.hypsum.api.placeholder.Placeholder;

HypsumApi api = HypsumProvider.get();
api.registerPlaceholder(new Placeholder() {
    @Override
    public String getIdentifier() {
        return "my_placeholder";
    }

    @Override
    public String getValue(PlayerRef player) {
        return "¡Hola, " + player.getDisplayName();
    }
});

🔍 Usar tus Marcadores de Posición

Para reemplazar marcadores de posición en una cadena:

String text = "¡Bienvenido %my_placeholder%!";
String result = HypsumProvider.get().process(player, text);
// Resultado: "¡Bienvenido ¡Hola, PlayerName!";

Asegúrate de añadir Hypsum como una dependencia en el manifest.json de tu plugin para usar estas características.
Si deseas una integración opcional, utiliza OptionalDependencies en su lugar.

{
  "Dependencies": {
    "com.craftlyworks.hypsum:Hypsum": ">=1.1"
  }
}

¡Disfruta programando con Hypsum! 🔥

© 2026 CraftlyWorks | Licenciado bajo la Licencia MIT