Lexiconfig مود لماينكرافت 1.20.1, 1.21.1

نظرة عامة

هذه واجهة برمجية للإعدادات تهدف إلى توفير التوافق عبر عدة مكتبات إعدادات مختلفة أخرى، بالإضافة إلى سهولة استخدامها في إعداد مشروع متعدد المحمّلات، وذلك بشكل أساسي للاستخدام في تعديلاتي.

تتميز بصياغة بسيطة قائمة على التعليقات التوضيحية، لجعل إنشاء ملفات الإعدادات الجديدة سهلاً قدر الإمكان.

إذا كنت مستخدماً للتعديلات، فمن المحتمل ألا تكون هذه المعلومات مفيدة جداً لك. أما إذا كنت مطوّر تعديلات وترغب في استخدام Lexiconfig في مشاريعك الخاصة، فانتقل إلى قسم التطوير.

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

إليك قائمة بالتكاملات الحالية والمخطط لها عبر مكتبات وواجهات الإعدادات المختلفة:

❌ - غير مدمج ✅ - مدمج ❓ - قيد التقدم

الحالة التعديل

❌ Cloth Config

❌ oωo config

✅ Configured

❌ Forge Config Screens

التطوير

يحتوي هذا التعديل على واجهة برمجية يمكن استخدامها لإيداع معاجم جديدة، والاستماع إلى الأحداث، وما إلى ذلك.

الاعتماد

build.gradle

dependencies { implementation "com.codinglitch.lexiconfig:lexiconfig-api:APIVERSIONHERE" }

يمكنك زيارة https://versions.codinglitch.com لعرض أحدث إصدار من الواجهة البرمجية.

الاستخدام

لإيداع معاجمك الخاصة، عليك أولاً إنشاء مكتبتك الخاصة. يمكن القيام بذلك ببساطة عبر إنشاء صنف جديد يمتد من صنف Library، وإضافة التعليق التوضيحي LexiconLibrary عليه.

@LexiconLibrary public class MyNewLibrary extends Library { @Override public void shelveLexicons() { } }

في إعداد Forge، لا حاجة لإجراء أي تغييرات إضافية. أما إذا كنت تطوّر لـ Fabric، فسيتعين عليك إضافة هذا الصنف كنقطة دخول في ملف fabric.mod.json الخاص بك.

fabric.mod.json

//... "entrypoints": { "lexiconfig": [ "com.path.to.MyNewLibrary" ] } //...

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

@Lexicon(name = MYLEXICONTITLE) // preferably use your mod id as a name public class MyLexicon extends LexiconData { @LexiconEntry(comment = "This is a comment for a simple field!") public String mySimpleField = "content"; @LexiconPage(comment = "This is a fancy new comment on the fancy new category!") public MyNewPage myNewPage = new MyNewPage(); public static class MyNewPage extends LexiconPageData { @LexiconEntry(comment = "This field is inside a lexicon page!") public Boolean myPageField = true; } }

الخطوة التالية والأخيرة هي إيداع المعجم، ويمكن القيام بذلك ببساطة عبر إضافة نسخة منه كحقل في المكتبة وإيداعه في الدالة المحددة.

@LexiconLibrary public class MyNewLibrary extends Library { public static MyLexicon MYLEXICON = new MyLexicon(); @Override public void shelveLexicons() { LexiconfigApi.shelveLexicon(MYLEXICON); } }