Prickle مود لماينكرافت 1.21, 26.3

Prickle هو تنسيق إعدادات قائم على JSON. تتيح هذه الإضافة استخدام هذا التنسيق في Minecraft! للاطلاع على الوثائق التقنية، يُرجى مراجعة صفحة GitHub.

الأسئلة الشائعة

ما المزايا التي يقدمها Prickle؟ يستند Prickle إلى JSON لكنه يضيف عدة ميزات مفيدة مثل التعليقات والمُزيّنات. Prickle متوافق بنسبة 100% مع الإصدارات السابقة من JSON ويدعم جميع ميزاته وأدواته وإبراز الصياغة فيه.

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

لماذا لا تستخدم تنسيقًا موجودًا بالفعل؟ في الماضي استخدمت JSON لملفات الإعدادات الخاصة بي لكن ظهرت عدة مشكلات مثل غياب التعليقات والقيم الافتراضية. يضيف Prickle هذه الميزات إلى JSON مع بقائه متوافقًا بنسبة 100% مع الإصدارات السابقة. جربت تنسيقات أخرى مثل TOML لكنني خُيّبت في كثير من تطبيقاتها بلغة Java. فغالبًا ما تفتقر إلى ميزات أراها مهمة، وتحتوي على أخطاء جسيمة، ولم تعد تُصان. يستخدم Minecraft بالفعل JSON لحزم البيانات والأوامر، مما يجعله خيارًا مألوفًا لمعظم اللاعبين.

مواصفات التنسيق

في Prickle تُغلَّف قيم الخصائص داخل كائن JSON. يتيح ذلك إسناد بيانات وصفية مثل التعليقات إلى تلك الخاصية.

على سبيل المثال، يبدو ملف JSON القياسي هكذا.

{ "databasehost": "192.168.1.222" }

نفس JSON في ملف Prickle يبدو هكذا.

{ "databasehost": { "//": "The IP address of the database to connect to.", "value": "192.168.1.222" } }

التعليقات

المفتاح // محجوز للتعليقات. تُستخدم التعليقات فقط لتقديم سياق إضافي للقارئ ولا ينبغي أن تؤثر أبدًا في كيفية تحليل الملف. يمكن أن يكون التعليق نصًا JSON أو مصفوفة من النصوص للتعليقات متعددة الأسطر.

{ "databasehost": { "//": [ "The IP address of the database to connect to.", "The port can be defined at the end using an :" ], "value": "192.168.1.222:1273" } }

المُزيّنات

المُزيّنات هي تعليقات مسماة تنقل سمة محددة للخاصية. من الأمثلة الشائعة على المُزيّن //default الذي يمكن استخدامه لعرض القيمة الافتراضية للخاصية. مثل التعليقات، لا تؤثر المُزيّنات في كيفية تحليل الملف، بل تصف فقط كيفية تحليل الخاصية.

قد تصادف بعض المُزيّنات التالية في ملفات prickle.

• //default - القيمة الافتراضية للخاصية.
• //reference - مصدر يمكن استخدامه لمعرفة المزيد، مثل رابط إلى صفحة ويكي.
• //range - النطاق المقبول للقيمة. على سبيل المثال >=5.
• //regex - نمط regex يجب أن تطابقه القيمة.
• //empty-allowed - ما إذا كانت القيمة يمكن أن تكون فارغة أم لا. (الافتراضي هو true).

الرعاة

هذا المشروع برعاية Nodecraft. استخدم الرمز DARKHAX للحصول على خصم 30% على أول شهر من الخدمة!