מדריך

איך ליצור פלאגין BungeeCord

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

פלאגין BungeeCord רץ על ה-פרוקסי שעומד לפני השרתים שלכם, לא על שרת משחק. הוא רואה שחקנים מתחברים, עוברים בין שרתים ויוצאים, ולכן זה המקום הנכון לצ'אט ברמת הרשת, כלים לצוות, מצב תחזוקה, ה-MOTD ושליחת שחקנים בין שרתים. אין לו עולמות או בלוקים: הגיימפליי שייך לפלאגין בשרתי ה-backend.

התאימו את הפקודות לרשת שלכם.

צרו את זה עם Codexe

שלב אחר שלב

  1. 1.ודאו איזה פרוקסי אתם מריצים

    BungeeCord (או fork כמו Waterfall) ו-Velocity הם API שונים. פלאגין BungeeCord לא רץ על Velocity, וגם לא להפך.

  2. 2.הקימו את הפרויקט

    פרויקט Maven או Gradle עם התלות bungeecord-api בהיקף provided. הפרוקסי מספק אותה בזמן הריצה.

  3. 3.כתבו את המחלקה הראשית

    מחלקה שמרחיבה את net.md_5.bungee.api.plugin.Plugin, עם onEnable() שרושם פקודות ומאזינים דרך getProxy().getPluginManager().

  4. 4.תארו אותו ב-bungee.yml

    name, version, main ו-author. BungeeCord קורא גם את plugin.yml, אבל bungee.yml מונע בלבול עם פלאגינים של Spigot. הפקודות נרשמות בקוד, לא בקובץ.

  5. 5.כתבו פקודות ומאזינים

    פקודות מרחיבות את Command; מאזינים מממשים את Listener עם מתודות @EventHandler לאירועים כמו PostLoginEvent או ServerSwitchEvent.

  6. 6.תקשרו עם שרתי ה-backend אם צריך

    הפרוקסי לא רואה מלאים או עולמות. בשביל זה, פלאגין משלים קטן בכל שרת backend מחליף plugin messages עם פלאגין הפרוקסי.

  7. 7.התקינו אותו בפרוקסי

    שימו את ה-.jar בתיקיית plugins/ של הפרוקסי והפעילו מחדש את הפרוקסי, לא את שרתי ה-backend.

אירועי פרוקסי שימושיים

אירועמתי הוא מופעלשימוש נפוץ
ProxyPingEventלקוח מרענן את רשימת השרתיםMOTD, מספר שחקנים, הודעת תחזוקה
PostLoginEventשחקן הצטרף לפרוקסיהודעות הצטרפות, טעינת נתוני שחקן
ServerConnectEventשחקן עומד להתחבר לשרתשליחת שחקנים ללובי, חסימת שרתים
ServerSwitchEventשחקן עבר לשרת אחרהודעות "הצטרף לשרת" ברמת הרשת
PlayerDisconnectEventשחקן עזב את הרשתשמירת נתונים, התראות לצוות
ChatEventשחקן שולח הודעת צ'אט או פקודהצ'אט רשת, מסננים, צ'אט צוות

הגדרה נכונה של הרשת

  • הפעילו את ip_forward ב-config.yml של הפרוקסי ואת bungeecord: true ב-spigot.yml של כל שרת Spigot או Paper, כדי ששמות השחקנים וה-UUID שלהם יועברו.
  • הגדירו את שרתי ה-backend ל-online-mode=false וודאו שאי אפשר להגיע אליהם ישירות מהאינטרנט, רק דרך הפרוקסי.
  • plugin messages עוברות רק כששחקן מחובר לשרת ה-backend הזה, ולכן הודעה לשרת ריק לא נמסרת.

תיאור לדוגמה

"פלאגין פרוקסי ל-BungeeCord 1.21 בשם NetUtils. /lobby שולח את השחקן לשרת הלובי. /staffchat <message> (כינוי /sc) שולח הודעה לכל מי שיש לו netutils.staff בכל שרת. /maintenance on|off מציג MOTD של תחזוקה ומעיף שחקנים בלי netutils.bypass. הודעת הצטרפות בצ'אט הצוות כשאיש צוות עובר שרת. שמות השרתים, ה-MOTD וההודעות ב-config.yml."

עם Codexe

בחרו בסוג BungeeCord/Velocity וציינו איזה פרוקסי אתם מריצים, כי מדובר ב-API שונים. Codexe מקמפל את הפלאגין עם Maven ובודק שב-.jar יש את קובץ התיאור הנכון לפני שהוא מוכן; בלי גרסה בבקשה, נעשה שימוש ב-API של BungeeCord 1.21. אם אתם צריכים פלאגין משלים ל-backend, בקשו אותו כפרויקט Spigot/Paper נפרד.

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

שאלות

האם פלאגין BungeeCord יכול לשנות בלוקים או מלאים?

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

זה עובד על Velocity?

לא. ל-Velocity יש API משלו ו-velocity-plugin.json. אם אתם מריצים את שניהם, צרו שני פרויקטים.

פלאגין פרוקסי או פלאגין backend לצ'אט?

פלאגין פרוקסי אם הצ'אט צריך להגיע לשחקנים בכל שרת. פלאגין backend אם הצ'אט נשאר בשרת אחד.

צרו פלאגין לרשת שלכם

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

“פלאגין פרוקסי ל-BungeeCord 1.21 בשם NetUtils: /lobby שולח את השחקן לשרת הלובי, /staffchat (כינוי /sc) שולח הודעה לכל מי שיש לו netutils.staff בכל שרת, /maintenance on|off מציג MOTD של תחזוקה ומעיף שחקנים בלי netutils.bypass, מעברי שרת של הצוות מוכרזים בצ'אט הצוות, שמות השרתים, ה-MOTD וההודעות ב-config.yml.”

צרו את זה עם Codexe
איך ליצור פלאגין BungeeCord לרשת שלכם | Codexe