خوادم Minecraft (Paper و Velocity و Bungee)

إيقاف اتصالات VPN والبروكسي قبل أن ينضموا إلى عالم لعبتك.

يفحص ProxyTracer عناوين IP للاعبين المنضمين مقابل ProxyTracer API عالية الدقة ويسمح لك بـ حظر أو تحذير أو تسجيل الاتصالات الخبيثة. مثالي لمنع التحايل على الحظر، والحسابات البديلة، وغارات البوتات المعتمدة على VPN.

معاينة

شاشة الطرد داخل اللعبة	تنبيه تحذير وحدة التحكم

لماذا ProxyTracer؟

كشف في الوقت الفعلي: فحوصات دقيقة مقابل قواعد بيانات ProxyTracer المحدثة باستمرار لشبكات VPN السكنية والعامة.
دعم أصيل للمنصات المتعددة: تكاملات مخصصة للخوادم الفردية (Paper/Spigot) وشبكات الخوادم المتعددة (Velocity أو BungeeCord/Waterfall).
أداء فائق السرعة: تخزين مؤقت مدمج في الذاكرة يوفر رصيد API ويضمن اتصال اللاعبين العائدين فوراً.
قائمة بيضاء ذكية: أوامر تجاوز القائمة البيضاء لأسماء اللاعبين الموثوقين وعناوين IP للشبكة.
تنبيهات ديسكورد: تسجيل عمليات الانضمام المحظورة عبر VPN مباشرة إلى قنوات طاقم الإدارة لديك.
شاشة طرد مميزة: تظهر للاعبين رسالة حظر احترافية تشير إلى proxytracer.com.

أي ملف jar يجب تثبيته؟

إعدادك	ثبت ملف jar هذا	الموقع	الإجراء
خادم فردي Paper / Spigot / Purpur	`proxytracer-bukkit-1.4.0.jar`	مجلد `plugins/` في خادم اللعبة	تنزيل
شبكة بروكسي Velocity	`proxytracer-velocity-1.4.0.jar`	مجلد `plugins/` في خادم البروكسي (لا تثبته على Paper)	تنزيل
شبكة BungeeCord / Waterfall	`proxytracer-bungee-1.4.0.jar`	مجلد `plugins/` في خادم البروكسي (لا تثبته على Paper)	تنزيل

قاعدة: ثبت ProxyTracer حيث يكون عنوان IP الحقيقي للعميل مرئياً. إذا كنت تدير شبكة بروكسي (Velocity أو BungeeCord)، فقم بتثبيته فقط على البروكسي. لا تشغل ملحقات Bukkit و Velocity معاً في وضع الحظر (يؤدي هذا إلى ازدواجية الفوترة وفحوصات مكررة).

إعداد سريع (60 ثانية)

احصل على مفتاح API مجاني من: ProxyTracer.com/dashboard
قم بتنزيل ملف jar المناسب لإعدادك من Releases.
ضع ملف jar في مجلد plugins/ بخادمك وشغّله مرة واحدة.
اضبط مفتاح API الخاص بك مباشرة داخل اللعبة أو عبر وحدة التحكم (Console):
```
/proxytracer set your_api_key_here
```
(يقوم هذا تلقائياً بكتابة المفتاح في ملف التكوين وإعادة تحميل الملحق).
تحقق من الاتصال بتشغيل: /proxytracer status

أبرز نقاط التكوين


mode: "block"          # الإجراء عند اكتشاف بروكسي: block | warn | log
 
api:
  base-url: "https://api.proxytracer.com/v1"
  key: "proxy_your_key_here"
  on-error: "allow"    # سياسة Fail-open إذا توقفت API عن العمل: allow | block | warn
  timeout-ms: 2000
 
notifications:
  in-game: false       # إرسال رسائل دردشة ملونة داخل اللعبة لطاقم الإدارة (proxytracer.notify)
 
cache:
  enabled: true
  ttl-minutes: 1440    # تخزين نتيجة فحص IP مؤقتاً لمدة 24 ساعة
  max-entries: 10000
 
discord:
  enabled: false
  webhook-url: ""
  notify-blocked: true

الأوامر والأذونات

تبدأ جميع الأوامر بـ /proxytracer:

/proxytracer notify <on|off|toggle> — تبديل رسائل الدردشة الملونة داخل اللعبة لطاقم الإدارة.
/proxytracer notify add|remove|list [player] — إضافة/إزالة/عرض أسماء مستخدمي الإدارة المسموح لهم بتلقي إشعارات داخل اللعبة (تُحفظ تلقائياً في config.yml).
/proxytracer set <api_key> — تعيين مفتاح API مباشرة وحفظه في config.yml وإعادة التحميل.
/proxytracer status — التحقق من حالة التكوين، وبيانات اعتماد API، وحالة الإشعارات داخل اللعبة.
/proxytracer check <ip> — الاستعلام عن عنوان IP يدوياً.
/proxytracer cache clear — مسح الذاكرة المؤقتة المحلية لعناوين IP.
/proxytracer reload — إعادة تحميل ملف التكوين.
/proxytracer whitelist name add|remove|list [player] — إعفاء اللاعبين من الفحوصات.
/proxytracer whitelist ip add|remove|list [ip] — إعفاء عناوين IP للشبكة من الفحوصات.

الأذونات:

proxytracer.admin — الوصول إلى أوامر إعادة التحميل والحالة والإدارة.
proxytracer.bypass — يتجاوز اللاعبون الذين يمتلكون هذا الإذن متطلبات الفحص أثناء مرحلة ما قبل تسجيل الدخول.
proxytracer.notify — يتلقى طاقم الإدارة تحذيرات داخل اللعبة عند تسجيل أو تحذير مستخدم VPN.

(ملاحظة: افتراضياً، يتم تعيين هذه الأذونات فقط لمشغلي الخادم (OPs). لمنح هذه الأذونات للاعبين آخرين أو مجموعات الإدارة، استخدم ملحق إدارة أذونات مثل LuckPerms).

التوافق والمتطلبات

إصدار Java: Java 17 أو أعلى (تم اختباره بالكامل على Java 17 و 21 و 22). تم تجميع الملحق باستهداف Java 17.
دعم برامج الخادم: Paper / Spigot / Purpur (من 1.13 إلى 1.21.x)، و Velocity (الإصدار 3.x)، و BungeeCord / Waterfall (الإصدارات الحديثة).
الوصول إلى API: مفتاح API مجاني أو مدفوع مسجل على proxytracer.com.

استكشاف الأخطاء: مشاكل IP الحقيقي (`127.0.0.1`)

إذا أظهرت سجلاتك أن كل لاعب منضم يتصل من 127.0.0.1، فلن تتمكن واجهة ProxyTracer API من فحصهم. يشير هذا إلى أن تخطيط شبكة الاستضافة أو البروكسي الأمامي يحجب عناوين IP الحقيقية للاعبين.

كيفية الإصلاح:

لشبكات البروكسي (Velocity / Bungee): انشر ProxyTracer فقط على بروكسي البوابة (Velocity/Bungee). تأكد من تفعيل تمرير معلومات اللاعب (player-info-forwarding-mode = "modern" في velocity.toml أو ip_forward: true في config.yml الخاص بـ Bungee) حتى تتلقى عقد اللعبة الخلفية عنوان IP الحقيقي.
للاستضافات المشتركة (مثل بروكسيات لوحة TickHosting): إذا كان مضيفك يمرر ترويسات الاتصال عبر بروتوكول البروكسي (Proxy Protocol)، فقم بتمكينه داخل تكوين Paper لديك (proxies.proxy-protocol: true في config/paper-global.yml) وأعد التشغيل. تحذير: لا تفعل هذا الخيار ما لم يكن مضيفك يدعمه صراحة؛ حيث سيؤدي التكوين الخاطئ لمنع جميع اللاعبين من الانضمام.

الأسعار وحصص API

ملحقات ProxyTracer لـ Minecraft مجانية 100%. يتطلب الكشف اتصالاً بـ ProxyTracer API:

- الخطة المجانية: 100 فحص/شهرياً لخوادم SMP الصغيرة والتطوير.
- Starter (3 يورو/شهرياً): مثالية للخوادم العامة المتنامية.
- Pro (9 يورو/شهرياً) / Scale (39 يورو/شهرياً): مخصصة للشبكات الراسخة.

أنشئ مفتاحك واختر خطة: ProxyTracer