PIMP: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
Line 108: Line 108:
----
----
====[[Image:Boost.png]] Boost====
====[[Image:Boost.png]] Boost====
#First, create a '''vehicle''' (NOT a spawnpoint, just a vehicle): [[Image:Editor_Vehicle.png]]
Give the player/vehicle a boost.


'''''NOTE: '''''Time is in '''milliseconds'''! (1 second = 1000 milliseconds) If you want it to move for 5 seconds, fill in 5000.
*'''ID''': The name of the element. If you name it properly, it's easier to find it back when you set it as parent later on.
*'''type''': Boost vehicle along world axes (Y = north, Z = east, Z = up) or along the vehicle's axes (Y = forwards/backwards, X = sidewards, Z = up/down).
*'''velocityX, velocityY, velocityZ''': New X-, Y- and Z-velocity after teleportation.
*'''hideMarkers''': Make the marker invisble (true) or don't (false).
 
----
====[[Image:Setvehiclegravity.png]] Set vehicle gravity====
Set gravity on the vehicle. Default is X=0, Y=0 and Z=-1. For example, upside-down is X=0, Y=0 and Z=1.
 
*'''ID''': The name of the element. If you name it properly, it's easier to find it back when you set it as parent later on.
*'''gravityX, gravityY, gravityZ''': X-, Y- and Z-gravity on the vehicle.
*'''hideMarkers''': Make the marker invisble (true) or don't (false).
 
----
====[[Image:Blip.png]] Blip====
Create a blip on the position of the marker or attach a blip to the player/vehicle when the marker is hit.


*'''ID''': The name of the element. If you name it properly, it's easier to find it back when you set it as parent later on.
*'''ID''': The name of the element. If you name it properly, it's easier to find it back when you set it as parent later on.
*'''teleportTo''': Click on '''"Browse"''' and select the '''vehicle''' you created. You will be teleported to the position and rotation of this vehicle.
*'''type''': Attach to the player when hit, or attach to the marker (permanently).
*'''velocity''': After teleportation, change the velocity (fill in velocityX, velocityY, velocityZ) or keep old velocity.
*'''iconID''': IconID. Click for a list of ID's: [[Radar Blips]]
*'''velocityX, velocityY, velocityZ''': New X-, Y- and Z-velocity after teleportation.
*'''size''': Size of the blip, only works if iconID = 0.
*'''turnVelocity''': After teleportation, change the turnVelocity (fill in turnVelX, turnVelY, turnVelZ) or keep old turnvelocity.
*'''color''': Color of th eblip, only works if iconID = 0.
*''' turnVelX,  turnVelY,  turnVelZ''': New X-, Y- and Z-turnvelocity after teleportation.
*'''distance''': Maximum distance the blip is visible from.
*'''freezeTime''': Time the vehicle should remain frozen after teleportation ('''milliseconds''').
*'''hideMarkers''': Make the marker invisble (true) or don't (false).
*'''fadeScreen''': Set true to fade-out to a black screen and fade-in again after teleportation.
 
*'''fadeTime''': Time the fade-in and fade-out take ('''milliseconds''').
----
====[[Image:Cameraposition.png]] Camera Position====
Position the player's camera somewhere else and make it follow the player, or look at a certain position.
 
*'''ID''': The name of the element. If you name it properly, it's easier to find it back when you set it as parent later on.
*'''type''': Attach to the player when hit, or attach to the marker (permanently).
*'''iconID''': IconID. Click for a list of ID's: [[Radar Blips]]
*'''size''': Size of the blip, only works if iconID = 0.
*'''color''': Color of th eblip, only works if iconID = 0.
*'''distance''': Maximum distance the blip is visible from.
*'''hideMarkers''': Make the marker invisble (true) or don't (false).
*'''hideMarkers''': Make the marker invisble (true) or don't (false).

Revision as of 12:24, 17 May 2012

Pimplogo.png


What is it?

PIMP is for actions on markers. Teleports, handling, text on your screen, creating filmic scenes and much more: it's all there and very easy to use! This tutorial explains how to use the tool, what the options are for and more.

Enjoy!

Installation

Once you have downloaded the file, put it in the resources directory of your MTA-installation:

MTA San Andreas / server / mods / deathmatch / resources

NOTE: The server where your map will be played must also have the resource in the 'resources' directory and the resource must be running on the background (just start it when the server starts and that's all you have to do).

Starting it up in the map-editor

Once you are in the map editor:

  1. Click on the Definitions icon.
    Editor Definitions.png
  2. Click on pimp and click the Add button
    Pimpadd.png
  3. Position your mouse on the buttons on the bottom-left corner
    Moe scroll1.png
  4. Scroll your mousewheel until you reach the PIMP-buttons
    Pimpbuttons.png
  5. You are now ready to use it! Don't forget to save!

How to use the tool

PIMP works with markers. For example, you add a teleport-element to a marker and when you hit that marker, you are teleported.

Creating a PIMP-element and adding it to a marker

  1. Position your mouse on the bottom-left icons and scroll until you reach the default elements:
    Moe scroll1.png
  2. Click the "marker"-button to create a marker:
    Editor Marker.png
  3. Place it somewhere, select it and press the "F3"-key on your keyboard.
  4. Fill in a decent name in the "ID"-box. If you're going to add a boost to it for example, name it "boost marker 1". Then click on the "OK"-button.
    Pimpfillinid.png
  5. Click on one of the PIMP-elementbuttons on the bottomleft corner of your screen:
    Pimpbuttons.png
  6. Click on the "Browse"-button next to "parent":
    Pimpparent.png
  7. Choose the marker you just created and click on the "OK"-button:
    Pimpchoosemarker.png

Fill in the other options and hit the "OK"-button at the bottom of the window again to save.

You're done!


IMPORTANT: Sometimes the "parent" isn't saved properly when you click on "OK"!

This is a bug in the editor and it appears mostly at the "Teleport"- and "Camera Position"-elements!

You can check this by opening the elements-list: Editor Current elements.png

Doubleclick on your PIMP-element in the list (properties window of that element should appear) and if it says <none> in the "parent"-box, set a new parent by clicking the "Browse button", as described above.

PIMP-elements and their options


2dtext.png 2D Text

Create a text on the screen when you hit the marker. NOTE: Time is in milliseconds! (1 second = 1000 milliseconds) If you want it to move for 5 seconds, fill in 5000.

  • ID: The name of the element. If you name it properly, it's easier to find it back when you set it as parent later on.
  • text: Text to be displayed. Use #N to start a new line and use normal colorcodes (#ffaa00 etc.) to change the color. For example: This is the first line#NThis is the second line and #ff0000this text is now red
  • time: Time for the text to be displayed (milliseconds).
  • fadeTime: Time the fade-in and fade-out take (milliseconds).
  • size: Size of the text. Default is 2, 1 is normal small text like in the chatbox.
  • font: Font the text is written in.
  • color: Color of the text. However, this can be overridden if you use colorcodes (#ffaa00 etc).
  • shadow: Shadow on (true) or off (false).
  • alignX: Horizontally align the text left, center or right.
  • alignY: Vertically align the text at the top, center or bottom.
  • screenX: Horizontal position of the text on the screen, between 0 and 1. For example, 0 means left, 0.5 is the middle.
  • screenY: Vertical position of the text on the screen, between 0 and 1. For example, 0 means top and 0.5 is the middle.
  • hideMarkers: Make the marker invisble (true) or don't (false).

3dtext.png 3D Text

Create a text that seems to be in the world at the position of the marker.

  • ID: The name of the element. If you name it properly, it's easier to find it back when you set it as parent later on.
  • text: Text to be displayed. Use #N to start a new line and use normal colorcodes (#ffaa00 etc.) to change the color. For example: This is the first line#NThis is the second line and #ff0000this text is now red
  • maxDistance: Maximum distance for the text to be visible.
  • scaling: Scaling of the text, when further away, on (true) or off (false).
  • fading: Fading of the text, when further away, on (true) or off (false).
  • size: Size of the text. Default is 2, 1 is normal small text like in the chatbox.
  • font: Font the text is written in.
  • color: Color of the text. However, this can be overridden if you use colorcodes (#ffaa00 etc).
  • shadow: Shadow on (true) or off (false).
  • alignX: Horizontally align the text left, center or right.
  • alignY: Vertically align the text at the top, center or bottom.
  • hideMarkers: Make the marker invisble (true) or don't (false).

Teleport.png Teleport

Teleport the player/vehicle.

  1. First, create a vehicle (NOT a spawnpoint, just a vehicle): Editor Vehicle.png

NOTE: Time is in milliseconds! (1 second = 1000 milliseconds) If you want it to move for 5 seconds, fill in 5000.

  • ID: The name of the element. If you name it properly, it's easier to find it back when you set it as parent later on.
  • teleportTo: Click on "Browse" and select the vehicle you created. You will be teleported to the position and rotation of this vehicle.
  • velocity: After teleportation, change the velocity (fill in velocityX, velocityY, velocityZ) or keep old velocity.
  • velocityX, velocityY, velocityZ: New X-, Y- and Z-velocity after teleportation.
  • turnVelocity: After teleportation, change the turnVelocity (fill in turnVelX, turnVelY, turnVelZ) or keep old turnvelocity.
  • turnVelX, turnVelY, turnVelZ: New X-, Y- and Z-turnvelocity after teleportation.
  • freezeTime: Time the vehicle should remain frozen after teleportation (milliseconds).
  • fadeScreen: Set true to fade-out to a black screen and fade-in again after teleportation.
  • fadeTime: Time the fade-in and fade-out take (milliseconds).
  • hideMarkers: Make the marker invisble (true) or don't (false).

Boost.png Boost

Give the player/vehicle a boost.

  • ID: The name of the element. If you name it properly, it's easier to find it back when you set it as parent later on.
  • type: Boost vehicle along world axes (Y = north, Z = east, Z = up) or along the vehicle's axes (Y = forwards/backwards, X = sidewards, Z = up/down).
  • velocityX, velocityY, velocityZ: New X-, Y- and Z-velocity after teleportation.
  • hideMarkers: Make the marker invisble (true) or don't (false).

Setvehiclegravity.png Set vehicle gravity

Set gravity on the vehicle. Default is X=0, Y=0 and Z=-1. For example, upside-down is X=0, Y=0 and Z=1.

  • ID: The name of the element. If you name it properly, it's easier to find it back when you set it as parent later on.
  • gravityX, gravityY, gravityZ: X-, Y- and Z-gravity on the vehicle.
  • hideMarkers: Make the marker invisble (true) or don't (false).

Blip.png Blip

Create a blip on the position of the marker or attach a blip to the player/vehicle when the marker is hit.

  • ID: The name of the element. If you name it properly, it's easier to find it back when you set it as parent later on.
  • type: Attach to the player when hit, or attach to the marker (permanently).
  • iconID: IconID. Click for a list of ID's: Radar Blips
  • size: Size of the blip, only works if iconID = 0.
  • color: Color of th eblip, only works if iconID = 0.
  • distance: Maximum distance the blip is visible from.
  • hideMarkers: Make the marker invisble (true) or don't (false).

Cameraposition.png Camera Position

Position the player's camera somewhere else and make it follow the player, or look at a certain position.

  • ID: The name of the element. If you name it properly, it's easier to find it back when you set it as parent later on.
  • type: Attach to the player when hit, or attach to the marker (permanently).
  • iconID: IconID. Click for a list of ID's: Radar Blips
  • size: Size of the blip, only works if iconID = 0.
  • color: Color of th eblip, only works if iconID = 0.
  • distance: Maximum distance the blip is visible from.
  • hideMarkers: Make the marker invisble (true) or don't (false).