Hytale Modding המדריך המלא של Server Plugin Development Guide

מערכת תוסף השרת של Hytale נותנת למפתחים שליטה עמוקה על כל היבט של המשחק. אם כתבת Bukkit או תוספי Spigot עבור Minecraft, המעבר הוא פשוט - אבל האדריכלות של Hytale שונה באופן יסודי בדרכים שחשובות. מדריך זה עובר אותך דרך כל דבר מההגדרה הראשונית לפריסת הייצור. המונחים:Architecture סקירה: לפני כתיבת כל קוד, להבין איך המודול של Hytale עובד: הלקוח הוא עורך. הלקוח של Hytale מטפל בגרפיקה, קלט ואודיו - אך אינו מכיל לוגיקה של משחק. כל הסימולציות פועלות בשרת Java, אפילו בשחקן יחיד. Everything הוא Server-side. כאשר השחקנים מצטרפים לשרת מותאם, נכסים וזרם התנהגות מותאם באופן אוטומטי. אין צורך ב- 4 קטגוריות מודוליות קיימות: נכסי נתונים (JSON), Art Assets (מודלים של Blockbench), Server Plugins (Java), ו- Visual Scripting (בקרוב). Server plugins הם הקטגוריה החזקה ביותר - הם נותנים לך גישה מלאה ג'אווה לשרת בריצה, כולל מערכת תאימות, צינור אירועים, מסגרת פיקוד ומניפולציה עולמית. פיתוח הסביבה Prerequisites ToolVersionnotes< Java25+< Hytale משתמשת בתכונות מודרניות כולל חוטים וירטואליים (Project Loom) >>IntelliJ IDEACommunity or UltimateRecommended IDE - Free Community Edition עובד בסדר Gradle9.2.0+Build system (כולל בתבנית התוסף)9. Git>> כל גרסה עדכנית כדי לשחזר את התבנית הרשמית Clone את התבנית הרשמית Hypixel Studios מספק תבנית תוסף רשמית ב- GitHub: git Cloe google:github.com/HytaleModding/plugin-template הראשון שלי תגית: My FirstPlugin פתח את הפרויקט ב- IntelliJ IDEA ותן לגרנדל לסנכרן. התבנית כוללת את המבנה הדירקטורי הנכון, בניית תצורה ותלויי API של השרת. Alternatively, The HytaleIO Project Generator at hytaleio.com/project-generator יכול ליצור Plugin, Mod, או מלא (combo) פרויקט עם אינטרנט UI. Plugin Structure כל תוסף Hytale עוקב אחר הפריסה המנהלית הזו: Your-plugin/ ├── src/main/java/com/yourname/yourpelloin/ └── שלך. המונחים: המונחים: src /main /resources │ ├── ג'ייסון # Plugin metadata (required) │ Common / # משותף נכסים (דוגמניות, מרקמים) │ Server / # Server-side Data Assets בונה.gradle.kts המונחים:gradle.kts └──dle.properties manifest.json כל תוסף דורש manifest.json בשורש JAR. זה שווה ערך של Bukkit של plugin.yml: { שם הסרטון: "Com.yourname" שם הסרטון: YourPlugin Name "Main": "com.yourpelloin. YourPlugin" "Version": "1.0.0" "Description": "What your plugin does" שם הספר בלועזית: "Your Name" "ServerVersion": "*" "מכשולים": המונחים: "Load Before": "Disabled ByDefault": שקר "Includes AssetPack": שקר מזהה התוסף נוצר כ שם הקבוצה: (לדוגמה, com.yourname: YourPluginname). תגית: Main נקודות שדה לשיעור הכניסה שלך - קבל את זה לא נכון ואת התוסף לא לטעון. Plugin Lifecycle השיעור הראשי שלך משתרע JavaPelloin ויש לו ארבעה שלבים מחזור חיים: שיעור הציבור שלך Plugin מרחיב JavaPlugin { שם הסרטון: YourPlugin (@Nonnull JavaP Cloinit Init) סופר (init); GetLogger (info (Plugin) נבנה! } @Override טיהור ציבורי() { / / שלב 2: אירועי רישום, פקודות, מערכות ECS / / זהו המקום שבו רוב קוד הרישום שלך הולך } @Override התחלה חופשית () { / / שלב 3: Server מוכן לשחקנים / / התחל משימות מתוכננות, חיבורים פתוחים } @Override נפילה ציבורית () { / / שלב 4: ניקוי לפני שהשרת מפסיק / / לשמור נתונים, קשרים קרובים, ביטול משימות } PhaseMethod>> מה לעשות כאן 1. ConstructionConstructor>> המונחים: logging 2.setup()code>< אירועי רישום, פקודות, רכיבי ECS ומערכות 3.התחלstart()code>< התחל משימות, השרת מקבל שחקנים 4. Shutdownshutdown() לחסוך מידע, ניקוי משאבים מערכת האירועים הכפולה זהו הרעיון החשוב ביותר להבין. Hytale יש שתי מערכות אירועים נפרדות, ושימוש בשגוי הוא טעות נפוצה. אוטובוס - Global Server Events The EventBus מטפל באירועים שרתיים כמו חיבורי שחקנים, צ'אט וטעינה עולמית. מטפלים רשומים באמצעות Eventregistry המסופקים לתוסף שלך: @ Override טיהור ציבורי() { אירוע גלובלי סינכרוני המונחים:registerGlobal שחקן קוראי קורס, אירוע > GetLogger (info) ("Player הצטרף: " + אירוע } ); אירוע Async (כמו PlayerChatevent) המונחים:registerAsync(Global) שחקן צ'אט עתיד > עתיד. לאחר מכן Accept (event) אם (אפילוט.getMesage) { אירוע זה (נכון); } 1) } ); אירוע חזק אירועי אוטובוס: PlayConnectevent / PlayerDislinkevent> מקור החיים Playyevent שחקן טעון ומוכן לחלוטין PlayChatevent - הודעות צ'אט (async, cancellable) Add PlayerToworldevent - שחקן נכנס לעולם Startworldevent> AddWorldevent / RemoveWorld Event ניהול עולמי עדיפויות אירועים: השתמש EventPriority. EARLY לרוץ ראשון ולשנות אירועים לפני שמטפלים אחרים רואים אותם. השתמש EventPriority. LATE כדי לראות את המצב הסופי לאחר שכל מטפל אחר מעובד. ECS אירועים – Entity-Specific Actions אירועים ברמה גבוהה כגון שבירת בלוק, הצבת בלוקים, ונזקים מטופלים באמצעות מערכת Entity Component System, לא את EventBus. אתה יוצר Entity Event System: Public Class BlockBreakHandler Entity Event System < EntityStore, BreakBlock אירוע & gt; @Override המונחים: getQuery() { • ישויות מטרות עם רכיבים ספציפיים החזרת קווירי.Builder(); } @Override קטגוריה:BreakBlock Event > GeteventType { החזרה חוזרת BreakBlockevent } @Override חנות ללא טיפול (EntityStore) CommandBuffer buffer BreakBlock אירוע) / / עקבו אחרי Theblock Break / / ביטול בשלב המסנן, לא כאן } המונחים: רק לבטל את אירועי ECS במהלך שלב filter. ביטול בשלב הבדיקה אין השפעה כי הפעולה כבר קרה. Entity Component System (ECS) Hytale משתמשת באדריכלות ECS אישית. הבנה זו חיונית עבור כל תוסף שאינו טריביאלי. Core Concepts < Strong>Entity - רק מזהה ייחודי, אינו מכיל נתונים עצמם Component - מיכל נתונים טהור המחובר לישות System לוגיקה שמעבדת ישויות עם שילובים ספציפיים של רכיבים Ref - טיפול בטוח בישות (לעולם אל תקנו הפניות של ישות ישירה) Store - ניהול ישויות באמצעות Archetypes עבור פריסת זיכרון יעילה Custom Components שם מקור: Public Class Score הטמעת נתונים מקור: EntityStore > הציון הציבורי = 0 צוות החתירה הציבורי = " הציבור הצטרף At = System.currentMillis(); @Override קידוד נתונים ציבורי () { עותק נתונים = נתונים חדשים (); עותק.score = This.score העתק. צוות = זה העתק. הצטרף תגית: This.joined ב; החזרת עותק; } Components חייב ליישם clone(). לצרף אותם לגופים לאחסון נתונים מותאמים אישית - ציונים, קבוצות, קירור, ממציאים או כל מצב ספציפי למשחק. Understanding PlayerRef A "Player" ב Hytale אינה מחלקה מיוחדת - זו ישות המורכבת מרכיבים. PlayerRef הוא למעשה מרכיב שמאחסן את שם המשתמש של השחקן, UUID, שפה, מטפל רשת. הוא נשאר פעיל כל עוד השחקן מחובר. Command הרשמה Commands ליישם את ממשק Command: Class Spawn קומנדו @Override שם הספר בלועזית: "Fawn"; } @Override מוציא לאור (CommandSender Sender, String[עריכת קוד מקור] אם (שחקן שחקן) / / שחקן טלפורט כדי ליצור שלח.סendMesage (Teleporting to Destruction) } } } רישום בהקמה() Commandistry.registerCommand (New SpawnCommand); Both Player ו CommandSender תמיכה hasPermission() בדיקות. מערכת הרשאות המובנות תומכת הרשאות ברמת המשתמש, ירושה קבוצתית וכרטיסי בר התאמה. Build and Deploy Building /gradlew Build> הפלט JAR הולך Build/libs/.. Deployment Paths Platform Directory Windows (local)%AppData%/Roaming/Hytale/User Data/Mods/code> Server/opt/hytale/Server/mods/ עומס חם נתמך באופן חלקי לשינויים קטנים - השתמש Ctrl+F9 ב- Intellilili ג'יי לבנות מחדש ללא הפעלה מלאה. שינויים גדולים דורשים הפעלה מחדש של השרת. אפילוtregistry מנקה באופן אוטומטי מטפלים כאשר תוסף unloads. תשלום עבור CurseForge CurseForge מזהה שלושה סוגים: Packs - ערכות נכסים / תוכן (נתוני JSON, מודלים, מרקמים) Plugins - קבצי Java JAR באמצעות שרת API Plugins - תוספי איסוף המגפיים לטרנספורמציות ברמה נמוכה (advanced, השתמש בספאלי)> משאבים קהילתיים קהילת המודולינג בנתה תיעוד נרחב מעבר למה ש- Hypixel Studios מספק: ResourceFocus >HytaleModding.dev>>>>> מדריכים, docs, כלים - 8,000+ חברים בולטים Britakee Studios GitBookComprehensive נבדק הדרכות עבור Packs ו Plugins HytaleDocs.comCommunity wiki ו- API Hytale-Toolkit (GitHub)Decompiled Source, javadocs, חיפוש קוד סמנטי> פתח את השרת JAR כפרויקט IntelliJ הערה: השרת JAR אינו obfuscated והוא יכול להיות מחוספס בחופשיות. Hypixel Studios התחייבה לשחרר את קוד מקור השרת המלא בתוך 1-2 חודשים של השקת EA. What's Coming Server Source Code צפו ב-2026 Visual Scripting - תסריט מבוסס צומת עבור שאינם פרוגרמה (Similar to Unreal Blueprints)> < Strong>Development bouns - Hypixel Studios מתכננת להציע בורות לתרומות קהילתיות < Strong>Official Document הרחבה - הודה כבלתי שלם, הורחב על בסיס משוב קהילתי Ready כדי לפרוס את התוסף שלך? רשמו את השרת המודרך שלכם ב