MineDown

MineDown -مغامرة

مكتبة تضيف القدرة على استخدام العلامات المستوحاة من MarkDown لكتابة مكونات دردشة Minecraft!

فهو يوفر صيغة ترميز مخصصة تعتمد بشكل فضفاض على MarkDown والتي تضيف القدرة على استخدام القوة الكاملة لرسائل المكونات بنفس البساطة مثل رموز التنسيق القديمة. (والذي لا يزال بإمكانه دعمه!) ويتضمن أيضًا طريقة لاستبدال العناصر النائبة مباشرةً في الرسائل، سواء تلك القائمة على السلسلة أو القائمة على المكونات!

يتطلب هذا واجهة برمجة تطبيقات الدردشة kyori-adventure، لذا يتعين عليك توفير إحدى مكتبات النظام الأساسي في مشروعك لاستخدام هذه الرسائل! راجع هذا البرنامج المساعد لتنفيذ بسيط.

بناء الجملة

التنسيق المضمن

وصف	بناء الجملة	مزيد من المعلومات	معاينة
تراث اللون	&6Text	رموز التنسيق
لون	&gold&Text	أسماء الألوان
لون RGB سداسي عشري	&#ff00ff&Text	تنسيق سداسي عشري كامل
لون RGB سداسي عشري	&#f0f&Text	تنسيق قصير (يعادل التنسيق الطويل)
التدرج	&#f0f-#fff&Text	التدرجات المضمنة
قوس قزح	&rainbow&Text	قوس قزح مضمن
مرحلة قوس قزح	&rainbow:20&Text	قوس قزح مضمن مع مرحلة
عريض	**Text**
مائل	##Text##
تحته خط	__Text__
يتوسطه خط	~~Text~~
غامض	??Text??

الأحداث

يمكنك تحديد أحداث النقر والتمرير باستخدام بنية رابط MarkDown شائعة الاستخدام بالإضافة إلى تحديد التنسيق والخط والألوان بهذه الطريقة.

بناء جملة بسيط

وصف	بناء الجملة
بناء الجملة العام	[Text](text-color text-formatting... link hover text)
رابط بسيط	[Text](https://example.com)
أمر بسيط	[Text](/command to run)
الرابط + التحويم	[Text](https://example.com Hover Text)
تنسيق النص	[Text](blue underline !bold)
التدرج	[Text](#fff-#000)
قوس قزح	[Text](rainbow)
قوس قزح مرحلي	[Text](rainbow:20)
تنسيق النص + الرابط + التحويم	[Text](#0000ff underline https://example.com Hover Text)

بناء الجملة المتقدم

وصف	بناء الجملة	مزيد من المعلومات
بناء الجملة العام	[Text](action=value)	انقر فوقEvent.Action، HoverEvent.Action
وصلة	[Text](open_url=https://example.com)
لون	[Text](color=red)	أسماء الألوان
لون RGB سداسي عشري	[Text](color=#ff00ff)	تنسيق سداسي عشري كامل
اللون السداسي RGB	[Text](color=#f0f)	تنسيق قصير (يعادل التنسيق الطويل)
التدرج اللوني RGB	[Text](color=#fff-#000)	التدرج من لونين. (يدعم جميع أشكال الألوان)
التدرج اللوني RGB	[Text](color=#fff-#333-#222)	التدرج من ثلاثة ألوان.
قوس قزح RGB	[Text](color=rainbow)	قوس قزح RGB.
قوس قزح RGB على مراحل	[Text](color=rainbow:50)	قوس قزح RGB مع مرحلة محددة.
التنسيق	[Text](format=underline,bold)	تحديد التنسيق
تعطيل التنسيق	[Text](format=!underline)	قم بتعطيل التنسيق المحدد باستخدام ! بادئة
الخط	[Text](font=custom_font)	قم بتعيين خط مخصص من حزمة الموارد
تشغيل الأمر	[Text](run_command=/command string)	تشغيل الأمر عند النقر
أقترح الأمر	[Text](suggest_command=/command)	اقتراح أمر عند النقر
تحوم بسيط	[Text](hover=Hover Text)	إظهار نص التمرير
تحوم النص	[Text](show_text=Hover Text)	إظهار نص التمرير
تحوم معلومات الكيان	[Text](show_entity=uuid:pig Name)	إظهار معلومات الكيان.
تحوم معلومات العنصر	[Text](show_item=stone*2 nbt...)	عرض معلومات العنصر، يجب توفير معلومات إضافية كسلسلة من nbt في json
الإدراج	[Text](insert=insert into input)	إدراج في الإدخال عند النقر على مفتاح Shift، ويمكن دمجه مع أحداث أخرى

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

كيفية استخدامه

يتم الوصول إلى واجهة برمجة التطبيقات (API) الرئيسية للمكتبة من خلال فئة MineDown .class وطرق التحليل الخاصة بها.

على سبيل المثال، يمكنك استخدامه بهذه الطريقة في مكون Bukkit الإضافي الخاص بك:

MineDown(rawMessage).replace(replacements).toComponent());">

 BukkitAudiences . create ( plugin ). player ( player ). sendMessage ( new MineDown ( rawMessage ). replace ( replacements ). toComponent ());

أو مع نهج ثابت:

MineDown.parse(rawMessage, replacements));">

 BukkitAudiences . create ( plugin ). player ( player ). sendMessage ( MineDown . parse ( rawMessage , replacements ));

قم بإلقاء نظرة على MineDown JavaDocs للحصول على معلومات أكثر تفصيلاً عن المكتبة والفصول الدراسية المضمنة.

قم بتضمينه في البرنامج المساعد الخاص بك

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

مستودع

< repositories >
    < repository >
        < id >minebench-repo</ id >
        < url >https://repo.minebench.de/</ url >
    </ repository >
</ repositories >

قطعة أثرية

MineDown-adventure</artifactId> <version>1.7.3-SNAPSHOT</version> <scope>compile</scope> </dependency> </dependencies>">

< dependencies >
    < dependency >
        < groupId >de.themoep</ groupId >
        < artifactId > MineDown -adventure</ artifactId >
        < version >1.7.3-SNAPSHOT</ version >
        < scope >compile</ scope >
    </ dependency >
</ dependencies >

مكتبة دردشة BungeeCord القديمة

لم تعد مكتبة BungeeCord-chat الأصلية تتم صيانتها وتم استبدالها بتنفيذ المغامرة هذا. إذا كنت بحاجة إلى الاستمرار في استخدام الإصدار القديم (الموجود في الفرع legacy )، فيمكنك تضمينه على النحو التالي:

MineDown</artifactId> <version>1.7.1-SNAPSHOT</version> <scope>compile</scope> </dependency> </dependencies>">

< dependencies >
    < dependency >
        < groupId >de.themoep</ groupId >
        < artifactId > MineDown </ artifactId >
        < version >1.7.1-SNAPSHOT</ version >
        < scope >compile</ scope >
    </ dependency >
</ dependencies >

النقل

MineDown</pattern> <shadedPattern>your.package.path.libraries. MineDown </shadedPattern> </relocation> </relocations> </configuration> <executions> <execution> <phase>package</phase> <goals> <goal>shade</goal> </goals> </execution> </executions> </plugin> </plugins> </build>">

< build >
    < plugins >
        < plugin >
            < artifactId >maven-shade-plugin</ artifactId >
            < version >3.1.0</ version >
            < configuration >
                < relocations >
                    < relocation >
                        < pattern >de.themoep. MineDown </ pattern >
                        < shadedPattern >your.package.path.libraries. MineDown </ shadedPattern >
                    </ relocation >
                </ relocations >
            </ configuration >
            < executions >
                < execution >
                    < phase >package</ phase >
                    < goals >
                        < goal >shade</ goal >
                    </ goals >
                </ execution >
            </ executions >
        </ plugin >
    </ plugins >
</ build >

بديل التظليل

وبدلاً من ذلك، يمكنك أيضًا الاعتماد بشكل مباشر على مكون MineDown الخاص بي بدلاً من التظليل في هذه المكتبة! يتضمن MineDown Plugin نسخة غير منقولة من هذه المكتبة.

رخصة

MineDown مرخص بموجب ترخيص MIT مفتوح المصدر:

 Copyright (c) 2024 Max Lee (https://github.com/Phoenix616)

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.