samp.directory
← Skripte und Bibliotheken

Southclaws/samp-geoip

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

Bibliothek★ 14aktualisiert Juli 2020Keine LizenzPawnsampctlArchiviert
Auf GitHub öffnen

Der Autor hat dieses Repository archiviert, es wird also nicht mehr gepflegt.

Dieses Repository hat keine Lizenzdatei. Es ist öffentlich lesbar, aber das allein gibt noch keine Erlaubnis, es weiterzuverwenden.

Mit sampctl installieren

sampctl package install Southclaws/samp-geoip

Führe das in deinem Projektordner aus. sampctl lädt das Paket und alles herunter, wovon es abhängt.

Im Pawn-Compiler ausprobieren →

Fügt seine Include-Dateien samt der Bibliotheken, von denen es abhängt, dem Pawn-Compiler in deinem Browser hinzu, bereit zum Einbinden in ein Skript.

Hängt von 5 Paketen ab

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

Diese Seite wird aus dem erstellt, was GitHub über das Repository veröffentlicht. samp.directory hostet den Code nicht. Ein Problem mit diesem Eintrag melden

Southclaws/samp-geoip: SA-MP Bibliothek | samp.directory