Plugin AMXX nu se încarcă pe serverul CS 1.6? Diagnostic „bad load”

Un plugin AMXX care nu se încarcă nu trebuie rezolvat prin reinstalarea completă a serverului. Mesajele „bad load”, „Plugin file open error”, „Invalid Plugin”, „Module required for plugin” și „Run time error” indică probleme diferite și au soluții diferite.

Diagnosticul corect începe de la Metamod, continuă cu AMX Mod X și modulele sale, apoi ajunge la pluginul afectat. Urmând această ordine poți identifica problema fără să ștergi addonul, configurațiile sau toate pluginurile serverului.

Cum diferențiezi simptomele asemănătoare

Simptom	Cauză probabilă	Prima verificare
Comanda meta este necunoscută	Metamod nu este încărcat	Verifică instalarea Metamod și pornirea GameDLL
meta list funcționează, dar AMX Mod X lipsește	AMX Mod X nu este configurat în Metamod sau binarul nu poate fi încărcat	Verifică starea AMX Mod X în lista Metamod
Pluginul nu apare deloc în amxx plugins	Nu este înscris în fișierul corect sau este dezactivat de o configurație pentru hartă	Verifică toate fișierele care pot încărca pluginuri
Pluginul apare cu bad load	Fișier absent, plugin invalid, modul lipsă sau versiune incompatibilă	Citește mesajul complet din consolă și logul AMXX
Pluginul apare ca running, dar funcția sa nu merge	Configurație greșită, comandă diferită, dependență externă sau eroare de logică	Activează debug numai pentru pluginul respectiv
Serverul se închide imediat după activarea pluginului	Modul binar incompatibil, resursă invalidă sau eroare gravă la inițializare	Dezactivează pluginul din configurație și repornește serverul
Eroarea apare numai pe anumite hărți	Configurație specifică hărții, resursă absentă sau problemă în plugin_precache	Verifică fișierele din configs/maps și resursele hărții

Dacă serverul funcționează fără plugin, dar se oprește sau generează erori imediat după activarea lui, problema nu este produsă automat de port, lista Internet sau configurația generală a jocului.

Ordinea corectă a diagnosticului

Componentele principale sunt încărcate în următoarea ordine:

1. HLDS sau ReHLDS pornește jocul.
2. Metamod este încărcat de server.
3. Metamod încarcă AMX Mod X.
4. AMX Mod X încarcă modulele necesare.
5. AMX Mod X încarcă pluginurile din fișierele de configurare.

Dacă Metamod nu funcționează, comenzile AMX Mod X nu vor exista. Dacă AMX Mod X nu funcționează, modificarea unui plugin individual nu poate rezolva problema. De aceea, verificările trebuie făcute în această ordine.

Înainte de modificări: oprește serverul și creează un backup

Avertisment: nu înlocui binare, module sau configurații înainte să ai o copie de siguranță. Unele fișiere AMX Mod X pot conține parole administrative, date SQL sau alte informații care nu trebuie publicate.

Salvează cel puțin următoarele elemente:

• cstrike/addons/amxmodx/configs;
• cstrike/addons/amxmodx/plugins;
• cstrike/addons/amxmodx/modules;
• cstrike/addons/amxmodx/data;
• cstrike/addons/amxmodx/scripting, dacă păstrezi sursele pluginurilor;
• cstrike/addons/metamod/plugins.ini;
• cstrike/liblist.gam, dacă instalarea folosește acest fișier pentru încărcarea Metamod.

Backup pe un server găzduit profesional

Oprește serverul din panoul de control. Folosește funcția de backup a panoului, dacă este disponibilă, sau descarcă directoarele necesare prin metoda de transfer oferită de furnizor.

Nu încerca să folosești comenzi de sistem dacă ai acces doar la consola jocului. Consola HLDS nu este un terminal Linux sau PowerShell.

Backup pe un server Linux administrat direct

Din directorul care conține folderul cstrike, execută:

tar -czf ../cs16-amxx-backup.tar.gz \
  cstrike/addons/amxmodx \
  cstrike/addons/metamod \
  cstrike/liblist.gam

Comanda creează o arhivă în directorul părinte. Execut-o numai după ce ai confirmat că respectivele căi există și că destinația are suficient spațiu.

Backup pe un server Windows administrat direct

Din directorul care conține folderul cstrike, execută în PowerShell:

Compress-Archive `
  -Path .\cstrike\addons\amxmodx, .\cstrike\addons\metamod, .\cstrike\liblist.gam `
  -DestinationPath ..\cs16-amxx-backup.zip

Alege un nume diferit dacă arhiva există deja. Nu depozita backupul într-un director public sau într-o arhivă distribuită altor persoane.

Pasul 1: verifică Metamod

Pornește serverul și execută în consola sa:

meta version
meta list

meta version afișează versiunea Metamod încărcată. meta list arată pluginurile native gestionate de Metamod, inclusiv AMX Mod X.

Aceste comenzi se execută în consola serverului din panoul de hosting sau direct în consola HLDS/ReHLDS. Nu le introduce în fișierele server.cfg sau plugins.ini.

Dacă primești Unknown command: meta

Metamod nu este încărcat. În această situație nu continua cu reinstalarea pluginului AMXX. Verifică:

• dacă binarul Metamod corespunde sistemului de operare;
• dacă fișierul există în calea configurată;
• dacă serverul pornește instalarea corectă;
• dacă liblist.gam sau parametrul folosit de instalare indică Metamod;
• dacă jurnalul de pornire raportează o bibliotecă sau dependență absentă.

Nu copia un fișier .dll pentru Windows pe un server Linux și nu redenumi un fișier .so în .dll. Extensia schimbată nu convertește binarul pentru alt sistem de operare.

Dacă AMX Mod X nu apare ca RUN

În rezultatul meta list, AMX Mod X trebuie să fie încărcat și să aibă o stare funcțională, de regulă RUN. Dacă apare cu eroare:

1. Verifică intrarea AMX Mod X din cstrike/addons/metamod/plugins.ini.
2. Confirmă că fișierul indicat există.
3. Confirmă că ai instalat binarul pentru Windows sau Linux, după caz.
4. Citește prima eroare afișată la pornire.
5. Nu înlocui toate modulele până nu identifici fișierul care nu poate fi încărcat.

Comanda meta refresh poate solicita Metamod să recitească lista de pluginuri și să afișeze motivul unei încărcări eșuate:

meta refresh

Execut-o în consola serverului numai pentru diagnostic. Pentru confirmarea finală este recomandată o repornire completă, deoarece unele module nu sunt proiectate pentru reîncărcare în timpul funcționării.

Pasul 2: verifică AMX Mod X, pluginurile și modulele

Dacă AMX Mod X apare corect în meta list, execută:

amxx version
amxx plugins
amxx modules

• amxx version confirmă versiunea AMX Mod X încărcată.
• amxx plugins afișează pluginurile și starea fiecăruia.
• amxx modules arată modulele disponibile și eventualele erori de încărcare.

Comenzile se execută în consola serverului. Nu publica rezultatul complet înainte să verifici dacă include informații despre infrastructura sau configurația ta.

Cum interpretezi starea pluginului

Stare	Semnificație	Acțiune
running	Pluginul a fost încărcat	Verifică configurația și erorile la rulare dacă funcția sa nu merge
debug	Pluginul rulează cu informații suplimentare de depanare	Reproduce eroarea și citește logul AMXX
paused	Pluginul este încărcat, dar execuția sa este suspendată	Verifică motivul pauzei și configurația serverului
stopped	Pluginul și-a oprit execuția sau a fost oprit	Citește mesajele anterioare din log
bad load	Pluginul nu a putut fi încărcat	Citește eroarea completă, verifică fișierul, modulele și compatibilitatea
Pluginul nu apare	Nu este înscris în configurația încărcată sau este dezactivat	Verifică plugins.ini și configurațiile pentru hărți

Pasul 3: verifică fișierul și intrarea din plugins.ini

Fișierul compilat trebuie să aibă extensia .amxx și să fie plasat în:

cstrike/addons/amxmodx/plugins/

Fișierul sursă .sma nu se încarcă direct pe server. Acesta trebuie compilat, iar rezultatul .amxx trebuie copiat în directorul de pluginuri.

În fișierul cstrike/addons/amxmodx/configs/plugins.ini, adaugă numele exact:

plugin_exemplu.amxx

Pe Linux, diferența dintre litere mari și mici contează. Următoarele nume pot reprezenta fișiere diferite:

plugin_exemplu.amxx
Plugin_Exemplu.amxx

Nu adăuga o cale completă în plugins.ini dacă documentația pluginului nu cere explicit acest lucru. Pentru instalarea obișnuită este suficient numele fișierului din directorul plugins.

Dezactivarea sigură a unui plugin

Pentru a dezactiva pluginul fără să-l ștergi, adaugă punct și virgulă la începutul liniei:

;plugin_exemplu.amxx

Oprește serverul înainte de modificare, salvează fișierul și pornește-l din nou. Comentarea liniei este reversibilă și păstrează pluginul pentru investigații.

Verifică și configurațiile specifice hărților

AMX Mod X poate încărca sau dezactiva pluginuri și prin fișiere aflate în:

cstrike/addons/amxmodx/configs/maps/

Exemple:

plugins-de_dust2.ini
plugins-de.ini

Primul fișier se aplică unei anumite hărți, iar al doilea se poate aplica unui prefix de hartă. Dacă problema apare numai pe hărți de_, verifică aceste configurații înainte să modifici lista principală.

Pasul 4: interpretează mesajul exact de eroare

Plugin file open error

AMX Mod X găsește intrarea din configurație, dar nu poate deschide fișierul indicat. Verifică:

• numele și extensia fișierului;
• literele mari și mici pe Linux;
• directorul addons/amxmodx/plugins;
• permisiunile de citire;
• dacă transferul fișierului s-a finalizat complet.

Nu rezolva eroarea prin crearea unui fișier gol cu același nume. Un fișier gol nu este un plugin AMXX valid.

Invalid Plugin sau bad load

Fișierul poate fi corupt, compilat într-un format incompatibil sau poate proveni din AMX Mod, nu din AMX Mod X. Dacă ai sursa .sma, compileaz-o din nou cu un compilator și fișiere .inc potrivite versiunii AMX Mod X instalate.

AMX Mod X 1.9 avertizează că pluginurile compilate cu funcționalități noi nu vor rula pe o versiune AMX Mod X mai veche. Actualizarea doar a pluginului, fără verificarea versiunii serverului, poate produce exact acest tip de eroare.

Module required for plugin sau Library required

Pluginul folosește o funcție oferită de un modul care nu este încărcat. Rulează:

amxx modules

Identifică modulul lipsă, apoi consultă documentația pluginului. Modulele standard pot include, în funcție de plugin, fakemeta, engine, hamsandwich sau cstrike.

Nu activa toate modulele la întâmplare. Un plugin care cere o bibliotecă terță, precum ReAPI, are nevoie de modulul respectiv și de componentele compatibile indicate de proiectul său.

Dacă versiunea AMX Mod X și documentația modulului cer o intrare în modules.ini, folosește numele recomandat de proiect. Un exemplu generic este:

fakemeta
hamsandwich
cstrike

Acest exemplu nu este o listă obligatorie. Adaugă numai modulele necesare și verifică din nou rezultatul comenzii amxx modules după repornire.

Function not found

Pluginul solicită o funcție pe care instalarea curentă nu o oferă. Cauzele obișnuite sunt:

• modul necesar absent sau neîncărcat;
• versiune AMX Mod X prea veche pentru plugin;
• versiune incompatibilă a unui modul terț;
• plugin compilat cu alte fișiere .inc decât cele disponibile pe server.

Nu redenumi funcțiile într-un fișier binar și nu instala module din arhive necunoscute. Dacă sursa este disponibilă, verifică instrucțiunile autorului și compilează pluginul cu dependențele corecte.

Run time error: debug not enabled

Pluginul s-a încărcat, dar a produs o eroare în timpul execuției. Activează depanarea numai pentru acel plugin:

plugin_exemplu.amxx debug

Linia se adaugă în fișierul care încarcă pluginul, de regulă configs/plugins.ini. După salvare, schimbă harta sau repornește serverul și reproduce problema.

AMX Mod X va putea afișa un traseu cu fișierul sursă și liniile implicate, dacă pluginul conține informațiile necesare pentru debug.

Nu seta global amx_debug 2 pe un server public decât pentru o investigație controlată. Această valoare activează debug pentru toate pluginurile și poate genera loguri foarte voluminoase.

ML_NOTFOUND sau ML_LNOTFOUND

Aceste mesaje indică o problemă cu fișierele de limbă ale pluginului. Verifică dacă ai copiat fișierele cerute în:

cstrike/addons/amxmodx/data/lang/

Folosește fișierul de limbă livrat cu aceeași versiune a pluginului. Nu adăuga traduceri inventate pentru chei pe care pluginul nu le definește.

Pasul 5: citește logul AMX Mod X

Erorile AMX Mod X sunt salvate de regulă în:

cstrike/addons/amxmodx/logs/

Caută fișierul de eroare corespunzător datei și o secvență asemănătoare cu:

[AMXX] Run time error
[AMXX] Debug Trace
[AMXX] Invalid native
[AMXX] Plugin file open error

Citește și câteva linii înaintea erorii. Mesajul care explică modulul sau fișierul absent poate apărea înaintea stivei de debug.

Securitate: înainte să trimiți logul unui dezvoltator sau pe un forum, elimină parolele, adresele reale, datele SQL, căile private și informațiile despre conturi. Trimite numai secțiunea necesară pentru reproducerea erorii.

Pasul 6: izolează pluginul care provoacă oprirea serverului

Dacă serverul se închide fără un mesaj clar, nu șterge toate pluginurile. Folosește o izolare controlată:

1. Oprește serverul.
2. Confirmă că backupul este disponibil.
3. Comentează pluginul instalat sau actualizat cel mai recent.
4. Pornește serverul și verifică dacă problema reapare.
5. Dacă problema persistă, dezactivează temporar jumătate dintre pluginurile personalizate.
6. Repetă testul și restrânge grupul până identifici pluginul.
7. Reactivează pluginurile confirmate ca funcționale.

Nu folosi doar o comandă de pauză pentru un plugin care blochează serverul la pornire sau la încărcarea hărții. Codul din etapele de inițializare și precache poate fi executat înainte să ai posibilitatea să-l pui pe pauză.

Dacă oprirea este produsă de un modul binar, acesta poate apărea în meta list sau amxx modules. Verifică separat modulele și pluginurile Pawn.

Pasul 7: recompilează pluginul din sursă

Recompilarea este utilă când pluginul a fost construit pentru altă versiune AMX Mod X sau folosește dependențe diferite. Ai nevoie de:

• fișierul sursă .sma;
• compilatorul AMX Mod X;
• fișierele .inc cerute de plugin;
• versiuni compatibile ale dependențelor.

Compilare pe Linux

Din directorul addons/amxmodx/scripting:

./amxxpc plugin_exemplu.sma

Comanda compilează sursa indicată. Nu o executa dacă nu ai verificat mesajele și versiunile dependențelor. Un rezultat cu erori de compilare nu trebuie copiat în directorul de producție.

Compilare pe Windows

Din directorul addons\amxmodx\scripting:

.\amxxpc.exe plugin_exemplu.sma

Verifică rezultatul compilatorului. După compilare, oprește serverul, păstrează o copie a pluginului vechi și înlocuiește numai fișierul .amxx corespunzător.

Compilatorul web oficial AMX Mod X poate fi folosit pentru pluginuri care depind doar de include-urile disponibile acolo. Pentru pluginuri cu ReAPI sau alte include-uri personalizate, compilează local folosind fișierele furnizate de proiectul respectiv.

Instrucțiuni diferite pentru hosting și serverul de acasă

Server găzduit profesional

• Folosește consola, managerul de fișiere și funcțiile de backup ale panoului.
• Nu încerca să instalezi biblioteci de sistem din consola jocului.
• Nu schimba arhitectura binarelor oferite de serviciul de hosting.
• Dacă un modul nativ nu poate fi încărcat, trimite suportului numai eroarea anonimizată.

Server pornit acasă

• Verifică dacă sistemul este Windows sau Linux și folosește binarele corespunzătoare.
• Verifică permisiunile fișierelor și dependențele raportate de sistem.
• Nu dezactiva mecanismele de securitate ale sistemului pentru a forța încărcarea unui modul vechi.
• Nu expune RCON sau alte servicii administrative direct către Internet fără protecție.

Greșeli frecvente

Copierea fișierului SMA în directorul plugins

AMX Mod X încarcă fișierul compilat .amxx, nu sursa .sma. Sursa trebuie compilată înainte.

Numele diferă între plugins.ini și fișier

Pe Linux, Plugin.amxx și plugin.amxx pot fi nume diferite. Copiază exact numele fișierului.

Activarea tuturor modulelor

Încărcarea modulelor inutile nu repară automat pluginul și mărește suprafața de diagnostic. Activează numai dependențele documentate.

Instalarea unui modul pentru alt sistem de operare

Fișierele .dll sunt destinate Windows, iar fișierele .so sunt utilizate pe Linux. Redenumirea extensiei nu schimbă platforma binarului.

Activarea globală a debugului

Folosește sufixul debug numai pentru pluginul afectat. Debugul global poate produce loguri excesive pe un server activ.

Ștergerea pluginului înainte de citirea erorii

Prin ștergere pierzi fișierul care trebuie analizat și riști să lași intrări invalide în configurație. Comentează linia și păstrează pluginul în backup.

Descărcarea unui AMXX fără sursă sau proveniență clară

Un plugin execută cod pe server. Folosește proiecte cunoscute, verifică sursa când este disponibilă și evită arhivele distribuite prin linkuri neverificate.

Ignorarea fișierelor pentru hărți

Un plugin poate fi activat sau dezactivat prin configs/maps/plugins-*.ini. Verifică aceste fișiere dacă eroarea apare numai pe anumite hărți.

Checklist rapid

• Serverul și addonurile au backup.
• meta version funcționează.
• AMX Mod X apare corect în meta list.
• amxx version confirmă versiunea instalată.
• Pluginul apare în amxx plugins.
• Numele din plugins.ini corespunde exact fișierului.
• Fișierul încărcat are extensia .amxx.
• Modulele necesare apar în amxx modules.
• Configurațiile din configs/maps au fost verificate.
• Debugul este activat numai pentru pluginul afectat.
• Logul AMXX a fost citit și anonimizat.
• Pluginul a fost testat separat înainte de reactivarea tuturor addonurilor.

Întrebări frecvente

De ce pluginul apare cu bad load?

Fișierul poate lipsi, poate fi corupt, poate necesita un modul neîncărcat sau poate fi incompatibil cu versiunea AMX Mod X instalată. Mesajul complet din consolă indică direcția corectă.

Trebuie să repornesc serverul după modificarea plugins.ini?

O schimbare de hartă poate reîncărca pluginurile, dar după înlocuirea modulelor sau binarelor este recomandată o repornire completă.

Pot instala direct fișierul SMA?

Nu. Fișierul .sma este sursa. Compilează-l cu amxxpc, apoi instalează rezultatul .amxx.

De ce pluginul funcționează pe Windows, dar nu pe Linux?

Pluginul Pawn poate depinde de un modul binar disponibil numai pentru o anumită platformă, de nume de fișiere cu litere diferite sau de resurse plasate în căi incorecte.

Pot folosi amx_debug 2 permanent?

Nu este recomandat. Activează debug numai pentru pluginul investigat și elimină opțiunea după ce ai obținut traseul necesar.

Surse tehnice oficiale și proiecte primare

• AMX Mod X — instalarea și depanarea pluginurilor
• AMX Mod X — instalarea și verificarea modulelor
• AMX Mod X — documentația de troubleshooting
• AlliedModders — depanarea pluginurilor AMX Mod X
• AlliedModders — compilarea pluginurilor AMX Mod X
• AlliedModders — compatibilitatea pluginurilor AMX Mod X 1.9
• Metamod-P — comenzile și configurarea Metamod
• ReHLDS — proiectele oficiale ReHLDS, Metamod-R și ReAPI

Un mediu pregătit pentru comunitatea ta CS 1.6

Dacă vrei să administrezi pluginurile, configurațiile și repornirile într-un mediu construit special pentru Counter-Strike, poți alege un pachet de Hosting CS 1.6 HostCS.ro.

Pentru pachetul cumpărat pe o lună, codul CS10 oferă o reducere de 10%. Reducerea nu se aplică perioadelor de 3, 6 sau 12 luni.