Main Page

Introduction

NPCs also known as bots -feature introduced in April 2022 in vc-mp forum. This new feature allows you to create NPCs inside your server who will work like virtual players. Like normal players, they use server slot. Their actions are scripted by squirrel scripts. These scripts with 'artificial intelligence' of NPC reside in npcscripts directory. If you want to have 10 different NPC doing 10 different things, you might want to script 10 different scripts.

Each NPC run in its own process. This might make their usage and working economical. The NPC scripts have functions as well as callbacks.

NPC script callbacks

NPC script functions

OnNPCScriptLoad OnNPCScriptUnload OnNPCConnect OnNPCDisconnect OnNPCSpawn OnNPCEnterVehicle OnNPCExitVehicle OnClientMessage OnPlayerDeath OnPlayerText OnPlayerStreamIn OnPlayerStreamOut OnVehicleStreamIn OnVehicleStreamOut OnRecordingPlaybackEnd OnPlayerUpdate OnSniperRifleFired OnConsoleInput Constants BodyParts LocalValue fields Game Keys Player States Player functions GetPlayerState GetPlayerPos GetPlayerVehicleID GetPlayerArmedWeapon GetPlayerHealth GetPlayerArmour GetPlayerKeys GetPlayerFacingAngle IsPlayerInRangeOfPoint GetPlayerName IsPlayerConnected GetPlayerSkin (v1.5) GetPlayerTeam (v1.5) GetPlayerSlotWeapon (v1.5) GetPlayerSlotAmmo (v1.5) WhereIsPlayer (v1.5)

StartRecordingPlayback StopRecordingPlayback PauseRecordingPlayback ResumeRecordingPlayback SendChat SendCommand GetMyPos SetMyPos GetMyFacingAngle SetMyFacingAngle GetDistanceFromMeToPoint IsVehicleStreamedIn IsPlayerStreamedIn SetTimer SetTimerEx (v1.5) KillTimer Advanced functions(v1.5+) SendOnFootSyncData SendOnFootSyncDataLV SendPassengerSyncData FireSniperRifle SendShotInfo SendDeathInfo GetLocalValue SetLocalValue GetSlotFromWeaponId FaceNPCToPlayer GetTickCount Functions used only in server scripts ConnectNPC ConnectNPCEx IsPlayerNPC ShowNPCConsole StartRecordingPlayerData StopRecordingPlayerData More Squirrel Add-On Plugin NPC Installation Squirrel Standard Library Functions v1.5 New Release Command-line usage Attack Script