Овој водич ги опфаќа поставувањето на администратор, ресурсите на серверската страна, прилагодените мапи, управувањето со возила и решавањето на проблеми за вашиот BeamMP сервер на Legion Hosting. За почетното поставување на серверот, клучевите за автентикација и основната конфигурација, видете Водич за поставување на BeamMP сервер.

---

Поставување на администратор

BeamMP нема традиционален систем за најава или лозинка на администратор. Наместо тоа, администраторските команди се извршуваат преку серверската конзола или преку Lua приклучоци на серверската страна кои ги проверуваат идентификаторите на играчите.

Команди на конзолата

Серверската конзола во GPanel обезбедува директен пристап до вградените серверски команди. Внесувајте ги командите директно во полето за внес на конзолата:

---

Структура на папката Resources

BeamMP користи папка Resources за организирање на содржината на серверската страна. Оваа папка содржи два потфолдери со различни намени:

Resources/
  Client/       <-- Client-side mods (maps, vehicles) synced to players
  Server/       <-- Server-side Lua plugins (not sent to players)

Ресурси на клиентот

Датотеките поставени во Resources/Client/ автоматски се преземаат од играчите кога ќе се поврзат. Ова се користи за:

• Прилагодени мапи — .zip датотеки со модови за мапи кои им се потребни на играчите за да ја вчитаат мапата на серверот.
• Прилагодени возила — .zip датотеки со модови за возила кои додаваат нови автомобили или модифицираат постоечки.
• Други модови за клиентот — Секој BeamNG.drive мод кој треба да биде присутен кај клиентот.

Ресурси на серверот (Lua приклучоци)

Директориумот Resources/Server/ содржи Lua приклучоци на серверската страна. Тие се извршуваат само на серверот и не се испраќаат до играчите. Секој приклучок се наоѓа во својот потфолдер со датотека main.lua:

Resources/
  Server/
    MyPlugin/
      main.lua        <-- Plugin entry point
    AnotherPlugin/
      main.lua

Приклучоците на серверската страна можат да:

• Реагираат на настани на играчите (приклучување, напуштање, пораки за разговор, спавнување на возила).
• Имплементираат прилагодени команди активирани преку разговор (на пр., /tp, /give).
• Управуваат со дозволите и ограничувањата за возила.
• Додаваат економски системи, телепортација или други прилагодени функции на играта.
• Бележат активност на играчите и спроведуваат правила.

---

Додавање на прилагодени мапи

За да извршите прилагодена (нестандардна) мапа на вашиот BeamMP сервер:

1. Преземете го модот за мапа како .zip датотека од извор на BeamNG.drive модови (на пр., складиштето на BeamNG.drive модови).
2. Запрете го серверот во GPanel.
3. Прикачете ја .zip датотеката во Resources/Client/ преку табот Files или SFTP. Немојте да го извлекувате zip-от.
4. Ажурирајте ја стартната променлива MAP (или Map во ServerConfig.toml) на точната патека на мапата за прилагодената мапа. Оваа патека е обично во форматот /levels/map_name/info.json — проверете ја документацијата на модот за точната патека.
5. Стартувајте го серверот.

---

Управување со возила

Управувањето со возила на BeamMP сервери се контролира преку поставката MaxCars и опционално преку Lua приклучоци на серверската страна.

Поставка MaxCars

Поставката MaxCars во ServerConfig.toml (или стартната променлива MAX_CARS) контролира колку возила секој играч може да спавнува истовремено:

• 1 — Секој играч може да има едно возило истовремено (препорачано за поголеми сервери).
• 2–3 — Им дозволува на играчите да имаат неколку возила, корисно за помали сервери или собири на автомобили.
• Повисоките вредности го зголемуваат оптоварувањето на серверот пропорционално.

Прилагодени модови за возила

За да додадете прилагодени возила на вашиот сервер:

1. Преземете го модот за возило како .zip датотека.
2. Поставете го во Resources/Client/.
3. Рестартирајте го серверот. Играчите автоматски ќе го преземат модот за возило при поврзување.

Ограничување на возила преку приклучоци

За поголема контрола (на пр., забрана на одредени возила, ограничување на типовите возила), ќе ви треба Lua приклучок на серверската страна. Овие приклучоци можат да ги пресретнат настаните за спавнување на возила и да ги дозволат или одбијат врз основа на прилагодени правила. Проверете ги форумите на BeamMP за приклучоци за управување со возила.

---

Инсталирање и управување со приклучоци

Lua приклучоците на серверската страна ја прошируваат функционалноста на вашиот сервер. Еве како да ги инсталирате и управувате со нив:

Инсталирање на приклучок

1. Преземете ги датотеките на приклучокот (обично папка што содржи main.lua и можеби други датотеки).
2. Запрете го серверот.
3. Прикачете ја папката на приклучокот во Resources/Server/ преку табот Files или SFTP.
4. Осигурете се дека структурата на папката е точна: Resources/Server/PluginName/main.lua.
5. Стартувајте го серверот. Конзолата ќе прикаже пораки додека приклучоците се вчитуваат.

Отстранување на приклучок

1. Запрете го серверот.
2. Избришете ја папката на приклучокот од Resources/Server/.
3. Стартувајте го серверот.

---

Решавање на проблеми

Грешки со клучот за автентикација

• Проверете дали клучот е правилно залепен во стартната променлива AUTH_KEY — без дополнителни празни места или прекини на линии.
• Осигурете се дека клучот не е отповикан или истечен на BeamMP Keymaster.
• Секој клуч може да се користи само на еден сервер истовремено. Ако го користите истиот клуч на друго место, ќе пропадне.
• Конзолата ќе прикаже грешки во автентикацијата при стартување ако клучот е неважечки.

Играчите не можат да се поврзат

• Потврдете дека серверот е целосно стартуван и се прикажува како онлајн во GPanel.
• Проверете дали играчот го користи лансерот на BeamMP, а не стандардниот лансер на BeamNG.drive.
• Ако серверот е поставен на Private = true, играчите мора да користат директно поврзување со точната IP и порта. Видете Како да ги најдете IP и портата на вашиот сервер.
• Осигурете се дека верзијата на лансерот на BeamMP на играчот е компатибилна со верзијата на серверот. Застарените лансери може да не успеат да се поврзат.
• Ако серверот е полн (достигнато е MaxPlayers), дополнителните играчи не можат да се приклучат додека некој не замине.

Проблеми со синхронизација на модови

• Ако играчите заглавуваат при преземање или добиваат грешки за модови што недостасуваат, проверете дали .zip датотеките на модовите во Resources/Client/ не се оштетени.
• Повторно преземете ја и повторно прикачете ја датотеката на модот ако .zip е оштетена.
• Многу големите датотеки на модови може да предизвикаат истекувања на времето за играчи на спори врски. Размислете за отстранување на непотребните големи модови.
• Осигурете се дека .zip датотеките на модовите не се вгнездени (т.е., .zip во папка во друга .zip).

Проблеми со перформанси со многу играчи/возила

• Намалете го MaxCars на 1 по играч.
• Намалете го MaxPlayers ако серверот доживува постојано доцнење.
• Префрлете се на поедноставна мапа (Grid Map или Industrial) за подобри перформанси со голем број играчи.
• Отстранете ги непотребните модови за клиентот од Resources/Client/ за да го намалите времето за преземање и употребата на меморијата.
• Проверете ги графиконите за употреба на ресурси во GPanel — ако CPU или RAM постојано е на границата, размислете за надградба на вашиот серверски план. Отворете тикет за поддршка за да ги разговарате опциите.

Серверот не се појавува во прелистувачот

• Осигурете се дека Private е поставено на false во вашата конфигурација.
• Проверете дали клучот за автентикација е важечки и не се користи од друг сервер.
• Почекајте 1–2 минути по стартувањето за серверот да се регистрира кај задниот дел на BeamMP.
• Проверете ја конзолата за какви било грешки поврзани со врската со главниот сервер.

---

Поврзани статии

• Водич за поставување на BeamMP сервер — Почетно поставување, клуч за автентикација, конфигурација и упатства за поврзување
• Како да ги најдете IP и портата на вашиот сервер
• Како да прикачите датотеки преку SFTP
• Водич за стартување на сервер — Општ водич за стартување на кој било игрален сервер на Legion Hosting

---

Потребна е дополнителна помош?

Ако доживувате проблеми кои не се опфатени во овој водич, нашиот тим за поддршка е достапен да помогне. Отворете тикет на legionhosting.net/submitticket.php со деталите за вашиот сервер, опис на проблемот и сите релевантни пораки за грешки од конзолата на GPanel.