[Include] Simple Checkpoint Streamer

[-zriptarusk]

[3Play : Checkpoint Streamer Library]

Include File Features:

• Simple Checkpoint Streaming
• Optimized Scripting Method
• Advanced Checkpoint Options (Interior, Virtual World, Owner)
• Single User Checkpoint Streaming
• The simpliest Checkpoint Identifier ever

How does it work?
In the following example, I will create a simple bank checkpoint inside the City Planning Dpt. at Las Venturas

1. We need the include statement at the top of the script in order to include the CheckpointManager.inc

#include <a_samp>
#include <CheckpointManager>

2. Here I will define a number that identifies my Checkpoint right next to the includes

// Checkpoint Definitions
#define BANK_CITYPLANNING        0

3. Somewhere inside GameModeInit, I will create my checkpoint and set its interior to 3 (City Planning Dpt Interior ID)

// Add Checkpoints
    // Note: GLOBAL_OWNER_ID is defined at CheckpointManager.inc as -1
    CreateCheckpoint(GLOBAL_OWNER_ID, BANK_CITYPLANNING, 362.2479, 173.5770, 1008.3828);
    SetCheckpointInterior(BANK_CITYPLANNING, 3);

    // Initializing the CheckpointManager
    StartCheckpointSeeking();
    (...)

4. Very important: You need to call "VerifyCheckpoint" method at OnPlayerEnterCheckpoint. Like this:

public OnPlayerEnterCheckpoint(playerid){
    VerifyCheckpoint(playerid); // Asks the ChpManager to check this checkpoint and fire the next function 
    return 1;
}

This will make the ChpManager check which checkpoint the player has entered and fire a more specified function:

public OnCheckpointEnter(playerid, checkpointid){
    switch(checkpointid)
    {
      // BANKS
      case BANK_CITYPLANNING: // The checkpoint ID we specified when we created the checkpoint
      {
        SendClientMessage(playerid, COLOR_MESSAGE, "Welcome to the San Andreas Bank");
        SendClientMessage(playerid, COLOR_MESSAGE, "To deposit money type «/bank deposit [ammount]»");
        SendClientMessage(playerid, COLOR_MESSAGE, "To withraw money type «/bank withraw [ammount]»");
        SendClientMessage(playerid, COLOR_MESSAGE, "To request a loan type «/bank loan [ammount]»");
      }
    }
    return 1;
}

Simple isn't it?

Functions Included:
CreateCheckpoint(ownerid, chpid, FloatosX, FloatosY, FloatosZ); Creates a checkpoint
SetCheckpointInterior(chpid, interiorid); Sets the checkpoint interior
SetCheckpointVirtualWorld(chpid, VirtualWorldID); Sets the checkpoint virtual world
ToggleCheckpointActive(chpid, bool:active); Makes the checkpoint active or innactive
ChangeCheckpointOwner(chpid, owner); Changes the checkpoint owner
RemoveCheckpoint(chpid); Removes a checkpoint
StartCheckpointSeeking(); Makes the manager start seeking for nearby checkpoints
StopCheckpointSeeking(); Makes the manager stop seeking for nearby checkpoints
VerifyCheckpoint(playerid); Must be called at OnPlayerEnterCheckpoint


Source Download:
Version 0.1.1b

- Fixed a major Checkpoint Streaming Bug. Download please

[Oxside]

REALLY NICE
But the post looks some gaotic!

[T RP [Tomorrows-RP.co.uk]]

Originally Posted by Oxside

REALLY NICE
But the post looks some gaotic!

Agreed.

[-zriptarusk]

Originally Posted by Damien [T-RP

]

Agreed.

Sorry lol.
It was my first release. I kinda didn't knew how to do it xD

[MazaHACKa]

VERY VERY COOL!!!!!
THANKS!

[cristab]

hello sorry for my bad english
then already superb include

I add a function when we exit the CP see below

#include <a_samp>
#include <CheckpointManager>
#define CP_1 0
#define CP_2 1
#define CP_3 2
#define CP_4 3
#define CP_5 4

public OnGameModeInit()
{
    CreateCheckpoint(GLOBAL_OWNER_ID, CP_1, 1958.3783,1343.1572,15.3746);
    CreateCheckpoint(GLOBAL_OWNER_ID, CP_2, 2031.7180,1366.5226,10.8203);
    CreateCheckpoint(GLOBAL_OWNER_ID, CP_3, 1988.9958,1422.4563,9.1094);
    CreateCheckpoint(GLOBAL_OWNER_ID, CP_4, 1957.9187,1447.3143,10.8203);
    CreateCheckpoint(GLOBAL_OWNER_ID, CP_5, 1910.4789,1496.8055,13.6717);
    SetGameModeText("Blank Script");
    AddPlayerClass(0, 1958.3783, 1343.1572, 15.3746, 269.1425, 0, 0, 0, 0, 0, 0);
    StartCheckpointSeeking();
    return 1;
}

public OnPlayerEnterCheckpoint(playerid)
{
  VerifyCheckpoint(playerid);
    return 1;
}

public OnPlayerLeaveCheckpoint(playerid)
{
  VerifyCheckpointe(playerid);
    return 1;
}

public OnCheckpointEnter(playerid, checkpointid){
    switch(checkpointid)
    {
      
      case CP_1: 
      {
        SendClientMessage(playerid, 0xFFFFFFAA, "enter CP_1 ");

      }
      case CP_2:
      {
        SendClientMessage(playerid, 0xFFFFFFAA, "enter CP_2 ");

      }
      case CP_3:
      {
        SendClientMessage(playerid, 0xFFFFFFAA, "enter CP_3 ");

      }
      case CP_4:
      {
        SendClientMessage(playerid, 0xFFFFFFAA, "enter CP_4 ");

      }
      case CP_5:
      {
        SendClientMessage(playerid, 0xFFFFFFAA, "enter CP_5 ");

      }
    }
    return 1;
}

public OnCheckpointEXIT(playerid, checkpointid){
    switch(checkpointid)
    {

      case CP_1:
      {
        SendClientMessage(playerid, 0xFFFFFFAA, "exit CP_1 de test");

      }
      case CP_2:
      {
        SendClientMessage(playerid, 0xFFFFFFAA, "exit CP_2 de test");

      }
      case CP_3:
      {
        SendClientMessage(playerid, 0xFFFFFFAA, "exit CP_3 de test");

      }
      case CP_4:
      {
        SendClientMessage(playerid, 0xFFFFFFAA, "exit CP_4 de test");

      }
      case CP_5:
      {
        SendClientMessage(playerid, 0xFFFFFFAA, "exit CP_5 de test");

      }
    }
    return 1;
}

[mr.b]

can you add checkpoint size?

[Blantas]

Here you are:

http://blantas.paste.lt/paste/093419...902253927576bb


I added a size parameter:

CreateCheckpoint(ownerid, chpid, Float:posX, Float:posY, Float:posZ, Float:size);

[Calgon]

Interesting. Nice release. I'll probably use this.

[mr.b]

Here you are:

http://blantas.paste.lt/paste/093419...902253927576bb


I added a size parameter:
Code:

CreateCheckpoint(ownerid, chpid, FloatosX, FloatosY, FloatosZ, Floatize);


Wink

thank you very much