[API] Data Player (Load/Save)

[BlackSmoke]

Авторы: BlackSmoke

Версия: 0.1

Описание:

Работа плагина заключается в сохранении и загрузке данных игрока с помощью файла.

Типы сохранения\загрузки:

• По имени игрока DP_PLAYER_NAME
• По стим идентификатору игрока DP_PLAYER_STEAMID
• По айпи игрока DP_PLAYER_IP

Нативы:
[pawn]

1. native dp_save_int( iTypeSL:iType, iPlayer, const sFileName[ ], iData );


2. native dp_save_float( iTypeSL:iType, iPlayer, const sFileName[ ], Float:fData );


3. native dp_save_string( iTypeSL:iType, iPlayer, const sFileName[ ], const sData[ ] );


4. native dp_load_int( iTypeSL:iType, iPlayer, const sFileName[ ], &iData );


5. native dp_load_float( iTypeSL:iType, iPlayer, const sFileName[ ], &Float:fData );


6. native dp_load_string( iTypeSL:iType, iPlayer, const sFileName[ ], sData[ ], iLen );

[/pawn]

Пример ( сохранение денег ):
[pawn]

1. #include        amxmodx


2. #include        data_player_api


3. #include        cstrike


4.  


5. public client_disconnect( id )


6. {


7.      dp_save_int( DP_PLAYER_NAME, id, "addons/amxmodx/configs/PlayersMoney.ini", cs_get_user_money( id ) ) ;


8. }


9.  


10. public client_putinserver( id )


11. {


12.      cs_set_user_money( id, 0 ) ;


13.      set_task( 10.0, "Load__Money", id ) ;


14. }


15.  


16. public Load__Money( id )


17. {


18.      new iReturnMoney ;


19.      if( dp_load_int( DP_PLAYER_NAME, id, "addons/amxmodx/configs/PlayersMoney.ini", iReturnMoney ) )


20.      {


21.              cs_set_user_money( id, iReturnMoney ) ;


22.              client_print( id, print_center, "Ваши загруженные деньги: %d", iReturnMoney ) ;


23.      }


24.      else


25.              client_print( id, print_center, "Ошибка загрузки денег" ) ;


26. }

[/pawn]

Пример работы с массивом:
[pawn]

1. public Save__Origin( id )


2. {


3.      new Float:fOrigin[ 3 ] , sText[ 64 ] ;


4.      pev( id, pev_origin, fOrigin ) ;


5.      format( sText, charsmax( sText ), "%f %f %f", fOrigin[ 0 ], fOrigin[ 1 ], fOrigin[ 2 ] ) ;


6.      dp_save_string( DP_PLAYER_NAME, id, "addons/amxmodx/configs/PlayersOrigin.ini", sText ) ;


7. }


8.  


9. public Load_Origin( id )


10. {


11.      new sReturnData[ 128 ] , sPos[ 3 ][ 8 ], Float:fOrigin[ 3 ] ;


12.      dp_load_string( DP_PLAYER_NAME, id, "addons/amxmodx/configs/PlayersOrigin.ini", sReturnData, charsmax( sReturnData ) ) ;


13.      parse( sReturnData, sPos[ 0 ], charsmax( sPos[ ] ), sPos[ 1 ], charsmax( sPos[ ] ), sPos[ 2 ], charsmax( sPos[ ] ) ) ;


14.      fOrigin[ 0 ] = str_to_float( sPos[ 0 ] ) ;


15.      fOrigin[ 1 ] = str_to_float( sPos[ 1 ] ) ;


16.      fOrigin[ 2 ] = str_to_float( sPos[ 2 ] ) ;

[/pawn]

Файлы:

data_player_API.sma

data_player_api.inc

[BlackSmoke]

Asmodai, В смысле не сам придумал ? На идею наткнул тёма, когда говорил, что нужно запилить интерфейс load/save

[Safety1st]

Наоборот, мне кажется, конечному пользователю надо просто использовать, а не вдаваться в подробности, как оно работает.

Согласен. Но API - для скриптеров, не для конечных. Я как стал разбираться в плагинах - тупо их теперь не ставлю, обязательно должен в общих чертах представлять, что там да как, всё ли разумно) Косвенно отсутствие интереса новичков подтверждается отсутствием школоло-комментариев в топике

Ну да ладно, это уже не наши проблемы.

[Asmodai]

Допилил, правда наскоро. Вообще не запускал.

Плагин позволяет хранить информацию о игроках вида ключ-значение между подключениями. А также обеспечивает возможность доступа к ней из разных плагинов. Идентификация игрока происходит по SteamID, IP или нику. При условии, что игрок не меняет свой идентификатор, позволяет хранить информацию удобнее, чем в userinfo и в больших объемах. Плагин является альтернативой mysql базе. Вся работа по получению информации для нужного идентификатора ложится на файловую систему.

Нативы dp_register_* позволяют зарегистрировать стандартное значение для ключа.
Нативы dp_save_* сохраняют значение для ключа. Если оно соответствует стандартному, запоминаться не будет.
Нативы dp_load_* получают значение ключа. Если найдено, возвращают 1, если получено стандартное значение -1 (что тоже true для условий if), если нет значения 0.
Натив dp_remove_key позволяет удалить определенный ключ для всех игроков.

В исходнике также можно указать параметры MAX_PLAYERS и MAX_DAYS_STORE, ну и остальные если надо. Первый задает максимум игроков, второй это максимальное количество дней хранения информации, если она не используется.

[pawn]

1. dpapi_save_by "1"


2. 1 - SteamID


3. 2 - IP


4. 3 - Name


5.  


6. dpapi_allow_rename "1"


7. 1 - менять имя файла при смене ника


8. 2 - оставить какое было при подключении

[/pawn]

[pawn]

1. native dp_save_int( id, const key[], value )


2. native dp_save_float( id, const key[], Float:value )


3. native dp_save_string( id, const key[], const value[] )


4. native dp_load_int( id, const key[], &value )


5. native dp_load_float( id, const key[], &Float:value )


6. native dp_load_string( id, const key[], value[], maxlen )


7. native dp_register_int( const key[], value )


8. native dp_register_float( const key[], Float:value )


9. native dp_register_string( const key[], const value[] )


10. native dp_remove_key( const key[] )

[/pawn]