PapyrusUtil SE - وظائف أداة برمجة النصوص للمُعدِّلين

1. الوصف
2. المتطلبات
3. التثبيت
4. إلغاء التثبيت
5. التحديث
6. التوافق والمشاكل
7. الاعتمادات
8. سجل التغييرات


1. وصف

إضافة SKSE تُمكّنك من حفظ أي عدد من قيم int وfloat وform وstring في أي نموذج أو عالميًا من نصوص Papyrus. كما تدعم قوائم أنواع البيانات هذه. يُمكن الوصول إلى هذه القيم من أي تعديل، مما يُتيح توافقًا ديناميكيًا سهلًا.

برنامج PapyrusUtil.psc - التحقق من الإصدار والمصفوفات المتغيرة المبدئية.
StorageUtil.psc - تخزين المتغيرات وقوائم البيانات في نموذج يمكن استرجاعها باستخدام اسم النموذج والمتغير كمفاتيح. راجع ملف psc للاطلاع على الوثائق.
JsonUtil.psc - مشابه لـ StorageUtil.psc ولكنه يحفظ البيانات في ملفات .json خارجية مخصصة بدلاً من النماذج، مما يسمح بتخصيصها خارج اللعبة وتخزينها بشكل مستقل عن ملف حفظ المستخدم.
MiscUtil.psc - بعض الأوامر المتنوعة.
ActorUtil.psc - تجاوز حزمة الممثل.

2. متطلبات
SKSE SE/AE 2.2.6+ http://skse.silverlock.org/
مكتبة العناوين لمكونات SKSE الإضافية: https://www.nexusmods.com/skyrimspecialedition/mods/32444

3. التثبيت
استخدم مدير التعديل أو استخرج الملفات يدويًا.


4. إلغاء التثبيت
قم بإزالة الملفات التي أضفتها في خطوة التثبيت رقم 9


5. تحديث
فقط قم بالكتابة فوق كافة الملفات.


6. التوافق والمشاكل
ينبغي أن تكون متوافقة مع كل شيء.


7. الاعتمادات
exiledviper - استمرار الصيانة وإعادة هيكلة الكود المصدري للمكون الإضافي الأصلي
meh321 - النسخة الأصلية، الفكرة، تحويل مكتبة العناوين
فريق SKSE - لجعل هذا البرنامج الإضافي ممكنًا
milzschnitte - for suggestions
eventHandler، Expired، aers، arha، ianpatt - مساعدة في تحويل وتحديث SKSE64



8. سجل التغييرات

4.6 AE/SE - 18/01/2024
تم التحديث لـ SKSE64 AE/SE 2.2.6 و Skyrim 1.6.1170

4.5 AE/SE - 12/05/2023
تم التحديث لـ SKSE64 AE/SE 2.2.4 و Skyrim 1.6.1130

4.4 AE/SE - 01/7/2022
تم التحديث لإصدار SKSE AE 2.2.2
تمت إضافة وظائف ListRandom() إلى StorageUtil وJsonUtil
إصلاح بعض الأخطاء

4.3 AE/SE - 01/07/2022
تم التحديث لإصدار SKSE AE 2.1.5

4.2 AE/SE - 14/12/2021
تم التحديث لإصدار SKSE AE 2.1.4

4.1 AE/SE - 23/11/2021
تم التحديث لإصدار SKSE AE 2.1.3
تم التحديث لمكتبة العناوين

4.0 AE/SE - 19/11/2021
تم التحديث لإصدار SKSE AE 2.1.2
تمت إضافة وظائف RemoveDupe() و GetDiff() و GetMatching() إلى PapyrusUtil.psc
تم إصلاح JsonUtil الذي يعيد قيمة نموذج خاطئة عند إلغاء تحميل البرنامج الإضافي المرتبط.

3.9 جنوب شرق - 02/04/2020
تم إصلاح تحميل نماذج FF المخصصة من الحفظ المشترك
تم تغيير موقع ملف السجل إلى My Documents/My Games/Skyrim Special Edition/SKSE/PapyrusUtilDev.log

3.8 جنوب شرق - 22/11/2019
تم التحديث لـ SKSE 2.0.17
تم إصلاح التعامل مع النماذج من ملف ESL

3.7b SE - 06/17/2019
تم التحديث لـ SKSE64 SE 2.0.16

3.7 جنوب شرق - 19/03/2019
تم التحديث لـ SKSE 2.0.13-15
تمت إضافة MiscUtil.FoldersInFolder()

3.6b SE - 09/10/2018
تم التحديث لـ SKSE64 SE 2.0.11

3.6 جنوب شرق - 09/10/2018
تم التحديث لـ SKSE64 SE 2.0.9/2.0.10

3.5 جنوب شرق - 09/10/2018
تم التحديث لـ SKSE64 SE 2.0.8
تم إصلاح وظائف Scan Cell في MiscUtil

3.4b SE - 04/05/2018
تم التحديث لـ SKSE64 SE 2.0.7
تم نسخ البرامج النصية إلى مسار creationkit /source/scripts


3.4 جنوب شرق - 01/05/2018
تمت إضافة وظائف ذات صلة بـ TFC
تمت إضافة وظائف تجاوز حزمة ActorUtil مرة أخرى
تم إصلاح المشكلة المتعلقة بالنماذج التي يتم تخزينها/إرجاعها بشكل خاطئ في بعض الأحيان أثناء نشاط ملف .esl في ترتيب التحميل

3.3c SE hotfix - 12/04/2017
تم التحديث لـ SKSE64 SE 2.0.6

3.3b SE الإصلاح العاجل - 11/12/2017
تم التحديث لـ SKSE64 SE 2.0.5
تمت إضافة وظيفة MiscUtil.SetMenus() مرة أخرى


3.3 SE- 21/10/2017
إصدار SKSE64 الأولي



3.3 - 15/09/2016
إصلاحات مختلفة لمختلف مشكلات CTD والأداء
وظائف JsonUtil الجديدة:
تمت إضافة وظائف المسار التعسفي للسماح بتنسيق JSON المخصص
JsonInFolder(string folder) للحصول على مجموعة من ملفات JSON الموجودة في مجلد معين
MiscUtil وظيفة جديدة:
ScanCellNPCsByFaction() للبحث في الخلية عن الجهات الفاعلة داخل فصيل معين
PapyrusUtil وظيفة جديدة:
GetScriptVersion() للحصول على إصدار البرنامج النصي المثبت الحالي، والذي قد يختلف عن قيمة DLL الخاصة بـ GetVersion() اعتمادًا على تثبيت التعديل المتنوع و/أو السيئ للمستخدم. 
الإصلاحات:
بعض الإصلاحات لمعالجة ملف JsonUtil والقيم المفقودة
هناك العديد من الإصلاحات الأخرى التي لا أستطيع تذكرها على وجه التحديد في الوقت الحالي


3.2 - 01/04/2016

• العديد من الإصلاحات لمختلف مشكلات CTD والأداء
• وظائف JsonUtil الجديدة:
      Unload() - تفريغ ملف من الذاكرة التي تم استخدامها بواسطة JsonUtil، وحفظ التغييرات اختياريًا أولاً IsPendingSave() - التحقق مما إذا كان ملف Json المحدد قد تم تعديله منذ آخر تحميل/حفظ له IsGood() - التحقق مما إذا كان ملف Json المحدد محملًا حاليًا أم لا ولا يحتوي على أخطاء GetErrors() - إرجاع سلسلة منسقة لأي أخطاء تحليل Json، إن وجدت JsonInFolder() - إرجاع مجموعة من جميع ملفات Json في دليل معين.
• StorageUtil وظائف جديدة:
      كونت أوبج<type> Prefix() - يحسب عدد المفاتيح التي تبدأ بسلسلة على كائن معين ClearObj<type> Prefix() - يزيل أي قيم بمفاتيح تبدأ بسلسلة على كائن معين
• وظائف MiscUtil الجديدة:
      FilesInFolder() - تُرجع مصفوفة من جميع الملفات، أو الملفات ذات الامتدادات المحددة، الموجودة في مجلد. ScanCellActors() - تحصل على مصفوفة من العناصر القريبة في خلية مطابقة للمعايير. ScanCellObjects() - تحصل على مصفوفة من الكائنات القريبة من نوع شكل محدد في خلية مطابقة للمعايير. WriteToFile() - أُعيدت إضافتها بعد حذفها في التحديث السابق. ReadFromFile() - أُعيدت إضافتها بعد حذفها في التحديث السابق.

3.1 - 09/01/2015

• تم إصلاح خطأ يتسبب في حدوث CTD أثناء تحميل الحفظ لبعض المستخدمين.
• تمت إضافة عدد<type> Prefix() إلى StorageUtil وJsonUtil - يحسب عدد المفاتيح التي تبدأ بسلسلة
• تمت إضافة مسح<type> Prefix() إلى StorageUtil - يزيل أي قيم تحتوي على مفاتيح تبدأ بسلسلة
• تمت إضافة النتف<type> () إلى StorageUtil - يحصل على قيمة ويعيدها، ثم يزيلها من التخزين.
• تمت إضافة Shift<type> List() إلى StorageUtil - يحصل على القيمة الأولى من القائمة ثم يزيلها من تلك القائمة.
• تمت إضافة موسيقى البوب<type> List() إلى StorageUtil - يحصل على القيمة الأخيرة من القائمة ثم يزيلها من تلك القائمة.
  

3.0 - 21/08/2015

• يتطلب SKSE 1.7.3
• StorageUtil &amp; JsonUtil Int/Float/String/FormListToArray()
• وظائف جديدة ومتنوعه للمرافق والمصفوفات في PapyrusUtil.psc
• هناك العديد من الوظائف الجديدة الأخرى التي لا أستطيع تذكرها، ومعظمها يتعلق بالتعامل مع المصفوفات أو إرجاعها
• تم إصلاح العديد من الأخطاء المتعلقة بالتعطل
• تحسين الأداء للعديد من الوظائف
• تمت إزالة MiscUtil.WriteToFile()،ReadFromFile()،ExecuteBat() - لم يتم استخدام الوظائف إلى حد كبير، مما يشكل خطرًا أمنيًا، وكان من الأفضل إنجازها بوسائل أخرى.
  

2.8 - 10/03/2014

• تم إصلاح خطأ خطير يتسبب في قيام StringListRemove بعكس ما تريد تمامًا
• تم إصلاح مشكلة تعطل سطح المكتب التي واجهها بعض المستخدمين عند قيام البرنامج المساعد بتحميل ملفات json خارجية للقراءة
• تمت إضافة وظائف تهيئة مجموعة البردي إلى PapyrusUtil.psc
  

2.7 - 09/09/2014

• تمت إضافة توفير تجاوز الحزمة الخلفية.
• تمت إضافة الدالتين AdjustInt/FloatValue() وInt/FloatListAdjust() إلى StorageUtil وJsonUtil، وهي دالة اختصار لضبط القيم الموجودة +/- مبلغ معين
• تمت إضافة وظيفة ClearAll() إلى JsonUtil لإفراغ محتويات ملفات json الخارجية.
• تم تنظيف العديد من الوظائف الأصلية للتحقق بشكل أفضل من تمرير الوسائط الصحيحة لمنع الأعطال المحتملة.
  

2.6 - 08/11/2014

• تم إصلاح الخلل الذي يتسبب في التعطل/التجميد عند محاولة تحميل ملف خارجي غير موجود.
  

2.5 - 08/08/2014

• يتطلب SKSE 1.7.1
• إعادة كتابة كود مصدر البرنامج الإضافي
• تمت إضافة نص JsonUtil جديد
• دالة ListSlice() لنسخ القائمة إلى مصفوفة Papyrus
• دالة ListCopy() لنسخ مجموعة ورق البردي إلى قائمة
• دالة ListResize() لتغيير طول القائمة
• إصلاحات أخرى متنوعة للأخطاء ووظائف جديدة بسيطة