מדריך

איך לתקן שגיאות בפלאגינים של Minecraft

עודכן 18 באוקטובר 2026

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

ציינו את גרסת השרת שלכם ומה הפלאגין צריך לעשות.

צרו את זה עם Codexe

שלב אחר שלב

1.פתחו את יומן העלייה
קראו את הקונסולה, או את logs/latest.log בתיקיית השרת. בפאנל אחסון, השתמשו בקונסולה או במנהל הקבצים שלו.
2.חפשו את שם הפלאגין
מצאו את השגיאה הראשונה שמזכירה אותו. השורות שמתחילות ב-[ERROR] או ב-[WARN] וה-stack trace שמתחתן הן אלה שחשובות.
3.קראו את השורה הראשונה ואת שורות "Caused by"
השורה הראשונה אומרת מה נכשל; שורת ה-Caused by: האחרונה בדרך כלל אומרת למה. שורות עם שם החבילה של הפלאגין עצמו מראות איפה בקוד שלו.
4.התאימו אותה לרשימה שלמטה
רוב שגיאות העלייה הן בעיה של גרסה, Java או תלות, וההודעה אומרת איזו.
5.תקנו דבר אחד והפעילו מחדש
שנו דבר אחד, הפעילו מחדש (לא /reload) וקראו שוב את היומן. שגיאות מפלאגין אחד יכולות לגרום לשגיאות באחרים.

השגיאות הנפוצות

מה רואים	מה זה אומר	תיקון
`Unsupported API version 1.21`	ה-`api-version` של הפלאגין חדש יותר מהשרת שלכם.	השיגו את הגרסה לשרת שלכם, או עדכנו את השרת.
`Could not load 'plugins/X.jar'` עם `Invalid plugin.yml` או `Jar does not contain plugin.yml`	קובץ התיאור של הפלאגין חסר או שיש בו שגיאת YAML, או שהקובץ אינו פלאגין.	ודאו שהורדתם את הפלאגין ולא את קוד המקור שלו, מוד או zip. אם בניתם אותו בעצמכם, תקנו את `plugin.yml`.
`UnsupportedClassVersionError`, "class file version 65.0"	הפלאגין צריך Java חדשה יותר ממה שהשרת מריץ (61 = Java 17, 65 = Java 21, 69 = Java 25).	הריצו את השרת על ה-Java הזו, או בנו מחדש את הפלאגין ל-Java שלכם.
`NoClassDefFoundError` או `ClassNotFoundException`	מחלקה שהפלאגין צריך לא נמצאת: פלאגין שהוא תלוי בו חסר, ספרייה לא נארזה לתוך ה-.jar, או שה-API לא קיים בגרסה הזו.	התקינו את הפלאגין שמוזכר בשגיאה (Vault, ProtocolLib), או השתמשו בבנייה לגרסה שלכם.
`Unknown/missing dependency plugins`	פלאגין שמופיע ב-`depend` לא מותקן.	התקינו אותו ב-`plugins/`.
`Error occurred while enabling X (Is it up to date?)`	הפלאגין נטען אבל קרס ב-`onEnable`.	קראו את שורת ה-`Caused by`: לרוב מדובר בשגיאה בהגדרות או בתלות חסרה.
`Ambiguous plugin name`	ב-`plugins/` יש שני קובצי .jar של אותו פלאגין.	מחקו את הישן.

שגיאות שלא קשורות לטעינה

הפלאגין ירוק אבל פקודה כותבת "Unknown command": הפקודה חסרה ב-plugin.yml, או שפלאגין אחר משתמש באותו שם.
"I'm sorry, but you do not have permission": לשחקן חסרה ההרשאה. בדקו בדף הפלאגין מה שם ההרשאה ותנו אותה עם פלאגין ההרשאות שלכם.
שגיאות אחרי עריכת config.yml: YAML צריך רווחים, לא טאבים, ומרכאות סביב טקסט שמתחיל ב-: או ב-&.
עובד אחרי הפעלה מחדש, נשבר אחרי /reload: הפלאגין לא תומך ב-/reload. הפעילו מחדש במקום זאת.

איזו Java השרת שלכם צריך

Minecraft 1.20.5 ואילך צריך Java 21, ו-26.x צריך Java 25; 1.18 עד 1.20.4 צריכים Java 17. הריצו java -version עם אותה Java שהשרת משתמש בה (בפאנל אחסון זו בדרך כלל הגדרה בשם Docker image או Java version). פלאגין שנבנה ל-Java ישנה יותר רץ על חדשה יותר, ולא להפך.

תיקון פלאגינים שנוצרו עם Codexe

פלאגינים שנוצרים ב-Codexe מקומפלים לגרסה שבחרתם ונבדקים שיש להם plugin.yml תקין לפני שהם מוכנים. בשרת בדיקה, הלשונית יומנים מציגה את היומן בזמן אמת עם השגיאות מודגשות, וייצוא יומנים שומר אותו כקובץ. תארו בצ'אט של הפרויקט מה אתם רואים ("הפלאגין אדום ב-/plugins והיומן כותב ...") ו-Codexe משנה את הקוד ובונה שוב. אם קומפילציה נכשלת על קבצים בדיוק כמו ש-Codexe מסר אותם, תיקון עם AI מתקן אותם בחינם.

שאלות

איפה נמצא יומן השרת?

logs/latest.log בתיקיית השרת, לריצה הנוכחית. ריצות קודמות נמצאות באותה תיקייה כקובצי .log.gz.

האם פלאגין אחד יכול לשבור אחר?

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

האם בטוח לשתף את היומן שלי?

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

בנו מחדש פלאגין שבור לשרת שלכם

הפרומפט הזה נפתח מוכן לשליחה:

“פלאגין ל-Paper 1.21.4 בשם SimpleWarps שמחליף את הישן שלי שכבר לא נטען: /setwarp, /warp ו-/delwarp עם שם, /warps מציג אותם ב-GUI, הרשאה warps.admin להגדרה ולמחיקה, ה-warps נשמרים בין הפעלות מחדש, הודעות ב-config.yml.”