كيفية استخدام مولد القائمة البيضاء لماين كرافت
أداة مولد whitelist.json هي أداة بسيطة تحول قائمة أسماء مستخدمي ماين كرافت إلى ملف whitelist.json منسق بشكل صحيح. يمكنك لصق أسماء المستخدمين سطرًا بسطر أو مفصولة بفواصل. تقوم الأداة تلقائيًا بإزالة التكرارات وتقليم المسافات الزائدة. بمجرد الإنشاء، يمكنك نسخ JSON أو تنزيله مباشرة. هذا الملف ضروري لأصحاب الخوادم الذين يرغبون في تقييد الوصول إلى اللاعبين المعتمدين فقط.بالنسبة لخوادم الوضع غير المتصل (المكسورة أو غير المميزة)، تستخدم الأداة خوارزمية UUID الرسمية للاعب غير المتصل. يتم اشتقاق UUID من اسم المستخدم باستخدام طريقة Java UUID.nameUUIDFromBytes. من المهم استخدام هذا التنسيق بالضبط لأن الخادم يتوقع UUIDs غير متصلة في whitelist.json. إذا استخدمت UUIDs للوضع المتصل على خادم غير متصل، فلن تتطابق القائمة البيضاء مع UUIDs داخل اللعبة للاعبين، وسيتم طردهم.بالنسبة لخوادم الوضع المتصل (المميزة أو الموثقة من Mojang)، يمكن للأداة حل كل اسم مستخدم إلى UUID ملف تعريف Mojang الحالي. يتطلب ذلك اتصالًا بالإنترنت ويستخدم واجهة برمجة تطبيقات Mojang. ستجلب الأداة UUID لكل اسم وتنشئ whitelist.json مع UUIDs المتصلة الصحيحة. لاحظ أنه إذا تم تغيير اسم مستخدم، فإن UUID سيعكس الملف الشخصي الحالي، وليس الاسم القديم. استخدم دائمًا اسم المستخدم الحالي للوضع المتصل.اختلافات الإصدار مهمة: في ماين كرافت 1.7.9 والإصدارات الأقدم، كان تنسيق whitelist.json يستخدم مصفوفة بسيطة من أسماء المستخدمين. من 1.8 فصاعدًا، تغير التنسيق إلى مصفوفة من الكائنات مع حقلي 'uuid' و 'name'. ينتج هذا المولد دائمًا التنسيق الحديث، الذي يعمل مع جميع الإصدارات من 1.8 إلى الأحدث. إذا كنت تدير خادمًا أقدم، فقد تحتاج إلى تحويل الملف يدويًا، لكن معظم الخوادم الحديثة تستخدم تنسيق الكائنات.نصائح عملية: احتفظ دائمًا بنسخة احتياطية من whitelist.json الحالي قبل استبداله. بعد الإنشاء، ضع الملف في الدليل الجذر لخادمك (حيث يوجد server.properties). ثم نفذ الأمر 'whitelist reload' في وحدة تحكم الخادم أو استخدم الأمر داخل اللعبة '/whitelist reload' إذا كان لديك صلاحيات المشغل. اختبر بحساب غير مدرج في القائمة البيضاء للتأكد من أن القائمة البيضاء نشطة. تذكر تعيين 'white-list=true' في server.properties لتفعيل القائمة البيضاء.
معرفات UUID عبر الإنترنت ومعرفات UUID دون اتصال غير قابلة للتبادل
خادم Java في وضع الاتصال بالإنترنت يحدد حسابًا مدفوعًا باستخدام UUID الذي ترجعه خدمات Mojang. أما خادم وضع عدم الاتصال فيشتق UUID مختلفًا يعتمد على الاسم، لذا فإن نسخ قائمة البيض غير المتصلة إلى خادم متصل قد يفشل حتى لو كان اسم المستخدم يبدو صحيحًا. طابق طريقة UUID مع وضع مصادقة الخادم، وأعد إنشاء الملف إذا تغير هذا الوضع.
ثبّت الملف دون فقدان اللاعبين الحاليين
أوقف الخادم أو استخدم أوامر القائمة البيضاء قبل استبدال whitelist.json. إذا كان الخادم يحتوي بالفعل على لاعبين معتمدين، فادمج تلك الإدخالات بدلاً من الكتابة فوق الملف بشكل أعمى. حافظ على JSON صالح مع اسم وUUID فريدين لكل إدخال، ثم ابدأ الخادم وشغّل /whitelist reload إذا كان برنامج الخادم يدعم ذلك. احتفظ بنسخة احتياطية قبل تعديل خادم الإنتاج.
أسئلة شائعة
ما الفرق بين UUIDs للوضع غير المتصل والوضع المتصل؟
يتم إنشاء UUIDs للوضع غير المتصل من اسم المستخدم باستخدام خوارزمية ثابتة، لذا فهي نفسها في كل مرة لهذا الاسم. UUIDs للوضع المتصل يتم تعيينها بواسطة Mojang لكل حساب مميز وهي فريدة للحساب، وليس لاسم المستخدم. إذا غيّر اللاعب اسمه، يظل UUID المتصل كما هو، لكن UUID غير المتصل يتغير لأنه يعتمد على الاسم. للخوادم غير المتصلة، يجب استخدام UUIDs غير متصلة؛ وللخوادم المتصلة، استخدم UUIDs متصلة.
هل يمكنني استخدام هذا المولد لخادم يضم لاعبين متصلين وغير متصلين معًا؟
لا، يعمل الخادم إما في الوضع المتصل أو غير المتصل، وليس كلاهما. إذا قمت بتعيين online-mode=true في server.properties، يجب أن يكون جميع اللاعبين بحسابات مميزة ويجب استخدام UUIDs متصلة. إذا كان online-mode=false، يتم التعامل مع جميع اللاعبين كغير متصلين ويجب استخدام UUIDs غير متصلة. خلط أنواع UUIDs في whitelist.json سيؤدي إلى طرد اللاعبين لأن UUID داخل اللعبة لن يتطابق مع إدخال القائمة البيضاء.
لماذا لا تعمل القائمة البيضاء بعد لصق JSON المولد؟
الأسباب الشائعة تشمل: نسيت تعيين white-list=true في server.properties، أو وضعت الملف في المجلد الخاطئ (يجب أن يكون في نفس دليل server.properties)، أو لم تنفذ 'whitelist reload' بعد استبدال الملف، أو استخدمت وضع UUID الخاطئ (غير متصل مقابل متصل). تأكد أيضًا من أن JSON صالح، بدون فواصل زائدة أو أقواس مفقودة. ينتج المولد JSON صالحًا، لكن إذا قمت بتحريره يدويًا، تحقق من الصيغة.
هل يدعم المولد أسماء مستخدمين بأحرف خاصة أو أرقام؟
نعم، يمكن أن تحتوي أسماء مستخدمي ماين كرافت على أحرف وأرقام وشرطات سفلية. يقبل المولد أي تنسيق اسم مستخدم صالح. ومع ذلك، للوضع غير المتصل، تعمل خوارزمية UUID مع أي سلسلة، لذا حتى الأسماء غير المعتادة ستنتج UUID ثابتًا. للوضع المتصل، سترجع واجهة برمجة تطبيقات Mojang خطأً إذا كان اسم المستخدم غير موجود أو غير صالح. ستتخطى الأداة الأسماء غير الصالحة وتعرض تحذيرًا، لذا يمكنك تصحيحها.
هل يمكنني استخدام هذه الأداة لإضافة لاعبين إلى whitelist.json موجود؟
ينشئ المولد whitelist.json جديدًا من الصفر. إذا كنت تريد إضافة لاعبين إلى قائمة بيضاء موجودة، يمكنك نسخ الإدخالات الموجودة ولصقها مع أسماء المستخدمين الجديدة في حقل الإدخال. ستقوم الأداة بدمجها وإزالة التكرارات. ومع ذلك، كن حذرًا: إذا كنت تستخدم الوضع المتصل، فستعيد الأداة جلب UUIDs لجميع الأسماء، مما قد يحدّث الإدخالات إذا غيّر اللاعب اسمه. للوضع غير المتصل، تكون UUIDs حتمية، لذا يكون الدمج آمنًا.