[Craxor]

Gravity API

Description
This plugin give you 2 natives wich you can manage user gravity(set/get).

Difference bettwen default one

• + You can give give directly the exact gravity value you want( without calculating floats )
• + Return the exact gravity you have
• + Checking user alive for don't throw errors.
• + An easy way to take/give gravity, example on "Examples" section.
• + Save the gravity for users.

API

Quick preview of new natives:

set_player_gravity( id, iGravity=800, save_gravity=1 )
get_player_gravity( id )
get_server_gravity( )
give_player_gravity( id, i_IncreaseValue )
take_player_gravity( id, i_DecreaseValue )
reset_player_gravity( id )

Full documentation can be found there, as well in include file:

/*
*   set_player_gravity( id, iGravity=800, save_gravity=1 )
*      @param id: User index.
*      @param igravity: Gravity to set for a specific id.
*      @param save_gravity: if 1 Save gravity, if 0 not save.
*/
native set_player_gravity( id, iGravity=800, save_gravity=1 );


/*
*   get_player_gravity( id )
*      @param id: User index
*      @return: Return the user current gravity
*/
native get_player_gravity( id )

/*
*   get_server_gravity( )
*      @return: Return the sv_gravity console variabile value.
*/
stock get_server_gravity( )
{
    static GravityPointer;
    if( !GravityPointer ) 
        GravityPointer = get_cvar_pointer("sv_gravity");

    new iServerGravity = get_pcvar_num( GravityPointer );
    return iServerGravity;  
}

/*
*   give_player_gravity( id, i_IncreaseValu )
*      @id: User index
*      @value: The gravity value you wanna give.
*      #Note: 'Value' is the gravity you give +(plus) current gravity of user(Not setting the exact value of gravity)!
*/
stock give_player_gravity( id, i_IncreaseValue ) 
{
    set_player_gravity( id, get_player_gravity( id ) + i_IncreaseValu );    
}

/*
*   take_player_gravity( id, i_DecreaseValue )
*      @id: User index
*      @value: The gravity value you wanna take.
*      #Note: 'Value' is the gravity you take -(minus) current gravity of user(Not setting the exact value of gravity)!
*/
stock take_player_gravity( id, i_DecreaseValue ) 
{
    set_player_gravity( id, get_player_gravity( id ) - i_DecreaseValue );   
}

/*
*   reset_player_gravity( id )
*      @id: User index
*      #Note: This function is set gravity of player to default server gravity.
*/
stock reset_player_gravity( id ) 
{
    set_player_gravity( id, get_server_gravity( ) );    
}

Example

PHP Code:

#include <amxmodx>
#include <gravity_api>

public plugin_init( )
{
    register_clcmd( "say a", "atest" );
    register_clcmd( "say x", "xtest" );
    register_clcmd( "say n", "ntest" );
    register_clcmd( "say y", "ytest" );
}

public ytest( id ) set_player_gravity( id, get_player_gravity( id ) - 10 );

public atest( id )
    client_print( id, print_chat, "Your curr grav is: %i", get_player_gravity( id ) );

// this should give you 800 gravity.
public ntest( id )
    set_player_gravity( id );

public xtest( id )
    set_player_gravity( id, 500 ); 


Credit's

• HamletEagle - for unnaproving it !

ChangeLog
V0.3:

• + Added Save Gravity for users ( New Vault ).
• + Some natives repaired and code optimized.

V0.2:

• + Added a new native.
• + Added some stocks
• + Removed return -1 and put only "return".
• + Change "iGravity < 0" to "iGravity < 1" ( Thanks to Nubo. )

V0.1:

• + First release

[HamletEagle]

I'm not sure how such API is usefull. API is for giving control over some functionalities or to help the coder accomplish something that is hard without.

Here is not the case. Unapproved.

[Craxor]

Originally Posted by HamletEagle I'm not sure how such API is usefull. API is for giving control over some functionalities or to help the coder accomplish something that is hard without. Here is not the case. Unapproved.

Not so important for me if is approved or unnaproved, just a question, if is unnaproved i have permision to continue add support for it?

Edit: give_user_gravity get_user_gravity ( native from default amxx addon ) is broken, mine working well.

[HamletEagle]

Yes, you can do whatever you want with your plugin, also it can be reviewed at any time you want.
Also, there is no give_user_gravity native in amxx core, but set_user_gravity, which you are using in your code and it's not broken in any way.

[Craxor]

Originally Posted by HamletEagle Yes, you can do whatever you want with your plugin, also it can be reviewed at any time you want. Also, there is no give_user_gravity native in amxx core, but set_user_gravity, which you are using in your code and it's not broken in any way.

Lol, sorry! i wanna mean get_user_gravity .

Here: http://www.amxmodx.org/doc/index.htm...er_gravity.htm

[HamletEagle]

set_user_gravity is not broken. If you are talking about the float values, everyone should be able to understand how to use it, or simply do value/sv_gravity. API should not be a lazy wrapper around core functions.

[Craxor]

Originally Posted by HamletEagle set_user_gravity is not broken. If you are talking about the float values, everyone should be able to understand how to use it, or simply do value/sv_gravity. API should not be a lazy wrapper around core functions.

I'm talking about get_user_gravity



( #Wrong link above sorry... )

[Depresie]

ahm, no offense, but why an API? for such thing?

[Craxor]

Originally Posted by Depresie ahm, no offense, but why an API? for such thing?

Normal gravity native: set_user_gravity( id, 0.5 ) // 500
My gravity native: set_player_gravity( id, 500 )

My API return corectly the user gravity, instead get_user_gravity is broken. + You have more natives to manage users gravity ( gravity_api.inc ).

But who care? If i need i use this, if not i will not use. That's all.

[klippy]

How is it broken? You never told or showed us what is broken about it? Tell us and show a code snippet that proves it.