يمكّنك Zomboid-RCON من التواصل بسهولة مع خوادم Zomboid لمشروعك عبر RCON. باستخدام Zomboid-Rcon ، يمكنك إرسال أوامر إلى الخادم الخاص بك ، وإدارة اللاعبين ، وأكثر من ذلك ، كل ذلك من داخل البرنامج النصي Python الخاص بك.
للبدء ، ما عليك سوى تثبيت zomboid-rcon باستخدام PIP:
pip install zomboid-rconباستخدام Zomboid-RCON أمر سهل. إليك مثال أساسي:
from zomboid_rcon import ZomboidRCON
if __name__ == "__main__" :
pz = ZomboidRCON ( ip = 'localhost' , port = 12345 , password = 'myPassword' )
command = pz . serverMsg ( "You dead yet?" )
print ( command . response )يتصل هذا المثال بخادم يعمل على جهازك المحلي ويرسل الرسالة "أنت ميت حتى الآن؟".
يوفر Zomboid-RCON العديد من الطرق المدمجة لمهام إدارة الخادم الشائعة ، مثل الحصول على قائمة من اللاعبين المتصلين:
from zomboid_rcon import ZomboidRCON
if __name__ == "__main__" :
pz = ZomboidRCON ( ip = 'localhost' , port = 12345 , password = 'myPassword' )
print ( pz . players (). response )يطبع هذا المثال قائمة بجميع اللاعبين المتصلين حاليًا بالخادم.
يوفر Zomboid-RCON طرقًا مدمجة لأوامر RCON المتاحة داخل Project Zomboid.
additem("user", "item") : يمكن العثور على العناصر على pz wiki: https://pzwiki.net/wiki/Itemsaddvehicle("user") : يولد السيارة.addxp("user", "perk", xp) : يعطي XP للمشغل.alarm() : يبدو إنذارًا للمبنى في موضع المسؤول. يجب أن تكون في غرفة.changeoption("option", "newOption") : يغير خيار الخادم.chopper() : يضع حدث طائرة هليكوبتر على لاعب عشوائي.changepwd("pwd", "newPwd") : يغير كلمة المرور الخاصة بك.createhorde("number") : يولد حشد بالقرب من لاعب.godmode("user") : يجعل اللاعب لا يقهر.gunshot() : يصدر ضجيج ناري بالقرب من اللاعب.help() : يجلب قائمة المساعدة. (يسرد أوامر RCON الأصلية. لجميع أوامر zomboid_rcon ، راجع هذه القائمة)invisible("user") : يجعل اللاعب غير مرئي للزومبي.noclip("user") : يسمح للاعب بالمرور عبر كائنات صلبة.quit() : يحفظ ويتوقف عن الخادم.releasesafehouse() : تصدر منزل آمن تملكه.reloadlua("filename") : إعادة تحميل البرنامج النصي LUA على الخادم.reloadoptions() : إعادة تحميل خيارات الخادم.replay("user", [-record | -play | -stop], "filename") : السجلات وتلعب إعادة تشغيل لاعب متحرك.save() : ينقذ العالم الحالي.sendpulse() : تبديل إرسال معلومات أداء الخادم إلى العميل.showoptions() : يعرض قائمة بخيارات وقيم الخادم الحالية.startrain() : يبدأ المطر على الخادم.stoprain() : توقف المطر على الخادم.teleport("user", "toUser") : Teleports to a Player.teleportto(x, y, z) : النقل الفضائي إلى بعض الإحداثيات.addalltowhitelist() : يضيف جميع المستخدمين الحاليين المتصلين بكلمة مرور إلى القائمة البيضاء.adduser("user", "pwd") : يضيف مستخدمًا جديدًا إلى القائمة البيضاء.addusertowhitelist("user") : يضيف مستخدمًا واحدًا متصلًا بكلمة مرور إلى القائمة البيضاء.removeuserfromwhitelist("user") : يزيل مستخدمًا واحدًا متصلًا بكلمة مرور إلى القائمة البيضاء.banid("SteamID") : حظر معرف البخار.unbanid("SteamID") : unfans معرف البخار.banuser("user") : حظر المستخدم.unbanuser("user") : Unlans مستخدم.checkModsNeedUpdate() : يشير إلى ما إذا كان قد تم تحديث وزارة الدفاع. يكتب الإجابة على ملف السجل.grantadmin("user") : يعطي حقوق المسؤول للمستخدم.removeadmin("user") : يزيل حقوق المسؤول إلى مستخدم.kickuser("user") : يركل مستخدم من الخادم.players() : يسرد جميع اللاعبين المتصلين.servermsg("message") : بث رسالة إلى جميع اللاعبين. (يتم استبدال المساحات مع السطح السفلي للتوافق)setaccesslevel("user", [admin | moderator | overseer | gm | observer]) : قم بتعيين مستوى الوصول/إذن للاعب.voiceban("user", [-true | -false]) : حظر مستخدم من استخدام ميزة الصوت.يمكنك تنفيذ أي أمر مخصص باستخدام طريقة الأمر:
pz . command ( "command" , "arg1" , "arg2" , "etc" )يرجى ملاحظة أن Zomboid-rcon يستخدم حزمة timeout_decorator ، والتي تتوافق حاليًا فقط مع أنظمة UNIX/Linux. نتيجة لذلك ، قد تتسبب الموعد في أخطاء على آلات Windows . نحن نعمل بنشاط على إيجاد حل بديل لمستخدمي Windows.
نرحب بالمساهمات من أي شخص! إذا كنت ترغب في المساهمة في المشروع ، فيرجى فتح مشكلة أو إرسال طلب سحب على Github.
تم ترخيص Zomboid-RCON بموجب ترخيص GPL-3.0.