support AchievementsGO - narzędzie do tworzenia własnych osiągnięć

#include <sourcemod>
#include <AchievementsGO>
  
int AGO_Bomb;
  
public OnPluginStart()
{
	HookEvent("bomb_planted", Event_BombPlanted);
}
  
public void AGO_OnRegisterAchievements()
{
	AGO_Bomb = AGO_AddAchievement("Boom!", "Plant 5 bombs", "Pyro path", 5);
}
  
public Action Event_BombPlanted(Handle event, const char[] name, bool dontBroadcast)
{
	int attackerId = GetClientOfUserId(GetEventInt(event, "userid"));
	
	AGO_AddPoint(attackerId, AGO_Bomb);
}

/**
 * Dodaje nowe osiągnięcie. Operacja musi byc przeprowadzona wewnątrz AGO_OnRegisterAchievements()
 * aby wszystko załadowało się poprawnie
 *
 * @param Name			Nazwa achievementa (max 64 znaki)
 * @param Description	Krótki opis (max 128 znaków)
 * @param Category		Kategoria Achievementa. Jeśli chcesz aby znajdował się w głownej sekcji, pozostaw puste ("")
 * @param Value			Ustawia cel, które achievement musi spełnić aby go zaliczyć
 * @return				ID achievementa, -1 w razie porażki lub zawiera niedozwolone znaki.
 */
native int AGO_AddAchievement(char[] Name, char[] Description, char[] Category, int Value);

/**
 * Dodaje punkt do osiągnięcia gracza
 *
 * @param client			ID gracza
 * @param IdOfAchievement	ID achievementa (uzyskane z funkcji AGO_AddAchievement())
 * @return					Aktualny progress achievementa lub -1 w razie niepowodzenia.
 */
native int AGO_AddPoint(int client, int IdOfAchievement);

/**
 * Dodaje punkty do osiągnięcia gracza
 *
 * @param client			ID gracza
 * @param IdOfAchievement	ID achievementa (uzyskane z funkcji AGO_AddAchievement())
 * @param amount			Ilość punktów, jaka ma być przydzielona
 * @return					Aktualny progress achievementa lub -1 w razie niepowodzenia.
 */
native int AGO_AddPoints(int client, int IdOfAchievement, int amount);

/**
 * Usuwa jeden punkt z osiągnięcia gracza
 *
 * @param client			ID gracza
 * @param IdOfAchievement	ID achievementa (uzyskane z funkcji AGO_AddAchievement())
 * @return					Aktualny progress achievementa lub -1 w razie niepowodzenia.
 */
native int AGO_RemovePoint(int client, int IdOfAchievement);

/**
 * Usuwa punkty z osiągnięcia gracza
 *
 * @param client			ID gracza
 * @param IdOfAchievement	ID achievementa (uzyskane z funkcji AGO_AddAchievement())
 * @param amount			Ilość punktów, która ma być zabrana
 * @return					Aktualny progress achievementa lub -1 w razie niepowodzenia.
 */
native int AGO_RemovePoints(int client, int IdOfAchievement, int amount);

/**
 * Resetuje progress achievementa gracza do zera
 *
 * @param client			ID gracza
 * @param IdOfAchievement	ID achievementa (uzyskane z funkcji AGO_AddAchievement())
 * @return					Aktualny progress achievementa lub -1 w razie niepowodzenia.
 */
native int AGO_ResetPoints(int client, int IdOfAchievement);

/**
 * Zwracaa nazwe achievementu na podstawie jego indexu
 *
 * @param IdOfAchievement	ID achievementa (uzyskane z funkcji AGO_AddAchievement())
 * @param tab				Tablica na nazwe
 * @param size				Rozmiar tablicy
 * @return					0 w razie powodzenia. Jesli sie nie udalo: -1, a tablica zawiera: "NOT FOUND"
 */
native void AGO_GetNameByIndex(int IdOfAchievement, char[] tab, int size);

/**
 * Zwraca index Achievementa na podstawie jego nazwy
 *
 * @param name				Tablica z nazwą Achievmentu
 * @return					Index Achievementa. Jeśli nie znaleziono -1
 */
native int AGO_GetIndexByName(char[] name);

/**
 * Zwraca opis Achievementa na podstawie jego indexu
 *
 * @param IdOfAchievement	ID achievementa (uzyskane z funkcji AGO_AddAchievement())
 * @param tab				Tablica na opis
 * @param size				Rozmiar tablicy
 * @return					0 w razie powodzenia. Jesli sie nie udalo: -1, a tablica zawiera: "NOT FOUND"
 */
native void AGO_GetDescriptionByIndex(int IdOfAchievement, char[] tab, int size);

/**
 * Zwraca aktualny progress Achievementu gracza
 *
 * @param client			ID gracza
 * @param IdOfAchievement	ID achievementa (uzyskane z funkcji AGO_AddAchievement())
 * @return					Progress. Jeśli się nie udało, -1
 */
native int AGO_GetAchievementProgress(int client, int IdOfAchievement);

/**
 * Sprawdza, czy dany Achievement gracza został ukończony
 *
 * @param client			ID gracza
 * @param IdOfAchievement	ID achievementa (uzyskane z funkcji AGO_AddAchievement())
 * @return					1: ukończony, 0: nieukończony, -1: porażka
 */
native int AGO_IsAchievementCompleted(int client, int IdOfAchievement);

/**
 * Zwraca ilość aktywnych achievementów
 *
 * @return					Ilość achievementów
 */
native int AGO_GetAmountOfAchievements();

/**
 * Sprawdza, czy tabele SQL zostały poprawnie utworzony
 *
 * @return					1: Tabele utworzone, 0: nieutworzone
 */
native int AGO_AreTablesCreated();




/**
 * Wywoływany, kiedy wszystkie Achievementy zostały poprawnie załadowane do silnika
 */
forward void AGO_OnAllAchievementsLoaded();

/**
 * Wywoływane, gdy Achievement został ukończony przez gracza
 *
 * @param client			ID gracza
 * @param IdOfAchievement	ID achievementa (uzyskane z funkcji AGO_AddAchievement())
 */
forward void AGO_OnAchievementAccomplished(int client, int IdOfAchievement);

/**
 * Wywoływany, kiedy silnik jest gotowy ma ładowanie Achievementów. Może się to odbywać wyłącznie w tym miejscu
 */
forward void AGO_OnRegisterAchievements();