Minecraft-plugin PlaceholderAPI

🔌 Om PlaceholderAPI

PlaceholderAPI är ett Minecraft-plugin som erbjuder ett centraliserat placeholdersystem och ett ekosystem av expansioner (eCloud). Det låter andra plugins läsa och ersätta tusentals dynamiska placeholders (spelardata, ekonomivärden, pluginspecifika värden osv.) utan direkt integration eller tunga beroenden.

🎯 Syfte

Pluginet löser integrationsfriktion mellan plugins genom att erbjuda ett enda, utbyggbart placeholder-API. Pluginutvecklare publicerar "expansions" som tillhandahåller namngivna placeholders; serveradministratörer installerar dessa expansioner så att servernära plugins (scoreboards, chat, hologram, GUI) kan visa live-data med en konsekvent syntax.

⚙️ Funktioner

• Grundläggande API för placeholder-parsning som andra plugins kan koppla in sig mot.
• Expansionssystem: separat paketerade expansioner eller expansioner som följer med i plugins.
• eCloud (expansion cloud) för att hitta och ladda ner verifierade expansioner i spelet.
• Hanteringskommandon under drift för att lista, registrera, avregistrera och ladda om expansioner.
• Debug-/parse-kommandon för att utvärdera placeholders för en spelare eller sända resultat, användbart vid felsökning.
• Verktyg som dump-kommandot för att dela installerade expansioner och pluginstatus när du söker support.

🧩 För vem

• Serveradministratörer som behöver enhetlig dynamisk text över flera plugins (scoreboards, tablists, hologram, GUI).
• Pluginutvecklare som vill exponera eller använda placeholders utan att tvinga fram tunga beroenden.
• Survival-, minigame- och nätverksservrar som kombinerar många plugins och behöver konsekvent placeholder-syntax.

🏗️ Exempel på användning

• En server installerar en Vault-expansion så att ekonomiplaceholders som spelares saldo kan användas i scoreboard- och chatplugins.
• En administratör laddar ner en pluginspecifik expansion från eCloud så att ett hologramplugin kan visa live-data om mål.
• En utvecklare exponerar plugin-data via en PlaceholderExpansion så att andra servrar kan visa den datan utan att direkt vara beroende av pluginet.

⌨️ Kommandon

(Notera: kommandona ovan är dokumenterade i den officiella PlaceholderAPI-kommandoreferensen. Behörighetsnoder för enskilda kommandon listas inte i den refererade dokumentationen.)

⚙️ Installation

📥 Setup

• Ladda ner den officiella PlaceholderAPI-jar-filen och placera den i serverns katalog plugins/.
• Starta eller starta om servern och bekräfta att PlaceholderAPI läses in i konsolen.
• Installera expansioner antingen genom att lägga expansion-jar-filer i plugins/PlaceholderAPI/expansions/ eller genom att använda eCloud-kommandon i spelet (för verifierade expansioner).

📦 Beroenden

• PlaceholderAPI i sig kräver inget generellt plugin-beroende för att fungera. Vissa placeholders som tillhandahålls av expansioner är beroende av andra plugins (till exempel kräver en expansion som visar ekonomivärden motsvarande ekonomiplugin). Dessa krav beror på den specifika expansionen.

🧠 Tekniska anteckningar

• PlaceholderAPI tillhandahålls för Spigot-baserade servrar och används också ofta på Paper. Det exponerar ett API för pluginutvecklare att registrera PlaceholderExpansions.
• Expansioner kan distribueras som fristående jar-filer eller paketeras med andra plugins; fristående expansioner installeras vanligtvis i plugins/PlaceholderAPI/expansions/.
• eCloud-funktionen gör det möjligt att upptäcka och ladda ner verifierade expansioner i spelet; servrar måste tillåta utgående HTTPS för att eCloud-nedladdningar ska fungera.
• Pluginet innehåller debug- och parse-kommandon som hjälper administratörer att verifiera att placeholders löses korrekt.

🤝 När detta plugin är användbart

Om din server använder flera plugins som behöver visa dynamisk data mellan plugins (chat, tab, hologram, scoreboards eller GUI), är PlaceholderAPI användbart eftersom det centraliserar placeholder-hanteringen och låter dig lägga till stöd för fler plugins via modulära expansioner utan att ändra varje konsumerande plugin.