خوادم Minecraft مع إضافة SkinsRestorer

## 🔌 حول SkinsRestorer SkinsRestorer هو إضافة Minecraft لاستعادة وإدارة سكنات اللاعبين على خوادم online-mode وoffline-mode. يوفر أوامر داخل اللعبة وواجهة GUI والتخزين المؤقت وميزات السكنات المخصصة، بحيث يمكن للخوادم تطبيق سكنات اللاعبين وتغييرها بشكل موثوق حتى عندما تكون خدمات السكن الخارجية غير متاحة. ## 🎯 الهدف يعالج SkinsRestorer مشكلة السكنات المفقودة أو الافتراضية (Steve/Alex) على الخوادم، خصوصًا خوادم offline/cracked أو الشبكات الكبيرة التي تحتاج إلى تطبيق السكن فورًا أو من التخزين المؤقت. وهو موجه لمديري الخوادم الذين يحتاجون إلى معالجة متسقة للسكنات عبر اللاعبين وproxies. ## ⚙️ المميزات - تطبيق سكن حساب اللاعب عند الانضمام أو تطبيق سكنات افتراضية/مخصصة للاعبين غير المميزين. - أمر `/skin` للاعبين (بما في ذلك إنشاء سكن عبر URL) وواجهة GUI لتصفح/اختيار السكنات. - دعم السكنات المخصصة (رفع / سكنات عبر URL) وإنشاء سكنات مخصصة على مستوى الخادم بالكامل. - التخزين المؤقت والطلبات الواعية لمعدل الاستخدام إلى Mojang/MineSkin لتحسين الاعتمادية في الشبكات الكبيرة. - خيارات إعداد لتقييد السكنات، وصلاحيات لكل سكن، وسلوك السكن الافتراضي، وإعدادات GUI. - تشغيل متوافق مع proxy وخيارات إعداد خاصة بالـ backend/proxy. ## 🧩 لمن هذا الإضافة - خوادم Survival وSMP التي تريد عرض سكنات موثوقًا. - خوادم offline-mode أو cracked التي تحتاج إلى دعم تجميلي للاعبين غير المميزين. - الشبكات التي تستخدم proxies أو عدة خوادم backend وتحتاج إلى سلوك سكن مخزن مؤقتًا أو متسق. ## 🏗️ حالات استخدام مثال - خادم خاص offline يسمح للاعبين بتغيير السكنات باستخدام `/skin <name>` دون الحاجة إلى امتلاك حساب Mojang. - شبكة تخزن السكنات مؤقتًا حتى يظل مظهر اللاعب ثابتًا عندما تكون خدمات السكن upstream بطيئة أو غير متاحة. - يحدد المسؤول مجموعة سكن افتراضية للاعبين الجدد أو غير المميزين عبر الإعدادات. ## ⌨️ الأوامر | **Command** | **Description** | **Permission** | **Access** | |---|---|---|---| | `/skin <skin>` | تعيين سكن اللاعب إلى سكن باسم محدد أو سكن الحساب. | (انظر permissions) | Player | | `/skin url "<url>"` | إنشاء/تطبيق سكن من رابط صورة خارجي. | (انظر permissions) | Player | | `/skull` | إنشاء أو استرجاع جماجم اللاعبين (يمكن تعطيل تسجيل الأمر). | غير محدد | Player | | `/skins` | فتح GUI السكنات (يمكن تعطيل تسجيل الأمر). | غير محدد | Player | | `/sr createcustom` | إنشاء إدخال سكن مخصص للخادم (إجراء على مستوى المسؤول). | غير محدد | Admin | (ملاحظة: يمكن تفعيل أو تعطيل تسجيل الأوامر من الإعدادات؛ وتوثق العقد الدقيقة للصلاحيات للعديد من الأوامر في دليل الأوامر والصلاحيات الخاص بالإضافة.) ## 🔐 Permissions | **Permission** | **Description** | **Default** | |---|---|---| | `skinsrestorer.player` | صلاحية أساسية تُمنح للاعبين لاستخدام ميزات السكن (يمكن فرضها عبر config). | true | | `skinsrestorer.skin.<name>` | صلاحية لكل سكن مطلوبة عند تفعيل `perSkinPermissions` لسكنات محددة. | غير محدد | ## ⚙️ التثبيت ### 📥 الإعداد - حمّل ملف JAR الرسمي للإضافة من صفحة الإصدارات الخاصة بالمشروع. - ضع ملف JAR في مجلد `plugins/` الخاص بالخادم على backend متوافق مع Spigot/Paper (أو إعداد proxy/backend المناسب عند استخدام proxies). - شغّل الخادم أو أعد تشغيله وتحقق من سجل الكونسول للتأكد من أن SkinsRestorer تم تحميله. ### 📦 Dependencies - الدعم للتكامل الاختياري مع MineSkin متوفر (يمكن إعداد API key لتسريع إنشاء السكنات). لا توجد تبعيات إضافية إلزامية مذكورة في الوثائق الرسمية. ### 🧾 الإعدادات - تستخدم الإضافة إعدادات YAML مع خيارات للسكنات الافتراضية، ووقت تبريد الأوامر، وتبويبات GUI، وصلاحيات كل سكن، وإعدادات proxy/backend، والتخزين المؤقت. - تتضمن مفاتيح الإعدادات أعلامًا مثل `forceDefaultPermissions` و`perSkinPermissions` و`disableSkinCommand` و`enablePaperJoinListener` (المستخدمة لتحسين تطبيق السكن الفوري في Paper). ## 🧠 ملاحظات تقنية - يدعم الإعدادات المتوافقة مع proxy (backend مقابل proxy) ويحتوي على خيارات لاكتشاف وضع proxy. - يوفر التخزين المؤقت وسلوك التجميع لتجنب حدود معدلات واجهة برمجة التطبيقات عند الاتصال بـ Mojang أو خدمات السكن الخارجية. - تكشف الإعدادات عن دعم API key الخاص بـ MineSkin لإنشاء سكنات أسرع/مدارة بشكل اختياري. - المشروع مفتوح المصدر ويتم صيانته مع إصدارات على GitHub وتوثيق متاح على موقع الوثائق الرسمي. ## 🤝 متى تكون هذه الإضافة مفيدة إذا كنت تحتاج إلى معالجة سكنات متسقة وقابلة للتخصيص للاعبين عبر خوادم online/offline أو شبكات proxy — بما في ذلك السكنات المخصصة، والسكنات عبر URL، والتخزين المؤقت للاستمرار أثناء انقطاع الخدمات الخارجية — فإن SkinsRestorer يوفر أدوات وإعدادات مركزة لإدارة هذه الاحتياجات بشكل موثوق.

الإضافات