פתרון שגיאות ובעיות נפוצות
הדף מפריד בין שגיאת קישור באתר לבין הודעה שהבוט מציג ב־Discord. בדוק את הכתובת המדויקת ואת שם הפקודה לפני שינוי הרשאות או חזרה על פעולה.
האתר אומר 404, אבל הדף קיים
- העתק את הקישור מחדש מתוך מרכז התיעוד; השתמש בקישור המלא שמסתיים ב־
.htmlכשמגיעים מקישור חיצוני. - רענן בלי cache או פתח חלון פרטי. אם הדף עדיין נפתח רק מכתובת אחת, שלח לתמיכה גם את הכתובת שהחזירה שגיאה וגם את זו שעובדת.
- אל תסיר חלקים מהנתיב או תשנה אותיות גדולות/קטנות. שרתי האתר מבחינים לפעמים בין שמות נתיבים.
- הקישורים המקומיים נבדקים בפרויקט בעזרת
npm run check:links; בדיקה מקומית מוצלחת אינה מוכיחה שהגרסה החדשה כבר פורסמה.
הפקודה לא מופיעה ב־Discord
- ודא שהבוט מחובר לשרת ושהוא הוזמן עם scope של
applications.commands. - הפקודות הגלובליות מסונכרנות בזמן הפעלת הבוט; הפצה ב־Discord עלולה להתעכב. הפעל מחדש את השירות רק אם יש לך הרשאת פריסה.
- לבדיקת פיתוח, משתנה
DEV_GUILD_IDמסנכרן לשרת בדיקה במקום גלובלית. ודא שאינו נשאר מכוון לשרת הלא נכון. - רשימת הפקודות באתר נוצרת ממקור הפקודות של הבוט. לאחר שינוי פקודה, הרץ
python scripts/sync_command_reference.py --writeבתיקיית SAC Bot ואזnpm run check:linksבאתר.
אין הרשאה / Safe Mode נדרש
- הודעת “Only staff” או “Manager” — ודא שיש לך תפקיד מתאים בהגדרות השרת ושדרגת הבוט מכירה אותו.
- הודעת “authenticate” — בצע
/staff_loginאו/owner_authלפי סוג המשתמש והפעלת אימות הצוות. - הודעת Safe Mode — הפעל
/safemode. אם 2FA נדרש, הגדר אותו קודם לפי מדריך 2FA. - “Role hierarchy” / אין הרשאה לבצע פעולה — מקם את תפקיד הבוט מעל תפקיד היעד והענק לבוט את הרשאת Discord הרלוונטית.
קוד 2FA נדחה
- הזן את הקוד בן שש הספרות מהחשבון של SAC Bot, לא קוד של שרת אחר.
- המתן לקוד הבא וסנכרן את השעה בטלפון. בקוד ההגדרה יש חלון סובלנות קצר בלבד.
- הגדרה שלא אושרה תוך 10 דקות פוקעת: התחל שוב ב־
/2fa→ Set up authenticator. - אם החלפת טלפון ואיבדת את מפתח ה־authenticator, אל תשתף אותו או סיסמה בצ׳אט. פנה למנהל השרת דרך ערוץ התמיכה המאומת.
ענישה נכשלה
- בדוק שהמודרטור ב־Safe Mode ושלא פג תוקף הסשן.
- ודא שהבוט והמודרטור גבוהים מהמשתמש בהיררכיית התפקידים; הבוט לא יכול לבצע פעולה נגד מנהל.
- בדוק שלבוט יש הרשאת Timeout/Kick/Ban ושהמשך timeout תקין.
- עיין ב־מדריך הענישה ובערוץ הלוגים לפני ניסיון חוזר, כדי למנוע ענישה כפולה.
הגדרה נשמרת או נתונים לא נטענים
- אם מתקבלת הודעת database/Supabase, אל תנסה לעקוף אותה בעזרת cache מקומי. השירות צריך את כתובת הפרויקט ומפתח שרת תקין, וצריך להפעיל את המיגרציות.
- אם הבוט עולה אך הפאנל לא מציג נתונים, בדוק את פעימת הלב ואת הרשאות API; דף אתר נטען אינו הוכחה שה־API או מסד הנתונים מחוברים.
- אל תעתיק מפתחות API, סיסמאות או QR של 2FA לתמיכה. ציין את הפקודה, השעה, הודעת השגיאה המדויקת והשרת (בלי מזהי משתמש אם אינם נחוצים).