👟البدء

تعرف على كيفية إنشاء خادم باستخدام Plazma.

لاستخدام Plazma بشكل مستقر، يجب أن يفي النظام بمتطلبات التالية.

	الحد الأدنى	الموصى به
البنية	x64	-
الذاكرة العشوائية	8GB	16GB
مساحة التخزين	1GB	8GB
JDK	17	21

لضمان تعديل ملف التكوين بسهولة، من الجيد تثبيت محرر مثل Visual Studio Code.

---

1. JDK 설치

이름에서 알 수 있듯이, Minecraft: "Java" Edition 은 Java로 개발되어, 실행을 위해선 를 필요로 합니다.

Plazma는 Mojang Studios의 공식 서버 플랫폼을 , Plazma를 사용하기 위해서도 JDK를 설치해야 합니다.

1.1 JDK 설치 유무 확인

JDK가 시스템에 설치되어 있는지 확인하려면, 에 을 입력하고 실행합니다.

다음과 같이 출력되면 2 단계로 건너뜁니다.

الناتج الصحيح

openjdk 21.0.2 2024-01-16 LTS
بيئة تشغيل OpenJDK Zulu21.32+17-CA (البناء 21.0.2+13-LTS)
OpenJDK 64 بت خادم VM Zulu21.32+17-CA (البناء 21.0.2+13-LTS، وضع مختلط، مشاركة)

위와 같이 출력되지 않거나, 아래와 같이 출력되면 JDK가 없거나 너무 오래되었으므로, 1.2 단계를 수행해야 합니다.

JDK가 설치되어 있지 않음

'java' غير معروف كأمر داخلي أو خارجي، برنامج قابل للتنفيذ، أو
ملف دفعي.

JDK가 너무 오래됨

خيار غير معترف به: --version
خطأ: تعذر إنشاء الآلة الافتراضية لـ Java.
خطأ: حدث استثناء قاتل. سيتم الخروج من البرنامج.

1.2 JDK 설치

본 설명서에서는 JDK의 로 Azul Zulu를 사용합니다.

설치를 완료한 후, 1.1 단계을 다시 수행하여 설치가 올바르게 완료되었는지 확인해 보세요.

Windows

1. أولًا، قم بتنزيل JDK 21 من Azul Zulu بتنسيق .msi.
2. قم بتشغيل معالج التثبيت الذي تم تنزيله وانقر على التالي.

3. بعد ذلك، انتقل إلى القائمة الموجودة في منتصف الجزء الأيسر من النافذة وقم بتفعيل تعيين متغير JAVA_HOME، ثم انقر على التالي.

4. اضغط على تثبيت لإكمال تثبيت JRE.

macOS

Azul Zulu 에서 JDK 21을 .dmg 형태의 설치 마법사를 다운로드 한 후 실행하여 JRE를 설치합니다.

Debian/Ubuntu

먼저, 다음 명령어를 터미널에서 실행하여 APT에 Azul Zulu 저장소를 추가합니다.

sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y

curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg

echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list

ثم، قم بتشغيل الأمر التالي في الطرفية لتثبيت JRE.

sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless

Fedora/RHEL

다음 명령어를 입력하여 JDK를 설치할 수 있습니다.

sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm

sudo dnf install -y zulu21-ca-jre-headless

---

2. تحميل بلازما

تقدم بلازما مجموعة متنوعة من ملفات التشغيل.

대부분의 경우에는 Mojang-mapped Paperclip을 사용합니다.

아래 내용은 개발자 또는 각 형태의 특징에 대해 궁금한 분들을 위한 것입니다. 일반 사용자라면 3 단계로 뛰어 넘겨도 문제되지 않습니다.

تعرف على المزيد

اسم الملف التنفيذي هو plazma-(مدير الإصدار)-1.20.4-R0.1-SNAPSHOT-(نوع التعيين).jar.

• نوع التعيين التعيين يعد نوعًا من الخريطة التي تربط بين الشفرة الفعلية لـ Minecraft والشفرة المشفرة.

  • Reobf Reobfuscated (재난독화), Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다. 1.20.6부터 지원이 종료되었습니다.

  • Mojmap مُعدلة من قِبل Mojang، وهي تعني تعيين Minecraft الأصلي. 1.20.6 이후의 모던 플러그인에서 사용합니다.

• مدير الإصدار مدير الإصدار هو الشخص الذي يمكن أن يُعتبر مشغل الخادم الذي يحتاج إلى مكتبات لتشغيل الخادم وتطبيق تصحيحات على ملفات الخادم.

  • Paperclip مدير إصدار Minecraft الأصلي.

  • Bundler مدير الإصدار Minecraft الأصلي.

---

3. إنشاء نص بدء

لبدء بلازما بسهولة وإعادة تشغيل الخادم تلقائيًا، يجب عليك إنشاء نص بدء.

Flags.sh를 통해 시작 스크립트를 생성할 수 있습니다. Plazma에 만 입력하면 명령어가 자동으로 최적화 됩니다.

يمكنك تنزيل نص البدء من خلال زر التنزيل في الزاوية السفلى اليسرى. تأكد من أن نص البدء الذي تم تنزيله متوافق مع نظام التشغيل الخاص بك.

---

4. تنظيف الملفات

الآن، قم بنقل نص البدء الذي تم تنزيله وبلازما إلى مجلد جديد.

폴더 명칭은 반드시 띄어 쓰기와 특수 문자가 없고, 영어로 설정되어야 합니다.

그렇지 않으면 Plazma 또는 JDK가 올바르게 작동하지 않을 수 있습니다.

الآن، قم بتشغيل نص البدء. Windows의 경우, 방화벽 허용 선택 창에서, 반드시 허용을 선택해야 합니다.

---

5. موافقة EULA

بمجرد تشغيل نص البدء مرة واحدة، سيتم إنشاء ملف eula.txt في المجلد.

هو اتفاقية ترخيص يجب عليك الموافقة عليها من خلال استخدام خدمات Mojang Studios.

만일 동의하지 않는 경우, 서버를 시작할 수 없으며, EULA를 위반하는 경우 계정을 정지되는 등의 제재를 받을 수 있습니다.

للموافقة على EULA، قم بتغيير eula=false إلى eula=true في ملف eula.txt واحفظ التغييرات.

---

6. السماح بالوصول الخارجي (Windows)

تمنع الأنظمة الحديثة من الوصول الخارجي لحماية ضد الوصول الخطير من الخارج عبر جدران الحماية وجهاز التوجيه.

Windows의 경우, 방화벽은 3 단계에서 허용했으므로, 포트 포워딩만 하면 됩니다.

해당 설명서는 Windows 운영 체제 및 를 사용할 수 있는 라우터임을 가정하고 작성되었습니다.

إذا كان جهاز التوجيه لا يدعم UPnP، فيجب عليك البحث عن الإعدادات الخاصة بجهاز التوجيه لأنها تختلف حسب الجهاز.

يمكنك أيضًا إنشاء عنوان مؤقت باستخدام Ngrok.

Linux 또는 macOS 등 (준) UNIX 체계 운영체제의 경우, 방화벽 서비스 별로 설정 방법이 다르므로, 직접 자료를 검색해야 합니다.

6.1 التحقق من ضرورة إعادة توجيه المنفذ

أدخل الأمر التالي في نافذة التشغيل وقم بتشغيله.

powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content"

إذا كانت النتيجة True، يمكنك الانتهاء هنا، وإذا كانت False، فيجب عليك تكوين إعادة توجيه المنفذ.

6.2 الاتصال بالخادم

외부에서 접속

포트 포워딩이 필요 없거나, 이미 포트 포워딩을 성공했다면, 이제 서버에 접속할 수 있습니다.

يمكنك التحقق من العنوان المستخدم للوصول إلى الخادم هنا.

UPnP로 포트포워딩 시도

서버 폴더의 purpur.yml에서, network.upnp-port-forwarding을 true로 활성화합니다.

ثم، بعد إعادة تشغيل الخادم، سيحاول Plazma توجيه المنفذ تلقائيًا.

النجاح أو الفشل في UPnP يعتمد على الرسالة التي تظهر في وحدة التحكم، حيث تظهر على سبيل المثال [UPnP] (الرسالة).

رسالة	المعنى
تم فتح المنفذ بنجاح (المنفذ)	نجاح توجيه المنفذ.
المنفذ (المنفذ) مفتوح بالفعل	المنفذ قيد الاستخدام بواسطة خدمة أخرى.
فشل في فتح المنفذ (المنفذ)	فشل توجيه المنفذ.
الخدمة غير متوفرة	جهاز التوجيه لا يدعم UPnP.

عند إيقاف تشغيل الخادم، سيقوم Plazma تلقائيًا بإغلاق المنافذ.

Ngrok으로 임시 주소 생성

Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다.

1. قم بتنزيل ملف ZIP 'Windows (64-bit)' من موقع Ngrok.
2. ضع ملف Ngrok الذي قمت بتنزيله في مجلد الخادم.

3. قم بإنشاء رمز مصادقة من لوحة تحكم Ngrok.
4. قم بتشغيل الأمر الذي يظهر في 'Command Line' في مجلد الخادم.

5. أضف السطر start /b ngrok tcp --region jp 25565 في أعلى النص البرمجي، وأضف taskkill /f /t /im ngrok.exe في الأسفل.

6. في أعلى وحدة التحكم، ستجد Forwarding tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565، حيث يكون 0.tcp.jp.ngrok.io:12345 هو عنوان الخادم.

7. يمكنك الآن الاتصال من الخارج باستخدام هذا العنوان.

로컬에서 접속

로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 cmd /k ipconfig를 실행하여 출력된 IPv4 주소 로 접속할 수 있습니다.

على سبيل المثال، عندما يتم عرض الناتج بعد تشغيل الأمر،

Windows IP 구성

이더넷 어댑터 이더넷:

    연결된 DNS 접미사. . . . :
    IPv4 주소. . . . . . . . . : 192.168.3.7
    서브넷 마스크 . . . . . . . : 255.255.255.0
    기본 게이트웨이 . . . . . . : 192.168.3.1

يمكنك الاتصال بالخادم من الجهاز المحلي باستخدام 192.168.3.7 المعروض كعنوان IPv4.

إذا كان الخادم واللعبة تعملان على نفس الكمبيوتر، يمكنك الاتصال باستخدام 'localhost'.

7. النمو

إذا كنت قد بدأت الخادم بنجاح ويعمل بشكل صحيح، فإن الآن حان وقت تخصيص الخادم.

تعرف من خلال هذا الدليل على كيفية تخصيص الخادم.

https://github.com/PlazmaMC/Document/blob/prod/ar/origin/plazma/administration/getting-started/الخطوة-التالية.md

---