Водич за BlueMap: 3D веб-мапа за вашиот Minecraft сервер

Што е BlueMap

BlueMap ги чита датотеките на вашиот свет, ги рендерира во 3D плочки на мапата и ги служи преку мал вграден веб-сервер. Одблизу ги гледате блоковите во целосно 3D; оддалеку, рамен преглед. Живите ознаки покажуваат каде се играчите, а мапата се ажурира како што се менува светот.

Рендерира само светови од Java Edition. Тековното издание, BlueMap 5.29, доаѓа во верзии за:

За постара верзија на Minecraft, преземете постаро издание на BlueMap што ја наведува. Секое издание на Modrinth и Hangar ги прикажува верзиите што ги поддржува.

Инсталирајте BlueMap

1. Преземете ја датотеката што одговара на вашиот сервер од Modrinth, Hangar или од изданијата на BlueMap на GitHub: -paper jar за 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. За да ја прикажете мапата на ваш домен без број на порта, ставете обратен прокси како 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 драјвер. Секој HytHost Minecraft пакет вклучува MySQL бази на податоци, кои ги создавате во табот Databases во панелот.