איך ליצור פלאגין כלכלה ל-Minecraft

שלב אחר שלב

1. 1.החליטו מה הפלאגין עושה

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

2. 2.בחרו את השרת והגרסה

   כתבו את תוכנת השרת והגרסה, למשל Paper 1.21.4. הפלאגין נבנה מול ה-API ורמת ה-Java של אותה גרסה.

3. 3.פרטו את הפקודות והכללים

   /balance, /pay <player> <amount>, /baltop, ופקודות ניהול כמו /eco give|take|set. הוסיפו את יתרת הפתיחה, שם המטבע, מספר הספרות אחרי הנקודה ותשלום מינימלי.

4. 4.בחרו איפה היתרות נשמרות

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

5. 5.תנו ל-Codexe לכתוב ולבנות

   תארו את הפלאגין וציינו את Vault במפורש כדי שיתווסף כתלות. Codexe כותב את קוד ה-Java, את plugin.yml ואת config.yml, מקמפל ומתקן שגיאות בנייה לפני שהפרויקט מוכן.

6. 6.בדקו תשלומים בתוך המשחק

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

7. 7.התקינו אותו

   שימו את Vault ואת ה-.jar שלכם בתיקיית plugins/ של השרת והפעילו מחדש. הסירו כל פלאגין כלכלה אחר, או החליטו באיזה מהם Vault ישתמש.

איפה Vault נכנס לתמונה

Vault הוא גשר, לא כלכלה. פלאגין כלכלה מממש את הממשק Economy של Vault ורושם אותו במנהל השירותים של השרת; פלאגינים אחרים מבקשים אותו עם getServer().getServicesManager().getRegistration(Economy.class) וקוראים למתודות כמו getBalance, withdrawPlayer ו-depositPlayer.

כך פלאגין חנות אף פעם לא צריך לדעת איזו כלכלה מותקנת אצלכם. ב-plugin.yml השתמשו ב-depend: [Vault] כשהפלאגין לא יכול לעבוד בלעדיו, או ב-softdepend כש-Vault אופציונלי. ה-API של Vault נחוץ רק לקומפילציה; Vault עצמו מותקן בשרת.

החלטות שכדאי לכתוב בבקשה

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

איפה לשמור את היתרות

תיאור לדוגמה

"פלאגין כלכלה ל-Paper 1.21.4 בשם Coins שנרשם ככלכלה של Vault. /balance [player], /pay <player> <amount> עם מינימום של 1, /baltop עם 10 המובילים, ו-/eco give|take|set לשחקנים עם coins.admin. שחקנים חדשים מתחילים עם 100 מטבעות. שתי ספרות אחרי הנקודה. כל תשלום נרשם עם תאריך, שולח, מקבל וסכום. היתרות נשמרות ב-SQLite. שמות המטבע וכל הודעה ב-config.yml."

Codexe משתמש ב-SQLite כברירת מחדל כשלא מבקשים משהו אחר. אם מבקשים MySQL, הפלאגין נכתב עם הגדרת storage-type, ושרת הבדיקה נותן לו מסד נתונים MySQL משלו בזמן שאתם מנסים אותו.

שאלות