إعداد AuthMe
أعدّ تسجيل الدخول والتسجيل لخادمك واحصل على أسطر جاهزة لـ config.yml مع شرح لكل منها.
الإعدادات المسبقة
ما يجب تغييره في config.yml: 0
كل شيء يطابق الإعداد الافتراضي حاليًا. اختر إعدادًا مسبقًا أو غيّر الإعدادات أدناه، وستظهر هنا الأسطر التي تنسخها.
الأساسيات
لغة الرسائل ووضع الحساب
settings.messagesLanguageاللغة التي تستخدمها AuthMe لإخبار اللاعبين بـ «سجّل» و«أدخل كلمة المرور». الإنجليزية افتراضيًا؛ لخادم روسي اضبط ru.
settings.perPlayerLocaleيحصل كل لاعب على الرسائل بلغة لعبته، وتُستخدم اللغة أعلاه كبديل احتياطي.
settings.serverNameتُدرج في رسائل الإضافة ورسائل البريد الإلكتروني.
settings.enablePremiumينضم اللاعبون الذين يملكون حساب Minecraft رسميًا دون إدخال كلمة مرور، والبقية كالمعتاد. تختار الإضافة طريقة التحقق بنفسها.
settings.preventOtherCaseإذا كان Xephi مسجّلًا، فلن يتمكن XEPHI وxephi من تسجيل الدخول. يحمي من انتحال الهوية باستخدام حالة أحرف مختلفة.
التسجيل
كيف ينشئ اللاعب حسابًا لأول مرة
settings.registration.enabledأوقفه ولن يتمكن اللاعبون الجدد من إنشاء حساب.
settings.registration.forceدون التسجيل وتسجيل الدخول لا يستطيع اللاعب فعل أي شيء. تُضبط الاستثناءات في قسم القيود أدناه.
settings.registration.typePASSWORD: يختار اللاعب كلمة المرور بنفسه. EMAIL: تُولَّد كلمة مرور وتُرسل إلى عنوان البريد الإلكتروني الذي قدّمه.
settings.registration.secondArgNONE: تُدخل كلمة المرور مرة واحدة. CONFIRMATION: يجب تكرارها ككلمة ثانية. EMAIL_OPTIONAL وEMAIL_MANDATORY: الوسيط الثاني هو بريد إلكتروني، اختياري أو مطلوب.
settings.registration.messageIntervalعدد مرات تكرار الإضافة لرسالة «سجّل الدخول أو أنشئ حسابًا» للاعب.
settings.restrictions.maxRegPerIpعدد مرات التسجيل من عنوان واحد. 0 تعني بلا حد. الواحد قاسٍ على من يلعبون معًا من المنزل نفسه.
settings.restrictions.registerTimeoutعدد الثواني المتاحة للاعب للتسجيل. 0 تعني عدم الطرد أبدًا.
settings.registration.forceLoginAfterRegisterبعد التسجيل بنجاح يجب على اللاعب تسجيل الدخول مجددًا بالأمر.
settings.registration.forceKickAfterRegisterيُطرد اللاعب مباشرة بعد التسجيل ليعيد الانضمام. لا تفعّله مع طلب /login أعلاه.
تسجيل الدخول
ما يحدث عندما يدخل اللاعب كلمة المرور
settings.restrictions.loginTimeoutعدد الثواني المتاحة للاعب لإدخال كلمة المرور. 0 تعني عدم الطرد أبدًا.
settings.restrictions.kickOnWrongPasswordيُطرد اللاعب من الخادم مباشرة بعد الخطأ. يساعد ضد التخمين لكنه يزعج اللاعبين المعتادين.
settings.restrictions.kickNonRegisteredيُطرد اللاعب الذي لا يملك حسابًا مباشرة عند الانضمام. هذا وضع الخادم الخاص.
settings.restrictions.ForceSingleSessionلا يمكن طرد لاعب متصل بواسطة من ينضم بالاسم المستعار نفسه («Logged in from another Location»). يسدّ ثغرة معروفة في اختطاف الجلسات.
settings.restrictions.maxLoginPerIpعدد اللاعبين الذين يمكنهم تسجيل الدخول من عنوان واحد. 0 تعني بلا حد.
settings.restrictions.maxJoinPerIpعدد الاتصالات المسموح بها من عنوان واحد. 0 تعني بلا حد.
الجلسات
حتى لا تدخل كلمة المرور بعد كل انقطاع
settings.sessions.enabledتتذكر الإضافة الاسم المستعار وعنوان IP. إذا أعاد اللاعب الاتصال من العنوان نفسه قبل انتهاء المدة، لا تُطلب كلمة المرور.
settings.sessions.timeoutبعد كم دقيقة يُطلب كلمة المرور مرة أخرى. تنتهي الجلسة أيضًا عند تغيّر عنوان IP.
قبل تسجيل الدخول
ما يمكن للاعب فعله قبل إدخال كلمة المرور
settings.restrictions.allowChatعند الإيقاف لا يستطيع الضيف الدردشة. وتُحظر أيضًا كل الأوامر باستثناء المذكورة أدناه.
settings.restrictions.hideChatاللاعب الذي لم يسجّل الدخول لا يرى دردشة اللاعبين الآخرين.
settings.restrictions.allowCommandsكل ما عدا ذلك محظور. إزالة /login أو /register من هنا تمنع الجميع من الدخول.
settings.restrictions.allowMovementيستطيع الضيف التحرك. يُضبط النطاق أدناه.
settings.restrictions.allowedMovementRadiusإلى أي مدى يستطيع الضيف السير من نقطة الانضمام. 0 تعني بلا حد.
settings.restrictions.teleportUnAuthedToSpawnقبل تسجيل الدخول يبقى اللاعب عند نقطة الظهور، وبعد تسجيل الدخول يعود إلى حيث كان. بهذه الطريقة لا يستطيع أحد التجسس على قاعدة أحد من منظوره.
settings.restrictions.ProtectInventoryBeforeLogInلا يستطيع الضيف رؤية محتويات حقيبته حتى يسجّل الدخول. يتطلب PacketEvents.
يعمل فقط عند تثبيت PacketEvents، وفقًا لتوثيق الإضافة.
settings.restrictions.DenyTabCompleteBeforeLoginلا يستطيع الضيف الاطلاع على الألقاب والأوامر عبر الإكمال التلقائي. يتطلب PacketEvents.
settings.applyBlindEffectحتى يسجّل اللاعب الدخول، تُعتّم الشاشة بتأثير العمى.
settings.restrictions.noTeleportلا ينقل AuthMe اللاعبين إطلاقًا. مطلوب إذا كانت إضافة أخرى تتولى النقل وحدث تعارض.
كلمة المرور
الطول وكلمات المرور المحظورة وطريقة التخزين
settings.security.minPasswordLengthكلمات المرور الأقصر لن تُقبل.
settings.security.passwordMaxLengthالحد الأعلى لطول كلمة المرور.
settings.security.passwordHashخوارزمية التجزئة. BCRYPT و ARGON2 بطيئتان عمدًا، وهذا جيد: يصبح تخمين القوة الغاشمة مكلفًا. القيم الأخرى في القائمة مطلوبة عندما تأتي قاعدة بيانات كلمات المرور من محرك منتدى.
تغيّر الخوارزمية على خادم قيد التشغيل؟ أضف القديمة إلى settings.security.legacyHashes، وإلا لن يتمكن الناس من تسجيل الدخول بكلمات مرورهم.
settings.security.unsafePasswordsلا يمكن استخدامها ككلمات مرور. اكتبها بأحرف صغيرة. احرص على إبقاء help: فالتوثيق يحذّر من تعارض مع الأمر.
settings.restrictions.allowedPasswordCharactersتعبير نمطي. القيمة الافتراضية [!-~] تعني كل أحرف ASCII المرئية، وهو ما يوصي به المؤلفون.
أسماء المستخدمين
أي الأسماء مسموح بها على الخادم أصلًا
settings.restrictions.minNicknameLengthالألقاب الأقصر لن يُسمح لها بالدخول.
settings.restrictions.maxNicknameLengthحد Minecraft القياسي هو 16.
settings.restrictions.allowedNicknameCharactersتعبير نمطي. الافتراضي هو الأحرف اللاتينية والأرقام والشرطة السفلية، كما تسمح اللعبة نفسها.
البوتات والقوة الغاشمة
الحماية من الانضمام الجماعي وتخمين كلمات المرور
Protection.enableAntiBotتشغّل الإضافة الحماية تلقائيًا عند انضمام عدد كبير من اللاعبين في وقت قصير.
Protection.antiBotSensibilityعدد مرات الانضمام في الفترة الواحدة التي تُعد هجومًا.
Protection.antiBotIntervalالنافذة الزمنية التي تُحتسب خلالها عمليات الانضمام.
Protection.antiBotDurationعدد الدقائق التي تبقى فيها الحماية مفعّلة بعد تفعيلها.
Protection.quickCommands.denyCommandsBeforeMillisecondsإذا وصل أمر أسرع من هذا بعد الانضمام، فهذا بوت ويُطرد اللاعب.
Security.captcha.useCaptchaبعد عدة محاولات خاطئة يُعرض على اللاعب رمز لإدخاله.
Security.captcha.maxLoginTryعدد الأخطاء المسموح بها قبل طلب الرمز.
Security.captcha.captchaLengthعدد الأحرف في الرمز.
Security.tempban.enableTempbanيُحظر العنوان إذا أُدخلت منه كلمة مرور خاطئة مرات كثيرة جدًا.
Security.tempban.maxLoginTriesعدد الأخطاء التي تتحملها الإضافة قبل حظر العنوان.
Security.tempban.tempbanLengthعدد الدقائق التي يستمر فيها حظر العنوان المؤقت.
Protection.enableProtectionيُسمح بتسجيل الدخول والتسجيل فقط من العناوين في قائمة الدول أدناه. يتطلب قاعدة بيانات GeoIP.
Protection.countriesرموز دول من حرفين. LOCALHOST لتسجيل الدخول من جهاز الخادم نفسه.
الأسئلة الشائعة
أين ألصق هذه الأسطر؟
في ملف plugins/AuthMe/config.yml على الخادم. يُخرج المنشئ المفاتيح المتغيرة فقط مع الحفاظ على تداخلها: ابحث عن المسار نفسه في ملفك واضبط القيمة. لا حاجة لاستبدال الملف كاملًا، لأن فيه إعدادات غير موجودة هنا. بعد التعديل، أعد تشغيل الخادم أو نفّذ /authme reload.
كيف أغيّر لغة رسائل الإضافة؟
اضبط settings.messagesLanguage على رمز اللغة الذي تحتاجه، مثل ru. الافتراضي هو en، لذا تخاطب نسخة AuthMe المثبتة حديثًا اللاعبين بالإنجليزية. هناك أيضًا settings.perPlayerLocale: عند تفعيله يحصل كل لاعب على الرسائل بلغة لعبته، وتُستخدم القيمة أعلاه كبديل احتياطي.
يشكو اللاعبون من اضطرارهم لإدخال كلمة المرور بعد كل انقطاع
فعّل الجلسات: اضبط settings.sessions.enabled على true واضبط settings.sessions.timeout، مثلًا على 30 دقيقة. تتذكر الإضافة الاسم المستعار وعنوان IP، ولن تطلب كلمة المرور من العنوان نفسه خلال تلك المدة. تنتهي الجلسة إذا تغيّر عنوان IP، وهذا غير قابل للضبط.
ماذا أفعل إذا كان الخادم تحت هجوم بوتات؟
للإضافة مضاد بوتات مدمج: Protection.enableAntiBot مفعّل افتراضيًا، ويحدد Protection.antiBotSensibility عدد مرات الدخول في الفترة الواحدة التي تُعد هجومًا. تساعد أيضًا كلمة التحقق بعد عدة كلمات مرور خاطئة والحظر المؤقت للعنوان بسبب التخمين. الإعداد المسبق «تحت هجوم بوتات» أعلاه يفعّل كل هذا دفعة واحدة.
كن حذرًا مع فلتر الدول
يقيّد Protection.enableProtection الدخول بقائمة دول، لكن هذه القائمة تحتوي افتراضيًا على US وGB وLOCALHOST. إذا فعّلت الحماية دون تعديل القائمة، سيتوقف اللاعبون من كل دولة أخرى عن القدرة على الدخول. رموز الدول هي رموز ISO 3166 المكوّنة من حرفين.
هل يمكن للاعبين المرخّصين الدخول دون كلمة مرور؟
نعم، هذا ما يفعله settings.enablePremium. يُتحقق تلقائيًا من اللاعبين الذين لديهم حساب Minecraft رسمي ولا يدخلون كلمة مرور، وينضم الآخرون كالمعتاد. تختار الإضافة طريقة التحقق تلقائيًا.
أي طريقة لتخزين كلمات المرور أختار؟
الافتراضي هو SHA256. صُمم BCRYPT وARGON2 ليكونا بطيئين في الحساب عمدًا، وهذا هو المقصود: يصبح التخمين مكلفًا. مهم: إذا غيّرت الخوارزمية على خادم قيد التشغيل، أضف القديمة إلى settings.security.legacyHashes، وإلا لن يتمكن الناس من تسجيل الدخول بكلمات مرورهم.
يمكن للزائر رؤية إنشاءات الآخرين قبل تسجيل الدخول
فعّل settings.restrictions.teleportUnAuthedToSpawn: قبل تسجيل الدخول يبقى اللاعب في نقطة الظهور، وبعد تسجيل الدخول يعود إلى حيث كان. يقترن هذا عادةً بإخفاء الدردشة ومنع الحركة.
من أين تأتي البيانات
أُخذت أسماء الإعدادات والقيم الافتراضية من الوثائق الرسمية للإضافة في 1 سبتمبر 2026. يحتوي المنشئ على الإعدادات التي يغيّرها الناس يدويًا فعليًا، أما الباقي فينشئه الإضافة بنفسه.