/samp-plugin-mapandreas

Primary LanguageC++

Map Andreas Plugin

sampctl

This plugin was initially made by Kalcor and extended by Mauzen. It allows you to load different height maps and check the min height for x,y coordinates. You can us it as example for an anti cheat to detect airbreaks easier or to prevent falling through the ground.

Features:

  • Load height map
  • You can also implement it in your sampgdk plugins.

Topics:

Installation

Simply install to your project:

sampctl package install Southclaws/samp-plugin-mapandreas

Include in your code and begin using the library:

#include <mapandreas>

Usage

native params return
MapAndreas_Init mode, const name[] Error code or 0 on success
MapAndreas_Unload const name[], const message[] int (0 failed/1 success)
MapAndreas_SaveCurrentHMap const name[] int (0 failed/1 success)
MapAndreas_FindZ_For2DCoord Float:X, Float:Y, &Float:Z int (0 failed/1 success)
MapAndreas_FindAverageZ Float:X, Float:Y, &Float:Z int (0 failed/1 success)
MapAndreas_SetZ_For2DCoord Float:X, Float:Y, Float:Z int (0 failed/1 success)

Example

Initialize MapAndreas and get a position.

public OnGameModeInit(playerid, cmdtext[])
{
    MapAndreas_Init(MAP_ANDREAS_MODE_FULL, "scriptfiles/SAFull.hmap");
    new Float:pos;
    if (MapAndreas_FindAverageZ(20.001, 25.006, pos)) {
        // Found position - position saved in 'pos'
    }
    return 0;
}

Testing

Test with make:

make test-windows

If you want to build/test the Linux version, use Docker:

make build-linux
make test-linux

This will spin up a Debian container to build and then run sampctl with --container to run the test package in a Linux environment.