Saltar al contenido

Referencia de la API

API de placeholders

Lee placeholders de sofyCore desde código y registra tus propias claves en el registro interno que usa el scoreboard.

Leer un placeholder

Java
String rank = api.placeholders().resolve("rank_name", player.getUniqueId());

El identificador es la clave sin el prefijo sofycore_ y sin %. Las claves desconocidas devuelven una cadena vacía. Los resolutores solo leen memoria.

Registrar una clave propia

Java
api.placeholders().register("myplugin_kills", uuid -> String.valueOf(kills.getOrDefault(uuid, 0)));
  • Los identificadores deben cumplir [a-z0-9_]+; registrar una clave existente lanza IllegalArgumentException.
  • Las claves registradas las resuelven los textos de sofyCore que usan su registro, como el scoreboard y la hotbar del modo staff, como %sofycore_myplugin_kills%.
  • No se añaden a la expansión de PlaceholderAPI, que solo responde las claves propias de sofyCore.
  • Mantén los resolutores rápidos y sin I/O: pueden ejecutarse en el hilo del servidor en cada refresco.