samp.directory
← Scripts et bibliothèques

Southclaws/samp-object-loader

A simple yet powerful and easy to use map parser for SA:MP. Reads 'CreateObject' (and any varient) lines from .map files with recursive directory listing. Supports RemoveBuildingForPlayer as well as materials and material text.

Bibliothèque★ 7mis à jour déc. 2017Pas de licencePAWNsampctlArchivé
Ouvrir sur GitHub

L’auteur a archivé ce dépôt, il n’est donc plus maintenu.

Ce dépôt n’a pas de fichier de licence. Il est public en lecture, mais cela ne donne pas à lui seul le droit de le réutiliser.

Installer avec sampctl

sampctl package install Southclaws/samp-object-loader

Lance ceci dans le dossier de ton projet. sampctl télécharge le paquet et ce dont il dépend.

L’essayer dans le compilateur Pawn →

Ajoute ses fichiers include, avec les bibliothèques dont il dépend, au compilateur Pawn de ton navigateur, prêts à être inclus dans un script.

Dépend de 2 paquets

readme.md

Southclaw's Simple Map Parser

Loads .map files populated with CreateObject (or any variation) lines, supports materials and text.

Default load directory: ./scriptfiles/Maps/

Installation

Simply install to your project:

sampctl package install Southclaws/samp-object-loader

Include in your code and begin using the library:

#include <object-loader>

Supported Syntax

Objects

CreateObject(1337, 5.0, -5.0, 3.0, 90.0, 90.0, 90.0);
CreateDynamicObject(1337, 5.0, -5.0, 3.0, 90.0, 90.0, 90.0);

Any string starting with 'Create' is parsed as a CreateObject line, this is also valid:

CreateCake(1337, 5.0, -5.0, 3.0, 90.0, 90.0, 90.0);

Object Materials

CreateObject(1337, 5.0, -5.0, 3.0, 90.0, 90.0, 90.0);
SetObjectMaterial(object, 0, 18837, "mickeytextures", "ws_gayflag1", 0);

Any SetObjectMaterial or SetObjectMaterialText line will affect the last created object. The first parameter (objectid) is ignored and can be any string for flexibility.

Object Removal

RemoveBuildingForPlayer(playerid, 615, 0.0, 0.0, 0.0, 200.0);

'playerid' is ignored, but still valid to allow flexibility when copying from .pwn source code.

When a player connects (or when the filterscript loads, whichever comes first) a list of removed buildings is built and saved for that player.

If the filterscript reloads (perhaps to load an update to object data) any RemoveBuilding instructions that have already been called for each player are ignored. When a player disconnects, their data is discarded.

This data is stored in binary format in ./scriptfiles/Maps/session/

Options

Custom 'function' for altering world, interior and stream distance. This updates the settings for the current file, any lines below this will use these settings when creating objects. This function can be used multiple times.

options(world, interior, stream distance)

For example, to make all the objects after this line create in world 0, interior 1 and a stream distance of 300:

options(0, 1, 300)

Comments

Single line // comments are supported at the end of lines or on their own.

// comment
options(0, 1, 200) // comment
CreateObject(1337, 5.0, -5.0, 3.0, 90.0, 90.0, 90.0); // comment

Debugging

Create a file inside './scriptfiles/Maps/' called 'maps.cfg' Use debug option followed by level parameter to make the script load with debug mode enabled. Each 'level' of debugging offers different information:

  • -d0 = Print information messages
  • -d1 = Print each folder
  • -d2 = Print each loaded file
  • -d3 = Print each loaded data line in each file
  • -d4 = Print each line in each file

Testing

To test, simply run the package:

sampctl package run

And connect to localhost:7777 to test.

Cette page est construite à partir de ce que GitHub publie sur le dépôt. samp.directory n’héberge pas le code. Signaler un problème avec cette fiche

Southclaws/samp-object-loader : Bibliothèque SA-MP | samp.directory