[B3N4K]

Awesome work! Finally some free Achievements API!

[Xellath]

Originally Posted by B3N4K Awesome work! Finally some free Achievements API!

Thank you!

[t3hNox]

A while ago I was planning to make my own similar achievements API system but I will definitely use this one if it is well-coded (haven't looked at the code yet, hope it's good).

I'd also suggest to add SQL support and make simple web interface (not neccessarly anything fency).


Anyways, good job !

[Xellath]

Thank you, t3hNox.

SQL support is already done. Check main post about cvars and saving.

About a php part; I could put together one once I have some spare time on my hands. A lot going on with school and such, but will do along with the API tutorial.

Thanks for all the support so far!

[dfwu.dark]

i am using this in my server and it works quite good...thx a lot

[Racoon]

How to check if the achievement is done while ingame or check the list of achievements?
Does the player receive any notification about completed achievement?

[Xellath]

Originally Posted by Racoon How to check if the achievement is done while ingame or check the list of achievements?

If you take a look in one of the _addict, _1337 or example plugins you can see the basic idea behind it.

Explained in psuedo-code:

global variable holding objective info++

check if GetClientAchievementStatus( global var ) == _In_Progress
    // achievement not completed
    SetAchievementData( )
    // to save current progress

    check if GetClientAchievementStatus( global var ) == _Unlocked
        // achievement earned
        // send completed to api and announce
        ClientAchievementCompleted( .Announce = true )
    endif
else
    // achievement already completed
    // send completed to api, but don't announce
    ClientAchievementCompleted( .Announce = false );
endif

Thank you for your suggestion about a list of achievements. Will be implanted into the API shortly.

Originally Posted by Racoon Does the player receive any notification about completed achievement?

Yes. Notifications are text-based (or the elegant CZTutor messages if running CZ), and will show text to everyone on the server. Also, when an achievement is completed and announced by the plugin, a forward is called:

/*
 * Called when a player has recently earned an achievement
 * 
 * @param      AchiPointer - Pointer to achievement
 * @param      Client - Index of player
 * 
 * @noreturn
 * 
 */
forward Forward_ClientEarnedAchievement( const AchiPointer, const Client );

The forward is mainly to award additional things, specific things, that choose yourself. If you want a model to be awarded for completing the achievement, for example.

Native ClientAchievementCompleted( ) from the API:

PHP Code:

public _ClientAchievementCompleted( Plugin, Params )
{
    new Client = get_param( 1 );
    new AchievementPointer = get_param( 2 );
    
    AchievementsCompleted[ Client ]++;
    
    if( get_param( 3 ) )
    {
        new AchievementData[ AchievementsStruct ];
        ArrayGetArray( Achievement, AchievementPointer, AchievementData );
        
        new Data[ AchievementDataStruct ];
        ArrayGetArray( AchievementData[ _Data ], AchievementPointer, Data );
        
        #if defined UseCZTutor
            CreateTutorMessage( Client, random_num( 1, 4 ), 
                "Achievement Earned: %s",
                 AchievementData[ _Name ]
                );
        #endif
        
        new ClientName[ MaxClients ];
        get_user_name( Client, ClientName, charsmax( ClientName ) );
        
        #if defined UseChatColor
            client_print_color( 0, DontChange, 
                "^4[ Achievements API ]^3 %s unlocked achievement: ^4%s ^3- Progress: %i/%i",
                ClientName,
                AchievementData[ _Name ],
                AchievementsCompleted[ Client ],
                ArraySize( Achievement )
                );
        #else
            client_print( 0, print_chat, 
                "[ Achievements API ] %s unlocked achievement: %s - Progress: %i/%i",
                ClientName,
                AchievementData[ _Name ],
                AchievementsCompleted[ Client ],
                ArraySize( Achievement )
                );
        #endif
            
        ExecuteForward( ForwardClientAchievement, ForwardAchievementReturn, AchievementPointer, Client );
    }
} 


[t3hNox]

I've got a problem with GetClientAchievementStatus native. Error output:

L 09/14/2011 - 21:26:51: Invalid cellvector handle provided (10:1:1)
L 09/14/2011 - 21:26:51: [AMXX] Displaying debug trace (plugin "achievement_api2
.amxx")
L 09/14/2011 - 21:26:51: [AMXX] Run time error 10: native error (native "ArrayGe
tArray")
L 09/14/2011 - 21:26:51: [AMXX]    [0] achievement_api2.sma::_GetClientAchieveme
ntStatus (line 230)
L 09/14/2011 - 21:26:51: Unhandled dynamic native error
L 09/14/2011 - 21:26:51: [AMXX] Displaying debug trace (plugin "zzTest.amxx")
L 09/14/2011 - 21:26:51: [AMXX] Run time error 10: native error (native "GetClie
ntAchievementStatus")
L 09/14/2011 - 21:26:51: [AMXX]    [0] zzTest.sma::fnCurrentStats (li
ne 107)

Line 107 from zzTest.sma:

		for(new i = 0 ; i < Achievements; i++)
		{
			g_iCurrentProgress[id][i] = GetAchievementData( g_szName[id], AchievementInfo[ i ][ Save_Name ] );
			
			if( GetClientAchievementStatus( AchievementPointer[ i ], g_iCurrentProgress[ id ][ i ] ) == _Unlocked ) // This is line 107.
			{
				ClientAchievementCompleted( id, AchievementPointer[ i ], .Announce = false ); 		
			}
		}

AMXX version 1.8.1.3746.

[Lokogaditano]

Any tutorial for noobs? I read everithing and I dont understand....how to make achievementes for my jailbreak

[Xellath]

Originally Posted by t3hNox I've got a problem with GetClientAchievementStatus native. Error output: L 09/14/2011 - 21:26:51: Invalid cellvector handle provided (10:1:1) L 09/14/2011 - 21:26:51: [AMXX] Displaying debug trace (plugin "achievement_api2 .amxx") L 09/14/2011 - 21:26:51: [AMXX] Run time error 10: native error (native "ArrayGe tArray") L 09/14/2011 - 21:26:51: [AMXX] [0] achievement_api2.sma::_GetClientAchieveme ntStatus (line 230) L 09/14/2011 - 21:26:51: Unhandled dynamic native error L 09/14/2011 - 21:26:51: [AMXX] Displaying debug trace (plugin "zzTest.amxx") L 09/14/2011 - 21:26:51: [AMXX] Run time error 10: native error (native "GetClie ntAchievementStatus") L 09/14/2011 - 21:26:51: [AMXX] [0] zzTest.sma::fnCurrentStats (li ne 107) Line 107 from zzTest.sma: for(new i = 0 ; i < Achievements; i++) { g_iCurrentProgress[id][i] = GetAchievementData( g_szName[id], AchievementInfo[ i ][ Save_Name ] ); if( GetClientAchievementStatus( AchievementPointer[ i ], g_iCurrentProgress[ id ][ i ] ) == _Unlocked ) // This is line 107. { ClientAchievementCompleted( id, AchievementPointer[ i ], .Announce = false ); } } AMXX version 1.8.1.3746.

Thank you for the report!

Updated to v0.0.3. Check changelog for documentation.

v0.0.3 also received two additional natives:

• /*
   * Returns the name of the achievement
   * 
   * @param      AchievementPointer - Pointer from the registration of the achievement
   * @param      Description - Name passed by reference
   * 
   * @return    Returns the name by reference (2nd param)
   */
  native GetAchievementName( AchievementPointer, Name[ ] );

• /*
   * Returns the description of the achievement
   * 
   * @param      AchievementPointer - Pointer from the registration of the achievement
   * @param      Description - Description passed by reference
   * 
   * @return    Returns the description by reference (2nd param)
   */
  native GetAchievementDesc( AchievementPointer, Description[ ] );

A new plugin was also introduced; a MOTD plugin that allows you to see your current achievements earned (by saying /achievements).

Originally Posted by Lokogaditano Any tutorial for noobs? I read everithing and I dont understand....how to make achievementes for my jailbreak

I'll make one shortly, you'll have to wait a while. Sorry.