Skript-PAPI

Skript-PAPI bridges Skript variables to PlaceholderAPI for Minecraft 1.21.1 servers. It registers a PlaceholderAPI expansion (skriptpapi) that serves values from Skript and lets you manage custom placeholders from scripts or other plugins.

• Jar: build/libs/skriptpapi-1.0.0.jar
• Placeholder format: %skriptpapi_<category>:<name>% (default category is default when omitted). Auto-detected Skript variables use the first :: section as the category, with remaining sections joined as the name.
• Skript effects:
  • set placeholder "name" [in category "category"] to <value> for immediate static placeholders.
  • bind placeholder "name" [in category "category"] to variable "path" [refresh <timespan>] to mirror Skript variables. Include %player% or %uuid% inside the path for per-player values.
• Background tasks refresh cached placeholders (default ~2s for variable bindings) and scan for newly created Skript variables every few seconds. Missing or invalid placeholders are logged and return (unknown placeholder).
• Java API: SkriptPAPIPlugin.getInstance().getPlaceholderManager() exposes registration helpers for developers or Skript addons.

Limitations and notes:

• Auto detection watches global Skript variables; locals are ignored. Very large numbers of variables may be registered, so consider categorizing variables to keep names clear.
• Per-player placeholders use per-player caching; values refresh on demand or when the refresh window elapses. Keep refresh intervals reasonable for heavy data sources.

Server Validation

✅ Server validation passed - The mod was tested on a real Minecraft server and loaded successfully.