איך ליצור פלאגין תפריטי GUI ל-Minecraft

שלב אחר שלב

1. 1.שרטטו את התפריט

   לתפריט תיבה יש 1 עד 6 שורות של 9 משבצות (9 עד 54). כתבו איזה פריט נכנס לאיזו משבצת, מה כל לחיצה עושה, ואילו משבצות הן רק קישוט, כמו לוחות זכוכית.

2. 2.צרו את המלאי עם holder

   פתחו אותו עם Bukkit.createInventory(holder, size, title), בעזרת מחלקת InventoryHolder משלכם. ה-holder הוא הדרך של הפלאגין לדעת שלחיצה קרתה בתפריט שלו ולא בתיבה רגילה.

3. 3.טפלו בלחיצות

   ב-InventoryClickEvent, בדקו את ה-holder, בטלו את האירוע ואז הריצו את הפעולה של המשבצת הזו. סגרו את התפריט או רעננו אותו אחרי הפעולה.

4. 4.חסמו כל דרך אחרת להזיז פריטים

   בטלו גם את InventoryDragEvent, וטפלו בלחיצות shift, במקשי המספרים ובלחיצות במלאי של השחקן עצמו בזמן שהתפריט פתוח.

5. 5.הוסיפו עמודים אם הרשימה ארוכה

   ל-warps או לפריטי חנות שלא נכנסים, שמרו את השורה התחתונה לכפתורי הקודם, הבא וסגירה.

6. 6.פתחו אותו מפקודה

   למשל /warps, או מפריט או מ-NPC. תנו לפקודה הרשאה אם התפריט לא מיועד לכולם.

7. 7.בנו ולחצו על הכול

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

הכללים ששומרים על תפריט בטוח

• זהו את התפריט לפי ה-holder שלו, אף פעם לא לפי הכותרת: כל תיבה ששמה שונה יכולה להעתיק כותרות.
• בטלו את הלחיצה לפני כל דבר אחר, כדי ששגיאה בפעולה לא תשאיר אף פעם את הפריט בסמן של השחקן.
• בטלו גרירות ולחיצות shift מהמלאי של השחקן, אחרת אפשר לדחוף פריטים לתוך התפריט.
• אל תסמכו על הפריט שבמשבצת: חפשו את הפעולה לפי מספר המשבצת או לפי תגית על הפריט.
• הריצו עבודה איטית (קריאות ממסד נתונים, בקשות רשת) מחוץ ל-thread הראשי ועדכנו את התפריט כשהיא מסתיימת.

תפריטים מתוך הקונפיגורציה

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

תיאור לדוגמה

"פלאגין ל-Paper 1.21.4 בשם WarpMenu. /warps פותח תפריט של 6 שורות עם כפתור לכל warp, 45 בכל עמוד, עם כפתורי הקודם, הבא וסגירה בשורה התחתונה. אדמינים מוסיפים warps עם /setwarp <name> <material> ומסירים אותם עם /delwarp. לחיצה על warp משגרת אחרי המתנה של 3 שניות שמתבטלת בתנועה. השחקנים לא יכולים לקחת או להזיז אף פריט בתפריט. ה-warps נשמרים ב-warps.yml, כותרת התפריט, שמות הכפתורים וההודעות ב-config.yml."

בדיקת תפריטים עם שחקני בדיקה

שחקני הבדיקה של Codexe יכולים לפתוח תפריט וללחוץ על משבצת, ואז לבדוק שנפתח תפריט, שהופיעה הודעה או שניתן פריט. הוסיפו בדיקה במילים שלכם, כמו "שחקן רגיל מריץ /warps, לוחץ על משבצת 0 ורואה את הודעת השיגור", והיא תרוץ שוב בכל פעם ש-Codexe מוסר שינוי.

שאלות