Cum instalezi plugin-uri pe un server Minecraft (Paper & Spigot)

Plugin-uri vs mod-uri: care e diferența?

Înainte să descarci ceva, asigură-te că un plugin este chiar ce vrei. Lumea folosește cuvintele plugin și mod interschimbabil, dar pe un server sunt două lucruri complet diferite.

Plugin-urile se agață de API-ul Bukkit pe care Paper și Spigot îl expun. Trăiesc în întregime pe server, așa că jucătorii tăi se conectează cu un client Minecraft standard și nu descarcă niciodată vreun fișier — de aceea serverele cu plugin-uri sunt atât de ușor de administrat și de dezvoltat.

Mod-urile sunt cu totul altceva: schimbă chiar clientul jocului, așa că serverul și fiecare jucător trebuie să ruleze același loader și aceeași listă de mod-uri, de obicei livrate împreună ca modpack. Dacă asta cauți, acesta nu e ghidul potrivit — mergi la cum faci un server Minecraft moddat. Pentru comparația completă a loaderelor și unde se potrivește fiecare, vezi cel mai bun software pentru server Minecraft.

Înainte să începi: rulează Paper sau Spigot

Plugin-urile se încarcă doar pe un server care „vorbește" API-ul Bukkit. server.jar-ul vanilla de la Mojang nu o face — pui un plugin lângă el și nu se întâmplă nimic. Ai nevoie de unul dintre acestea:

• Paper — alegerea standard. Este cel mai rapid din familie, întreținut activ și compatibil cu uriașul ecosistem de plugin-uri Bukkit/Spigot. Începe de aici.
• Spigot — baza mai veche pe care majoritatea plugin-urilor încă o vizează și pe care sunt testate. Paper este un superset drop-in al acestuia, așa că un plugin etichetat „for Spigot" rulează și pe Paper.
• Purpur — o ramificație (fork) a Paper cu opțiuni suplimentare de gameplay. Aceleași plugin-uri, câteva setări în plus.

Dacă încă ești pe vanilla, schimbarea e rapidă. Pe un plan HytHost Minecraft, panoul GameCP are un schimbător de versiune integrat: alegi Paper (sau Spigot/Purpur) și versiunea de Minecraft, dai click o singură dată, iar build-ul corect se instalează singur — lumea ta rămâne neatinsă. Găzduiești singur? Descarcă jar-ul Paper și pornește-l în locul celui vanilla. Pentru ajutor în alegerea dintre vanilla, Paper, Forge și Fabric, citește cel mai bun software pentru server Minecraft; dacă nu ai construit încă un server, începe cu cum faci un server Minecraft.

Cum instalezi un plugin, pas cu pas

Cu Paper sau Spigot pornit, instalarea unui plugin înseamnă câțiva pași scurți. Întregul proces durează câteva minute.

1. Descarcă JAR-ul plugin-ului dintr-o sursă de încredere. Locurile serioase pentru plugin-uri sunt SpigotMC, Modrinth și Hangar (PaperMC). Descarcă fișierul .jar și confirmă că pagina listează suport pentru versiunea ta de Minecraft — un plugin construit pentru 1.20 de obicei refuză să se încarce pe 1.21.
2. Încarcă-l în folderul plugins. Deschide tab-ul Files din panou, intră în directorul plugins și încarcă JAR-ul — funcționează drag and drop. Instalezi mai multe deodată? Conectează-te prin SFTP cu datele de acces din panou și copiază-le direct în plugins. Găzduiești singur? Folderul plugins stă lângă server.jar.
3. Repornește serverul. Plugin-urile se încarcă doar la pornire, așa că apasă Restart în panou — un simplu reload nu va prelua un plugin nou-nouț. Urmărește consola în timp ce pornește: fiecare plugin se anunță singur pe măsură ce se activează.
4. Verifică dacă s-a încărcat. În căsuța de comenzi a consolei, scrie /plugins (sau forma scurtă /pl). Noul tău plugin ar trebui să apară în listă, scris cu verde. Verde înseamnă încărcat și funcțional; roșu înseamnă că a eșuat — sari la depanare dacă vezi asta.
5. Configurează-l. Prima pornire reușită creează plugins/<PluginName>/config.yml. Editează acel fișier în file manager ca să ajustezi pluginul, apoi rulează comanda lui de reload sau repornește. YAML e sensibil la spațiere — folosește spații pentru indentare, niciodată tab-uri, altfel fișierul nu se va parsa.

Plugin-uri esențiale de instalat mai întâi

Ai putea petrece un weekend întreg răsfoind plugin-uri, dar aproape orice server de supraviețuire sau SMP bine administrat se bazează pe aceeași listă scurtă. Instalează-le pe astea mai întâi:

• EssentialsX — cuțitul elvețian: /home, /spawn, /tpa, kit-uri, warp-uri, o economie de bază și zeci de comenzi de zi cu zi. Dacă instalezi un singur plugin, instalează-l pe acesta.
• LuckPerms — managerul de permisiuni. Decide cine poate rula ce comenzi și îți oferă ranguri și grupuri. Majoritatea celorlalte plugin-uri se agață de el, deci devine practic obligatoriu din momentul în care ai mai mult de un admin.
• WorldEdit + WorldGuard — WorldEdit îți permite să construiești și să editezi terenul rapid; WorldGuard protejează regiuni (spawn, magazine, arene) de grief și controlează zonele de PvP. Vin ca pereche.
• Vault — un plugin-punte discret care le permite plugin-urilor de economie, permisiuni și chat să comunice între ele. Multe plugin-uri îl listează ca dependență; îl instalezi și îl uiți.
• CoreProtect — logare de blocuri și rollback. Când un griefer îți lovește spawn-ul, CoreProtect arată exact cine a făcut ce și anulează în câteva secunde. Instalează-l înainte să ai nevoie de el.

O notă despre permisiuni: imediat după instalare, majoritatea plugin-urilor de comenzi răspund doar operatorilor serverului. Ca să lași un rang normal să folosească ceva precum /home, acorzi nodul de permisiune corespunzător (aici essentials.home) grupului lor în LuckPerms. Asta îi prinde pe aproape toți o dată — când o comandă „nu face nimic" pentru un jucător obișnuit, aproape întotdeauna e vorba de o permisiune lipsă, nu de un plugin defect.

Fiecare plugin adăugat consumă puțină memorie, așa că un server aglomerat cu plugin-uri are nevoie de mai multă marjă decât vanilla simplu — planifică 4-6 GB pentru un server Paper care rulează plugin-urile esențiale de mai sus. Dacă nu ești sigur cât să aloci, ghidul nostru despre câtă RAM are nevoie un server Minecraft detaliază totul pe număr de jucători și configurație.

Actualizarea și eliminarea plugin-urilor

Plugin-urile sunt doar fișiere într-un singur folder, ceea ce face întreținerea simplă.

Actualizarea unui plugin

Descarcă versiunea nouă, șterge JAR-ul vechi din folderul plugins (lasă folderul de configurare al pluginului neatins ca setările tale să supraviețuiască), încarcă noul JAR și repornește. Menținerea plugin-urilor la zi contează: un plugin învechit este de obicei vinovatul atunci când un server se strică imediat după o schimbare de versiune Minecraft, așa că actualizează-ți plugin-urile de fiecare dată când schimbi versiunea de Minecraft.

Eliminarea unui plugin

Repornește sau oprește serverul, șterge JAR-ul pluginului din plugins, și dispare la următoarea pornire. Folderul lui de configurare de sub plugins/<PluginName> rămâne pe loc dacă nu ștergi și el — inofensiv să-l lași, dar ordonat să-l cureți dacă ai terminat definitiv cu pluginul.

Pluginul nu se încarcă? Cum îl repari

Când un plugin apare roșu în /plugins sau nu face nimic deloc, motivul este aproape întotdeauna unul dintre câteva lucruri. Parcurge-le în ordine:

1. Nepotrivire de versiune. Cauza numărul unu. Verifică pagina pluginului comparativ cu versiunea de Minecraft a serverului tău — un JAR construit pentru 1.20 adesea nu se activează pe 1.21, și invers este la fel de valabil. Descarcă build-ul care se potrivește sau schimbă versiunea serverului tău să corespundă pluginului.
2. O dependență lipsă. Multe plugin-uri au nevoie de un ajutor instalat alături de ele — Vault pentru plugin-uri de economie, un plugin de economie pentru un magazin, o bibliotecă specifică. Consola îl numește pentru tine: caută o linie precum Unknown/missing dependency plugins: [Vault]. Instalează ce cere și repornește.
3. Tip greșit de server. Dacă nu se încarcă nimic deloc, confirmă că ești chiar pe Paper sau Spigot și nu pe vanilla — plugin-urile au nevoie de API-ul Bukkit. Schimbătorul de versiune arată ce rulezi.
4. O configurare stricată. O singură linie greșit indentată în config.yml poate opri complet un plugin. Eroarea din consolă indică de obicei linia și coloana. Repară YAML-ul (spații, niciodată tab-uri), sau șterge fișierul de configurare și lasă pluginul să regenereze unul curat la următoarea repornire.

Consola e cel mai bun prieten al tău aici. Orice ar eșua, serverul afișează motivul la pornire — o linie roșie ERROR sau WARN care numește pluginul și problema. Citește-o de sus în jos; prima eroare e de obicei cea reală.