Hytale Modding API: Der vollständige Server Plugin Development Guide

Von HytaleCharts Team Kategorie: guides :minuten min gelesen

Alles, was Sie zum Aufbau von Hytale Server-Plugins benötigen. Diese Anleitung umfasst das Java 25 Setup, das Plug-in-Lebenszyklus, das Dual-Event-System (EventBus + ECS), die Befehlsregistrierung, die Entity-Komponenten, manifest.json-Format und die Bereitstellung zu CurseForge.

Hytales Server-Plugin-System gibt Entwicklern tiefe Kontrolle über jeden Aspekt des Spiels. Wenn Sie Bukkit oder Spigot-Plugins für Minecraft geschrieben haben, ist der Übergang einfach — aber Hytales Architektur ist grundlegend anders in der Weise, die wichtig ist. Dieser Leitfaden führt Sie durch alles von der ersten Einrichtung bis zum Produktionseinsatz. Architektur Übersicht Vor dem Schreiben eines beliebigen Codes, verstehen Sie, wie Hytales Modding funktioniert: Everything is serverside. Wenn Spieler einem modifizierten Server beitreten, benutzerdefinierte Assets und Verhalten Stream automatisch. Keine Client-Mods erforderlich. strong>Four modmodKategorien existieren: Data Assets (JSON), Art Assets (Blockbench-Modelle), Server Plugins (Java) und Visual Scripting (in Kürze). < ul> Server Plugins sind die leistungsfähigste Kategorie – sie geben Ihnen vollen Java-Zugriff auf die Serverlaufzeit, einschließlich des Entity Component Systems, Ereignispipeline, Befehlsrahmen und Weltmanipulation. Entwicklungsumgebung Setup Voraussetzungen td>25+t> Hytale verwendet moderne Features einschließlich virtueller Threads (Projekt Loom)/tr> td>>strong>IntelliJ IDEA>/td>>c>td>Community oder Ultimatetd>recomed IDE — frei Community Edition arbeitet fein/tr> td>>strong>Gradle/td>td>td>9.2.0+td>td>Build-System (in der Pluginvorlage enthalten)/tr> td>>stark>Git>/td> Zuletzt geänderte Fassung Für die Klonierung der amtlichen Vorlage/tr> Clear the Official Template Hypixel Studios bietet eine offizielle Plugin-Template auf GitHub: code>git clone https://github.com/HytaleModding/plugin-template.git Meine erstePlugin cd MyFirstPlugin Eröffnen Sie das Projekt in IntelliJ IDEA und lassen Sie Gradle synchronisieren. Die Vorlage enthält die korrekte Verzeichnisstruktur, Aufbaukonfiguration und Server-API-Abhängigkeiten. Alternativ der HytaleIO Projekt-Generator bei hytaleio.com/Projekt-Generator kann Plugin, Mod oder Full (combo) Projekt Gerüst mit einem Web UI. erstellen Plugin Structure Every Hytale Plugin folgt diesem Verzeichnis Layout: code>your-plugin/ ĂŒ â â â â ¢ src/main/java/com/yourname/yourplugin/ Ψ └ â âTMa YourPlugin. java # Haupteingang ü â â â â src/main/resources/ ¶ â â â â â – manifestieren. json # Plugin Metadaten (erforderlich) │ ĂŒ â â â â Common/ # Geteilte Vermögenswerte (Modelle, Texturen) Ψ └ – Server/ # Serverseitiges Datenvermögen ĂŒ â â âTMa build.gradle.kts ĂŒ â â – Einstellungen.gradle.kts └ — gradle.properties/pre> manifest.json Every Plugin erfordert einen manifest.json an der Wurzel des kompilierten JAR. Dies ist Hytales Äquivalent von Bukkit's plugin.yml: < < <