Skip to content

Enables the creation of custom markers for SA-MP.

License

Notifications You must be signed in to change notification settings

Ramon-Sd/marker-plus

Repository files navigation

samp-include

exemplo imagem

Enables the creation of custom markers for SA-MP.


  1. Installation

  2. Documentation


🚀 Installation

You can install the "Marker Plus" library in two ways:

  • Using sampctl: You can install the library using the sampctl package manager. Simply run the following command in the terminal:
sampctl package install Ramon-Sd/marker-plus
  • Using Git: You can clone the library's Git repository and manually add it to your project. Run the following command in the terminal:
git clone https://github.com/Ramon-Sd/marker-plus.git

Then, include the "markerplus.inc" include file in your code:

#include "markerplus.inc"

☕ Documentation

Functions

  • CreateMarker: Creates a custom marker. This function returns a unique marker ID.

  • Parameters:

    • icon (icon): The marker icon. It can be one of the icons defined in the enum.
    • calledActive (active): Indicates whether the marker is active or not.
    • x, y, z (coordinates): The coordinates of the marker in the SA-MP world.
    • worldID (optional): The ID of the world where the marker is located. The default is -1 (main world).
    • interiorID (optional): The ID of the interior where the marker is located. The default is -1 (no interior).
    • drawDistance (optional): The marker's draw distance. The default is 0.0 (always draw).
  • Return:

    • Returns the ID of the created marker, or a warning message if the marker limit is reached.
  • DestroyMarker: Destroys an existing marker in SA-MP.

  • Parameters:

    • markerid (marker ID): The ID of the marker to be destroyed.

Callbacks

  • OnPlayerEnterMarker: Called when a player enters the area of a marker.

  • Parameters:

    • playerid (player ID): The ID of the player who entered the marker area.
    • markerid (marker ID): The ID of the marker whose area was accessed.
  • OnPlayerLeaveMarker: Called when a player leaves the area of a marker.

  • Parameters:

    • playerid (player ID): The ID of the player who left the marker area.
    • markerid (marker ID): The ID of the marker whose area was left.

Example

#include "markerplus.inc"

main()
{
	return 0;
}

static myMarker;

public OnGameModeInit() {

	myMarker = CreateMarker(ICON_FACTORY, true, 0.0, 0.0, 0.0);
	return 1;
}

public OnGameModeExit() {

	DestroyMarker(myMarker);
	return 1;
}

public OnPlayerEnterMarker(playerid, markerid) {

	return 1;
}

public OnPlayerLeaveMarker(playerid, markerid) {

	return 1;
}



This project is licensed. See the LICENSE file for more details.