איך להתקין תוספים בשרת Minecraft (Paper ו-Spigot)

תוספים מול מודים: מה ההבדל?

לפני שאתם מורידים משהו, ודאו שמה שאתם באמת רוצים הוא תוסף. אנשים משתמשים במילים תוסף ומוד לסירוגין, אבל בשרת מדובר בשני דברים שונים לחלוטין.

תוספים מתחברים ל-Bukkit API שחושפים Paper ו-Spigot. הם חיים לגמרי על השרת, כך שהשחקנים שלכם מתחברים עם קליינט Minecraft רגיל ולעולם לא מורידים קובץ — בדיוק בגלל זה שרתי תוספים כל כך קלים להפעלה ולצמיחה.

מודים הם עולם אחר לגמרי: הם משנים את קליינט המשחק עצמו, כך שהשרת וכל שחקן חייבים להריץ את אותו הלואדר ואת אותה רשימת מודים, בדרך כלל ארוזים יחד כחבילת מודים (modpack). אם זה מה שאתם מחפשים, זה לא המדריך המתאים — עברו ל-איך להקים שרת Minecraft עם מודים. להשוואה מלאה בין הלואדרים ואיפה כל אחד מתאים, ראו התוכנה הטובה ביותר לשרת Minecraft.

לפני שמתחילים: הריצו Paper או Spigot

תוספים נטענים רק על שרת שדובר את Bukkit API. ה-server.jar הוואניל של Mojang לא תומך בזה — שימו תוסף לידו ושום דבר לא יקרה. תזדקקו לאחד מאלה:

• Paper — הבחירה הסטנדרטית. המהירה ביותר במשפחה, מתוחזקת באופן פעיל, ותואמת למערכת האקולוגית העצומה של תוספי Bukkit/Spigot. התחילו כאן.
• Spigot — הבסיס הוותיק יותר שרוב התוספים עדיין מכוונים ונבדקים כלפיו. Paper הוא סופרסט ישיר שלו, כך שתוסף המסומן "ל-Spigot" רץ גם על Paper.
• Purpur — פיצול (fork) של Paper עם כפתורי gameplay נוספים. אותם תוספים, כמה כפתורים נוספים.

אם אתם עדיין על ואניל, המעבר מהיר. בתוכנית Minecraft של HytHost יש בפאנל GameCP מחליף גרסאות מובנה: בחרו Paper (או Spigot/Purpur) ואת גרסת ה-Minecraft, לחצו פעם אחת, והבנייה הנכונה מתקינה את עצמה — העולם שלכם נשאר ללא פגע. מארחים בעצמכם? הורידו את קובץ ה-jar של Paper והריצו אותו במקום הוואניל. לעזרה בבחירה בין vanilla, Paper, Forge ו-Fabric, קראו את התוכנה הטובה ביותר לשרת Minecraft; אם עדיין לא הקמתם שרת, התחילו עם איך להקים שרת Minecraft.

איך מתקינים תוסף, שלב אחר שלב

כש-Paper או Spigot רצים, התקנת תוסף היא כמה שלבים קצרים. כל התהליך לוקח כמה דקות.

1. הורידו את קובץ ה-JAR של התוסף ממקור אמין. הבתים המוכרים לתוספים הם SpigotMC, Modrinth ו-Hangar (PaperMC). הורידו את קובץ ה-.jar, וודאו שהעמוד מציין תמיכה ב-גרסת ה-Minecraft שלכם — תוסף שנבנה ל-1.20 בדרך כלל יסרב להיטען על 1.21.
2. העלו אותו לתיקיית plugins. פתחו את הלשונית Files בפאנל, היכנסו לתיקיית plugins, והעלו את קובץ ה-JAR — גרירה ושחרור עובדים. מתקינים הרבה בבת אחת? התחברו דרך SFTP עם הפרטים שבפאנל שלכם והעתיקו ישירות לתוך plugins. מארחים בעצמכם? תיקיית ה-plugins נמצאת ליד ה-server.jar שלכם.
3. אתחלו את השרת. תוספים נטענים רק בעלייה, אז לחצו על Restart בפאנל — רילוד רגיל לא יזהה תוסף חדש לגמרי. עקבו אחרי הקונסולה בזמן העלייה: כל תוסף מכריז על עצמו כשהוא מופעל.
4. ודאו שהוא נטען. בתיבת הפקודות בקונסולה, הקלידו /plugins (או בקיצור /pl). התוסף החדש שלכם אמור להופיע ברשימה, מודפס בירוק. ירוק פירושו נטען ורץ; אדום פירושו כשל — קפצו לפתרון תקלות אם אתם רואים את זה.
5. הגדירו אותו. ההפעלה המוצלחת הראשונה יוצרת plugins/<PluginName>/config.yml. ערכו את הקובץ הזה במנהל הקבצים כדי לכוונן את התוסף, ואז הריצו את פקודת הרילוד שלו או אתחלו. YAML רגיש מאוד לרווחים — הזיחו עם רווחים, לעולם לא עם טאבים, אחרת הקובץ לא ייפרס.

תוספים חיוניים שכדאי להתקין ראשונים

אפשר לבלות סוף שבוע שלם בדפדוף בין תוספים, אבל כמעט כל שרת survival או SMP המנוהל היטב בנוי על אותה רשימה קצרה. התקינו אלה קודם:

• EssentialsX — סכין השוויצרי: /home, /spawn, /tpa, ערכות, וורפים, כלכלה בסיסית ועשרות פקודות יומיומיות. אם אתם מתקינים תוסף אחד, שיהיה זה.
• LuckPerms — מנהל ההרשאות. הוא קובע מי יכול להריץ אילו פקודות ונותן לכם דרגות וקבוצות. רוב שאר התוספים מתחברים אליו, אז הוא בעצם הכרחי ברגע שיש לכם יותר ממנהל אחד.
• WorldEdit + WorldGuard — WorldEdit מאפשר לבנות ולערוך שטח מהר; WorldGuard מגן על אזורים (ספאון, חנויות, זירות) מפני חבלנים ושולט באזורי PvP. הם מגיעים כזוג.
• Vault — תוסף גשר שקט שמאפשר לתוספי כלכלה, הרשאות וצ׳אט לתקשר זה עם זה. כמה תוספים מציינים אותו כתלות; התקינו אותו ושכחו ממנו.
• CoreProtect — רישום בלוקים ורולבק. כשחבלן פוגע בספאון שלכם, CoreProtect מראה בדיוק מי עשה מה ומחזיר את המצב לאחור תוך שניות. התקינו אותו לפני שתצטרכו אותו.

הערה לגבי הרשאות: מיד לאחר ההתקנה, רוב תוספי הפקודות מגיבים רק לאופרטורים של השרת. כדי לאפשר לדרגה רגילה להשתמש במשהו כמו /home, מעניקים את נקודת ההרשאה המתאימה (כאן essentials.home) לקבוצה שלה ב-LuckPerms. כמעט כולם נתקלים בזה פעם אחת — כשפקודה "לא עושה כלום" לשחקן רגיל, כמעט תמיד מדובר בהרשאה חסרה, לא בתוסף שבור.

כל תוסף שאתם מוסיפים משתמש בקצת זיכרון, אז שרת תוספים עמוס זקוק ליותר מרווח מאשר ואניל נקי — תכננו 4-6 GB לשרת Paper שמריץ את התוספים החיוניים שלמעלה. אם אתם לא בטוחים כמה להקצות, המדריך שלנו על כמה RAM צריך שרת Minecraft מפרט זאת לפי מספר שחקנים והגדרה.

עדכון והסרה של תוספים

תוספים הם פשוט קבצים בתיקייה אחת, מה שהופך את התחזוקה לפשוטה.

עדכון תוסף

הורידו את הגרסה החדשה, מחקו את קובץ ה-JAR הישן מתיקיית plugins (השאירו את תיקיית ההגדרות של התוסף כמו שהיא כדי שההגדרות שלכם ישרדו), העלו את ה-JAR החדש, ואתחלו. שמירה על עדכניות התוספים חשובה: תוסף מיושן הוא בדרך כלל האשם כשהשרת נשבר מיד אחרי עדכון גרסת Minecraft, אז עדכנו את התוספים בכל פעם שאתם משנים את גרסת ה-Minecraft.

הסרת תוסף

אתחלו או עצרו את השרת, מחקו את קובץ ה-JAR של התוסף מ-plugins, והוא ייעלם בעלייה הבאה. תיקיית ההגדרות שלו תחת plugins/<PluginName> נשארת אלא אם תמחקו גם אותה — אין נזק להשאיר אותה, אבל נקי יותר לנקות אם סיימתם עם התוסף הזה לתמיד.

התוסף לא נטען? איך לתקן את זה

כשתוסף מופיע באדום ב-/plugins או לא עושה כלום, הסיבה כמעט תמיד אחת מכמה אפשרויות. עברו עליהן לפי הסדר:

1. אי-התאמת גרסאות. הסיבה מספר אחת. בדקו את עמוד התוסף מול גרסת ה-Minecraft של השרת שלכם — JAR שנבנה ל-1.20 לעיתים קרובות לא יופעל על 1.21, וההפך נכון באותה מידה. הורידו את הבנייה המתאימה, או שנו את גרסת השרת שלכם כדי שתתאים לתוסף.
2. תלות חסרה. תוספים רבים זקוקים לעזר מותקן לצדם — Vault לתוספי כלכלה, תוסף כלכלה לחנות, ספרייה מסוימת. הקונסולה נוקבת בשמה עבורכם: חפשו שורה כמו Unknown/missing dependency plugins: [Vault]. התקינו את מה שהיא מבקשת ואתחלו.
3. סוג שרת שגוי. אם כלום לא נטען בכלל, ודאו שאתם באמת על Paper או Spigot ולא ואניל — תוספים זקוקים ל-Bukkit API. מחליף הגרסאות מראה מה אתם מריצים.
4. קונפיגורציה שבורה. שורה אחת עם הזחה שגויה ב-config.yml יכולה לעצור תוסף לגמרי. שגיאת הקונסולה בדרך כלל מצביעה על השורה והעמודה. תקנו את ה-YAML (רווחים, לעולם לא טאבים), או מחקו את קובץ ההגדרות ותנו לתוסף ליצור מחדש קובץ נקי באתחול הבא.

הקונסולה היא החבר הכי טוב שלכם כאן. מה שלא נכשל, השרת מדפיס את הסיבה בעלייה — שורת ERROR או WARN אדומה שנוקבת בשם התוסף ובבעיה. קראו מלמעלה למטה; השגיאה הראשונה היא בדרך כלל האמיתית.