מדריך BlueMap: מפת אינטרנט תלת־ממדית לשרת ה־Minecraft שלכם

מה זה BlueMap

BlueMap קורא את קבצי העולם שלכם, מרנדר אותם לאריחי מפה תלת־ממדיים ומגיש אותם דרך שרת אינטרנט קטן מובנה. בזום קרוב רואים את הבלוקים בתלת־ממד מלא; בזום רחוק, מבט־על שטוח. סמנים חיים מראים איפה השחקנים נמצאים, והמפה מתעדכנת כשהעולם משתנה.

הוא מרנדר עולמות Java Edition בלבד. הגרסה הנוכחית, BlueMap 5.29, זמינה עבור:

לגרסת Minecraft ישנה יותר, הורידו גרסה ישנה יותר של BlueMap שמציינת אותה. כל גרסה ב־Modrinth וב־Hangar מציגה את הגרסאות שהיא תומכת בהן.

התקנת BlueMap

1. הורידו את הקובץ שמתאים לשרת שלכם מ־Modrinth, מ־Hangar או מהגרסאות של BlueMap ב־GitHub: קובץ ה־jar ‏-paper עבור Paper, ‏-fabric עבור Fabric וכן הלאה.
2. שימו אותו בתיקייה plugins ‏(Paper, Spigot) או בתיקייה mods ‏(Fabric, Forge, NeoForge) והפעילו מחדש את השרת. העלאת תוספים מוסברת במדריך איך להתקין תוספים ל־Minecraft.
3. 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. בשרתים מאוחסנים בדרך כלל אי אפשר לבחור פורט חופשי, ולכן משתמשים בפורט שהוקצה לשרת שלכם:

1. השיגו פורט שני לשרת. ב־HytHost, פתחו את הלשונית Network בפאנל והוסיפו הקצאה: הפאנל בוחר פורט פנוי ופותח אותו עבורכם.
2. פתחו את webserver.conf והגדירו את port למספר הזה:

   port: 25570

3. הריצו /bluemap reload ופתחו את http://your-server-ip:25570 בדפדפן.

אל תשתמשו בפורט של המשחק; הוא שייך ל־Minecraft. כדי להציג את המפה בדומיין שלכם בלי מספר פורט, שימו לפניה reverse proxy כמו nginx; בתיעוד של BlueMap יש דוגמאות מוכנות.

פקודות BlueMap

לכל פקודה יש הרשאה בצורה bluemap.<command>, למשל bluemap.reload. ברוב הזמן לא תצטרכו אף אחת מהן: BlueMap מזהה שינויים בעולם ומרנדר אותם בעצמו.

שמירה על רינדור קל

BlueMap מרנדר בתהליכוני רקע ולא בתהליכון הראשי של השרת, אבל הרינדור עדיין צורך CPU. הרינדור הראשון של עולם גדול הוא החלק הכבד; אחריו מצוירים מחדש רק ה־chunks שהשתנו.

• תהליכוני רינדור: הגדירו את 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 בפאנל.