samp.directory
← Scripts et bibliothèques

Southclaws/samp-geoip

A simple library that provides information from IPHub for connected players.

Bibliothèque★ 14mis à jour juil. 2020Pas de licencePawnsampctlArchivé
Ouvrir sur GitHub

L’auteur a archivé ce dépôt, il n’est donc plus maintenu.

Ce dépôt n’a pas de fichier de licence. Il est public en lecture, mais cela ne donne pas à lui seul le droit de le réutiliser.

Installer avec sampctl

sampctl package install Southclaws/samp-geoip

Lance ceci dans le dossier de ton projet. sampctl télécharge le paquet et ce dont il dépend.

L’essayer dans le compilateur Pawn →

Ajoute ses fichiers include, avec les bibliothèques dont il dépend, au compilateur Pawn de ton navigateur, prêts à être inclus dans un script.

README.md

samp-geoip

A simple library that provides information from IPHub for connected players.

This package is built using the Requests package which is used to perform a web request to IPHub's API when a player connects.

Currently the results are not cached so you may encounter rate limits if your server has many players connecting per minute. This may be addressed in future by using Redis as a cache.

Installation

Simply install to your project:

sampctl package install Southclaws/samp-geoip

Include in your code and begin using the library:

#include <geoip>

Usage

When a player connects, their details are automatically requested. Once the response has arrived, the API can be used.

bool:IsGeoDataReady(playerid) Checks if the data is ready, requests should only take milliseconds but this ensures your code doesn't attempt to request data that isn't ready yet.

The rest of the API corresponds directly to the IPHub documentation:

  • GetPlayerCountryCode(playerid, output[], len = sizeof output)
  • GetPlayerCountryName(playerid, output[], len = sizeof output)
  • GetPlayerASN(playerid, &asn)
  • GetPlayerISP(playerid, output[], len = sizeof output)
  • GetPlayerIPBlock(playerid, &block)

There is also an event that is called when the data is available:

  • OnGeoDataReady(playerid)

Testing

To test, first you must build build the package with the file iphub_key.inc which should consist of:

#define IPHUB_KEY your_api_key

You can get a free API key from this page by clicking Looking for the free plan (2000 req/day)? Here!

Then just run as normal and connect to localhost:7777:

sampctl package run

If you connect locally, you'll see no useful data because you'll be sending the loopback interface address, but a response will still appear:

text="requesting ip data" addr="127.0.0.1" playerid=0
text="received ip data" request=0 status=200
text="determined target player for ip data" playerid=0
text="extracted ip data for player" code="ZZ" name="Unknown" asn=0 isp="Private/local IP" block=0

You can also type /ip in-game to see a message containing the data.

geolocationiphubpawn-packagesa-mpsa-mp-library

Cette page est construite à partir de ce que GitHub publie sur le dépôt. samp.directory n’héberge pas le code. Signaler un problème avec cette fiche

Southclaws/samp-geoip : Bibliothèque SA-MP | samp.directory