https://github.com/kkmzero/isampp
Includes for San Andreas Multiplayer Plus
https://github.com/kkmzero/isampp
gta gtasa sa-mp sanandreas
Last synced: 6 months ago
JSON representation
Includes for San Andreas Multiplayer Plus
- Host: GitHub
- URL: https://github.com/kkmzero/isampp
- Owner: kkmzero
- License: cc0-1.0
- Created: 2018-08-13T22:26:50.000Z (about 7 years ago)
- Default Branch: main
- Last Pushed: 2025-01-24T15:48:21.000Z (9 months ago)
- Last Synced: 2025-01-24T16:33:09.487Z (9 months ago)
- Topics: gta, gtasa, sa-mp, sanandreas
- Language: Pawn
- Homepage:
- Size: 4.11 MB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Includes for San Andreas Multiplayer+
Includes for San Andreas Multiplayer Plus (ISAMPP) is library of include files for San Andreas Multiplayer Mod (SA-MP). SA-MP uses in most cases counterintuitive numeric identifiers as input values which can be very hard to remember and without enough experience you have to rely on external sources, such as mirrors of SA-MP wiki with incomplete or outdated information. ISAMPP seeks to make development of SA-MP gamemodes easier by re-defining these numeric identifiers and by providing collection of useful custom scripting functions.
Additionally, ISAMPP provides other libraries - such as list of location coordinates and their names in game, lists of objects, sounds and vehicle names, various functions for string manipulation and much more. ISAMPP also has its own sandbox-styled gamemode in which you can test everything. Extended manual can be found in [docs](docs/manual.md) folder.
*ISAMPP is not part of San Andreas Multiplayer mod (SA-MP) and it is not affiliated with Rockstar Games, Rockstar North or Take-Two Interactive Software, Inc. Grand Theft Auto and Grand Theft Auto: San Andreas are registered trademarks of Take-Two Interactive Software, Inc.*
*ISAMPP versions 1.3 or newer should be considered [public domain](LICENSE).*
# Installation
Copy contents of include folder to *”[SA-MP Server folder]/include”* and also to *”include”* folder for Pawno *(by default ”[SA-MP Server folder]/pawno/include”)*.
In your gamemode file you can include ISAMPP header for all its contents:
```pawn
#include
```
or you can include each file separately:
```pawn
#include
#include
#include
#include
#include
#include
#include
#include
#include
#include
#include
#include
#include
#include
#include
#include
#include
#include
#include
#include
#include
#include
#include
```
If you wish to run included sandbox gamemode, you have to add file ```testmpp.pwn``` to your *”gamemodes”* folder and compile it.
Alternatively, you can use pre-compiled file ```testmpp.amx```.
# Library
Every ISAMPP include file starts with prefix *'i_'*. Please keep in mind that ISAMPP may not be the only set of include files using this prefix.
*bodyparts* - List of available player/npc body parts
*boneids* - List of player bone identifiers
*cammode* - List of known camera modes
*carcols* - List of definitions for all available vehicle colors
*carmods* - List of all available components for vehicle customization
*colorlist* - List of color definitions for strings
*crimes* - List of crime reports
*explosions* - List of available types of explosions
*funcl* - Legacy functions
*iconids* - List of HUD map icons
*locationids* - List of location coordinates, interior identifiers and names
*objects* - List of game objects/models
*paintjob* - List of all available vehicle paintjobs
*pickupids* - List of definitions for pickup identifiers
*pickuptypes* - List of definitions for pickup types
*skinids* - List of character skins/models
*soundids* - List of game sounds
*textstyle* - List of definitions for GameText styles
*vehcomponents* - List of default vehicle components
*vehhealth* - List of vehicle health configurations
*vehids* - List of all available vehicles and their names
*weaponids* - List of weapons sorted by weapon slot IDs
*weatherids* - List of definitions for weather identifiers
# Custom Functions
ISAMPP uses various stock scripting functions which may be useful in creating your custom gamemodes for SA-MP
or simply for debugging purposes. These stock functions are defined in ```i_sampp.inc``` file.
#### print_isampp_version()
*Outputs ISAMPP version to server console.*
#### print_pawncc_version()
*Outputs version of compiler to server console if Pawn Community Compiler (Pawncc) is used.*
#### MppTeleport(playerid, locationid)
*Teleports player to desired location passed as parameter ’locationid’.*
#### MppTeleportEx(playerid, locationid, pstringcolor)
*Same as MppTeleport, plus outputs location name to in-game chat window.*
#### MppTeleportToCoords(playerid, x, y, z, interiorid, facingangle)
*Teleports player to specified xyz coordinates, supplied with interior identifier and player facing angle.*
#### MppShowPlayerPosition(playerid, pstringcolor)
*Outputs current player location coordinates, interior identifier, facing angle and player camera position coordinates to in-game chat window.*
#### MppShowVehicleInfo(playerid, vehmodelid, pstringcolor)
*Outputs ID, model, health, position and rotation of vehicle in which is player currently sitting to in-game chat window.*
#### MppGetPlayerName(playerid)
*Returns player nick/name from given playerid.*
#### MppEnableVehicleLights(vehicleid, lights)
*Turns on (enables) lights of any given vehicle. You can use bitwise operator OR to combine specific lights.*
#### MppDisableVehicleLights(vehicleid, lights)
*Turns off (disables) lights of any given vehicle. You can use bitwise operator OR to combine specific lights.*
#### MppFixVehicleTires(vehicleid, tires)
*Fixes tires of any given vehicle. You can use bitwise operator OR to combine specific tires.*
#### MppPopVehicleTires(vehicleid, tires)
*Pops tires of any given vehicle. You can use bitwise operator OR to combine specific tires.*