Hytale Modding API: The Complete Server Plugin Development Guide

By HytaleCharts Team Category: guides 7 min read

Hytale server eklentilerini inşa etmeye başlamanız gereken her şey. Bu kılavuz, Java 25 kurulumu, eklenti yaşam döngüsü, ikili etkinlik sistemi (hattatBus + ECS), komut kaydı, varlık bileşenleri, açık.json formatı ve CurseForge'ye dağıtma.

Hytale’nin sunucu eklenti sistemi, geliştiricilere oyunun her yönünde derin bir kontrol verir. Bukkit veya Spigot eklentileri Minecraft için yazdıysanız, geçiş basittir - ancak Hytale'nin mimarisi temel olarak bu konuda farklı. Bu kılavuz sizi ilk kurulumdan üretim dağıtımına kadar her şeyi yürür. Architecture Genel bakış Herhangi bir kodu yazmadan önce, Hytale'in modding'in nasıl çalıştığını anlayın: Müşteri bir taşıyıcıdır. Hytale's C# müşteri grafikler, giriş ve ses işliyor - ancak oyun mantığı yok. Tüm simülasyon, tek bir oyuncuda bile Java sunucusu üzerinde çalışır. Her şey sunucunun tarafında. Oyuncular bir modded sunucusuna katıldığında, özel varlıklar ve davranışlar otomatik olarak yayınlar. Hiçbir müşteri modları gerekli değildir. Four modding kategorileri var: Data Assets (JSON), Art Assets (Blockbench modelleri), Server Plugins (Java), ve Visual scripting (en kısa sürede). Server eklentileri en güçlü kategoridir - Entity Cons System, event pipeline, komut framework ve dünya manipülasyonu dahil olmak üzere sunucu runtime'ya tam Java erişimi verirler. Gelişmiş Çevre Kurulum Önkoşullar ToolVersionNots Java25+ Hytale, sanal iplikler (Project Loom) IntelliJ IDEACommunity or Ultimate IDE - ücretsiz Community Edition iyi Gradle9.2.0+Build sistemi ( addd> Git Son versiyon Resmi şablonu klonlama için Resmi Şablon Hycrypt Studios, GitHub'da resmi bir eklenti şablonu sunar: git klon https://github.com/HytaleModding / Cockin-template.git MyFirstPlugin cd MyFirstPlugin IntelliJ IDEA projesini açın ve Gradle senkronizasyonuna izin verin. Şablon, doğru dizi yapısını, yapılandırmayı ve sunucu API bağımlılıklarını içerir. Alternatively, HytaleIO Project Jeneratör hiptaleio.com/proje-jeneratör bir web UI ile şüpheli bir proje oluşturabilir. Plugin Structure Her Hytale eklenti bu diziyi takip eder: your cover-in / src/main/java/com/yourname/yourin / . . YourPlugin. Java # Main entry point src/main/resources / . . açık. json # Plugin metadata (gerçekten) Ortak / # Ortak varlıklar (modeller, dokular) Server/ # Server-side data varlıkları . inşa.gradle.kts . ayarları.gradle.kts