ماد Hey Wiki (نسخه 26.1.2, 1.21.1) – بازکننده ویکی و راهنمای لینک در بازی

ماد Hey Wiki به پلیرها اجازه می‌دهد تا به سرعت صفحه ویکی مربوط به بلاک، آیتم یا موجودی (entity) که دوربین روی آن نشانه رفته است را باز کنند، چه مربوط به نسخه اصلی بازی (vanilla) باشد و چه مربوط به یک ماد دیگر.

ویژگی‌ها:

قابلیت‌ها

• فشردن کلید H (قابل شخصی‌سازی) برای باز کردن صفحه ویکی (Minecraft Wiki یا ویکی اختصاصی ماد مربوطه) بلاک/آیتم/موجودی که نشانه روی آن قرار دارد.
• فشردن Alt + H (یا ⌥ Opt + H) برای باز کردن صفحه ویکی آیتمی که در دست اصلی (main hand) است.
• فشردن کلید B برای باز کردن صفحه جستجوی ویکی و گشتن به دنبال صفحات مختلف.
• پشتیبانی از دستورات (commands) ویژه برای باز کردن سریع صفحات مرتبط ویکی.
• پشتیبانی از ساختار [[wiki link]] در چت برای تبدیل خودکار به لینک‌های قابل کلیک.
• امکان وب‌گردی اختیاری داخل بازی از طریق MCBrowser و MCEF.

نحوه استفاده

• ماد (و پیش‌نیازهای لازم) را از GitHub یا Modrinth نصب کنید.
• نشانه (crosshair) خود را روی یک بلاک یا موجود بگیرید، یا نشانگر موس را روی یک آیتم در اینونتوری نگه دارید.
• کلید میانبر را فشار دهید (پیش‌فرض: H).
• در صفحه باز شده، یا باز کردن صفحه را تایید کنید و یا لینک را کپی کنید.

تنظیمات Config (از طریق Mod Menu یا Menulogue در Fabric)

• نیاز به تایید (Confirmation required) قبل از باز کردن صفحه ویکی (پیش‌فرض: true).
• زبان ترجیحی ویکی: به طور پیش‌فرض روی زبان فعلی بازی تنظیم است مگر اینکه تغییر داده شود.
• تغییر خط چینی: سوئیچ بین چینی ساده‌شده و سنتی.
• کلید میانبر باز کردن ویکی: پیش‌فرض H است.
• فاصله دسترسی (Reach distance): پیش‌فرض 5.2 بلاک (برد حالت creative).
• هدف‌گیری بلاک‌های مایع: فعال یا غیرفعال کردن امکان نشانه رفتن روی مایعات (پیش‌فرض: false).

دستورات (Commands)

• /imfeelinglucky [<namespace>] – باز کردن یک صفحه تصادفی در فضای نام (namespace) مشخص شده ویکی.
  مثال: /imfeelinglucky minecraft
• /wiki <pageName> – باز کردن صفحه Minecraft Wiki مطابق با نام وارد شده.
  مثال: /wiki creeper
  نام مستعار: /whatis
• /whatbiome – باز کردن صفحه ویکی مربوط به بایومی که پلیر در حال حاضر در آن است.
• /whatstructure – باز کردن صفحه ویکی مربوط به سازه‌ای (structure) که پلیر در آن قرار دارد (فقط در حالت تک‌نفره).
• /whatcommand <command> – باز کردن صفحه ویکی برای دستور مشخص شده.
  مثال: /whatcommand give
  نام مستعار: /whatcmd
• /whatisthis – باز کردن صفحه ویکی بلاک/آیتم/موجودی که پلیر در حال حاضر روی آن نشانه رفته است.
• /whatisthisitem – باز کردن صفحه ویکی آیتمی که در دست اصلی است.
  /whatisthisitem offhand – مشابه قبلی، اما برای دست دوم (offhand).

لینک‌های ویکی در چت

• پیام‌هایی که از ساختار [[wiki link]] استفاده می‌کنند به طور خودکار با لینک‌های قابل کلیک جایگزین می‌شوند.
• پیشوندهای Interwiki و زبان پشتیبانی می‌شوند، برای مثال:
  • [[aether:The Aether]] – صفحه “The Aether” در ویکی Aether.
  • [[en:enderman]] – صفحه انگلیسی “enderman” در ویکی ماینکرفت.
  • [[minecraft:en:enderman]] – ویکی ماینکرفت، زبان انگلیسی، صفحه “enderman”.

ویکی‌های پشتیبانی شده

• Minecraft Wiki
• Aether Wiki
• Mekanism Wiki
• The Twilight Forest Wiki
• Applied Energistics 2 Wiki
• Stardust Labs Wiki
• Create Wiki
• Voidscape Wiki
• Advent of Ascension Wiki
• Doggy Talents Next Wiki
• Endertech Infinity Wiki
• Marvel Superheroes Mod Wiki
• BlockFront Wiki
• Cobblemon Wiki
• Arthropod Phobia Expansions Wiki

توسعه با استفاده از Resource Packها

• ریسورس پک‌ها می‌توانند ویکی‌های جدیدی را ثبت کنند تا با Hey Wiki کار کنند.
• یک فایل JSON در مسیر assets/<namespace>/wiki_family/ بسازید تا موارد زیر را تعریف کنید:
  • Namespaceها متصل به خانواده ویکی.
  • الگوی URL مقالات و URLهای اختیاری برای جستجو و مقاله تصادفی.
  • قوانین زبان (کد زبان، زبان اصلی، زبان پیش‌فرض بازی، تطبیق regex).
  • تنظیمات اختیاری MediaWiki API، چکیده و ارائه‌دهنده جستجو (از جمله Algolia).
• یک فایل ترجمه در assets/<namespace>/lang/ اضافه کنید تا نام خانواده ویکی در بازی نمایش داده شود.

آیتم‌های سفارشی از طریق Data Component / NBT

• دیتا پک‌ها و سرورهای سفارشی می‌توانند نحوه ارجاع آیتم‌های سفارشی به صفحات ویکی را با استفاده از موارد زیر تعریف کنند:
  • heywiki:identifier – شناسه سفارشی به فرمت <namespace>:<id>.
  • heywiki:fallback_title – عنوان جایگزین اختیاری برای صفحه.
  • heywiki:translation_key – کلید ترجمه اختیاری که قبل از عنوان جایگزین استفاده می‌شود.
• این فیلدها در minecraft:custom_data روی آیتم ذخیره می‌شوند و در نسخه‌های 1.20.4 به بالا کار می‌کنند.

اسکرین‌شات‌ها:

پیش‌نیازها:

Fabric Loader الزامیFabric API الزامیNeoForge الزامیCloth Config API الزامیArchitectury API Mod الزامی

YetAnotherConfigLib (YACL) الزامی

MCBrowser اختیاری

Just Enough Items (JEI) اختیاری

Roughly Enough Items Mod اختیاریDistraction Free Recipes Mod اختیاریMod Menu Mod اختیاری

لینک‌های دانلود ماد Hey Wiki