Z-finder: Difference between revisions

From NPC for VCMP 0.4 Servers
Jump to navigation Jump to search
(Created page with "This library is used to get the ground z co-ordinate for the npc to walk. It relies on 16 MB file default.map ( vice city map ). z-finder is ported from [https://forum.vc-mp.org/index.php?topic=9006 Miami-Scale] plugin of server. ==Functions== {| class="wikitable" ! Return value !! Function Name !! Parameter !! Description |- | true on success || MiamiScale_Init || [string] mapfile || The full path to mapfile as parameter |- | true or null || MiamiScale_Unload || - || |...")
 
 
(5 intermediate revisions by the same user not shown)
Line 17: Line 17:
| true on success || MiamiScale_SaveCurrentMap || [string]filename || Saves the current map which might have changes resulting from function mentioned in above row.
| true on success || MiamiScale_SaveCurrentMap || [string]filename || Saves the current map which might have changes resulting from function mentioned in above row.
|}
|}
==Map File==
You can download default.map [https://www.mediafire.com/file/gz3cwzhrkrk4v1w/default.map/file here]
==Links==
<poem>
Windows: [https://www.mediafire.com/file/7ke2ybt0heixqhr/z-finder.dll/file z-finder.dll]
Linux: [https://www.mediafire.com/file/sz7umvvf0jx7hmu/z-finder32.so/file z-finder32.so] or [https://www.mediafire.com/file/vyujj6th419wsxg/z-finder64.so/file z-finder64.so]
</poem>
==API Version==
1.2
==Note==
In linux systems, the full name such as 'z-finder64.so' instead of 'z-finder' must be used while loading the library through [[ConnectNPC]] or [[ConnectNPCEx]].

Latest revision as of 17:54, 7 May 2023

This library is used to get the ground z co-ordinate for the npc to walk. It relies on 16 MB file default.map ( vice city map ). z-finder is ported from Miami-Scale plugin of server.

Functions

Return value Function Name Parameter Description
true on success MiamiScale_Init [string] mapfile The full path to mapfile as parameter
true or null MiamiScale_Unload -
float or null. FindZFor2DCoord integer]x, [float\|integer]y The x,y co-ordinates to find the corresponding z. Return value null means z does not exist - it might be sea or something.
float or null FindAverageZ integer]x, [float\|integer]y same as above
true on success SetZFor2DCoord [integer]x, [integer]y, [float]z Sets the z co-ordinate for a certain pair of integer x,y co-ordinates. Setting means subsequent get will fetch this value.
true on success MiamiScale_SaveCurrentMap [string]filename Saves the current map which might have changes resulting from function mentioned in above row.

Map File

You can download default.map here

Links

API Version

1.2

Note

In linux systems, the full name such as 'z-finder64.so' instead of 'z-finder' must be used while loading the library through ConnectNPC or ConnectNPCEx.