פתרון שגיאות ובעיות נפוצות

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

האתר אומר 404, אבל הדף קיים

העתק את הקישור מחדש מתוך מרכז התיעוד; השתמש בקישור המלא שמסתיים ב־.html כשמגיעים מקישור חיצוני.
רענן בלי cache או פתח חלון פרטי. אם הדף עדיין נפתח רק מכתובת אחת, שלח לתמיכה גם את הכתובת שהחזירה שגיאה וגם את זו שעובדת.
אל תסיר חלקים מהנתיב או תשנה אותיות גדולות/קטנות. שרתי האתר מבחינים לפעמים בין שמות נתיבים.
הקישורים המקומיים נבדקים בפרויקט בעזרת npm run check:links; בדיקה מקומית מוצלחת אינה מוכיחה שהגרסה החדשה כבר פורסמה.

ודא שהבוט מחובר לשרת ושהוא הוזמן עם scope של applications.commands.
הפקודות הגלובליות מסונכרנות בזמן הפעלת הבוט; הפצה ב־Discord עלולה להתעכב. הפעל מחדש את השירות רק אם יש לך הרשאת פריסה.
לבדיקת פיתוח, משתנה DEV_GUILD_ID מסנכרן לשרת בדיקה במקום גלובלית. ודא שאינו נשאר מכוון לשרת הלא נכון.
רשימת הפקודות באתר נוצרת ממקור הפקודות של הבוט. לאחר שינוי פקודה, הרץ python scripts/sync_command_reference.py --write בתיקיית SAC Bot ואז npm run check:links באתר.

הודעת “Only staff” או “Manager” — ודא שיש לך תפקיד מתאים בהגדרות השרת ושדרגת הבוט מכירה אותו.
הודעת “authenticate” — בצע /staff_login או /owner_auth לפי סוג המשתמש והפעלת אימות הצוות.
הודעת Safe Mode — הפעל /safemode. אם 2FA נדרש, הגדר אותו קודם לפי מדריך 2FA.
“Role hierarchy” / אין הרשאה לבצע פעולה — מקם את תפקיד הבוט מעל תפקיד היעד והענק לבוט את הרשאת Discord הרלוונטית.

הזן את הקוד בן שש הספרות מהחשבון של SAC Bot, לא קוד של שרת אחר.
המתן לקוד הבא וסנכרן את השעה בטלפון. בקוד ההגדרה יש חלון סובלנות קצר בלבד.
הגדרה שלא אושרה תוך 10 דקות פוקעת: התחל שוב ב־/2fa → Set up authenticator.
אם החלפת טלפון ואיבדת את מפתח ה־authenticator, אל תשתף אותו או סיסמה בצ׳אט. פנה למנהל השרת דרך ערוץ התמיכה המאומת.

בדוק שהמודרטור ב־Safe Mode ושלא פג תוקף הסשן.
ודא שהבוט והמודרטור גבוהים מהמשתמש בהיררכיית התפקידים; הבוט לא יכול לבצע פעולה נגד מנהל.
בדוק שלבוט יש הרשאת Timeout/Kick/Ban ושהמשך timeout תקין.
עיין ב־מדריך הענישה ובערוץ הלוגים לפני ניסיון חוזר, כדי למנוע ענישה כפולה.

אם מתקבלת הודעת database/Supabase, אל תנסה לעקוף אותה בעזרת cache מקומי. השירות צריך את כתובת הפרויקט ומפתח שרת תקין, וצריך להפעיל את המיגרציות.
אם הבוט עולה אך הפאנל לא מציג נתונים, בדוק את פעימת הלב ואת הרשאות API; דף אתר נטען אינו הוכחה שה־API או מסד הנתונים מחוברים.
אל תעתיק מפתחות API, סיסמאות או QR של 2FA לתמיכה. ציין את הפקודה, השעה, הודעת השגיאה המדויקת והשרת (בלי מזהי משתמש אם אינם נחוצים).