بروتبوف لودر

قم بتحميل ملف protobuf(.data) في وقت التشغيل.
جميع التعديلات مفتوحة المصدر فيجيثب.
شكر خاص لـ@chenstackلـ CSharpLoader

النص التالي مخصص بشكل أساسي للمطورين.
إذا كنت مستخدمًا، فلن تحتاج حقًا إلى معرفة تفاصيل حول هذا التعديل.
كل ما عليك فعله هو اتباع تعليمات التثبيت الخاصة بمؤلف آخر إذا قال أن تعديله يتطلب هذا التعديل.
واعرف أن Ctrl+F7 هو مفتاح إعادة التحميل السريع.

كيفية تحميل ملف .Data:


لماذا تحتاج هذا؟
يمكن لهذا التعديل تحميل السجل واحدًا تلو الآخر بدلاً من الكتابة فوق الجدول بأكمله.
إذا قام المُعدِّلون بإنشاء تعديلات ".data" بدلاً من تعديلات ".pak"، فهناك فرصة جيدة جدًا لعدم تعارضهما مع بعضهما البعض.
(هذا التعديل لا يحذف جميع التعارضات تلقائيًا! حتى لو ثبّتته، ستظل تعديلات "pak" القديمة لديك متعارضة كما كانت من قبل.)
بالنسبة للمعدلين، يمكنك تعديل ملف .data وإعادة تحميله في وقت التشغيل. يوفر لك هذا الوقت لحزم الحزم وتصحيح أخطائها أو دمجها للمستخدمين.

كل ما عليك فعله هو الحصول على mod mod، وما هو نوع mod الذي يمكنك الحصول عليه!!!
يجب أن يكون لديك معلومات حول كيفية الحصول على بيانات وزارة الدفاع发布并以该mod加载،就不会像以前pak文件那样极易冲突了
الحصول على البيانات الخاصة بك من خلال حزمة البيانات

ملحوظة:

0.إعادة التحميل وإعادة الضبط
اضغط على Ctrl+F7 لإعادة تحميل ملفات البيانات.
البيانات في الذاكرةسيتم إعادة تعيين(منذ الإصدار 1.1) قبل إعادة التحميل.
ولكن لن يتم إعادة تعيين أنواع البيانات التي لا يمكن استنساخها.
سيقوم هذا التعديل بتعديل prorobuf وتحديث ذاكرة التخزين المؤقت في GameDB عند إعادة التحميل.

اضغط على Ctrl + F8 لإعادة التعيين.
عند تحميل ملفات البيانات، يقوم هذا التعديل بتخزين القيم قبل تعديلها.
عند إعادة التعيين، يقوم هذا التعديل بكتابة السجلات المخزنة مرة أخرى.
إذا قام مسؤول آخر بتعديل السجل الذي تم تعديله بواسطة هذا المسؤول بين التحميل وإعادة التعيين، فسيتم فقد هذه التغييرات.
عند الضغط على Ctrl+F7 لإعادة التحميل، سيتم إعادة تعيين هذا الوضع تلقائيًا قبل إعادة التحميل.

اضغط على Ctrl+F9 لإعادة الضبط.
قم بإعادة تحميل كل شيء من الملفات الافتراضية.
عند إعادة الضبط، يحاول هذا التعديل استعادة البيانات المُعدَّلة فقط. عند إعادة الضبط الفائقة، يتجاهل هذا التعديل جميع البيانات ويُحمِّلها من ملفات .pak (كما فعلت اللعبة عند بدء التشغيل).
إذا لم يكن هناك خطأ أو فشل في التحميل أو تعديل آخر يغير protobuf، فيجب أن يكون لـ "إعادة التعيين" و"إعادة التعيين الفائقة" نفس التأثير تمامًا.

1. ترتيب التحميل:
يقوم هذا التعديل بتحميل المجلدات الفرعية فيالترتيب المعجمي(ترتيب القاموس).
على سبيل المثال، يجب تحميل المجلد "100_abc" قبل "200_lalla".
لن يتم البحث في المجلد بشكل متكرر. على سبيل المثال، لن يتم تحميل الملفات الموجودة ضمن "CSharpLoader/Mods/ProtobufLoader/BestSuit/MoreSuitSubDir/".
يوصى بشدة بتسمية المجلد الخاص بك على هيئة [رقم]_[اسم] في حالة احتياجك إلى التحميل بترتيب معين.

بالنسبة للملفات الموجودة في نفس المجلد:
يقوم هذا التعديل بتحميل جميع ملفات ".data" (باستثناء ".insert.data" أو ".bak.data") حسب ترتيب القاموس أولاً،
ثم يقوم هذا التعديل بتحميل كافة ".insert.data" حسب ترتيب القاموس.

2. قاعدة التحميل
عندما يتم تحميل سجل في ".data".
إذا لم يكن موجودًا في الجدول في الذاكرة، فسيتم إضافته إلى الجدول.
إذا كان موجودًا بالفعل في الجدول في الذاكرة، فسيتم حفظ السجل القديمتماما تم استبدالهبالواحد الجديد.
يعني أنه يمكنك الحصول على العديد من ملفات البيانات التي تعدل نفس الجدول، ولن تتعارض طالما أنها لا تعدل نفس السجل.
إذا قاموا بتعديل نفس السجل،الفائز هو الأخير المحمل.

عندما يتم تحميل سجل في ".insert.data".
إذا لم يكن موجودًا في الجدول في الذاكرة، فسيتم إضافته إلى الجدول.
إذا كان موجودًا بالفعل في الجدول في الذاكرة، فقم بزيادة معرفه حتى لا يكون المعرف الجديد موجودًا في الجدول. قم بتعديل معرفه وإدراجه في الجدول بالمعرف الجديد.

سيقوم هذا التعديل بتحميل الملفات بعد بدء التوطين.
عندما يتم تحميل هذا التعديل بواسطة CSharpLoader، إذا كان كل من GameInstance وGSLocalization قد أنهيا عملية التهيئة، فسوف يقوم هذا التعديل بتحميل الملفات على الفور.
بخلاف ذلك، سيقوم هذا التعديل بتحميل الملفات بمجرد بدء تشغيل GSlocalization.

3. ماذا يعدل هذا التعديل؟
عمومًا، البيانات الموجودة في اللعبة موجودة في:
أ) الملفات الافتراضية في .pak.
ب) ذاكرة التخزين المؤقت GSProtobufRuntimeAPI/BG_ProtobufDataAPI في الذاكرة.
ج) ذاكرة التخزين المؤقت GameDBRuntime/BGW_GameDB في الذاكرة
د) حالات أخرى في الذاكرة

عند بدء اللعبة، تقوم اللعبة بقراءة جميع البيانات من A إلى B، ثم تقوم ببناء ذاكرة التخزين المؤقت لبعض البيانات في C.
أثناء عملية اللعبة، تقوم بعض الحالات بالقراءة مباشرة من B/C، بينما تقوم حالات أخرى ببناء ذاكرة تخزين مؤقتة من B/C في D عند بدء اللعبة ثم القراءة من D لاحقًا.

عندما تستخدم تعديل `pak` التقليدي، فإنك في الواقع تتجاوز A.
عندما يقوم هذا التعديل بتحميل التعديلات، فإنهيعدل B ويفرض إعادة بناء C.


4.2. ملف التكوين:
ProtobufLoader/Config.json:
اسكت: تقليل إخراج السجل إذا كان صحيحًا. خطأ افتراضيًا.
إذا كان لديك ملفات بيانات ضخمة لتحميلها، قم بتشغيل هذا لتحسين الأداء.
اصمت: قلل من إخراج السجل في المستقبل أكثر إذا كانت القيمة صحيحة. افتراضيًا، القيمة خاطئة.
اسكت: لن يتم عرض أي سجل إلا في حالة مواجهة خطأ إذا كانت القيمة صحيحة. القيمة خاطئة افتراضيًا.
تمكين سجل وحدة التحكم الصينية:تعيين صفحة التعليمات البرمجية لوحدة التحكم CSharpLoader إلى UTF-8لعرض سجل وحدة التحكم الصينية بشكل صحيح. صحيح افتراضيًا. (أوقف هذه الميزة إذا كنت بحاجة إلى أحرف أخرى في وحدة التحكم.)

4.3.إشعار: إذا كنت تريد تعديل عدة سجلات في جدول.
يجب أن يحتوي ملف البيانات الخاص بك علىفقطالسجلات المعدّلة لتجنب التعارضات. (لأن هذا هو الهدف الأساسي من استخدام هذا المُحمِّل.)

(إذا كنت بحاجة إلى زر "حذف أي شيء آخر غير هذا" في محرر البيانات.
يمكنك الانتظار حتى يقوم مؤلف DataEditor بإضافته.
أو استخدمشوكة محرر البيانات الخاصة بي.)

5.الجداول التالية غير مدعومة.


6. كن حذرًا من العناصر التي تحمل نفس الاسم ولكن معرفًا مختلفًا.
على سبيل المثال،
قد يحتوي الدواء على عنصر وصفة وعنصر دواء في جدول العناصر بنفس الاسم. لكنهما مختلفان.
يمكن أن يحتوي الجهاز على عدة سجلات لكل مستوى في جدول الجهاز.
يمكن أن يكون لتأثير القوة السلبية عدة سجلات لكل مستوى أيضًا.
إلخ.

7. كن على دراية بالبيانات التي تتم قراءتها فقط من جدول desc عند التهيئة.
على سبيل المثال،
يتم استخدام جدول TransQiTianDaShengConfigDesc لبدء تشغيل BUS_QiTianDaShengComp.
إذا قمت بإعادة تحميل الجدول بعد بدء اللعبة، فقد لا يسري ذلك لأنه لم يتم استدعاء دالة init مرة أخرى بعد.



أمثلة على ملفات البيانات:
يمكنك تنزيل الأمثلة التالية في صفحة الملف.
100_增加一个珍玩套装(君子牌风铎仙篆)增加火抗
200_锦鳞套加2条套装效果_日金乌套改为加大量攻防
300_青田葫芦改为10口上限
400_金箍棒(大圣套)添加天龙棍效果
500_行者套改为1件即可触发
600_InsertData_插入全局设置和被动技能映射
مثال على تحويل التعديلات الموجودة إلى إصدار ملف بيانات

يمكنك استخداممحرر البياناتللتحقق مما فعلوه بالضبط.
(لاحظ أن بعض الأمثلة تعدل نفس الجدول ويمكنها العمل في نفس الوقت.
ويحتوي كل ملف بيانات مثال على السجلات الضرورية فقط.)


التثبيت يدويًا:
0.تثبيتسي شارب لودر(>= الإصدار 0.0.8)
(لاحظ أن الإصدار الأقل من هذا التعديل قد لا يعمل مع أحدث إصدار من CSharpLoader. يُنصح أيضًا بتحديث هذا التعديل إذا كنت ترغب في ترقية CSharpLoader)

1. قم بتنزيل ملف zip واستخراجه.

2.
انسخ المجلد [ModName] إلى[GameFolder]\b1\Binaries\Win64\CSharpLoader\Mods\
يجب أن يكون هيكل الدليل مثل:
-- b1\Binaries\Win64\CSharpLoader\Mods\
-- [اسم التعديل]
-- [اسم التعديل].dll

التثبيت بواسطة Vortex:
مدعوم