תוספים בשרתי Minecraft; היא מפעילה את מערכת ההרשאות, הכלכלה, ההגנה, השוק, האירוע, התביעה, האנטי-צ'יט ומערכות מיוחדות רבות. אם אחד התוספים אינו מותקן, ייתכן שחלק ניכר מהשרת לא יפעל.

שגיאות פלאגין מתרחשות בדרך כלל במסוף או logs/latest.log מופיע בקובץ. הטעויות הנפוצות ביותר; לא ניתן היה לטעון את הפלאגין, גרסת API לא נתמכת, תלות לא ידועה, plugin.yml לא חוקי וחוסר תאימות לגרסת Java.

1. איפה אתה יכול לראות את שגיאת הפלאגין?

אם התוסף לא נטען, המקום הראשון לחפש בו הוא קונסולת השרת וקובץ latest.log.

tail -n 200 logs/latest.log

למעקב חי:

tail -f logs/latest.log

כדי לחפש לפי שם הפלאגין:

grep -i "pluginadi" logs/latest.log

2. שגיאת גרסת API לא נתמכת

שגיאה זו מציינת שגרסת ה-API של Minecraft הנתמכת על ידי הפלאגין אינה תואמת לגרסת השרת.

Unsupported API version 1.20

לדוגמה, התוסף עשוי להיות מוכן לגרסה 1.20, אך ייתכן שהשרת שלך פועל בגרסה 1.16.5. במקרה זה, ייתכן שהתוסף לא נטען או עשוי לפעול באופן שגוי.

פתרון:

• בדוק את גרסת Minecraft הנתמכת על ידי התוסף.
• הורד את גרסת הפלאגין התואמת לגרסת השרת שלך.
• אל תצפה שתוספים חדשים יעבדו על שרתים ישנים מאוד.
• במידת הצורך, מצא את הגרסה המתאימה מארכיון הגרסאות הישן של התוסף.

3. שגיאת תלות לא ידועה

יש תוספים שלא עובדים לבד. הוא מבקש להתקין תחילה תוסף נוסף. זה נקרא תלות.

Unknown dependency Vault
Could not load plugin because dependency LuckPerms was not found

לדוגמה, תוספי כלכלה לעתים קרובות כספת רוצה. הרשאה או תוספי שוק עשויים להזדקק גם לתוספי ספרייה אחרים.

פתרון:

• קרא את הדרישות בדף הפלאגין.
• הורד את תוסף התלות החסר.
• ודא שתוסף התלות תואם גם לגרסת השרת שלך.
• הפעל מחדש את השרת לחלוטין.

4. שגיאת plugin.yml לא חוקית

בתוך קובץ צנצנת הפלאגין plugin.yml אם הקובץ פגום, חסר או שגוי, לא ניתן להתקין את התוסף.

Invalid plugin.yml
Plugin does not contain a plugin.yml

זה מתרחש בדרך כלל כאשר:

• הורד הקובץ הלא נכון.
• במקום התוסף, מיקוד קוד המקור הוצב בתיקיית התוספים.
• קובץ Jar פגום.
• התוסף נארז בצורה שגויה על ידי המפתח.

כפתרון, התוסף תקין. .צנצנת יש להוריד את הקובץ. אין למקם את ה-source-code.zip שהורדו מ-GitHub ישירות לתוך תיקיית התוספים.

5. אי תאימות לגרסת Java

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

java -version

שגיאה נפוצה:

UnsupportedClassVersionError

שגיאה זו מצביעה על כך שהתוסף הודר עם Java חדש יותר, אך נעשה שימוש ב-Java ישן יותר בשרת.

היגיון כללי:

• גרסאות Minecraft ישנות יותר דורשות לעתים קרובות ג'אווה ישנה יותר.
• גרסאות Minecraft חדשות יותר דורשות Java חדש יותר.
• יש לבדוק את דרישת ה-Java בתיאור הפלאגין.
• יש לאמת את גרסת ה-Java שנבחרה בלוח האירוח.

6. האם קובץ הפלאגין נמצא בתיקייה הנכונה?

קבצי פלאגין בשרתי Bukkit, Spigot ו-Paper תוספים נזרק לתיקיה.

ls plugins/

קובץ הפלאגין צריך להיות כך:

plugins/PluginAdi.jar

פלאגינים שנותרו ב-zip, rar, קוד מקור או תיקיות לרוב לא עובדים.

7. התנגשויות תוספים

שני תוספים שעושים את אותה עבודה עלולים להתנגש זה בזה. לדוגמה, שני תוספי צ'אט שונים, שני תוספים שונים לכלכלה או שתי מערכות תביעה שונות עשויים לנסות לנהל את אותם אירועים.

תסמיני עימות:

• התוסף מותקן אך הפקודות שלו לא עובדות.
• תוסף אחד מציף את ההגדרה של אחר.
• התנגשות אירוע או חריגה מתרחשת במסוף.
• שחקנים לא יכולים להשתמש בפקודות גם אם יש להם הרשאה.
• השרת מתנהג אחרת לאחר הפעלה מחדש.

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

8. שגיאת תצורה עשויה למנוע מהפלאגין להיפתח

חלק מהפלאגינים לא ייפתחו אם יש שגיאת YAML בקובץ התצורה. הזחות רווחים לבנים חשובים במיוחד בקבצי YAML.

טעויות נפוצות:

• שימוש בתו טאב
• אל תשאיר רווח אחרי המעי הגס
• כתיבת טקסט הדורש מרכאות ללא מרכאות
• השחתה בקובץ עקב אופי טורקי או סמל מיוחד
• שומר קובץ תצורה חסר

אם יש קובץ תצורה שגוי, ניתן לשנות את שם תיקיית הפלאגין באופן זמני כדי לגבות את תיקיית הפלאגין וליצור מחדש את התצורה.

טעויות נפוצות

• התקנת תוספים שאינם תואמים לגרסת השרת
• לא מתקין תוספי תלות חסרים
• טעות בקובץ ה-zip מקור GitHub בתור תוסף
• לא בודק את גרסת Java
• מנסה להתקין תוסף עם /Reload
• שימוש בכרטיסיות בקובצי התצורה של YAML

שאלות נפוצות

התוסף נמצא בתיקיית התוספים אבל הוא לא עובד, למה?
זה יכול להיות אי תאימות לגרסה, תלות חסרה, אי תאימות של Java או שגיאת תצורה. יש לבדוק את הקובץ האחרון.log.

מה המשמעות של UnsupportedClassVersionError?
התוסף הודר זה עתה עם Java. גרסת Java בשימוש בשרת מיושנת.

האם זה בטוח להשתמש / לטעון מחדש?
זה לא מומלץ עבור תוספים רבים. הפעלה מחדש מלאה בטוחה יותר עבור התקנת תוסף, הסרה ושינויי תצורה גדולים.

המלצות בטיחות ותפעול

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

מאמר זה הוכן במיוחד עבור PvPServer.