Add guide for installing Subnautica 2 mods

docs/subnautica-2-mods.md

@@ -0,0 +1,172 @@
+---
+id: subnautica-2-mods
+title: "Subnautica 2: Install Mods"
+description: "Learn how to install Subnautica 2 mods on your gameserver by adding Lua or C++ mods to the correct folder, so your Subnautica server loads them automatically on startup. -> Learn more now"
+sidebar_label: "Install Mods"
+services:
+ - gameserver-subnautica-2
+---
+
+import InlineVoucher from '@site/src/components/InlineVoucher';
+
+## Introduction
+
+Mods allow you to customize and enhance your Subnautica 2 server experience by adding new gameplay features, improving mechanics, or introducing fresh content. With mods, you can create a more varied and engaging environment for you and your players. This guide will show you how to install Subnautica 2 mods on your ZAP-Hosting gameserver by uploading supported Lua or C++ mods to the correct folder so they load automatically when the server starts.
+
+![](https://screensaver01.zap-hosting.com/index.php/s/SCREENSHOT_PLACEHOLDER/preview)
+
+## Preparation
+
+Before you begin, you need access to your Subnautica 2 gameserver files through the ZAP-Hosting web interface or an available file management method.
+
+:::info Required Mod Type
+Only Lua or C++ mods that are designed for Subnautica 2 should be used. If a mod is made for another game, such as Subnautica 1 or Subnautica Below Zero, compatibility cannot be assumed.
+:::
+
+:::note Mod Download Sources
+Subnautica 2 mods can for example be obtained from community platforms such as [Nexus Mods](https://www.nexusmods.com/games/subnautica2). Because third-party mod pages can change at any time, you should always review the mod description and installation notes before uploading files.
+:::
+
+## Download Compatible Mods
+
+First, download the mods you want to use on your server. Make sure the mod is specifically intended for **Subnautica 2** and check whether the author provides any extra requirements.
+
+### Check the Mod Contents
+
+After downloading a mod archive, extract it on your local computer and review the included files.
+
+Common things to look for:
+
+- Lua script files
+- C++ mod files
+- a folder structure provided by the mod author
+- a `README`, installation note, or dependency list
+
+:::caution Verify Compatibility
+Not all mods for games are server-compatible. Some mods are made only for the client and may not work on a dedicated Subnautica 2 gameserver. If the mod author does not mention server support, you should test carefully before using it in production.
+:::
+
+## Access Your Gameserver Files
+
+Next, open your Subnautica 2 gameserver file system and locate the main server directory.
+
+If you are using the ZAP-Hosting web interface, open the file manager for your gameserver and navigate to the root directory of the server installation.
+
+### Locate the Mods Folder
+
+Inside the main gameserver directory, find the `mods` folder.
+
+The installation target is:
+
+```text
+[main_gameserver_directory]/mods
+```
+
+Replace `[main_gameserver_directory]` with the base directory of your Subnautica 2 server files.
+
+:::info Automatic Mod Loading
+The server checks the `mods` folder during launch. If a supported Lua or C++ mod is placed there correctly, it will be picked up automatically on the next server start.
+:::
+
+## Upload and Install Mods
+
+Once you have the correct mod files and have opened the `mods` folder, you can upload the mod content.
+
+### Copy the Mod Files
+
+Upload or move the extracted Lua or C++ mod files into the `mods` folder in your main gameserver directory.
+
+Depending on the mod, this may mean:
+
+- uploading a single file directly into `mods`
+- uploading a complete mod folder into `mods`
+- preserving the folder structure exactly as provided by the mod author
+
+### Keep the Original Structure
+
+If the downloaded archive already contains a mod folder, do not rearrange the internal files unless the author explicitly instructs you to do so.
+
+| Item | What to do |
+| --- | --- |
+| Single Lua mod file | Upload it to the `mods` folder |
+| Single C++ mod file | Upload it to the `mods` folder |
+| Folder-based mod | Upload the full folder to the `mods` folder |
+| Archive file such as `.zip` | Extract it first, then upload the contents if required |
+
+:::caution Do Not Upload Compressed Archives Unless Explicitly Supported
+If you only upload a `.zip` or other archive file without extracting it, the server may not detect the mod. Unless the mod author states otherwise, upload the extracted files or folders.
+:::
+
+## Restart the Server
+
+After you have uploaded the mods, restart your Subnautica 2 gameserver.
+
+This is required because the server loads mods during startup. If the server is already running, newly uploaded files will usually not be applied until the next launch.
+
+### Confirm the Mod Load
+
+After the restart, check whether the mod is active in-game or through any logs or output that are available for your server.
+
+Because mod behavior can vary, confirmation may include:
+
+- changed gameplay behavior
+- new commands or features
+- visible log entries from the mod
+- successful server startup without errors
+
+:::tip Install Mods One by One
+If you want to use multiple game mods, install and test them one at a time. This makes it much easier to identify which mod causes a problem if the server no longer starts correctly.
+:::
+
+## Troubleshooting
+
+If your Subnautica 2 mods do not work, there are several common causes you should check.
+
+### Common Problems
+
+| Problem | Possible cause | Solution |
+| --- | --- | --- |
+| Mod does not load | Files were uploaded to the wrong directory | Make sure the files are inside the `mods` folder in the main gameserver directory |
+| Server starts but mod has no effect | Mod is client-side only or incompatible | Review the mod page and confirm dedicated server support |
+| Server fails to start | Broken mod files or version mismatch | Remove the last installed mod and restart the server |
+| Mod files are present but ignored | Archive was uploaded instead of extracted files | Extract the download and upload the actual mod files |
+| Multiple mods conflict | Two mods modify the same behavior | Test each mod separately and keep only compatible combinations |
+
+### Remove a Problematic Mod
+
+If a newly installed mod causes issues, delete the corresponding file or mod folder from the `mods` directory and restart the server again.
+
+```text
+[main_gameserver_directory]/mods
+```
+
+:::danger Use Trusted Mod Sources
+Only download mods from sources you trust. Third-party files can contain broken, outdated, or malicious content. Review the mod page carefully and avoid unknown downloads that do not provide clear installation or compatibility information.
+:::
+
+## Best Practices
+
+To keep your server stable, you should manage mods carefully instead of installing many at once.
+
+### Recommended Workflow
+
+1. Download one compatible Subnautica 2 mod.
+2. Extract the files locally.
+3. Upload the files or folder to the server `mods` directory.
+4. Restart the server.
+5. Test functionality.
+6. Repeat for the next mod.
+
+### Keep a Local Backup
+
+Before changing your active mod setup, keep a backup of:
+
+- your current mod files
+- any related configuration files
+- a list of installed mods and their versions
+
+This helps you restore a working setup quickly if a new mod causes issues.
+
+## Conclusion
+
+Congratulations, you have successfully installed mods on your Subnautica 2 gameserver. For further questions or assistance, please don't hesitate to contact our support team, which is available daily to assist you! 🙂

i18n/ar/docusaurus-plugin-content-docs/current/subnautica-2-mods.md

@@ -0,0 +1,172 @@
+---
+id: subnautica-2-mods
+title: "Subnautica 2: تثبيت المودات"
+description: "تعلم كيفية تثبيت مودات Subnautica 2 على سيرفر الألعاب الخاص بك عن طريق إضافة مودات Lua أو C++ إلى المجلد الصحيح، ليقوم سيرفر Subnautica بتحميلها تلقائيًا عند بدء التشغيل. -> تعلّم المزيد الآن"
+sidebar_label: "تثبيت المودات"
+services:
+ - gameserver-subnautica-2
+---
+
+import InlineVoucher from '@site/src/components/InlineVoucher';
+
+## Introduction
+
+تتيح لك المودات تخصيص وتحسين تجربة سيرفر Subnautica 2 الخاص بك عن طريق إضافة ميزات لعب جديدة، تحسين الميكانيكيات، أو تقديم محتوى جديد. مع المودات، يمكنك خلق بيئة أكثر تنوعًا وجاذبية لك وللاعبين. في هذا الدليل، ستتعلم كيفية تثبيت مودات Subnautica 2 على سيرفر الألعاب الخاص بك في ZAP-Hosting عن طريق رفع مودات Lua أو C++ المدعومة إلى المجلد الصحيح ليتم تحميلها تلقائيًا عند بدء تشغيل السيرفر.
+
+![](https://screensaver01.zap-hosting.com/index.php/s/SCREENSHOT_PLACEHOLDER/preview)
+
+## Preparation
+
+قبل أن تبدأ، تحتاج إلى الوصول إلى ملفات سيرفر ألعاب Subnautica 2 الخاص بك عبر واجهة الويب الخاصة بـ ZAP-Hosting أو أي طريقة متاحة لإدارة الملفات.
+
+:::info نوع المود المطلوب
+يجب استخدام مودات Lua أو C++ المصممة خصيصًا لـ Subnautica 2 فقط. إذا كان المود مخصصًا للعبة أخرى مثل Subnautica 1 أو Subnautica Below Zero، فلا يمكن افتراض التوافق.
+:::
+
+:::note مصادر تحميل المودات
+يمكنك الحصول على مودات Subnautica 2 من منصات المجتمع مثل [Nexus Mods](https://www.nexusmods.com/games/subnautica2). نظرًا لأن صفحات المودات الخارجية قد تتغير في أي وقت، يجب دائمًا مراجعة وصف المود وملاحظات التثبيت قبل رفع الملفات.
+:::
+
+## Download Compatible Mods
+
+أولاً، قم بتحميل المودات التي تريد استخدامها على سيرفرك. تأكد من أن المود مخصص تحديدًا لـ **Subnautica 2** وتحقق مما إذا كان المؤلف يوفر أي متطلبات إضافية.
+
+### Check the Mod Contents
+
+بعد تحميل أرشيف المود، قم بفك ضغطه على جهازك المحلي وراجع الملفات المضمنة.
+
+الأشياء الشائعة التي يجب البحث عنها:
+
+- ملفات سكريبت Lua
+- ملفات مود C++
+- هيكل مجلدات مقدم من مؤلف المود
+- ملف `README`، ملاحظة تثبيت، أو قائمة تبعيات
+
+:::caution تحقق من التوافق
+ليست كل المودات الخاصة بالألعاب متوافقة مع السيرفر. بعض المودات مخصصة فقط للعميل وقد لا تعمل على سيرفر ألعاب Subnautica 2 مخصص. إذا لم يذكر مؤلف المود دعم السيرفر، يجب عليك اختبارها بحذر قبل استخدامها في بيئة الإنتاج.
+:::
+
+## Access Your Gameserver Files
+
+بعد ذلك، افتح نظام ملفات سيرفر ألعاب Subnautica 2 الخاص بك وحدد موقع الدليل الرئيسي للسيرفر.
+
+إذا كنت تستخدم واجهة الويب الخاصة بـ ZAP-Hosting، افتح مدير الملفات لسيرفر الألعاب الخاص بك وانتقل إلى الدليل الجذري لتثبيت السيرفر.
+
+### Locate the Mods Folder
+
+داخل الدليل الرئيسي لسيرفر الألعاب، ابحث عن مجلد `mods`.
+
+وجهة التثبيت هي:
+
+```text
+[main_gameserver_directory]/mods
+```
+
+استبدل `[main_gameserver_directory]` بالدليل الأساسي لملفات سيرفر Subnautica 2 الخاص بك.
+
+:::info تحميل المودات تلقائيًا
+يقوم السيرفر بفحص مجلد `mods` أثناء الإقلاع. إذا تم وضع مود Lua أو C++ مدعوم هناك بشكل صحيح، فسيتم تحميله تلقائيًا عند بدء تشغيل السيرفر التالي.
+:::
+
+## Upload and Install Mods
+
+بمجرد حصولك على ملفات المود الصحيحة وفتح مجلد `mods`، يمكنك رفع محتوى المود.
+
+### Copy the Mod Files
+
+قم برفع أو نقل ملفات مود Lua أو C++ المستخرجة إلى مجلد `mods` في الدليل الرئيسي لسيرفر الألعاب.
+
+اعتمادًا على المود، قد يعني هذا:
+
+- رفع ملف واحد مباشرة إلى `mods`
+- رفع مجلد مود كامل إلى `mods`
+- الحفاظ على هيكل المجلدات كما هو مقدم من مؤلف المود
+
+### Keep the Original Structure
+
+إذا كان الأرشيف الذي تم تحميله يحتوي بالفعل على مجلد مود، لا تعيد ترتيب الملفات الداخلية إلا إذا طلب المؤلف ذلك صراحة.
+
+| العنصر | ماذا تفعل |
+| --- | --- |
+| ملف مود Lua واحد | ارفعه إلى مجلد `mods` |
+| ملف مود C++ واحد | ارفعه إلى مجلد `mods` |
+| مود قائم على مجلد | ارفع المجلد الكامل إلى مجلد `mods` |
+| ملف أرشيف مثل `.zip` | فك ضغطه أولاً، ثم ارفع المحتويات إذا لزم الأمر |
+
+:::caution لا ترفع أرشيفات مضغوطة إلا إذا كان ذلك مدعومًا صراحة
+إذا قمت برفع ملف `.zip` أو أرشيف آخر دون فك ضغطه، قد لا يكتشف السيرفر المود. إلا إذا ذكر مؤلف المود خلاف ذلك، ارفع الملفات أو المجلدات المستخرجة.
+:::
+
+## Restart the Server
+
+بعد رفع المودات، أعد تشغيل سيرفر ألعاب Subnautica 2 الخاص بك.
+
+هذا ضروري لأن السيرفر يحمل المودات أثناء بدء التشغيل. إذا كان السيرفر يعمل بالفعل، فلن تُطبق الملفات الجديدة عادةً حتى الإقلاع التالي.
+
+### Confirm the Mod Load
+
+بعد إعادة التشغيل، تحقق مما إذا كان المود نشطًا داخل اللعبة أو من خلال أي سجلات أو مخرجات متاحة لسيرفرك.
+
+نظرًا لاختلاف سلوك المودات، قد يشمل التأكيد:
+
+- تغير في سلوك اللعب
+- أوامر أو ميزات جديدة
+- سجلات مرئية من المود
+- بدء تشغيل السيرفر بنجاح بدون أخطاء
+
+:::tip ثبت المودات واحدة تلو الأخرى
+إذا كنت تريد استخدام عدة مودات، ثبتها واختبرها واحدة تلو الأخرى. هذا يسهل كثيرًا تحديد المود الذي يسبب مشكلة إذا لم يبدأ السيرفر بشكل صحيح.
+:::
+
+## Troubleshooting
+
+إذا لم تعمل مودات Subnautica 2 الخاصة بك، هناك عدة أسباب شائعة يجب التحقق منها.
+
+### Common Problems
+
+| المشكلة | السبب المحتمل | الحل |
+| --- | --- | --- |
+| المود لا يتم تحميله | تم رفع الملفات في الدليل الخطأ | تأكد من أن الملفات داخل مجلد `mods` في الدليل الرئيسي لسيرفر الألعاب |
+| السيرفر يبدأ لكن المود لا يؤثر | المود مخصص للعميل فقط أو غير متوافق | راجع صفحة المود وتأكد من دعم السيرفر المخصص |
+| السيرفر يفشل في البدء | ملفات مود معطوبة أو عدم تطابق في النسخة | احذف آخر مود تم تثبيته وأعد تشغيل السيرفر |
+| ملفات المود موجودة لكن يتم تجاهلها | تم رفع الأرشيف بدلاً من الملفات المستخرجة | فك ضغط التحميل وارفع ملفات المود الفعلية |
+| تعارض بين مودات متعددة | مودان يغيران نفس السلوك | اختبر كل مود على حدة واحتفظ فقط بالمجموعات المتوافقة |
+
+### Remove a Problematic Mod
+
+إذا تسبب مود تم تثبيته حديثًا في مشاكل، احذف الملف أو مجلد المود المقابل من دليل `mods` وأعد تشغيل السيرفر مرة أخرى.
+
+```text
+[main_gameserver_directory]/mods
+```
+
+:::danger استخدم مصادر مودات موثوقة فقط
+قم بتحميل المودات فقط من مصادر تثق بها. قد تحتوي الملفات الخارجية على محتوى معطوب، قديم، أو ضار. راجع صفحة المود بعناية وتجنب التنزيلات غير المعروفة التي لا توفر معلومات واضحة عن التثبيت أو التوافق.
+:::
+
+## Best Practices
+
+للحفاظ على استقرار سيرفرك، يجب إدارة المودات بحذر بدلاً من تثبيت العديد منها دفعة واحدة.
+
+### Recommended Workflow
+
+1. قم بتحميل مود Subnautica 2 متوافق واحد.
+2. فك ضغط الملفات محليًا.
+3. ارفع الملفات أو المجلد إلى مجلد `mods` على السيرفر.
+4. أعد تشغيل السيرفر.
+5. اختبر الوظائف.
+6. كرر مع المود التالي.
+
+### Keep a Local Backup
+
+قبل تغيير إعدادات المودات النشطة، احتفظ بنسخة احتياطية من:
+
+- ملفات المود الحالية
+- أي ملفات إعدادات ذات صلة
+- قائمة المودات المثبتة وإصداراتها
+
+هذا يساعدك على استعادة إعداد يعمل بسرعة إذا تسبب مود جديد في مشاكل.
+
+## Conclusion
+
+تهانينا، لقد قمت بتثبيت المودات بنجاح على سيرفر ألعاب Subnautica 2 الخاص بك. لأي أسئلة أو مساعدة إضافية، لا تتردد في التواصل مع فريق الدعم لدينا، المتوفر يوميًا لمساعدتك! 🙂