راهنمای BlueMap: نقشه وب سه‌بعدی برای سرور Minecraft شما
در این صفحه
BlueMap دنیای Minecraft شما را به یک نقشه سه‌بعدی زنده تبدیل میکند که هر کسی می‌تواند آن را در مرورگر باز کند. بازیکنان می‌توانند بدون ورود به بازی روی ساخته‌ها پرواز کنند، یکدیگر را پیدا کنند و دنیا را بگردند، و شما هم ویترینی برای وب‌سایت یا Discord سرورتان دارید.
این راهنما نصب BlueMap، تنها تنظیمی که پیش از کار کردن به آن نیاز دارد، دادن پورت جداگانه به نقشه، دستورها و راه جلوگیری از کند شدن سرور به‌خاطر رندر را پوشش می‌دهد.
BlueMap چیست
BlueMap فایل‌های دنیای شما را می‌خواند، آن‌ها را به کاشی‌های نقشه سه‌بعدی رندر میکند و از طریق یک وب‌سرور کوچک داخلی ارائه می‌دهد. با بزرگ‌نمایی، بلوک‌ها را کاملاً سه‌بعدی می‌بینید؛ با کوچک‌نمایی، یک نمای کلی تخت. نشانگرهای زنده محل بازیکنان را نشان می‌دهند و نقشه با تغییر دنیا به‌روز میشود.
فقط دنیاهای Java Edition را رندر میکند. نسخه فعلی، BlueMap 5.29، برای این‌ها عرضه میشود:
| نرم‌افزار سرور | نسخه‌های Minecraft |
|---|---|
| Paper و Folia (پلاگین) | 26.1.1 – 26.3 |
| Spigot (پلاگین) | 26.1 – 26.3 |
| Fabric، Forge، NeoForge (ماد) | 26.1 – 26.3 |
برای نسخه‌های قدیمی‌تر Minecraft، نسخه قدیمی‌تری از BlueMap را دانلود کنید که آن نسخه را فهرست کرده باشد. هر نسخه در Modrinth و Hangar نسخه‌های پشتیبانی‌شده‌اش را نشان می‌دهد.
نصب BlueMap
- فایل مناسب سرورتان را از Modrinth، Hangar یا انتشارهای BlueMap در GitHub دانلود کنید: فایل jar
-paperبرای Paper، -fabricبرای Fabric و به همین ترتیب. - آن را در پوشه
plugins(Paper، Spigot) یا پوشهmods(Fabric، Forge، NeoForge) بگذارید و سرور را ری‌استارت کنید. بارگذاری پلاگین‌ها در نحوه نصب پلاگین‌های Minecraft توضیح داده شده است. - BlueMap پیکربندی خود را در
plugins/BlueMap/، یا در سرورهای مادشده درconfig/bluemap/، می‌سازد و برای هر یک از دنیاهای شما از قبل یک نقشه تنظیم کرده است.
در این مرحله کنسول به شما می‌گوید BlueMap در انتظار است. تا زمانی که دانلود را تأیید نکنید چیزی رندر نمیکند؛ این مرحله بعدی است.
تأیید دانلود در core.conf
BlueMap برای کشیدن بلوک‌ها به تکسچرها و مدل‌های کلاینت Minecraft نیاز دارد و آن‌ها را از Mojang دانلود میکند. فایل core.conf را باز کنید و این را تغییر دهید:
accept-download: true
با این تنظیم EULA شرکت Mojang را می‌پذیرید و تأیید میکنید که مالک Minecraft Java Edition هستید. فایل را ذخیره کنید و /bluemap reload را اجرا کنید یا سرور را ری‌استارت کنید. BlueMap منابع را دانلود میکند و رندر را شروع میکند.
پورت جداگانه برای نقشه وب
وب‌سرور BlueMap بهطور پیشفرض روی پورت 8100 گوش می‌دهد. روی دستگاه خودتان، این پورت را باز کنید و به http://your-ip:8100 بروید. روی سرورهای میزبانیشده معمولاً نمی‌توانید آزادانه پورت انتخاب کنید، پس از پورتی استفاده میکنید که به سرورتان اختصاص داده شده است:
- یک پورت دوم برای سرورتان بگیرید. در HytHost، تب Network را در پنل باز کنید و یک allocation اضافه کنید: پنل یک پورت آزاد انتخاب میکند و آن را برایتان باز میکند.
- فایل
webserver.confرا باز کنید وportرا روی آن عدد بگذارید:port: 25570
/bluemap reloadرا اجرا کنید وhttp://your-server-ip:25570را در مرورگر باز کنید.
از پورت بازی استفاده نکنید؛ آن پورت مال Minecraft است. برای نمایش نقشه روی دامنه خودتان بدون شماره پورت، یک reverse proxy مثل nginx جلوی آن قرار دهید؛ مستندات BlueMap نمونه‌های آماده دارد.
خودتان در پنل برای BlueMap پورت اضافه کنید: هاستینگ Minecraft در HytHost از €2.59 در ماه شروع میشود.
مشاهده پلنهای Minecraftدستورهای BlueMap
| دستور | کاری که انجام می‌دهد |
|---|---|
/bluemap | وضعیت و پیشرفت رندر را نشان می‌دهد |
/bluemap reload | پس از ویرایش، پیکربندی را دوباره بارگذاری میکند |
/bluemap maps | نقشه‌ها و وضعیتشان را فهرست میکند |
/bluemap update [map] | تغییراتی را که هنوز ثبت نشده‌اند رندر میکند |
/bluemap force-update [map] | همه چیز را دوباره رندر میکند، حتی بخش‌های بدون تغییر |
/bluemap freeze <map> / unfreeze | به‌روزرسانی یک نقشه را متوقف یا از سر می‌گیرد؛ پس از ری‌استارت هم باقی می‌ماند |
/bluemap stop / start | کل رندر را متوقف یا از سر می‌گیرد |
/bluemap purge <map> | دادههای رندرشده یک نقشه را حذف میکند تا از صفر دوباره رندر شود |
هر دستور مجوزی به شکل bluemap.<command> دارد، برای مثال bluemap.reload. بیشتر وقت‌ها به هیچ‌کدام نیاز ندارید: BlueMap خودش تغییرات دنیا را تشخیص می‌دهد و رندر میکند.
رندر را سبک نگه دارید
BlueMap در رشته‌های پس‌زمینه رندر میکند، نه روی رشته اصلی سرور، اما رندر همچنان CPU مصرف میکند. اولین رندر یک دنیای بزرگ بخش سنگین کار است؛ پس از آن فقط chunkهای تغییرکرده دوباره کشیده میشوند.
- رشته‌های رندر: مقدار
render-thread-countرا درcore.confتنظیم کنید. مستندات BlueMap روی دستگاه‌هایی با چهار هسته یا کمتر مقدار1را پیشنهاد میکند. - در ساعات خلوت رندر کنید: در طول اولین رندر، در ساعات شلوغ
/bluemap stopو شب‌ها/bluemap startرا اجرا کنید. - وقتی بازیکنان آنلاین‌اند متوقف کنید:
player-render-limitدرplugin.confوقتی تعداد بازیکنان آنلاین به آن عدد برسد رندر را متوقف میکند. - مرز دنیا تعیین کنید. این کار جلوی رشد بی‌پایان نقشه، و کار رندر، را با گشت‌وگذار بازیکنان می‌گیرد.
- نقشه‌هایی را که لازم نیست زنده باشند فریز کنید، مثل End پس از آنکه کاوش شد.
ذخیره‌سازی: فایل یا پایگاه داده
بهطور پیشفرض BlueMap نقشه را به‌صورت فایل‌های فشرده در bluemap/web/maps، داخل فضای ذخیره‌سازی سرورتان، نگه می‌دارد. نقشه با گسترش ناحیه کاوش‌شده بزرگ میشود، پس در دنیاهای بزرگ فضای دیسک را زیر نظر داشته باشید.
می‌توانید بهجای آن، نقشه را به یک پایگاه داده منتقل کنید. در storages/sql.conf اتصال به MySQL، MariaDB، PostgreSQL یا SQLite را تنظیم کنید، سپس در فایل پیکربندی نقشه storage: "sql" را بگذارید و دوباره بارگذاری کنید:
connection-url: "jdbc:mysql://DB_HOST:3306/DB_NAME"
connection-properties: {
user: "DB_USER",
password: "DB_PASSWORD"
}
Paper یک درایور MySQL همراه دارد؛ برای Spigot، Fabric و Forge باید یک درایور JDBC اضافه کنید. همه پلنهای Minecraft در HytHost شامل پایگاه داده MySQL هستند که آن را در تب Databases پنل می‌سازید.
پرسش‌های متداول
تقریباً همیشه به این دلیل که accept-download در core.conf هنوز false است. آن را true کنید و /bluemap reload را اجرا کنید. اگر باز هم در انتظار ماند، کنسول را برای خطای دانلود بررسی کنید.
بهطور پیشفرض 8100 که در webserver.conf تنظیم میشود. روی سرور میزبانیشده، بهجای آن از یک پورت اضافه که به سرورتان اختصاص داده شده استفاده کنید؛ در HytHost آن را خودتان در تب Network پنل اضافه میکنید.
خارج از رشته اصلی رندر میکند، پس مستقیماً جلوی tickها را نمیگیرد، اما اولین رندر CPU زیادی مصرف میکند. در پلنهای کوچک از یک رشته رندر استفاده کنید و اولین رندر را وقتی اجرا کنید که بازیکنان کمی آنلاین هستند.
خیر. BlueMap فقط دنیاهای Java Edition را رندر میکند.
/bluemap purge <map> را اجرا کنید. دادههای رندرشده حذف میشوند و نقشه از صفر دوباره رندر میشود، مگر اینکه فریز شده باشد.
دنیای خود را روی نقشه بیاورید
هاستینگ Minecraft در HytHost پورت‌های اضافه از پنل و پایگاه داده MySQL در همه پلن‌ها به شما می‌دهد، از €2.59 در ماه.
Live chat 8 AM – 11 PM (Chișinău time) · tickets answered during business hoursاین راهنما برایتان مفید بود؟
