Pf2eTools
v0.8.13
فرع التطوير المباشر المتاح على dev Sublain.
يرجى الاطلاع على ويكي لدينا للحصول على دليل التثبيت. بالنسبة لكل شيء آخر ، لدينا مجموعة متنوعة من الأسئلة الشائعة التي تم الرد عليها على خادم Discord ، بالإضافة إلى أننا متاحون للأسئلة المباشرة!
فقط "الرسمية" (أي ، التي تم نشرها بواسطة Paizo) يجب تضمينها في الموقع. يجب إضافة أي شيء آخر إلى مستودع البيرة.
إعطاء الأولوية الخام قبل كل شيء. تهدف إلى توفير نسخة 1: 1 من البيانات الأصلية. يمكن تصحيح الأخطاء المطبعية الواضحة (على سبيل المثال ، الأخطاء الرياضية في STATBLOCKS) وفقًا لتقدير المشرف (S).
تهدف إلى استخدام أحدث إصدار من أي مادة منشورة. يمكن نقل الإصدارات القديمة التي تختلف بما فيه الكفاية (وذات صلة بمصالح المجتمع) إلى مستودع البيرة.
كان استهداف ES6 هو النية الأصلية ، ولكن الميزات الأكثر حداثة قد تسللت منذ فترة طويلة إلى الكود. لذلك ، إذا كان هناك شيء متاح كمعيار في كل من Chrome و Firefox (ويفضل أن يكون في الإصدارات التي يعود تاريخها إلى شهرين على الأقل) ، وليس حافة النزيف ، يمكن للمرء أن يبرر استخدامه. كما هو الحال مع كل الأشياء ، استخدم الحس السليم.
تنسيق JSON لمطابقة الإخراج الافتراضي لـ JavaScript's JSON.stringify (باستخدام علامات التبويب للمسافة البادئة) ، أي سطر واحد لكل شريحة وخط واحد لكل قيمة. ومع ذلك ، يجب تحديد ملفات JSON التي تم إنشاؤها برمجياً من ملفات JSON الأخرى (أي تلك المخزنة في data/generated ).
عند "وضع العلامات" المراجع في البيانات (على سبيل المثال {@creature goblin} ) ، تنطبق القواعد التالية:
You gain one cantrip of your choice from the wizard spell list ، في حين لا ينبغي وضع علامة على فئة المعالج Together, a group of seven powerful wizards sought to contain the demon . إحداها هي إشارة إلى الطبقة الميكانيكية ، واحد هو مجرد الاستخدام غير الرسمي لكلمة "معالج".quote . حتى إذا كان الاقتباس يشير مباشرة إلى مخلوق معين ، فيمكننا افتراض أن الاقتباس من الكون/المنظور الذي لا توجد فيه (على سبيل المثال) من الحبل الأساسي ، وبالتالي يجب حذف العلامة للحفاظ على نكهة الاقتباس. أجزاء من إرشادات التنظيف والأناقة JSON هي أيضًا آلية ويمكن تطبيقها باستخدام npm run clean-jsons . بالإضافة إلى ذلك ، يتم تشغيل هذا البرنامج النصي للتنظيف تلقائيًا كجزء من npm run build .
لإزالة الفواصل الزائدة في JSON:
البحث: (.*?)(,)(:?s*]|s*})
استبدال: $1$3
' يجب استبدالها بـ '“ و ” يجب استبدالها "— (اندفاعة EM) يجب استبدالها بـ u2014 (Unicode for EM Dash)– يجب استبداله بـ u2013 (Unicode for en dash)− يجب استبداله بـ u2212 (Unicode لعلامة ناقص)• لا ينبغي استخدامها إلا إذا لم يتم تغطية JSON المعنية بعد من قبل EntryRenderer ، أي يجب تشفيرها كقائمةu2014 و u2013 و u2212 ؛ يجب تخزين جميع الشخصيات الأخرى (ما لم يرد أعلاه) كما هو - (الواصلة) يجب أن تستخدم فقط للكلمات الواصلة ، على سبيل المثال 60-foot و 18th-levelu2014 لأزواج اندفاعة الأبوين ، أو لتمييز صفوف الجدول الفارغة.u2013 للانضمام إلى النطاقات العددية ، على سبيل المثال ، يجب أن يصبح 1-5 1u20135 .u2212 لعلامات أحادية ناقص ، في حالة العقوبات. على سبيل المثال ، "You have a -5 penalty to..." يجب أن تصبح "You have a u22125 penalty to..." .u2014 60-foot lineblindsight 60 ft. ، darkvision 120 ft./ ، مع عدم وجود مسافات على كلا الجانبين تليها وحدة الزمن الرسملة ، على سبيل المثال 2/Turn ، 3/Day يجب كتابة الزهر على أنه [X]dY[ <+|-|×> Z] ، أي مع مساحة بين الزهر والمشغل ، ومساحة بين المشغل والمعدل. بعض الأمثلة على التنسيق المقبول هي: d6 ، 2d6 ، أو 2d6 + 1 .
يجب أن تكون أسماء العناصر هي حالة العنوان ، باستثناء الوحدات الموجودة بين قوسين ، والتي يجب أن تكون الجملة. يتم تحديد العناصر التي يتم تحديد حجمها أو المبلغ بواسطة الحاوية (مثل (vial) ) الحاوية كوحدة.
تجنب ربط الأحداث المعدلة المعدلة ، لأنها غير متوفرة تحت MACOS أو نكهات Linux المختلفة. يتم تفضيل الأحداث المعدلة في التحول/CTRL.
تأكد من تثبيت كل شيء ( npm install ) وتم تصميمه ( npm run build ) للحصول على موقع يعمل بكامل طاقته. Run npm run serve:dev لاتخاذ خادم DEV محلي يخدم ملفات المشروع على http://localhost:8080/index.html .
يحتوي المستودع على مخطط JSON لملفات البيانات في test/schema-template/schema.json . المخطط هو حاليا عمل مستمر.
تختلف تفاصيل كيفية الاستفادة من المخطط بناءً على الإعداد الذي تستخدمه للعمل مع الريبو.
لاستخدام مخطط JSON مع رمز Visual Studio ، توجه إلى الإعدادات وتحديد موقع إعداد JSON: Schemas . يوصى بإضافة هذا التكوين فقط لمساحة العمل المحلية.
"json.schemas" : [
{
"fileMatch" : [
" data/**/*.json "
],
"url" : " ./test/schema-template/schema.json "
}
] قم npm run version-bump -- [OPTION] ، حيث [OPTION] هو واحد مما يلي:
major في زيادة الإصدار الرئيسي ( 1.2.3 سيصبح 2.0.0 )minor لزيادة النسخة الصغيرة ( 1.2.3 سيصبح 1.3.0 )patch لزيادة إصدار التصحيح ( 1.2.3 سيصبح 1.2.4 )1.2.3 ) سيتم تشغيل الاختبارات أولاً وتفشل في زيادة الإصدار في حالة فشل الاختبارات. بعد ذلك ، سيتم استبدال الإصدار تلقائيًا في الملفات التي تحتاج إلى استبدالها ، وإنشاء التزام chore(version): bump وإنشاء علامة (في النموذج v1.2.3 ) عند الالتزام. يمكن تعطيل هذه الميزة بسهولة عن طريق القيام npm config set git-tag-version false .
هذا المشروع مرخص بموجب شروط ترخيص معهد ماساتشوستس للتكنولوجيا.
