-המדריך נכתב במקור ע"י SA-MP ותוגרם ע"י Milne.-

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

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

יצירת הודעת כניסה :

public OnPlayerConnect(playerid)

[left]{     new pName[MAX_PLAYER_NAME];     new string[48];     GetPlayerName(playerid, pName, sizeof(pName));     format(string, sizeof(string), "%s has joined the server.", pName);     SendClientMessageToAll(0xAAAAAAAA, string);     return 1; } [/left]

ההודעה למעלה תראה הודעת הצטרפות בצ'אט,זה ממוקם ב OnPlayerConnect callback שמזהה כל פעם ששחקן מתחבר.

זה אומר שכאשר הקוד הזה יהיה מבוצע זה כאשר שחקן נכנס לסרבר.

תחילה,ערך pName חדש יהיה עם גודל של MAX_PLAYER_NAME (מוגדר בתור 24 בa_samp.inc)

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

לאחר מכן אנו מגדירים ערך חדש בשם string בערך הזה אנו נשמור את הודעת ההצטרפות,המידה היא 48 pName, 24 chars) וההודעה עצמה -
(" has joined the server.", 23 chars)
ויחידת מידע NUL בלתי נראת על מנת לגמור את ההתאמה של הstring לערך שלנו.

כעת,GetPlayerName
קודם כל,על מנת למצוא את שם השחקן-

public OnPlayerConnect(playerid)

[left]{     //Get the name of the new player and inform the other players     //about a new player       new name[MAX_PLAYER_NAME];     string[48];     GetPlayerName(playerid, name, sizeof(name));     format(string, sizeof(string), "%s has joined the server.", name );     SendClientMessageToAll(0xFFFF00AA, string);       return 1; }[/left]

playerid-האידי של השחקן שאת שמו אתם רוצים לדעת.

const name[]-המשתנה לשמירת השם .

len- מספר התאים למשתנה שהוקצב.

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

לאחר שאנחנו יודעים את שם השחקן עכשיו,אנחנו יכולים להסדיר ולערוך את הודעת הכניסה.
הפרמטר הראשון מאפשר לנו לפרט איפה אנחנו רוצים למקם את ה"מחרוזת" המפורמטת.
יצרנו את הערך של המחרוזת למטרה זו קודם לכן.
הפרמטר השני הוא האורך המקסימלי של המחרוזת המפורמטת.
זה בעצם יהיה המימדים של string.
ההפרמטר השלישי היא המחרוזת הממשית אותה אנחנו רוצים לפרמט.
%s הוא "שומר מקום" למחרוזת נוספת.בשימוש בפרמט הרביעי אנחנו מציינים שזה אמור להתחלף עם pName לכן יהיה לנו
"<player's name> has joined the server." במחרוזת של הערך.

יצירת הודעת עזיבה:
ונוסיף אם הם קיבלו קיק,קראש או יצאו לבד.

public OnPlayerDisconnect(playerid, reason)

[left]{     new pName[MAX_PLAYER_NAME];     new string[56];     GetPlayerName(playerid, pName, sizeof(pName));       switch(reason)     {         case 0: format(string, sizeof(string), "%s has left the server. (Timeout)", pName);         case 1: format(string, sizeof(string), "%s has left the server. (Leaving)", pName);         case 2: format(string, sizeof(string), "%s has left the server. (Kicked)", pName);     }       SendClientMessageToAll(0xAAAAAAAA, string);     return 1; }[/left]

הקוד הוא די דומה לקוד ההצטרפות.

דוגמא ליצירת טקסט עם הסיבה של יציאת השחקן-

public OnPlayerDisconnect(playerid, reason)

[left] {      new          string[64],          playername[ MAX_PLAYER_NAME ],          reasontext[10];      if(reason == 1) reasontext = "Leaving";      else if(reason == 2) reasontext = "Kicked/Banned";      else reasontext = "Timed out";      GetPlayerName(playerid, playername, sizeof(playername));      format(string, sizeof(string), "** %s left the server (%s)", playername, reasontext);      SendClientMessageToAll(0xFFFFFFFF, string);      return 1;  } [/left]

playerid-האידי של המשתמש שעזב.

reason-האידי של הסיבה מדוע הוא עזב.

סיבות:

0-קראש (Timed out)

1-יציאה רגילה (q/ או פשוט דרך התפריט)

2.קיבל קיק או באן.

הפונקציה הזאת מופעלת בכל פעם כשמתמש עוזב בצורה כלשהי.

הצהרת המפנה מאפשרת לנו ליצור הודעה אחרת ביחס לסיבה.

(קראש,קיק/באן,התנתקות)

שימו לב שהערך המחרוזת קיים עם גודל של 56 תאים כרגע,על מנת להעניק לו את הגודל המרבי בהודעה (24 + 31 + 1)

במקרה הזה,הדעת הTimed Out היא הארוכה ביותר.

עד כאן,בהצלחה.

תודה, אחלה של מדריך..

ואם אני רוצה לעשות ש - XXX has joined the server [ID:]

גיגמר אתה פשוט מוסיף עוד משתנה לפורמט:

format(string, sizeof(string), "%s has joined the server (ID:%d.", pName,playerid);

תהנה
נ.ב אחלה מדריך אחי

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