Server setup video

Add one-click dedicated server scripts for Hytale F2P
- server/start.sh: Linux/macOS starter with auto-download, auto-update, F2P launcher detection (game files + bundled JRE), and token fetch - server/start.bat: Windows equivalent using PowerShell for JSON/UUID - server/README.md: Beginner-friendly guide with playit.gg networking - Remove obsolete server_scripts_2.zip Scripts auto-detect F2P launcher install (including custom installPath from config.json), copy game files locally if available, download missing files (HytaleServer.jar, Assets.zip, dualauth-agent.jar), and check for updates on every launch via ETag/GitHub releases API.
2026-02-26 10:31:47 -03:00 · 2026-02-23 01:02:16 +01:00 · 2026-02-23 00:55:38 +01:00 · 2026-02-22 23:00:08 +01:00 · 2026-02-22 21:58:25 +00:00 · 2026-02-22 19:25:01 +00:00
10 changed files with 1643 additions and 21 deletions
--- a/GUI/index.html
+++ b/GUI/index.html
@@ -8,9 +8,10 @@
    <link href="https://cdn.jsdelivr.net/npm/tailwindcss@2.2.19/dist/tailwind.min.css" rel="stylesheet">
    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.0.0/css/all.min.css">
    <link
-        href="https://fonts.googleapis.com/css2?family=Space+Grotesk:wght@300;400;500;600;700&family=JetBrains+Mono:wght@400;500;600;700&display=swap"
+        href="https://fonts.googleapis.com/css2?family=Space+Grotesk:wght@300;400;500;600;700&family=JetBrains+Mono:wght@400;500;600;700&family=Noto+Sans+Arabic:wght@300;400;500;600;700&display=swap"
        rel="stylesheet">
    <link rel="stylesheet" href="style.css">
+    <link rel="stylesheet" href="style-RTL.css">
 </head>

 <body class="bg-black text-white overflow-hidden font-sans select-none" tabindex="-1">
--- a/GUI/js/i18n.js
+++ b/GUI/js/i18n.js
@@ -12,9 +12,18 @@ const i18n = (() => {
    { code: 'ru-RU', name: 'Russian (Russia)' },
    { code: 'sv-SE', name: 'Swedish (Sweden)' },
    { code: 'tr-TR', name: 'Turkish (Turkey)' },
-    { code: 'id-ID', name: 'Indonesian (Indonesia)' }
+    { code: 'id-ID', name: 'Indonesian (Indonesia)' },
+    { code: 'ar-SA', name: 'Arabic (Saudi Arabia)' }
  ];

+    // RTL languages
+  const rtlLanguages = ['ar-SA'];
+  
+  // Check if current language is RTL
+  function isRTL() {
+    return rtlLanguages.includes(currentLang);
+  }
+
  // Load single language file
  async function loadLanguage(lang) {
    if (translations[lang]) return true;
@@ -73,6 +82,24 @@ const i18n = (() => {
      const key = el.getAttribute('data-i18n-title');
      el.title = t(key);
    });
+    // Update RTL layout
+    updateRTL();
+  }
+
+  // Update RTL layout
+  function updateRTL() {
+    const html = document.documentElement;
+    const body = document.body;
+    
+    if (isRTL()) {
+      html.setAttribute('dir', 'rtl');
+      html.setAttribute('lang', currentLang);
+      body.classList.add('rtl');
+    } else {
+      html.removeAttribute('dir');
+      html.setAttribute('lang', currentLang);
+      body.classList.remove('rtl');
+    }
  }

  // Initialize - load saved language only
@@ -88,7 +115,8 @@ const i18n = (() => {
    t,
    setLanguage,
    getAvailableLanguages: () => availableLanguages,
-    getCurrentLanguage: () => currentLang
+    getCurrentLanguage: () => currentLang,
+    isRTL
  };
 })();

--- a/GUI/locales/ar-SA.json
+++ b/GUI/locales/ar-SA.json
@@ -0,0 +1,257 @@
+{
+  "nav": {
+    "play": "لعب",
+    "mods": "المودات",
+    "news": "الأخبار",
+    "chat": "دردشة اللاعبين",
+    "settings": "الإعدادات"
+  },
+  "header": {
+    "playersLabel": "اللاعبون:",
+    "manageProfiles": "إدارة الملفات الشخصية",
+    "defaultProfile": "الافتراضي"
+  },
+  "install": {
+    "title": "مشغل اللعب المجاني",
+    "playerName": "اسم اللاعب",
+    "playerNamePlaceholder": "أدخل اسمك",
+    "gameBranch": "إصدار اللعبة",
+    "releaseVersion": "إصدار نهائي (مستقر)",
+    "preReleaseVersion": "إصدار تجريبي (تجريبي)",
+    "customInstallation": "تثبيت مخصص",
+    "installationFolder": "مجلد التثبيت",
+    "pathPlaceholder": "الموقع الافتراضي",
+    "browse": "تصفح",
+    "installButton": "تثبيت HYTALE",
+    "installing": "جاري التثبيت..."
+  },
+  "play": {
+    "ready": "جاهز للعب",
+    "subtitle": "شغل Hytale وابدأ المغامرة",
+    "playButton": "لعب HYTALE",
+    "latestNews": "آخر الأخبار",
+    "viewAll": "عرض الكل",
+    "checking": "جاري التحقق...",
+    "play": "بدء"
+  },
+  "mods": {
+    "searchPlaceholder": "البحث عن مودات...",
+    "myMods": "موداتي",
+    "previous": "السابق",
+    "next": "التالي",
+    "page": "صفحة",
+    "of": "من",
+    "modalTitle": "موداتي",
+    "noModsFound": "لم يتم العثور على مودات",
+    "noModsFoundDesc": "حاول تعديل معايير البحث",
+    "noModsInstalled": "لا توجد مودات مثبتة",
+    "noModsInstalledDesc": "أضف مودات من CurseForge أو استورد ملفات محلية",
+    "view": "عرض",
+    "install": "تثبيت",
+    "installed": "مثبت",
+    "enable": "تفعيل",
+    "disable": "تعطيل",
+    "active": "نشط",
+    "disabled": "معطل",
+    "delete": "حذف المود",
+    "noDescription": "لا يوجد وصف متاح",
+    "confirmDelete": "هل أنت متأكد أنك تريد حذف \"{name}\"؟",
+    "confirmDeleteDesc": "لا يمكن التراجع عن هذا الإجراء.",
+    "confirmDeletion": "تأكيد الحذف",
+    "apiKeyRequired": "مطلوب مفتاح API",
+    "apiKeyRequiredDesc": "مطلوب مفتاح CurseForge API لتصفح المودات"
+  },
+  "news": {
+    "title": "كل الأخبار",
+    "readMore": "اقرأ المزيد"
+  },
+  "chat": {
+    "title": "دردشة اللاعبين",
+    "pickColor": "اللون",
+    "inputPlaceholder": "اكتب رسالتك...",
+    "send": "إرسال",
+    "online": "متصل",
+    "charCounter": "{current}/{max}",
+    "secureChat": "دردشة آمنة - الروابط محجوبة",
+    "joinChat": "انضمام للدردشة",
+    "chooseUsername": "اختر اسم مستخدم للانضمام إلى دردشة اللاعبين",
+    "username": "اسم المستخدم",
+    "usernamePlaceholder": "أدخل اسم المستخدم...",
+    "usernameHint": "3-20 حرفاً، حروف، أرقام، و - و _ فقط",
+    "joinButton": "انضمام",
+    "colorModal": {
+      "title": "تخصيص لون اسم المستخدم",
+      "chooseSolid": "اختر لوناً ثابتاً:",
+      "customColor": "لون مخصص:",
+      "preview": "معاينة:",
+      "previewUsername": "اسم المستخدم",
+      "apply": "تطبيق اللون"
+    }
+  },
+  "settings": {
+    "title": "الإعدادات",
+    "java": "بيئة تشغيل جافا",
+    "useCustomJava": "استخدام مسار جافا مخصص",
+    "javaDescription": "تجاوز بيئة جافا المرفقة واستخدام تثبيت خاص بك",
+    "javaPath": "مسار ملف جافا التنفيذي",
+    "javaPathPlaceholder": "اختر مسار جافا...",
+    "javaBrowse": "تصفح",
+    "javaHint": "اختر مجلد تثبيت جافا (يدعم ويندوز، ماك، ولينكس)",
+    "discord": "تكامل ديسكورد",
+    "enableRPC": "تفعيل نشاط ديسكورد (Rich Presence)",
+    "discordDescription": "إظهار نشاط المشغل الخاص بك على ديسكورد",
+    "game": "خيارات اللعبة",
+    "playerName": "اسم اللاعب",
+    "playerNamePlaceholder": "أدخل اسم اللاعب",
+    "playerNameHint": "سيتم استخدام هذا الاسم داخل اللعبة (1-16 حرفاً)",
+    "openGameLocation": "فتح موقع اللعبة",
+    "openGameLocationDesc": "فتح مجلد تثبيت اللعبة",
+    "account": "إدارة UUID اللاعب",
+    "currentUUID": "الـ UUID الحالي",
+    "uuidPlaceholder": "جاري تحميل UUID...",
+    "copyUUID": "نسخ UUID",
+    "regenerateUUID": "إعادة إنشاء UUID",
+    "uuidHint": "معرف اللاعب الفريد الخاص بك لهذا الاسم",
+    "manageUUIDs": "إدارة جميع الـ UUIDs",
+    "manageUUIDsDesc": "عرض وإدارة جميع معرفات اللاعبين",
+    "language": "اللغة",
+    "selectLanguage": "اختر اللغة",
+    "repairGame": "إصلاح اللعبة",
+    "reinstallGame": "إعادة تثبيت ملفات اللعبة (يحفظ البيانات)",
+    "gpuPreference": "تفضيل معالج الرسوميات (GPU)",
+    "gpuHint": "ميزة للمحمول فقط؛ اضبطها على Integrated إذا كنت تستخدم كمبيوتر مكتبي",
+    "gpuAuto": "تلقائي",
+    "gpuIntegrated": "مدمج",
+    "gpuDedicated": "منفصل",
+    "logs": "سجلات النظام",
+    "logsCopy": "نسخ",
+    "logsRefresh": "تحديث",
+    "logsFolder": "فتح المجلد",
+    "logsLoading": "جاري تحميل السجلات...",
+    "closeLauncher": "سلوك المشغل",
+    "closeOnStart": "إغلاق المشغل عند بدء اللعبة",
+    "closeOnStartDescription": "إغلاق المشغل تلقائياً بعد تشغيل Hytale",
+    "hwAccel": "تسريع الأجهزة (Hardware Acceleration)",
+    "hwAccelDescription": "تفعيل تسريع الأجهزة للمشغل",
+    "gameBranch": "فرع اللعبة",
+    "branchRelease": "إصدار نهائي",
+    "branchPreRelease": "إصدار تجريبي",
+    "branchHint": "التبديل بين الإصدار المستقر والإصدار التجريبي",
+    "branchWarning": "تغيير الفرع سيؤدي إلى تحميل وتثبيت نسخة مختلفة من اللعبة",
+    "branchSwitching": "جاري التبديل إلى {branch}...",
+    "branchSwitched": "تم التبديل إلى {branch} بنجاح!",
+    "installRequired": "التثبيت مطلوب",
+    "branchInstallConfirm": "سيتم تثبيت اللعبة لفرع {branch}. هل تريد الاستمرار؟"
+  },
+  "uuid": {
+    "modalTitle": "إدارة UUID",
+    "currentUserUUID": "UUID المستخدم الحالي",
+    "allPlayerUUIDs": "جميع معرفات UUID للاعبين",
+    "generateNew": "إنشاء UUID جديد",
+    "loadingUUIDs": "جاري تحميل الـ UUIDs...",
+    "setCustomUUID": "تعيين UUID مخصص",
+    "customPlaceholder": "أدخل UUID مخصص (الصيغة: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)",
+    "setUUID": "تعيين UUID",
+    "warning": "تحذير: تعيين UUID مخصص سيغير هوية اللاعب الحالية",
+    "copyTooltip": "نسخ UUID",
+    "regenerateTooltip": "إنشاء UUID جديد"
+  },
+  "profiles": {
+    "modalTitle": "إدارة الملفات الشخصية",
+    "newProfilePlaceholder": "اسم الملف الشخصي الجديد",
+    "createProfile": "إنشاء ملف شخصي"
+  },
+  "discord": {
+    "notificationText": "انضم إلى مجتمعنا على ديسكورد!",
+    "joinButton": "انضم إلى ديسكورد"
+  },
+  "common": {
+    "confirm": "تأكيد",
+    "cancel": "إلغاء",
+    "save": "حفظ",
+    "close": "إغلاق",
+    "delete": "حذف",
+    "edit": "تعديل",
+    "loading": "جاري التحميل...",
+    "apply": "تطبيق",
+    "install": "تثبيت"
+  },
+  "notifications": {
+    "gameDataNotFound": "خطأ: لم يتم العثور على بيانات اللعبة",
+    "gameUpdatedSuccess": "تم تحديث اللعبة بنجاح! 🎉",
+    "updateFailed": "فشل التحديث: {error}",
+    "updateError": "خطأ في التحديث: {error}",
+    "discordEnabled": "تم تفعيل نشاط ديسكورد",
+    "discordDisabled": "تم تعطيل نشاط ديسكورد",
+    "discordSaveFailed": "فشل حفظ إعدادات ديسكورد",
+    "playerNameRequired": "يرجى إدخال اسم لاعب صالح",
+    "playerNameSaved": "تم حفظ اسم اللاعب بنجاح",
+    "playerNameSaveFailed": "فشل حفظ اسم اللاعب",
+    "uuidCopied": "تم نسخ الـ UUID إلى الحافظة!",
+    "uuidCopyFailed": "فشل نسخ الـ UUID",
+    "uuidRegenNotAvailable": "إعادة إنشاء UUID غير متاحة",
+    "uuidRegenFailed": "فشل إعادة إنشاء الـ UUID",
+    "uuidGenerated": "تم إنشاء UUID جديد بنجاح!",
+    "uuidGeneratedShort": "تم إنشاء UUID جديد!",
+    "uuidGenerateFailed": "فشل إنشاء UUID جديد",
+    "uuidRequired": "يرجى إدخال UUID",
+    "uuidInvalidFormat": "صيغة UUID غير صالحة",
+    "uuidSetFailed": "فشل تعيين الـ UUID المخصص",
+    "uuidSetSuccess": "تم تعيين الـ UUID المخصص بنجاح!",
+    "uuidDeleteFailed": "فشل حذف الـ UUID",
+    "uuidDeleteSuccess": "تم حذف الـ UUID بنجاح!",
+    "modsDownloading": "جاري تحميل {name}...",
+    "modsTogglingMod": "جاري تبديل حالة المود...",
+    "modsDeletingMod": "جاري حذف المود...",
+    "modsLoadingMods": "جاري تحميل المودات من CurseForge...",
+    "modsInstalledSuccess": "تم تثبيت {name} بنجاح! 🎉",
+    "modsDeletedSuccess": "تم حذف {name} بنجاح",
+    "modsDownloadFailed": "فشل تحميل المود: {error}",
+    "modsToggleFailed": "فشل تبديل المود: {error}",
+    "modsDeleteFailed": "فشل حذف المود: {error}",
+    "modsModNotFound": "لم يتم العثور على معلومات المود",
+    "hwAccelSaved": "تم حفظ إعداد تسريع الأجهزة",
+    "hwAccelSaveFailed": "فشل حفظ إعداد تسريع الأجهزة",
+    "noUsername": "لم يتم تهيئة اسم مستخدم. يرجى حفظ اسم المستخدم أولاً.",
+    "switchUsernameSuccess": "تم التبديل إلى المستخدم \"{username}\" بنجاح!",
+    "switchUsernameFailed": "فشل تبديل اسم المستخدم",
+    "playerNameTooLong": "يجب أن يكون اسم اللاعب 16 حرفاً أو أقل"
+  },
+  "confirm": {
+    "defaultTitle": "تأكيد الإجراء",
+    "regenerateUuidTitle": "إنشاء UUID جديد",
+    "regenerateUuidMessage": "هل أنت متأكد أنك تريد إنشاء UUID جديد؟ سيؤدي ذلك إلى تغيير هوية اللاعب الخاصة بك.",
+    "regenerateUuidButton": "إنشاء",
+    "setCustomUuidTitle": "تعيين UUID مخصص",
+    "setCustomUuidMessage": "هل أنت متأكد أنك تريد تعيين هذا الـ UUID المخصص؟ سيؤدي ذلك إلى تغيير هوية اللاعب الخاصة بك.",
+    "setCustomUuidButton": "تعيين UUID",
+    "deleteUuidTitle": "حذف UUID",
+    "deleteUuidMessage": "هل أنت متأكد أنك تريد حذف الـ UUID الخاص بـ \"{username}\"؟ لا يمكن التراجع عن هذا الإجراء.",
+    "deleteUuidButton": "حذف",
+    "uninstallGameTitle": "إلغاء تثبيت اللعبة",
+    "uninstallGameMessage": "هل أنت متأكد أنك تريد إلغاء تثبيت Hytale؟ سيتم حذف جميع ملفات اللعبة.",
+    "uninstallGameButton": "إلغاء التثبيت",
+    "switchUsernameTitle": "تبديل الهوية",
+    "switchUsernameMessage": "التبديل إلى اسم المستخدم \"{username}\"؟ سيؤدي هذا إلى تغيير هوية اللاعب الحالية.",
+    "switchUsernameButton": "تبديل"
+  },
+  "progress": {
+    "initializing": "جاري التهيئة...",
+    "downloading": "جاري التحميل...",
+    "installing": "جاري التثبيت...",
+    "extracting": "جاري الاستخراج...",
+    "verifying": "جاري التحقق...",
+    "switchingProfile": "جاري تبديل الملف الشخصي...",
+    "profileSwitched": "تم تبديل الملف الشخصي!",
+    "startingGame": "جاري بدء اللعبة...",
+    "launching": "جاري التشغيل...",
+    "uninstallingGame": "جاري إلغاء تثبيت اللعبة...",
+    "gameUninstalled": "تم إلغاء تثبيت اللعبة بنجاح!",
+    "uninstallFailed": "فشل إلغاء التثبيت: {error}",
+    "startingUpdate": "جاري بدء تحديث اللعبة الإجباري...",
+    "installationComplete": "تم اكتمال التثبيت بنجاح!",
+    "installationFailed": "فشل التثبيت: {error}",
+    "installingGameFiles": "جاري تثبيت ملفات اللعبة...",
+    "installComplete": "اكتمل التثبيت!"
+  }
+}
--- a/GUI/style-RTL.css
+++ b/GUI/style-RTL.css
@@ -0,0 +1,209 @@
+body.rtl {
+    direction: rtl;
+    font-family: 'Noto Sans Arabic', 'Space Grotesk', sans-serif;
+}
+
+body.rtl .sidebar {
+    right: 0;
+    left: auto;
+    border-right: none;
+    border-left: 1px solid rgba(255, 255, 255, 0.1);
+}
+
+body.rtl .nav-item.active::before {
+    right: -8px;
+    left: auto;
+    border-radius: 4px 0 0 4px;
+}
+
+body.rtl .nav-tooltip {
+    right: 100%;
+    left: auto;
+    margin-right: 0.5rem;
+    margin-left: 0;
+}
+
+body.rtl .nav-item:hover .nav-tooltip {
+    transform: translateX(-8px);
+}
+
+
+body.rtl .main-content {
+    margin-right: 80px;
+    margin-left: 0;
+}
+
+/* Header Layout*/
+
+body.rtl .players-counter {
+    order: 2;
+    margin-left: 1.5rem;
+    margin-right: 0;
+}
+
+body.rtl .profile-selector {
+    order: -1;
+}
+
+body.rtl .window-controls {
+    order: 3;
+    flex-direction: row;
+}
+
+body.rtl .profile-dropdown {
+    right: auto;
+    left: 0;
+}
+
+
+
+body.rtl .form-group {
+    text-align: right;
+}
+
+body.rtl .radio-label,
+body.rtl .checkbox-group {
+    flex-direction: row-reverse;
+}
+
+body.rtl .form-input {
+    border-radius: 0 8px 8px 0;
+}
+
+
+body.rtl .mods-pagination {
+    flex-direction: row-reverse;
+}
+
+body.rtl .pagination-btn:first-child i {
+    transform: rotate(180deg);
+}
+
+body.rtl .pagination-btn:last-child i {
+    transform: rotate(180deg);
+}
+
+/* UUID Display */
+
+body.rtl .uuid-display-container {
+    flex-direction: row-reverse;
+}
+
+body.rtl .uuid-btn {
+    border-radius: 0 8px 8px 0;
+}
+
+body.rtl .uuid-input {
+    border-radius: 8px 0 0 8px;
+}
+
+
+body.rtl .segmented-control {
+    flex-direction: row-reverse;
+}
+
+/*  Mod Grid Layout */
+body.rtl .mods-search {
+    text-align: right;
+}
+
+body.rtl .mods-search-container {
+    flex-direction: row-reverse;
+}
+
+body.rtl .mods-actions {
+    order: -1;
+}
+
+body.rtl .mod-card {
+    direction: rtl;
+}
+
+body.rtl .installed-mod-card {
+    direction: rtl;
+}
+
+body.rtl .installed-mod-card .mod-info {
+    text-align: right;
+}
+
+body.rtl .mods-header {
+    flex-direction: row-reverse;
+}
+
+body.rtl .news-section .news-header {
+    flex-direction: row-reverse;
+}
+
+/* Settings Layout */
+
+body.rtl .settings-option {
+    text-align: right;
+}
+
+body.rtl .settings-input-group {
+    text-align: right;
+}
+
+body.rtl .settings-input {
+    border-radius: 0 8px 8px 0;
+}
+
+body.rtl .settings-section-title i {
+    margin-right: 0;
+    margin-left: 0.5rem;
+}
+
+body.rtl .settings-hint i {
+    margin-right: 0;
+    margin-left: 0.5rem;
+}
+
+body.rtl .custom-options,
+body.rtl .custom-java-options {
+    text-align: right;
+}
+
+body.rtl .checkbox-content {
+    margin-right: 2rem;
+    margin-left: 0;
+}
+
+body.rtl .btn-content {
+    text-align: right;
+}
+
+/* Icons & Transformations */
+
+body.rtl .news-title i {
+    padding-left: 0.5rem;
+}
+body.rtl .uuid-modal-title i {
+    padding-left: 0.5rem;
+}
+body.rtl .mods-modal-title i {
+    padding-left: 0.5rem;
+}
+
+body.rtl .view-all-btn i,
+body.rtl .sidebar-nav div i,
+body.rtl .logs-header i,
+body.rtl .home-play-button i {
+    transform: scaleX(-1);
+}
+
+body.rtl .play-title i {
+    transform: scaleX(-1);
+    padding-right: 0.5rem;
+}
+
+
+body.rtl .logs-terminal {
+    direction: ltr;
+    text-align: left;
+}
+
+body.rtl .version-display-bottom {
+    right: auto;
+    left: 1rem;
+}
--- a/backend/services/versionManager.js
+++ b/backend/services/versionManager.js
@@ -7,16 +7,17 @@ const { getOS, getArch } = require('../utils/platformUtils');
 // Patches base URL fetched dynamically via multi-source fallback chain
 const AUTH_DOMAIN = process.env.HYTALE_AUTH_DOMAIN || 'auth.sanasol.ws';
 const PATCHES_CONFIG_SOURCES = [
-  { type: 'http', url: `https://${AUTH_DOMAIN}/api/patches-config`, name: 'auth-server' },
-  { type: 'http', url: 'https://htdwnldsan.top/patches-config', name: 'backup-http' },
+  { type: 'http', url: `https://${AUTH_DOMAIN}/api/patches-config`, name: 'primary' },
+  { type: 'http', url: 'https://htdwnldsan.top/patches-config', name: 'backup-1' },
+  { type: 'http', url: 'https://dl1.htdwnldsan.top/patches-config', name: 'backup-2' },
  { type: 'doh',  name: '_patches.htdwnldsan.top', name_label: 'dns-txt' },
 ];
 const HARDCODED_FALLBACK = 'https://dl.vboro.de/patches';

-// Non-Cloudflare mirrors for users where Cloudflare IPs are blocked (Russia, Ukraine, etc.)
-// These redirect to MEGA S3 which is not behind Cloudflare
+// Alternative mirrors (non-Cloudflare) for regions where CF is blocked
 const NON_CF_MIRRORS = [
-  'https://htdwnldsan.top/patches',   // Direct IP VPS → MEGA redirect
+  'https://dl1.htdwnldsan.top',
+  'https://htdwnldsan.top/patches',
 ];

 // Fallback: latest known build number if manifest is unreachable
--- a/backend/utils/clientPatcher.js
+++ b/backend/utils/clientPatcher.js
@@ -9,7 +9,9 @@ const MAX_DOMAIN_LENGTH = 16;

 // DualAuth ByteBuddy Agent (runtime class transformation, no JAR modification)
 const DUALAUTH_AGENT_URL = 'https://github.com/sanasol/hytale-auth-server/releases/latest/download/dualauth-agent.jar';
+const DUALAUTH_AGENT_VERSION_API = 'https://api.github.com/repos/sanasol/hytale-auth-server/releases/latest';
 const DUALAUTH_AGENT_FILENAME = 'dualauth-agent.jar';
+const DUALAUTH_AGENT_VERSION_FILE = 'dualauth-agent.version';

 function getTargetDomain() {
  if (process.env.HYTALE_AUTH_DOMAIN) {
@@ -511,30 +513,70 @@ class ClientPatcher {
   */
  async ensureAgentAvailable(serverDir, progressCallback) {
    const agentPath = this.getAgentPath(serverDir);
+    const versionPath = path.join(serverDir, DUALAUTH_AGENT_VERSION_FILE);

    console.log('=== DualAuth Agent (ByteBuddy) ===');
    console.log(`Target: ${agentPath}`);

-    // Check if agent already exists and is valid
+    // Check local version and whether file exists
+    let localVersion = null;
+    let agentExists = false;
    if (fs.existsSync(agentPath)) {
      try {
        const stats = fs.statSync(agentPath);
        if (stats.size > 1024) {
-          console.log(`DualAuth Agent present (${(stats.size / 1024).toFixed(0)} KB)`);
-          if (progressCallback) progressCallback('DualAuth Agent ready', 100);
-          return { success: true, agentPath, alreadyExists: true };
+          agentExists = true;
+          if (fs.existsSync(versionPath)) {
+            localVersion = fs.readFileSync(versionPath, 'utf8').trim();
+          }
+        } else {
+          console.log('Agent file appears corrupt, re-downloading...');
+          fs.unlinkSync(agentPath);
        }
-        // File exists but too small - corrupt, re-download
-        console.log('Agent file appears corrupt, re-downloading...');
-        fs.unlinkSync(agentPath);
      } catch (e) {
        console.warn('Could not check agent file:', e.message);
      }
    }

+    // Check for updates from GitHub
+    let remoteVersion = null;
+    let needsDownload = !agentExists;
+    if (agentExists) {
+      try {
+        if (progressCallback) progressCallback('Checking for agent updates...', 5);
+        const axios = require('axios');
+        const resp = await axios.get(DUALAUTH_AGENT_VERSION_API, {
+          timeout: 5000,
+          headers: { 'Accept': 'application/vnd.github.v3+json' }
+        });
+        remoteVersion = resp.data.tag_name; // e.g. "v1.1.10"
+        if (localVersion && localVersion === remoteVersion) {
+          console.log(`DualAuth Agent up to date (${localVersion})`);
+          if (progressCallback) progressCallback('DualAuth Agent ready', 100);
+          return { success: true, agentPath, alreadyExists: true, version: localVersion };
+        }
+        console.log(`Agent update available: ${localVersion || 'unknown'} → ${remoteVersion}`);
+        needsDownload = true;
+      } catch (e) {
+        // GitHub API failed - use existing agent if available
+        console.warn(`Could not check for updates: ${e.message}`);
+        if (agentExists) {
+          console.log(`Using existing agent (${localVersion || 'unknown version'})`);
+          if (progressCallback) progressCallback('DualAuth Agent ready', 100);
+          return { success: true, agentPath, alreadyExists: true, version: localVersion };
+        }
+      }
+    }
+
+    if (!needsDownload) {
+      if (progressCallback) progressCallback('DualAuth Agent ready', 100);
+      return { success: true, agentPath, alreadyExists: true, version: localVersion };
+    }
+
    // Download agent from GitHub releases
-    if (progressCallback) progressCallback('Downloading DualAuth Agent...', 20);
-    console.log(`Downloading from: ${DUALAUTH_AGENT_URL}`);
+    const action = agentExists ? 'Updating' : 'Downloading';
+    if (progressCallback) progressCallback(`${action} DualAuth Agent...`, 20);
+    console.log(`${action} from: ${DUALAUTH_AGENT_URL}`);

    try {
      // Ensure server directory exists
@@ -548,7 +590,7 @@ class ClientPatcher {
      const stream = await smartDownloadStream(DUALAUTH_AGENT_URL, (chunk, downloadedBytes, total) => {
        if (progressCallback && total) {
          const percent = 20 + Math.floor((downloadedBytes / total) * 70);
-          progressCallback(`Downloading agent... ${(downloadedBytes / 1024).toFixed(0)} KB`, percent);
+          progressCallback(`${action} agent... ${(downloadedBytes / 1024).toFixed(0)} KB`, percent);
        }
      });

@@ -575,9 +617,13 @@ class ClientPatcher {
      }
      fs.renameSync(tmpPath, agentPath);

-      console.log(`DualAuth Agent downloaded (${(stats.size / 1024).toFixed(0)} KB)`);
+      // Save version
+      const version = remoteVersion || 'unknown';
+      fs.writeFileSync(versionPath, version, 'utf8');
+
+      console.log(`DualAuth Agent ${agentExists ? 'updated' : 'downloaded'} (${(stats.size / 1024).toFixed(0)} KB, ${version})`);
      if (progressCallback) progressCallback('DualAuth Agent ready', 100);
-      return { success: true, agentPath };
+      return { success: true, agentPath, updated: agentExists, version };

    } catch (downloadError) {
      console.error(`Failed to download DualAuth Agent: ${downloadError.message}`);
@@ -586,6 +632,11 @@ class ClientPatcher {
      if (fs.existsSync(tmpPath)) {
        try { fs.unlinkSync(tmpPath); } catch (e) { /* ignore */ }
      }
+      // If we had an existing agent, still use it
+      if (agentExists) {
+        console.log('Using existing agent despite update failure');
+        return { success: true, agentPath, alreadyExists: true, version: localVersion };
+      }
      return { success: false, error: downloadError.message };
    }
  }
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
  "name": "hytale-f2p-launcher",
-  "version": "2.3.7",
+  "version": "2.3.8",
  "description": "A modern, cross-platform launcher for Hytale with automatic updates and multi-client support",
  "homepage": "https://git.sanhost.net/sanasol/hytale-f2p",
  "main": "main.js",
--- a/server/README.md
+++ b/server/README.md
@@ -0,0 +1,118 @@
+# Hytale F2P - Dedicated Server
+
+Host your own Hytale server. The scripts handle everything automatically.
+
+## Prerequisites
+
+- **Java 25+** — [Windows installer](https://download.oracle.com/java/25/latest/jdk-25_windows-x64_bin.exe) | [Other platforms](https://adoptium.net/)
+  - If you have the F2P launcher installed, its bundled Java will be used automatically
+- **Internet connection** for first launch (downloads ~3.5 GB of game files)
+  - If you have the F2P launcher installed, game files are copied locally (no download needed)
+
+## Video Guide
+
+[![Video Guide](https://img.youtube.com/vi/KvuXLH7SKvI/maxresdefault.jpg)](https://youtu.be/KvuXLH7SKvI)
+
+## Quick Start
+
+### Windows
+
+1. Download `start.bat` to an empty folder
+2. Double-click `start.bat`
+3. Done — server starts on port **5520**
+
+### Linux / macOS
+
+```bash
+mkdir hytale-server && cd hytale-server
+curl -O https://raw.githubusercontent.com/amiayweb/Hytale-F2P/develop/server/start.sh
+chmod +x start.sh
+./start.sh
+```
+
+## What the scripts do
+
+1. Search for the F2P launcher install (default paths + custom `installPath` from config)
+2. Use bundled Java from the launcher, or fall back to system Java (25+ required)
+3. Copy game files from the launcher install if available
+4. Download missing files: `HytaleServer.jar` (~150 MB), `Assets.zip` (~3.3 GB), `dualauth-agent.jar` (~5 MB)
+5. Check for updates on every launch (server, assets, and agent)
+6. Generate a persistent server ID
+7. Fetch authentication tokens
+8. Start the server with dual-auth support
+
+## Connecting
+
+- **Same PC**: Connect to `localhost:5520` or `127.0.0.1:5520`
+- **LAN**: Connect to your local IP (e.g. `192.168.1.x:5520`)
+- **Internet**: Forward port `5520` (TCP + UDP) on your router, friends connect to your public IP
+
+### No public IP? Use playit.gg (recommended)
+
+If you're behind CGNAT or can't port forward, [playit.gg](https://playit.gg) gives you a public address for free:
+
+1. Go to [playit.gg](https://playit.gg) and create an account
+2. Download and run the playit agent
+3. Create a tunnel — select **Hytale** as the game type, local port `5520`
+4. Share the generated address with friends (e.g. `something.joinplayit.gg:12345`)
+
+### Other options
+
+- [Radmin VPN](https://www.radmin-vpn.com/) — virtual LAN, all players must install it
+- [ZeroTier](https://www.zerotier.com/) — same idea, create a network, friends join and connect via VPN IP
+
+## Configuration
+
+Set environment variables before running the script:
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `SERVER_NAME` | `My Hytale Server` | Server name shown in listings |
+| `BIND_ADDRESS` | `0.0.0.0:5520` | IP and port to listen on |
+| `JVM_XMX` | *(Java default)* | Max memory (e.g. `4G`, `8G`) |
+| `JVM_XMS` | *(Java default)* | Initial memory |
+| `AUTH_MODE` | `authenticated` | Auth mode (`authenticated` or `none`) |
+| `HYTALE_AUTH_DOMAIN` | `auth.sanasol.ws` | Auth server domain |
+| `DOWNLOAD_BASE` | `https://download.sanasol.ws/download` | File download URL |
+
+**Example (Linux):**
+```bash
+SERVER_NAME="Epic Server" JVM_XMX=4G ./start.sh
+```
+
+**Example (Windows):**
+```cmd
+set SERVER_NAME=Epic Server
+set JVM_XMX=4G
+start.bat
+```
+
+## Files created
+
+```
+your-folder/
+├── start.sh / start.bat     # Startup script
+├── HytaleServer.jar          # Game server (auto-downloaded)
+├── Assets.zip                 # Game assets (auto-downloaded)
+├── dualauth-agent.jar         # Auth agent (auto-downloaded)
+├── .server-id                 # Persistent server UUID
+├── .versions/                 # Version tracking for auto-updates
+├── Server/                    # Server data (created by server)
+│   ├── config.json
+│   └── worlds/
+└── UserData/                  # Player saves
+```
+
+## Troubleshooting
+
+| Problem | Solution |
+|---------|----------|
+| `java not found` | Install the F2P launcher (includes Java) or install Java 25+ from [adoptium.net](https://adoptium.net/) |
+| Download fails | Check internet connection. Files can be downloaded manually from `https://download.sanasol.ws/download/` |
+| Port already in use | Change port: `BIND_ADDRESS=0.0.0.0:5521 ./start.sh` |
+| Out of memory | Set more RAM: `JVM_XMX=4G ./start.sh` |
+| Friends can't connect | Forward port 5520 (TCP+UDP) on your router, or use [playit.gg](https://playit.gg) if you can't port forward |
+
+## Discord
+
+Need help? Join the community: https://discord.gg/Fhbb9Yk5WW
--- a/server/start.bat
+++ b/server/start.bat
@@ -0,0 +1,441 @@
+@echo off
+setlocal enabledelayedexpansion
+
+:: ============================================================
+:: Hytale F2P Dedicated Server - One-Click Starter
+:: ============================================================
+:: Just double-click this file to start your server!
+::
+:: The script will:
+::   1. Look for game files and Java in your F2P launcher install
+::   2. Auto-download anything missing
+::   3. Auto-update server, assets, and agent on each launch
+::   4. Fetch auth tokens and start the server
+:: ============================================================
+
+:: Configuration (edit these or set as environment variables)
+if not defined HYTALE_AUTH_DOMAIN set "HYTALE_AUTH_DOMAIN=auth.sanasol.ws"
+if not defined AUTH_SERVER set "AUTH_SERVER=https://%HYTALE_AUTH_DOMAIN%"
+if not defined SERVER_NAME set "SERVER_NAME=My Hytale Server"
+if not defined ASSETS_PATH set "ASSETS_PATH=.\Assets.zip"
+if not defined BIND_ADDRESS set "BIND_ADDRESS=0.0.0.0:5520"
+if not defined AUTH_MODE set "AUTH_MODE=authenticated"
+if not defined DOWNLOAD_BASE set "DOWNLOAD_BASE=https://download.sanasol.ws/download"
+
+:: File names
+set "AGENT_JAR=dualauth-agent.jar"
+set "SERVER_JAR=HytaleServer.jar"
+set "AGENT_URL=https://github.com/sanasol/hytale-auth-server/releases/latest/download/dualauth-agent.jar"
+set "AGENT_VERSION_API=https://api.github.com/repos/sanasol/hytale-auth-server/releases/latest"
+set "VERSION_DIR=.versions"
+
+echo ============================================================
+echo   Hytale F2P Dedicated Server
+echo ============================================================
+echo.
+
+:: --- Prerequisite Checks ---
+
+where curl >nul 2>&1
+if errorlevel 1 (
+    echo [ERROR] curl is required but not found
+    echo [ERROR] curl comes with Windows 10+. Update Windows or install curl.
+    pause
+    exit /b 1
+)
+
+if not exist "%VERSION_DIR%" mkdir "%VERSION_DIR%"
+
+:: --- Find Local F2P Launcher Install ---
+
+set "F2P_DIR="
+set "F2P_BASE=%USERPROFILE%\AppData\Local\HytaleF2P"
+set "F2P_CONFIG=%F2P_BASE%\config.json"
+set "JAVA_CMD=java"
+
+:: Check config.json for custom installPath
+set "F2P_CUSTOM_BASE="
+if exist "%F2P_CONFIG%" (
+    for /f "delims=" %%p in ('powershell -Command "try { $c = Get-Content '%F2P_CONFIG%' | ConvertFrom-Json; if ($c.installPath) { $c.installPath.Trim() + '\HytaleF2P' } } catch {}" 2^>nul') do (
+        set "F2P_CUSTOM_BASE=%%p"
+    )
+)
+
+:: Search for game files: custom path first, then default
+if defined F2P_CUSTOM_BASE (
+    if exist "!F2P_CUSTOM_BASE!\release\package\game\latest" (
+        set "F2P_DIR=!F2P_CUSTOM_BASE!\release\package\game\latest"
+    ) else if exist "!F2P_CUSTOM_BASE!\pre-release\package\game\latest" (
+        set "F2P_DIR=!F2P_CUSTOM_BASE!\pre-release\package\game\latest"
+    )
+)
+
+if not defined F2P_DIR (
+    if exist "%F2P_BASE%\release\package\game\latest" (
+        set "F2P_DIR=%F2P_BASE%\release\package\game\latest"
+    ) else if exist "%F2P_BASE%\pre-release\package\game\latest" (
+        set "F2P_DIR=%F2P_BASE%\pre-release\package\game\latest"
+    )
+)
+
+:: --- Find Java from F2P launcher ---
+
+:: Check config.json for custom javaPath
+if exist "%F2P_CONFIG%" (
+    for /f "delims=" %%j in ('powershell -Command "try { $c = Get-Content '%F2P_CONFIG%' | ConvertFrom-Json; if ($c.javaPath -and (Test-Path $c.javaPath)) { $c.javaPath.Trim() } } catch {}" 2^>nul') do (
+        set "JAVA_CMD=%%j"
+        echo [INFO] Found Java in F2P config: %%j
+    )
+)
+
+:: Check bundled JRE if no custom javaPath found
+if "!JAVA_CMD!"=="java" (
+    set "F2P_JRE_BASE="
+    if defined F2P_CUSTOM_BASE (
+        if exist "!F2P_CUSTOM_BASE!\release\package\jre\latest\bin\java.exe" (
+            set "F2P_JRE_BASE=!F2P_CUSTOM_BASE!\release\package\jre\latest"
+        ) else if exist "!F2P_CUSTOM_BASE!\pre-release\package\jre\latest\bin\java.exe" (
+            set "F2P_JRE_BASE=!F2P_CUSTOM_BASE!\pre-release\package\jre\latest"
+        )
+    )
+    if not defined F2P_JRE_BASE (
+        if exist "%F2P_BASE%\release\package\jre\latest\bin\java.exe" (
+            set "F2P_JRE_BASE=%F2P_BASE%\release\package\jre\latest"
+        ) else if exist "%F2P_BASE%\pre-release\package\jre\latest\bin\java.exe" (
+            set "F2P_JRE_BASE=%F2P_BASE%\pre-release\package\jre\latest"
+        )
+    )
+    if defined F2P_JRE_BASE (
+        set "JAVA_CMD=!F2P_JRE_BASE!\bin\java.exe"
+        echo [INFO] Found Java in F2P launcher: !JAVA_CMD!
+    )
+)
+
+:: Verify java exists
+"!JAVA_CMD!" -version >nul 2>&1
+if errorlevel 1 (
+    where java >nul 2>&1
+    if errorlevel 1 (
+        echo [ERROR] Java is not installed and no F2P launcher JRE found
+        echo.
+        echo   Options:
+        echo     1. Install the F2P launcher first ^(it includes Java^)
+        echo     2. Download Java 25: https://download.oracle.com/java/25/latest/jdk-25_windows-x64_bin.exe
+        echo.
+        pause
+        exit /b 1
+    )
+    set "JAVA_CMD=java"
+)
+
+:: Check Java version
+for /f "tokens=3 delims= " %%v in ('"!JAVA_CMD!" -version 2^>^&1 ^| findstr /i "version"') do (
+    set "JAVA_VER_RAW=%%~v"
+)
+if defined JAVA_VER_RAW (
+    for /f "tokens=1 delims=." %%m in ("!JAVA_VER_RAW!") do set "JAVA_MAJOR=%%m"
+)
+
+echo [INFO] Java: !JAVA_VER_RAW! ^(!JAVA_CMD!^)
+
+if defined JAVA_MAJOR (
+    if !JAVA_MAJOR! LSS 25 (
+        echo [ERROR] Java !JAVA_MAJOR! detected. Java 25+ is REQUIRED.
+        echo         The DualAuth agent requires Java 25 ^(class file version 69^).
+        echo.
+        echo   Download Java 25: https://download.oracle.com/java/25/latest/jdk-25_windows-x64_bin.exe
+        echo.
+        pause
+        exit /b 1
+    )
+)
+
+:: --- Copy game files from F2P install ---
+
+if defined F2P_DIR (
+    echo [INFO] Found F2P launcher game files: !F2P_DIR!
+
+    if not exist "%SERVER_JAR%" (
+        if exist "!F2P_DIR!\Server\HytaleServer.jar" (
+            echo [INFO] Found HytaleServer.jar in F2P launcher
+            echo [INFO]   Copying from: !F2P_DIR!\Server\HytaleServer.jar
+            copy "!F2P_DIR!\Server\HytaleServer.jar" "%SERVER_JAR%" >nul
+            echo [INFO]   Copied successfully
+        )
+    )
+
+    if not exist "%ASSETS_PATH%" (
+        if exist "!F2P_DIR!\Assets.zip" (
+            echo [INFO] Found Assets.zip in F2P launcher
+            echo [INFO]   Copying from: !F2P_DIR!\Assets.zip
+            copy "!F2P_DIR!\Assets.zip" "%ASSETS_PATH%" >nul
+            echo [INFO]   Copied successfully
+        )
+    )
+
+    echo.
+) else (
+    echo [INFO] No F2P launcher install found, will download files
+    echo.
+)
+
+:: --- Download / Update HytaleServer.jar ---
+
+set "JAR_URL=%DOWNLOAD_BASE%/HytaleServer.jar"
+set "JAR_VERSION_FILE=%VERSION_DIR%\HytaleServer.jar.version"
+
+if not exist "%SERVER_JAR%" (
+    echo [INFO] HytaleServer.jar not found, downloading...
+    echo [INFO]   Expected size: ~150 MB
+    curl -fL --progress-bar -o "%SERVER_JAR%.tmp" "%JAR_URL%" --connect-timeout 15 --max-time 3600
+    if exist "%SERVER_JAR%.tmp" (
+        move /y "%SERVER_JAR%.tmp" "%SERVER_JAR%" >nul
+        echo [INFO] HytaleServer.jar downloaded
+        for /f "delims=" %%h in ('powershell -Command "try { (Invoke-WebRequest -Uri '%JAR_URL%' -Method Head -UseBasicParsing).Headers['ETag'] } catch {}" 2^>nul') do (
+            echo %%h>"%JAR_VERSION_FILE%"
+        )
+    ) else (
+        echo [ERROR] Failed to download HytaleServer.jar
+        echo [ERROR] Check your internet connection
+        pause
+        exit /b 1
+    )
+) else (
+    echo [INFO] Checking for HytaleServer.jar updates...
+    set "LOCAL_JAR_VER="
+    if exist "%JAR_VERSION_FILE%" set /p LOCAL_JAR_VER=<"%JAR_VERSION_FILE%"
+
+    set "REMOTE_JAR_VER="
+    for /f "delims=" %%h in ('powershell -Command "try { (Invoke-WebRequest -Uri '%JAR_URL%' -Method Head -UseBasicParsing -TimeoutSec 10).Headers['ETag'] } catch { '' }" 2^>nul') do (
+        set "REMOTE_JAR_VER=%%h"
+    )
+
+    if defined REMOTE_JAR_VER (
+        if "!LOCAL_JAR_VER!"=="!REMOTE_JAR_VER!" (
+            echo [INFO] HytaleServer.jar is up to date
+        ) else (
+            echo [INFO] HytaleServer.jar update available, downloading...
+            curl -fL --progress-bar -o "%SERVER_JAR%.tmp" "%JAR_URL%" --connect-timeout 15 --max-time 3600
+            if exist "%SERVER_JAR%.tmp" (
+                move /y "%SERVER_JAR%.tmp" "%SERVER_JAR%" >nul
+                echo !REMOTE_JAR_VER!>"%JAR_VERSION_FILE%"
+                echo [INFO] HytaleServer.jar updated
+            ) else (
+                echo [WARN] Update failed, using existing HytaleServer.jar
+            )
+        )
+    ) else (
+        echo [INFO] Could not check for updates, using existing HytaleServer.jar
+    )
+)
+
+:: --- Download / Update Assets.zip ---
+
+set "ASSETS_URL=%DOWNLOAD_BASE%/Assets.zip"
+set "ASSETS_VERSION_FILE=%VERSION_DIR%\Assets.zip.version"
+
+if not exist "%ASSETS_PATH%" (
+    echo [INFO] Assets.zip not found, downloading...
+    echo [INFO]   Expected size: ~3.3 GB - this will take a while
+    curl -fL --progress-bar -o "%ASSETS_PATH%.tmp" "%ASSETS_URL%" --connect-timeout 15 --max-time 7200
+    if exist "%ASSETS_PATH%.tmp" (
+        move /y "%ASSETS_PATH%.tmp" "%ASSETS_PATH%" >nul
+        echo [INFO] Assets.zip downloaded
+        for /f "delims=" %%h in ('powershell -Command "try { (Invoke-WebRequest -Uri '%ASSETS_URL%' -Method Head -UseBasicParsing).Headers['ETag'] } catch {}" 2^>nul') do (
+            echo %%h>"%ASSETS_VERSION_FILE%"
+        )
+    ) else (
+        echo [ERROR] Failed to download Assets.zip
+        echo [ERROR] Check your internet connection
+        pause
+        exit /b 1
+    )
+) else (
+    echo [INFO] Checking for Assets.zip updates...
+    set "LOCAL_ASSETS_VER="
+    if exist "%ASSETS_VERSION_FILE%" set /p LOCAL_ASSETS_VER=<"%ASSETS_VERSION_FILE%"
+
+    set "REMOTE_ASSETS_VER="
+    for /f "delims=" %%h in ('powershell -Command "try { (Invoke-WebRequest -Uri '%ASSETS_URL%' -Method Head -UseBasicParsing -TimeoutSec 10).Headers['ETag'] } catch { '' }" 2^>nul') do (
+        set "REMOTE_ASSETS_VER=%%h"
+    )
+
+    if defined REMOTE_ASSETS_VER (
+        if "!LOCAL_ASSETS_VER!"=="!REMOTE_ASSETS_VER!" (
+            echo [INFO] Assets.zip is up to date
+        ) else (
+            echo [INFO] Assets.zip update available, downloading...
+            echo [INFO]   This is a large file ^(~3.3 GB^), please be patient
+            curl -fL --progress-bar -o "%ASSETS_PATH%.tmp" "%ASSETS_URL%" --connect-timeout 15 --max-time 7200
+            if exist "%ASSETS_PATH%.tmp" (
+                move /y "%ASSETS_PATH%.tmp" "%ASSETS_PATH%" >nul
+                echo !REMOTE_ASSETS_VER!>"%ASSETS_VERSION_FILE%"
+                echo [INFO] Assets.zip updated
+            ) else (
+                echo [WARN] Update failed, using existing Assets.zip
+            )
+        )
+    ) else (
+        echo [INFO] Could not check for updates, using existing Assets.zip
+    )
+)
+
+:: --- Download / Update DualAuth Agent ---
+
+set "AGENT_VERSION_FILE=%VERSION_DIR%\dualauth-agent.jar.version"
+
+if not exist "%AGENT_JAR%" (
+    echo [INFO] Downloading DualAuth Agent...
+    curl -fL -# -o "%AGENT_JAR%.tmp" "%AGENT_URL%" --connect-timeout 15 --max-time 120
+    if exist "%AGENT_JAR%.tmp" (
+        move /y "%AGENT_JAR%.tmp" "%AGENT_JAR%" >nul
+        echo [INFO] DualAuth Agent downloaded
+        for /f "delims=" %%v in ('powershell -Command "try { $r = Invoke-RestMethod -Uri '%AGENT_VERSION_API%' -TimeoutSec 10; $r.tag_name } catch { '' }" 2^>nul') do (
+            echo %%v>"%AGENT_VERSION_FILE%"
+        )
+    ) else (
+        echo [ERROR] Failed to download DualAuth Agent
+        echo [ERROR] Download manually: %AGENT_URL%
+        pause
+        exit /b 1
+    )
+) else (
+    echo [INFO] Checking for DualAuth Agent updates...
+    set "LOCAL_AGENT_VER="
+    if exist "%AGENT_VERSION_FILE%" set /p LOCAL_AGENT_VER=<"%AGENT_VERSION_FILE%"
+
+    set "REMOTE_AGENT_VER="
+    for /f "delims=" %%v in ('powershell -Command "try { $r = Invoke-RestMethod -Uri '%AGENT_VERSION_API%' -TimeoutSec 10; $r.tag_name } catch { '' }" 2^>nul') do (
+        set "REMOTE_AGENT_VER=%%v"
+    )
+
+    if defined REMOTE_AGENT_VER (
+        if "!LOCAL_AGENT_VER!"=="!REMOTE_AGENT_VER!" (
+            echo [INFO] DualAuth Agent up to date ^(!LOCAL_AGENT_VER!^)
+        ) else (
+            echo [INFO] Agent update: !LOCAL_AGENT_VER! -^> !REMOTE_AGENT_VER!
+            curl -fL -# -o "%AGENT_JAR%.tmp" "%AGENT_URL%" --connect-timeout 15 --max-time 120
+            if exist "%AGENT_JAR%.tmp" (
+                move /y "%AGENT_JAR%.tmp" "%AGENT_JAR%" >nul
+                echo !REMOTE_AGENT_VER!>"%AGENT_VERSION_FILE%"
+                echo [INFO] DualAuth Agent updated
+            ) else (
+                echo [WARN] Agent update failed, using existing
+            )
+        )
+    ) else (
+        echo [INFO] Could not check agent updates, using existing
+    )
+)
+
+:: --- Final Checks ---
+
+if not exist "%SERVER_JAR%" (
+    echo [ERROR] HytaleServer.jar not found
+    pause
+    exit /b 1
+)
+if not exist "%ASSETS_PATH%" (
+    echo [ERROR] Assets.zip not found
+    pause
+    exit /b 1
+)
+if not exist "%AGENT_JAR%" (
+    echo [ERROR] dualauth-agent.jar not found
+    pause
+    exit /b 1
+)
+
+:: --- Generate or Load Server ID ---
+
+set "SERVER_ID_FILE=.server-id"
+if exist "%SERVER_ID_FILE%" (
+    set /p SERVER_ID=<"%SERVER_ID_FILE%"
+    echo [INFO] Server ID: !SERVER_ID!
+) else (
+    for /f "delims=" %%i in ('powershell -Command "[guid]::NewGuid().ToString()"') do set "SERVER_ID=%%i"
+    echo !SERVER_ID!>"%SERVER_ID_FILE%"
+    echo [INFO] Generated server ID: !SERVER_ID!
+)
+
+:: --- Fetch Server Tokens ---
+
+echo.
+echo [INFO] Fetching server tokens from %AUTH_SERVER%...
+
+set "TEMP_RESPONSE=%TEMP%\hytale_auth_%RANDOM%.json"
+
+curl -s -X POST "%AUTH_SERVER%/server/auto-auth" ^
+    -H "Content-Type: application/json" ^
+    -d "{\"server_id\": \"!SERVER_ID!\", \"server_name\": \"%SERVER_NAME%\"}" ^
+    --connect-timeout 10 ^
+    --max-time 30 ^
+    -o "%TEMP_RESPONSE%" 2>nul
+
+if errorlevel 1 (
+    echo [ERROR] Failed to connect to auth server at %AUTH_SERVER%
+    del "%TEMP_RESPONSE%" 2>nul
+    pause
+    exit /b 1
+)
+
+findstr /C:"sessionToken" "%TEMP_RESPONSE%" >nul 2>&1
+if errorlevel 1 (
+    echo [ERROR] Invalid response from auth server:
+    type "%TEMP_RESPONSE%"
+    del "%TEMP_RESPONSE%" 2>nul
+    pause
+    exit /b 1
+)
+
+:: Extract tokens using PowerShell
+for /f "delims=" %%i in ('powershell -Command "$j = Get-Content '%TEMP_RESPONSE%' | ConvertFrom-Json; $j.sessionToken"') do set "SESSION_TOKEN=%%i"
+for /f "delims=" %%i in ('powershell -Command "$j = Get-Content '%TEMP_RESPONSE%' | ConvertFrom-Json; $j.identityToken"') do set "IDENTITY_TOKEN=%%i"
+
+del "%TEMP_RESPONSE%" 2>nul
+
+if "!SESSION_TOKEN!"=="" (
+    echo [ERROR] Could not extract session token from response
+    pause
+    exit /b 1
+)
+if "!IDENTITY_TOKEN!"=="" (
+    echo [ERROR] Could not extract identity token from response
+    pause
+    exit /b 1
+)
+
+echo [INFO] Tokens received successfully
+
+:: --- Start Server ---
+
+set "JAVA_ARGS="
+if defined JVM_XMS set "JAVA_ARGS=!JAVA_ARGS! -Xms%JVM_XMS%"
+if defined JVM_XMX set "JAVA_ARGS=!JAVA_ARGS! -Xmx%JVM_XMX%"
+
+echo.
+echo ============================================================
+echo   Starting Hytale Server
+echo   Name:    %SERVER_NAME%
+echo   Bind:    %BIND_ADDRESS%
+echo   Java:    !JAVA_CMD!
+echo   Agent:   %AGENT_JAR%
+echo ============================================================
+echo.
+
+"!JAVA_CMD!" %JAVA_ARGS% -javaagent:"%AGENT_JAR%" -jar "%SERVER_JAR%" ^
+    --assets "%ASSETS_PATH%" ^
+    --bind "%BIND_ADDRESS%" ^
+    --auth-mode "%AUTH_MODE%" ^
+    --disable-sentry ^
+    --session-token "!SESSION_TOKEN!" ^
+    --identity-token "!IDENTITY_TOKEN!" ^
+    %*
+
+echo.
+echo ============================================================
+echo   Server stopped. Exit code: %ERRORLEVEL%
+echo ============================================================
+pause
+
+endlocal
--- a/server/start.sh
+++ b/server/start.sh
@@ -0,0 +1,516 @@
+#!/bin/bash
+# ============================================================
+# Hytale F2P Dedicated Server - One-Click Starter
+# ============================================================
+# Just run: ./start.sh
+#
+# The script will:
+#   1. Look for game files in your F2P launcher install
+#   2. Auto-download anything missing
+#   3. Auto-update server, assets, and agent on each launch
+#   4. Fetch auth tokens and start the server
+# ============================================================
+
+set -e
+
+# Configuration (edit these or set as environment variables)
+HYTALE_AUTH_DOMAIN="${HYTALE_AUTH_DOMAIN:-auth.sanasol.ws}"
+AUTH_SERVER="${AUTH_SERVER:-https://$HYTALE_AUTH_DOMAIN}"
+SERVER_NAME="${SERVER_NAME:-My Hytale Server}"
+BIND_ADDRESS="${BIND_ADDRESS:-0.0.0.0:5520}"
+AUTH_MODE="${AUTH_MODE:-authenticated}"
+
+# Download URLs
+DOWNLOAD_BASE="${DOWNLOAD_BASE:-https://download.sanasol.ws/download}"
+AGENT_URL="https://github.com/sanasol/hytale-auth-server/releases/latest/download/dualauth-agent.jar"
+AGENT_VERSION_API="https://api.github.com/repos/sanasol/hytale-auth-server/releases/latest"
+
+# File names (in current directory)
+AGENT_JAR="dualauth-agent.jar"
+SERVER_JAR="HytaleServer.jar"
+ASSETS_FILE="Assets.zip"
+ASSETS_PATH="${ASSETS_PATH:-./Assets.zip}"
+VERSION_DIR=".versions"
+
+echo "============================================================"
+echo "  Hytale F2P Dedicated Server"
+echo "============================================================"
+echo ""
+
+# --- Prerequisite Checks ---
+
+if ! command -v curl &>/dev/null; then
+    echo "[ERROR] curl is required but not found"
+    echo "        Install: sudo apt install curl"
+    exit 1
+fi
+
+mkdir -p "$VERSION_DIR"
+
+# --- Find Local F2P Launcher Install ---
+
+get_f2p_default_dir() {
+    case "$(uname -s)" in
+        Darwin) echo "$HOME/Library/Application Support/HytaleF2P" ;;
+        Linux)  echo "$HOME/.hytalef2p" ;;
+        *)      return 1 ;;
+    esac
+}
+
+# Read a JSON string field from config.json using available tools
+read_config_field() {
+    local config_file="$1" field="$2"
+    if [ ! -f "$config_file" ]; then return 1; fi
+
+    if command -v python3 &>/dev/null; then
+        python3 -c "
+import json
+try:
+    c = json.load(open('$config_file'))
+    v = c.get('$field', '').strip()
+    if v: print(v)
+except: pass
+" 2>/dev/null
+    elif command -v jq &>/dev/null; then
+        jq -r ".$field // empty" "$config_file" 2>/dev/null
+    else
+        grep -o "\"$field\"[[:space:]]*:[[:space:]]*\"[^\"]*\"" "$config_file" 2>/dev/null | cut -d'"' -f4
+    fi
+}
+
+find_f2p_install() {
+    local default_app_dir
+    default_app_dir=$(get_f2p_default_dir) || return 1
+
+    local search_dirs=()
+
+    # Check config.json for custom installPath
+    local config_file="$default_app_dir/config.json"
+    local custom_path
+    custom_path=$(read_config_field "$config_file" "installPath")
+    if [ -n "$custom_path" ]; then
+        local custom_f2p="$custom_path/HytaleF2P"
+        if [ -d "$custom_f2p" ]; then
+            search_dirs+=("$custom_f2p")
+        fi
+    fi
+
+    # Always also check default location
+    search_dirs+=("$default_app_dir")
+
+    for base in "${search_dirs[@]}"; do
+        for branch in "release" "pre-release"; do
+            local game_dir="$base/$branch/package/game/latest"
+            if [ -d "$game_dir" ]; then
+                echo "$game_dir"
+                return 0
+            fi
+        done
+    done
+    return 1
+}
+
+# Find bundled JRE from F2P launcher install
+find_f2p_java() {
+    local default_app_dir
+    default_app_dir=$(get_f2p_default_dir) || return 1
+
+    local search_dirs=()
+
+    # Check config.json for custom javaPath first
+    local config_file="$default_app_dir/config.json"
+    local custom_java
+    custom_java=$(read_config_field "$config_file" "javaPath")
+    if [ -n "$custom_java" ] && [ -x "$custom_java" ]; then
+        echo "$custom_java"
+        return 0
+    fi
+
+    # Check custom installPath
+    local custom_path
+    custom_path=$(read_config_field "$config_file" "installPath")
+    if [ -n "$custom_path" ]; then
+        local custom_f2p="$custom_path/HytaleF2P"
+        [ -d "$custom_f2p" ] && search_dirs+=("$custom_f2p")
+    fi
+
+    search_dirs+=("$default_app_dir")
+
+    for base in "${search_dirs[@]}"; do
+        for branch in "release" "pre-release"; do
+            local jre_dir="$base/$branch/package/jre/latest"
+            # Standard path
+            if [ -x "$jre_dir/bin/java" ]; then
+                echo "$jre_dir/bin/java"
+                return 0
+            fi
+            # macOS bundle path
+            if [ -x "$jre_dir/Contents/Home/bin/java" ]; then
+                echo "$jre_dir/Contents/Home/bin/java"
+                return 0
+            fi
+        done
+    done
+    return 1
+}
+
+copy_from_f2p() {
+    local file="$1" local_path="$2" f2p_path="$3"
+
+    if [ -f "$local_path" ]; then
+        return 1  # Already exists locally
+    fi
+
+    if [ -f "$f2p_path" ]; then
+        echo "[INFO] Found $file in F2P launcher install"
+        echo "[INFO]   Copying from: $f2p_path"
+        cp "$f2p_path" "$local_path"
+        echo "[INFO]   Copied successfully"
+        return 0
+    fi
+    return 1
+}
+
+# --- Detect Java ---
+
+JAVA_CMD="java"
+
+# Try F2P bundled JRE first
+F2P_JAVA=$(find_f2p_java 2>/dev/null) || true
+if [ -n "$F2P_JAVA" ]; then
+    echo "[INFO] Found Java in F2P launcher: $F2P_JAVA"
+    JAVA_CMD="$F2P_JAVA"
+elif ! command -v java &>/dev/null; then
+    echo "[ERROR] Java is not installed and no F2P launcher JRE found"
+    echo ""
+    echo "  Options:"
+    echo "    1. Install the F2P launcher first (it includes Java)"
+    echo "    2. Install Java 25+ manually:"
+    echo "       Windows:       https://download.oracle.com/java/25/latest/jdk-25_windows-x64_bin.exe"
+    echo "       macOS:         brew install openjdk"
+    echo "       Ubuntu/Debian: sudo apt install openjdk-25-jre"
+    echo ""
+    exit 1
+fi
+
+# Check Java version
+JAVA_FULL=$("$JAVA_CMD" -version 2>&1 | head -1)
+JAVA_VER=$(echo "$JAVA_FULL" | grep -oP '(?<=")\d+' 2>/dev/null || echo "$JAVA_FULL" | sed 's/.*"\([0-9]*\).*/\1/')
+echo "[INFO] Java: $JAVA_FULL"
+if [ -n "$JAVA_VER" ] && [ "$JAVA_VER" -lt 25 ] 2>/dev/null; then
+    echo "[ERROR] Java $JAVA_VER detected. Java 25+ is REQUIRED."
+    echo "        The DualAuth agent requires Java 25 (class file version 69)."
+    echo ""
+    if [ -n "$F2P_JAVA" ]; then
+        echo "  Your F2P launcher JRE is outdated. Update the launcher to get a newer Java."
+    else
+        echo "  Install Java 25+:"
+        echo "    Windows:       https://download.oracle.com/java/25/latest/jdk-25_windows-x64_bin.exe"
+        echo "    macOS:         brew install openjdk"
+        echo "    Ubuntu/Debian: sudo apt install openjdk-25-jre"
+    fi
+    echo ""
+    exit 1
+fi
+
+# --- Find F2P Game Files ---
+
+F2P_DIR=""
+if F2P_DIR=$(find_f2p_install 2>/dev/null); then
+    echo "[INFO] Found F2P launcher game files: $F2P_DIR"
+
+    # Try to copy HytaleServer.jar from F2P install
+    copy_from_f2p "HytaleServer.jar" "$SERVER_JAR" "$F2P_DIR/Server/HytaleServer.jar" || true
+
+    # Try to copy Assets.zip from F2P install
+    copy_from_f2p "Assets.zip" "$ASSETS_PATH" "$F2P_DIR/Assets.zip" || true
+
+    echo ""
+else
+    echo "[INFO] No F2P launcher install found, will download files"
+    echo ""
+fi
+
+# --- Download / Update Functions ---
+
+get_remote_version() {
+    local url="$1"
+    local headers
+    headers=$(curl -sI -L "$url" --connect-timeout 10 --max-time 15 2>/dev/null | tr -d '\r')
+    local etag
+    etag=$(echo "$headers" | grep -i "^etag:" | tail -1 | sed 's/^[^:]*: *//' | tr -d '"')
+    if [ -n "$etag" ]; then printf '%s' "$etag"; return 0; fi
+    local lastmod
+    lastmod=$(echo "$headers" | grep -i "^last-modified:" | tail -1 | sed 's/^[^:]*: *//')
+    if [ -n "$lastmod" ]; then printf '%s' "$lastmod"; return 0; fi
+    local length
+    length=$(echo "$headers" | grep -i "^content-length:" | tail -1 | sed 's/^[^:]*: *//')
+    if [ -n "$length" ]; then printf 'size:%s' "$length"; return 0; fi
+    return 1
+}
+
+needs_update() {
+    local url="$1" dest="$2" name="$3"
+    local version_file="${VERSION_DIR}/${name}.version"
+
+    if [ ! -f "$dest" ]; then
+        echo "[INFO] $name not found, will download"
+        return 0
+    fi
+
+    echo "[INFO] Checking for $name updates..."
+    local remote_version
+    remote_version=$(get_remote_version "$url" 2>/dev/null) || true
+    if [ -z "$remote_version" ]; then
+        echo "[INFO] Could not check for updates, using existing $name"
+        return 1
+    fi
+
+    local local_version=""
+    [ -f "$version_file" ] && local_version=$(cat "$version_file" 2>/dev/null)
+
+    if [ "$remote_version" = "$local_version" ]; then
+        echo "[INFO] $name is up to date"
+        return 1
+    fi
+
+    if [ -n "$local_version" ]; then
+        echo "[INFO] $name update available"
+    fi
+    return 0
+}
+
+save_version() {
+    local url="$1" name="$2"
+    local version_file="${VERSION_DIR}/${name}.version"
+    local ver
+    ver=$(get_remote_version "$url" 2>/dev/null) || true
+    [ -n "$ver" ] && printf '%s\n' "$ver" > "$version_file"
+}
+
+download_file() {
+    local url="$1" dest="$2" name="$3" expected_mb="${4:-0}"
+    local tmp="${dest}.tmp"
+
+    echo "[INFO] Downloading $name..."
+    [ "$expected_mb" -gt 0 ] 2>/dev/null && echo "[INFO]   Expected size: ~${expected_mb} MB"
+
+    for attempt in 1 2 3; do
+        rm -f "$tmp" 2>/dev/null || true
+
+        if [ "$expected_mb" -gt 50 ] 2>/dev/null; then
+            curl -fL --progress-bar -o "$tmp" "$url" --connect-timeout 15 --max-time 3600 2>&1
+        else
+            curl -fL -# -o "$tmp" "$url" --connect-timeout 15 --max-time 300 2>&1
+        fi
+
+        if [ $? -eq 0 ] && [ -f "$tmp" ]; then
+            local size
+            size=$(stat -c%s "$tmp" 2>/dev/null || stat -f%z "$tmp" 2>/dev/null || echo 0)
+            if [ "$size" -gt 1000 ]; then
+                mv -f "$tmp" "$dest"
+                local mb=$((size / 1024 / 1024))
+                echo "[INFO] $name downloaded (${mb} MB)"
+                return 0
+            fi
+            echo "[WARN] $name download too small (${size} bytes), retrying..."
+        fi
+
+        echo "[WARN] Download attempt $attempt failed, retrying..."
+        rm -f "$tmp" 2>/dev/null || true
+        sleep 2
+    done
+
+    echo "[ERROR] Failed to download $name after 3 attempts"
+    rm -f "$tmp" 2>/dev/null || true
+    return 1
+}
+
+# --- Download / Update Server Files ---
+
+# HytaleServer.jar
+JAR_URL="${DOWNLOAD_BASE}/HytaleServer.jar"
+if needs_update "$JAR_URL" "$SERVER_JAR" "HytaleServer.jar"; then
+    if download_file "$JAR_URL" "$SERVER_JAR" "HytaleServer.jar" "150"; then
+        save_version "$JAR_URL" "HytaleServer.jar"
+    else
+        if [ ! -f "$SERVER_JAR" ]; then
+            echo "[ERROR] HytaleServer.jar is required. Check your internet connection."
+            exit 1
+        fi
+        echo "[WARN] Update failed, using existing HytaleServer.jar"
+    fi
+fi
+
+# Assets.zip
+ASSETS_URL="${DOWNLOAD_BASE}/Assets.zip"
+if needs_update "$ASSETS_URL" "$ASSETS_PATH" "Assets.zip"; then
+    echo "[INFO] Assets.zip is large (~3.3 GB), this may take a while..."
+    if download_file "$ASSETS_URL" "$ASSETS_PATH" "Assets.zip" "3300"; then
+        save_version "$ASSETS_URL" "Assets.zip"
+    else
+        if [ ! -f "$ASSETS_PATH" ]; then
+            echo "[ERROR] Assets.zip is required. Check your internet connection."
+            exit 1
+        fi
+        echo "[WARN] Update failed, using existing Assets.zip"
+    fi
+fi
+
+# DualAuth Agent (uses GitHub releases API for version tracking)
+check_agent_update() {
+    if [ -f "$AGENT_JAR" ]; then
+        local agent_size
+        agent_size=$(stat -c%s "$AGENT_JAR" 2>/dev/null || stat -f%z "$AGENT_JAR" 2>/dev/null || echo 0)
+        if [ "$agent_size" -lt 10000 ]; then
+            echo "[WARN] Agent JAR seems corrupt (${agent_size} bytes), re-downloading..."
+            rm -f "$AGENT_JAR"
+            return 0
+        fi
+
+        local version_file="${VERSION_DIR}/${AGENT_JAR}.version"
+        local local_version=""
+        [ -f "$version_file" ] && local_version=$(cat "$version_file" 2>/dev/null)
+
+        echo "[INFO] Checking for DualAuth Agent updates..."
+        local remote_version
+        remote_version=$(curl -sf "$AGENT_VERSION_API" --connect-timeout 5 --max-time 10 2>/dev/null | grep -o '"tag_name":"[^"]*"' | cut -d'"' -f4)
+
+        if [ -n "$remote_version" ]; then
+            if [ "$local_version" = "$remote_version" ]; then
+                echo "[INFO] DualAuth Agent up to date ($local_version)"
+                return 1
+            else
+                echo "[INFO] Agent update: ${local_version:-unknown} -> $remote_version"
+                return 0
+            fi
+        else
+            echo "[INFO] Could not check agent updates, using existing"
+            return 1
+        fi
+    else
+        return 0
+    fi
+}
+
+AGENT_REMOTE_VERSION=""
+if check_agent_update; then
+    echo "[INFO] Downloading DualAuth Agent..."
+    if curl -fL -# -o "${AGENT_JAR}.tmp" "$AGENT_URL" --connect-timeout 15 --max-time 120 2>&1 && [ -f "${AGENT_JAR}.tmp" ]; then
+        dl_size=$(stat -c%s "${AGENT_JAR}.tmp" 2>/dev/null || stat -f%z "${AGENT_JAR}.tmp" 2>/dev/null || echo 0)
+        if [ "$dl_size" -gt 10000 ]; then
+            mv -f "${AGENT_JAR}.tmp" "$AGENT_JAR"
+            AGENT_REMOTE_VERSION=$(curl -sf "$AGENT_VERSION_API" --connect-timeout 5 --max-time 10 2>/dev/null | grep -o '"tag_name":"[^"]*"' | cut -d'"' -f4)
+            [ -n "$AGENT_REMOTE_VERSION" ] && printf '%s\n' "$AGENT_REMOTE_VERSION" > "${VERSION_DIR}/${AGENT_JAR}.version"
+            echo "[INFO] DualAuth Agent ready (${AGENT_REMOTE_VERSION:-latest})"
+        else
+            echo "[WARN] Downloaded agent too small, discarding"
+            rm -f "${AGENT_JAR}.tmp"
+        fi
+    else
+        rm -f "${AGENT_JAR}.tmp" 2>/dev/null
+        if [ -f "$AGENT_JAR" ]; then
+            echo "[WARN] Agent update failed, using existing"
+        else
+            echo "[ERROR] Failed to download DualAuth Agent"
+            echo "[ERROR] Download manually: $AGENT_URL"
+            exit 1
+        fi
+    fi
+fi
+
+# --- Final Checks ---
+
+for required in "$SERVER_JAR" "$ASSETS_PATH" "$AGENT_JAR"; do
+    if [ ! -f "$required" ]; then
+        echo "[ERROR] Required file missing: $required"
+        exit 1
+    fi
+done
+
+# --- Generate Server ID ---
+
+SERVER_ID_FILE=".server-id"
+if [ -f "$SERVER_ID_FILE" ]; then
+    SERVER_ID=$(cat "$SERVER_ID_FILE")
+    echo "[INFO] Server ID: $SERVER_ID"
+else
+    SERVER_ID=$(cat /proc/sys/kernel/random/uuid 2>/dev/null || uuidgen 2>/dev/null || python3 -c "import uuid; print(uuid.uuid4())" 2>/dev/null)
+    if [ -z "$SERVER_ID" ]; then
+        echo "[ERROR] Could not generate UUID. Install uuidgen or python3."
+        exit 1
+    fi
+    printf '%s' "$SERVER_ID" > "$SERVER_ID_FILE"
+    echo "[INFO] Generated server ID: $SERVER_ID"
+fi
+
+# --- Fetch Tokens ---
+
+echo ""
+echo "[INFO] Fetching server tokens from $AUTH_SERVER..."
+
+TEMP_RESPONSE=$(mktemp)
+curl -s -X POST "$AUTH_SERVER/server/auto-auth" \
+    -H "Content-Type: application/json" \
+    -d "{\"server_id\": \"$SERVER_ID\", \"server_name\": \"$SERVER_NAME\"}" \
+    --connect-timeout 10 \
+    --max-time 30 \
+    -o "$TEMP_RESPONSE"
+
+if [ $? -ne 0 ]; then
+    echo "[ERROR] Failed to connect to auth server at $AUTH_SERVER"
+    rm -f "$TEMP_RESPONSE"
+    exit 1
+fi
+
+if ! grep -q "sessionToken" "$TEMP_RESPONSE" 2>/dev/null; then
+    echo "[ERROR] Invalid response from auth server:"
+    cat "$TEMP_RESPONSE"
+    rm -f "$TEMP_RESPONSE"
+    exit 1
+fi
+
+# Extract tokens (python3 > jq > grep fallback)
+if command -v python3 &>/dev/null; then
+    SESSION_TOKEN=$(python3 -c "import json,sys; print(json.load(open('$TEMP_RESPONSE'))['sessionToken'])")
+    IDENTITY_TOKEN=$(python3 -c "import json,sys; print(json.load(open('$TEMP_RESPONSE'))['identityToken'])")
+elif command -v jq &>/dev/null; then
+    SESSION_TOKEN=$(jq -r '.sessionToken' "$TEMP_RESPONSE")
+    IDENTITY_TOKEN=$(jq -r '.identityToken' "$TEMP_RESPONSE")
+else
+    SESSION_TOKEN=$(grep -o '"sessionToken":"[^"]*"' "$TEMP_RESPONSE" | cut -d'"' -f4)
+    IDENTITY_TOKEN=$(grep -o '"identityToken":"[^"]*"' "$TEMP_RESPONSE" | cut -d'"' -f4)
+fi
+
+rm -f "$TEMP_RESPONSE"
+
+if [ -z "$SESSION_TOKEN" ] || [ -z "$IDENTITY_TOKEN" ]; then
+    echo "[ERROR] Could not extract tokens from auth server response"
+    exit 1
+fi
+
+echo "[INFO] Tokens received successfully"
+
+# --- Start Server ---
+
+JAVA_ARGS=""
+[ -n "${JVM_XMS:-}" ] && JAVA_ARGS="$JAVA_ARGS -Xms$JVM_XMS"
+[ -n "${JVM_XMX:-}" ] && JAVA_ARGS="$JAVA_ARGS -Xmx$JVM_XMX"
+
+echo ""
+echo "============================================================"
+echo "  Starting Hytale Server"
+echo "  Name:    $SERVER_NAME"
+echo "  Bind:    $BIND_ADDRESS"
+echo "  Agent:   $AGENT_JAR"
+echo "============================================================"
+echo ""
+
+exec "$JAVA_CMD" $JAVA_ARGS -javaagent:"$AGENT_JAR" -jar "$SERVER_JAR" \
+    --assets "$ASSETS_PATH" \
+    --bind "$BIND_ADDRESS" \
+    --auth-mode "$AUTH_MODE" \
+    --disable-sentry \
+    --session-token "$SESSION_TOKEN" \
+    --identity-token "$IDENTITY_TOKEN" \
+    "$@"
Author	SHA1	Message	Date
sanasol	a63e026700	Server setup video	2026-02-23 01:02:16 +01:00
sanasol	552ec42d6c	Add one-click dedicated server scripts for Hytale F2P - server/start.sh: Linux/macOS starter with auto-download, auto-update, F2P launcher detection (game files + bundled JRE), and token fetch - server/start.bat: Windows equivalent using PowerShell for JSON/UUID - server/README.md: Beginner-friendly guide with playit.gg networking - Remove obsolete server_scripts_2.zip Scripts auto-detect F2P launcher install (including custom installPath from config.json), copy game files locally if available, download missing files (HytaleServer.jar, Assets.zip, dualauth-agent.jar), and check for updates on every launch via ETag/GitHub releases API.	2026-02-23 00:55:38 +01:00
sanasol	fb90277be9	Fix Arabic RTL support: correct locale code and CSS syntax - Rename ar-AR to ar-SA (valid BCP 47 code for Saudi Arabia) - Fix missing dot in CSS selector: .news-section .news-header - Add trailing newline to ar-SA.json Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-02-22 23:00:08 +01:00
sanasol	27c220a757	Merge pull request 'Arabic and RTL support added' (#1 ) from Yugurten/hytale-f2p:develop into develop	2026-02-22 21:58:25 +00:00
Finix	30929ee0da	Arabic and RTL support added	2026-02-22 19:25:01 +00:00
sanasol	44834e7d12	Bump version to 2.3.8 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-02-21 23:47:52 +01:00
sanasol	cb7f7e51bf	v2.3.8: auto-update agent from GitHub releases, add dl1 mirror fallback - Agent auto-update: check GitHub releases API for new versions, download only when update available, track version in .version file - Add dl1.htdwnldsan.top as backup-2 mirror in patches config sources - Add dl1.htdwnldsan.top as primary non-Cloudflare mirror - Graceful fallback: use existing agent if update check or download fails Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>	2026-02-21 23:31:28 +01:00