הפרויקט הראשון שלכם

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

#הבקשה

במסך יצירה, בחרו פלאגין Bukkit/Spigot/Paper (Java) וכתבו:

A Paper 1.21.4 plugin called SimpleHomes.
- /sethome saves the player's current location as their home (one home per player).
- /home teleports them there after a 3 second warm-up; moving cancels it.
- 30 second cooldown on /home, configurable in config.yml.
- Homes persist across restarts in a YAML file.
- Permissions: simplehomes.use (default true), simplehomes.bypasscooldown (default op).
- Messages configurable in config.yml, with color codes.

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

#מה קורה אחר כך

1. Codexe מזרים את הקבצים: pom.xml של Maven, המחלקה הראשית, מחלקות של פקודות ומאזינים, plugin.yml ו-config.yml.
2. הבאנר מתחלף לבודק את הפרויקט… ואז לבונה…. Codexe מקמפל את הפלאגין.
3. אם הקומפיילר מדווח על שגיאה (למשל import שגוי), תראו מתקן בעיה…. Codexe מתקן את הקוד ובונה שוב. זה לא משתמש בטוקנים שלכם.
4. הפרויקט הופך למוכן.

#הסתכלו על התוצאה

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

#שנו משהו

בצ'אט של הפרויקט, כתבו:

Allow up to 3 named homes per player: /sethome <name>, /home <name>, /delhome <name>, /homes to list them.

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

#בנו ובדקו אותו

לחצו על קומפילציה כדי להריץ בנייה טרייה, ואז על הורדת JAR. שימו את ה-JAR בתיקייה plugins/ של השרת שלכם והפעילו אותו מחדש. בדקו כל פקודה, כולל מקרי הקצה (תזוזה בזמן ההמתנה לשיגור, זמן ההמתנה בין שימושים, הפעלה מחדש).

#הלאה

• איך לכתוב בקשה טובה
• עבודה עם ה-AI
• מדריך Spigot ו-Paper