מדריך
איך ליצור פריטים מותאמים עם פלאגין
עודכן 18 באוקטובר 2026
חרבות, שרביטים, מפתחות וכלים מותאמים הם מהתכונות המבוקשות ביותר בפלאגינים. פלאגין לא יכול להוסיף למשחק פריט חדש באמת, אבל הוא יכול לקחת פריט vanilla, לתת לו שם, lore ותגית נסתרת, ולהגיב כששחקן משתמש בו. השחקנים מצטרפים עם המשחק הרגיל, בלי מודים.
החליפו את הפריטים בשלכם.
צרו את זה עם Codexeשלב אחר שלב
1.פרטו את הפריטים
לכל פריט: חומר הבסיס, שם התצוגה, שורות ה-lore ומה הוא עושה. "blaze rod בשם Fire Wand שיורה כדור אש בלחיצה ימנית, זמן המתנה של 5 שניות" הוא פריט שלם.
2.תייגו אותם עם PersistentDataContainer
שמרו מזהה כמו
fire_wandב-PersistentDataContainerשל הפריט עםNamespacedKey. הפלאגין מזהה את הפריט לפי התגית הזו, לא לפי השם שלו, כך ששינוי השם בסדן לא יוצר עותק.3.כתבו את היכולות
כל יכולת היא מאזין אירועים:
PlayerInteractEventללחיצות ימניות,EntityDamageByEntityEventלפגיעות,BlockBreakEventלכלים. הוסיפו זמני המתנה לכל שחקן ולכל פריט.4.החליטו איך השחקנים מקבלים אותם
פקודת
/giveלאדמינים, מתכון יצירה, חנות, שלל מיצורים או פרסים מתיבות.5.הפכו הכול לניתן להגדרה
שמות, lore, נזק, זמני המתנה ומתכונים ב-
config.yml, כדי שתוכלו לאזן את הפריטים בלי בנייה חדשה.6.בנו ונסו כל פריט
תנו ל-Codexe לקמפל את הפלאגין, הצטרפו לשרת הבדיקה עם נסו עכשיו, תנו לעצמכם כל פריט והשתמשו בו.
למה תגית ולא השם
בדיקה של שם התצוגה או ה-lore היא הטעות הקלאסית: כל שחקן עם סדן יכול לשנות שם של מקל ל-"Fire Wand". ה-PersistentDataContainer (Minecraft 1.14 ואילך) שומר על הפריט נתונים ששחקנים לא יכולים לערוך, והם שורדים הפעלות מחדש, תיבות ומסחר כי הם חלק מהפריט.
ב-1.8 עד 1.13 אין PersistentDataContainer; פלאגינים משתמשים ב-NBT דרך ספרייה או בסימון נסתר ב-lore. ציינו את הגרסה בבקשה ו-Codexe כותב את הגישה שהגרסה הזו תומכת בה.
יכולות והאירועים שמאחוריהן
| יכולת | אירוע | הערות |
|---|---|---|
| כוח בלחיצה ימנית | PlayerInteractEvent | בדקו את היד, האירוע מופעל פעם אחת לכל יד |
| נזק נוסף או אפקטים בפגיעה | EntityDamageByEntityEvent | בדקו שהפוגע הוא שחקן שמחזיק את הפריט |
| כלי כרייה של אזור | BlockBreakEvent | כבדו פלאגיני הגנה כמו WorldGuard |
| אפקט פסיבי כשהפריט ביד | משימה חוזרת או PlayerItemHeldEvent | הסירו את האפקט כשהפריט מונח בצד |
| קשת או קליע | EntityShootBowEvent, ProjectileHitEvent | תייגו את הקליע כדי לדעת מאיפה הוא הגיע |
טקסטורות ומודלים
פלאגין משנה את מה שפריט עושה, לא את איך שהוא נראה. מראה מותאם דורש חבילת משאבים שהשחקנים מורידים: בגרסאות ישנות הפריט נושא מספר CustomModelData שהחבילה ממפה למודל, ומ-1.21.2 פריט יכול גם להפנות למודל משלו דרך הרכיב item_model. בלי חבילה הפריט נראה כמו חומר הבסיס שלו עם שם מותאם, וזה מספיק להרבה שרתים.
תיאור לדוגמה
"פלאגין ל-Paper 1.21.4 בשם MagicItems. שלושה פריטים, כל אחד מתויג במזהה PersistentDataContainer: Fire Wand (blaze rod, לחיצה ימנית יורה כדור אש, זמן המתנה של 5 שניות), Frost Blade (חרב ברזל, פגיעות נותנות Slowness II ל-3 שניות), Miner's Pick (מכוש יהלום, שובר 3x3 אבל לא באזורי WorldGuard שבהם השחקן לא יכול לבנות). /mi give <player> <item> ל-magicitems.admin. מתכון עם צורה לכל אחד. שמות, lore, זמני המתנה ומתכונים ב-config.yml."
שאלות
פלאגין או מוד לפריטים מותאמים?
פלאגין אם השחקנים צריכים להצטרף עם המשחק הרגיל: הפריטים הם פריטי vanilla עם התנהגות חדשה. מוד אם אתם צריכים פריטים או בלוקים חדשים באמת עם תצוגה משלהם, שכל שחקן יצטרך להתקין. ראו פלאגין מול מוד.
אפשר להשתמש איתו ב-ItemsAdder או ב-Nexo?
הפלאגין שלכם יכול להיות תלוי בהם, אבל הם פלאגינים בתשלום: שרת הבדיקה של Codexe לא יכול להתקין אותם, ולכן פלאגין שדורש אחד מהם לא יופעל שם. תלויות חינמיות שמופיעות ב-plugin.yml מותקנות בשבילכם בשרת הבדיקה.
האם הפריטים מפסיקים לעבוד אחרי עדכון?
פריטים שמתויגים ב-PersistentDataContainer שומרים על התגית שלהם בין עדכוני Minecraft. ייתכן שהיכולות יצטרכו בנייה מחדש מול ה-API החדש; ראו עדכון פלאגין.
צרו את הפריטים המותאמים שלכם
הפרומפט הזה נפתח מוכן לשליחה:
“פלאגין ל-Paper 1.21.4 בשם MagicItems עם שלושה פריטים מתויגים ב-PersistentDataContainer: Fire Wand (blaze rod, לחיצה ימנית יורה כדור אש, זמן המתנה של 5 שניות), Frost Blade (חרב ברזל, Slowness II ל-3 שניות בפגיעה), Miner's Pick (מכוש יהלום שכורה 3x3). /mi give ל-magicitems.admin, מתכון עם צורה לכל אחד, שמות, lore, זמני המתנה ומתכונים ב-config.yml.”
צרו את זה עם Codexe