Minecraft-plugin skript-reflect

🔌 Om skript-reflect

skript-reflect er et Skript-addon, der giver reflection-funktioner til Skript-scripts. Det gør det muligt for skribentforfattere at importere og arbejde med Java-klasser, kalde metoder, læse og skrive felter, oprette proxies og definere eller lytte efter custom events, så Skript kan nå API’er og adfærd, som ikke er tilgængelige via indbyggede udtryk.

🎯 Formål

Pluginens kerneformål er at bygge bro mellem Skript og Java ved at tilbyde low-level reflection-værktøjer. Det løser begrænsninger, hvor Skript ikke har et direkte udtryk eller event, ved at lade erfarne scriptforfattere og addon-udviklere kalde serverens runtime eller andre plugins.

⚙️ Funktioner

• Importere og referere Java-klasser fra Skript.
• Kalde metoder og oprette objekter via reflection.
• Læse og skrive felter reflektivt.
• Oprette class proxies og custom events, der kan bruges inde i Skript.
• Understøttelse af at lytte til asynkrone events.
• Forbedringer og rettelser i forhold til ældre forks (håndtering af lokale variabler, rettelser til class proxies).
• Angivet kompatibilitet med nyere Java-runtime (Java 13+ og OpenJ9-understøttelse nævnt af vedligeholderen).

🧩 Hvem er det til

• Skript-skribentforfattere, der har brug for adgang til Java-API’er eller andre plugin-internals.
• Serveradministratorer, der kører brugerdefineret adfærd baseret på Skript og vil udvide Skript uden at skrive et fuldt Java-plugin.
• Addon-udviklere, der bygger højere niveau Skript-udvidelser ved hjælp af reflection.

🏗️ Eksempler på brug

• Få adgang til et plugins API, som Skript ikke har et indbygget udtryk til, ved at kalde dets Java-metoder.
• Oprette en custom event-type i Java og udløse/lytte til den fra Skript.
• Bruge proxies til at indkapsle Java-interfaces og få dynamisk adfærd i scripts.

⚙️ Installation

📥 Opsætning

• Download pluginets JAR fra projektets officielle releases.
• Læg JAR-filen i din servers plugins/-mappe sammen med Skript.
• Genstart serveren og tjek konsollen for at bekræfte, at skript-reflect indlæses.

📦 Afhængigheder

• Kræver Skript 2.14 eller nyere.

🧠 Tekniske noter

• Projektet distribueres under MIT-licensen.
• Vedligeholderen angiver, at skript-reflect kræver Skript 2.14+ og understøtter de samme platforme og Minecraft-versioner som Skript 2.14.
• Projektets dokumentation og releases vedligeholdes i projektets officielle repository og dokumentationsressourcer.

🤝 Hvornår er dette plugin nyttigt

Hvis du har brug for at udvide Skript med funktionalitet, der ikke er tilgængelig via indbyggede udtryk eller eksisterende addons (for eksempel ved at kalde andre plugins’ API’er eller oprette custom event-typer), giver skript-reflect dig de reflection-værktøjer, der skal til for at gøre det fra Skript-scripts uden at skrive et selvstændigt Java-plugin.