[TUT]The DYOM Complete Tutorial

[Alexander]

Hello DYOM Users! Welcome to the DYOM Complete Tutorial.
In this tutorial I'll try to explain all the functions of the current version of DYOM (v8.1)
Enough with this. Here's the tutorial:



------Table of content------

Installation
Functions
Text Options
Hotkeys
Custom Sounds
Helpful Links
Last Words

INSTALLATION

To install Design Your Own Mission, you need three things:

1) Grand Theft Auto: San Andreas (duh!)
2) The CLEO Library (I recommend CLEO 4.1, but 4.3 will work too). Download CLEO here:
3) Design Your Own Mission. You can download the latest version
here
Well, as probably you already have installed GTA: SA, let's go with the CLEO Library.

As many of you know, CLEO is a project made by Seeman (CLEO 1-3) Alien (v4) and now continued by Deji, that brings to the game new opcodes, the posibility to make custom scripts and use them without staring a new game, and some other cool features, but that's not too important for us right now.
Design Your Own Mission needs CLEO to be able to save/load the custom missions to/from a ".dat" file. I will explain it better in a few minutes.

Install CLEO using the auto-installer, it's fast and simple.

Once you have CLEO, you need to install the DYOM mod.

All you need to do is:

1) Download the latest version of Design Your Own Mission
2) Find the "GTA User Files" Directory in My Documents
3) In "GTA User Files", create a folder, with the name "MPACK"
4) Extract the content of the DYOM ".rip" in the the folder you've just created.

That's it. DYOM is installed.

Now try to start a new game. You will see two options:

SAN ANDREAS [sTANDAR GAME]

and...

Design Your Own Mission

Select DYOM, and start!

Not so hard, right?

Now let's see how to use the DYOM features to design missions:

FUNCTIONS

If you just started DYOM, CJ will spawn at Grove Street. You will see some info at the top left corner.

To open the Mission Menu, press Y, and a menu with a text like this will show up:

Mission Menu
Storyline Menu
Settings
Player
Objectives
Actors
Cars
Pickups
Objects
Tools

Let's explain it one by one:


1. Mission Menu

Button Function Play Mission Pressing this you will start the current loaded mission, of course, if it is not read-only Save Mission This will save the mission that is currently loaded. After pressing it, you will choose the slot you want and DYOM will save it as "DYOMX.dat", where "X" is the number of the slot. If you save it at slot 1, the name of the file will be "DYOM1.dat" This is often compared to the save slots of the normal game Load Mission Use this to load a mission. After pressing it, choose the desired mission, and DYOM will load it. If it is a read-only file, it will start automaticaly Publish mission Select this and you will save the current loaded mission as "DYOM0.dat" and it will be read-only, so the file it can not be edited by anyone (not even you, so be careful, have a backup in case you need to cahnge something) New Mission Creates a new mission. All the data of the current mission will be deleted. You will now be able to write the desired name for the mission and your name. Show Mission audicode This will show the audiocode of the current mission. (More info below)

 

 

2. Storyline Menu
The storyline is a function implemented in v6. It allows a game expeerience more similar to the normal game, because you can explore the whole map and start the missions when you want with the regular red circles.

The data of the storyline is stored in a folder inside the GTA User Files, called "DSL". You can only have in the folder one storyline at the same time.

When your storyline is ready, you can distribute it uploading the entire folder in a ".rar" or ".zip" file.

To add missions to the storyline, design the mission as usual and save it as an intro, outro or regular mission. I'll explain this below.

There's two modes in the storyline function: The design mode, and the in-game mode. You can access to the design menu when you're designing, but not access to the in-game menu.
When you're playing the storyline, you can use the in-game menu but you can not use design menu.


A) Design menu

• Test Storyline:
  Press this and you will start the current loaded storyline
• Clear Storyline:
  This option clears the current loaded storyline, so it will delete all of the storyline missions and missiontriggers
• Mission Menu:
  Choose this, and a submenu will show up:
  • Save Mission to DSL: This will save the current mission to the DSL folder as a normal mission. Choose a name for the file and save (not mission name, mission file name!)
  • Save Mission to intro: This will save the current mission to the DSL folder as the intro mission.
  • Save Mission to outro: This will save the current mission to the DSL folder as the outro mission.
• Make Storyline autorun:
  This will make the storyline autorun; it means that it will start when you start DYOM
• Add missiontrigger:
  This will add a missiontrigger, a red circle. This will be used to start a mission. When you select this, you need to enter the name of the file named as the mission you want to start with the trigger you're creating (NOT the mission name, the name on the file you choosed with the option "Save Mission to DSL"), how many missions do you need to pass in order to spawn the trigger, the position of the circle, and the icon you want. At the end, you can select the rewards of the mission: Money, wanted level, change in the weather, peds, cars and enable or disable the riot
• Edit missiontrigger:
  This allows you to edit the nearest missiontrigger
• Remove missiontrigger:
  This allows you to remove the nearest missiontrigger

The intro mission will start as sonn as you start the storyline. The outro mission is the final mission and it will start as soon as you finish the last mission. Patrick recommended to make the outro "fail-proof". Maybe an only-cutscene mission, but is your choice

The name of the files are selected when you press "Save mission to DSL", and it's used to asign the triggers to the missions, so you might want choose a name easy to remember.


B) In-game mode

You can use this menu pressing Y+N when not on a mission. This menu will show up:

-Abort Storyline: Use this to abort the current storyline. You'll return to the design mode

-Load Storyline Progress: Use this to load the saved progress of the current storyline

-Save Storyline Progress: Use this to save the progress of the current storyline

To be able to design missions correctly using the Storyline function, you'll probably need some practice. Try with some easy missions first to understand how it works.

3. Settings

Button Function Mission Name You can change the name of the mission using this Intro Text You can use this to add intro text to the mission. You can only make 3 text boxes in a mission. Time Limit Using this you can choose how many time has the player to complete the mission Timed Mission Choose this to select if the mission has a time limit or not Time of Day Choose this to select in what time the mission starts. Use "Y" and "N" to set the hour Weather Select this to choose the weather of the mission. Use "Y" and "N" to select the desired weather Minimum Wanted Level Choose this to set the minimun wanted level of the mission. By default is 0 Maximum Wanted Level Choose this to set the desired maximum wanted level of the mission. By default is 6. Riot Mode Choose this to set the Riot on and off

To be able to use the storyline feature correctly, you'll need a bit of practice to understand better the how it works. It's a bit harder than the usual mission feature, but for some stories, looks better. Feel free to ask any question regarding this or any other DYOM feature!


4. Player
This changes the configuration of the objective 0, that is where the mission start and it sets the player's skin, health, and weapon.


5. Objectives
[/tr]

Button Function Add Objective Use this to add an objective. When you select this, you will see another sub-menu:

• Add Actor:
  This adds an enemy actor as an objective that MUST be killed. You can select the skin, the animation and the weapon. After that, another sub-menu will show up. Use it to select the health (100 by default), the Gang (Enemy1 or Enemy2), his accurate when shooting (10, 25, 50, 75, 100), if it can be killed with a headshot or not, the actor's behavior (Attack Direct, Hold position, and Hold and direct) if you want to set a health bar for the actor, and set "Kill all enemy gangs". The last one let's you choose if the player has to kill all the enemies in the current objective, or just the actor you've just created as an objective
• Add Car:
  Using this you can spawn a car as an objective. First, select the model, then the primary color and secondary color, after that, set the position. When you do this, another sub-menu will show up. Use it to select the car's properties (if it is bullet proof, explosion proof, damage proof, if the car is locked or not, and/or the tires are popable), the health: 100 (it will burn instantly), 250 (very low, just a little hit can destroy the car), 500 (half of the normal health), 1000 (normal health) or 2500 (2.5 times the normal health). Also, you can set if it has to survive, or has to be destroyed, and if you want to set a health bar for the car.
• Add Pickup:
  This will add a objective pickup that must be picked up by the player. You need to select to location first. After that, you can choose the type of pickup (Weapon, Health, Armor, Bribe, Other) and then you need to choose the exact pickup you want (only if you selected "Weapon" or "Other") and the ammo (Only if you selected "Weapon"). Also, you can set if the players needs to pickup all the similar pickups available in the current objective.
• Add Checkpoint:
  This will add a checkpoint as an objective. The player needs to be in the checkpoint to complete it. First, you select the type of objective (red circles, coronas, invisible checlpoints, race checkpoints) then move it to the desired place with W-A-S-D keys. You can also change the height of the checkpoint pressing LSHIFT (Jump key) and the arrow keys. Additionaly, you can choose the size of the checkpoint using FIRE button (Left CTRL or Left mouse button) with the arrow keys.
• Add Object: This adds an object as an objective. First place the object where you want, and press space. You'll see the following options
  • Touch Object: To complete this objective, the player has to touch the object.
  • Damage Object: In order to complete the objective, the player needs to damage to object
  • Photograph object: The player needs to photograph the object to complete this objective.
  • Shoot Object: The player has to shoot the object
• Add Special Player Objectives:
  These objectives are special objectives that affect the player directly, lik
  • Teleport :
    Choose this to teleport the player to the desired place in the map. You can set the player's model after the teleport, the weapon and health.
  • Set Wanted level:
    This will change the current wanted level to a desired level, from 0 to 6.
  • Remove Weapons:
    This will remove all the weapons of the player.
  • Talk on Phone:
    This objective will result in something simple: the characther will recieve/make a call and it will start to talk on the phone. When you select this, select the time, and the text you want to show. If you put one, it will show that line and the character will put away the phone. If you have 2 or more of this objective in a row, the player's character will have the phone in his ear until the last "Talk on Phone" objective.
  • Drive-by mode: When the player is in a car as a passenger, you can enable the drive-by mode, so the player can shoot from a car!. Note that the player cannot exit normally of this mode, so you have to create a "Teleport" Objective to put the player outside the vehicle
• Add Special Enviroment Objective
  This type of objective affects what happens around the player.
  • Cutscene:
    This will allow you to add cutscenes to the mission. When using it, you have to use the arrow keys to rotate the camera, pressing and holding the LSHIFT (jump button) with the arrow keys will allow you to change the height. Pressing and holding the FIRE button (Left CTRL or Left Mouse Button) will allow you to change the position of the camera. After that you need to adjust the time (how seconds uses the cutscene), then the behaviour of the cutscene: Static (does not moves), Linear (Moves in a straight line), Smooth (Moves from the previous Cutscene to the location you've just set) and "Follow Actor" (The camera will follow the actor you want during the cutscene). At the end, no matter the type you choosed, type the text you want to show during the cutscene.
  • Countdown: This will set a countdown timer in the screen (like at the start of a race). The player cannot move during the countdown. You can set how long the countdown will be.
  • Timeout:
    It's similar the Countdown objective, but the player can move during the timeout and select if the player can see the timer or not.
  • Weather Change:
    You can change the weather with this objective.
  • Set Time:
    You can change the current time to a new desired one with this objective.
  • Ped/Car Behaviour:
    Use this to change the behaviour of the cars and peds on the street. With "Normal Ped/Cars" the cars and peds will spawn as usual. With "No Cars", The cars will not spawn in the street, but the peds will. With "No Peds" the peds will not spawn in the street. With "No Ped/Cars" the cars and the peds will not spawn in the street. With "Riot Mode", the Riot will activave.
  • Adjust Time Limit:
    With this, you can add or remove time from the timer (for timed missions)
  • Start Timed Section:
    With this, a timed section will start from the current objective (Like "Timed missions")

Edit Objective This will allow you to edit the closest objective of the current location. Delete Objective This will delete the closest objective of the player's current location Select Objective Select the closest objective of the player's current location Put After Selected Use this to make the closest objective occur after the selected objective

 

6. Actors
Actors are the NPCs in the mission. They can be: Allied (help the player), Neutrals (Only attacks the player if the players attacks him), Enemy1 (Enemies of the Player and Enemy2) and Enemy2 (Enemies of the Player and Enemy1)

Button Function Add Actor This allows you to add an actor. First you select the skin (model), select the animation, the weapon and ammo. Then, a menu will show up. You will set the health (100, 250, 500, 1000, 2500) by default is 100. Also, you need to set the actor's gang (Allied, Neutral, Enemy1, Enemy2), the behaviour (Normal, Hold Position, Attack Direct, Hold and Direct, Follow Player), if the actor Must Survive to pass the mission, the actor's weapon accuracy (10, 25, 50, 75, 100), if the actor can be killed by headshot, and if you want to set a health bar for the actor. The actor will spawn after the selected objective Spawn Actor This will make the closest actor to spawn after the selected objective Hide Actor This will make the closest actor to hide after the selected objective. That means that it will dissapear Edit Actor This will let you change the properties of the closest actor. Delete Actor This will delete the closest actor

7. Cars

This is really similar to the actor's menu.

Button Function Add Car First, select the model, then the primary color and secondary color, after that, set the position. When you do this, another sub-menu will show up. Use it to select the car's properties (if it is bullet proof, explosion proof, damage proof, if the car is locked or not, and/or the tires are popable), the health: 100 (it will burn instantly), 250 (very low, just a little hit can destroy the car), 500 (half of the normal health), 1000 (normal health) or 2500 (2.5 times the normal health). Also, you can set if it has to survive, or it has to be destroyed and if you want to set a health bar for the car Spawn Car This will make the closest car spawn after the selected objective Hide Car This will hide the car after the selected objective, that means that it will disappear Delete Actor This will delete the closest car

8. Pickups

Also really similar to the actor's (and car's) menu.

Button Function Add Pickup This will add a pickup. You need to select to location first. After that, you can choose the type of pickup (Weapon, Health, Armor, Bribe, Other) and then you need to choose the exact pickup you want (only if you selected "Weapon" or "Other"), and the ammo (Only if you selected "Weapon"). Spawn Pickups This will make the closest pickup to spawn after the selected objective Hide Pickup This will hide the pickup after the selected objective, that means that it will disappear Delete Pickup This will delete the closest pickup

9. Objects & Special Effects

Button Function Add Object This will add an object. You need to select to the object you want and then, the location. Use the W-A-S-D keys to move the object. Press and hold LSHIFT (Jump key) with the arrow keys to change the height of the object. Press and hold the FIRE button (Left CTRL or Left Mouse Button) to change the rotation and location. Press and hold Bloq Mayus to move the camera around the object. Once you have set the position of the object, a submenu will spawn. You can choose between "Ready" (The Object will stay there, static), "Move along road" (The object will move in a predefined rute) and "Move when approach" (The object will move to another position when the player is near it.) " If you've selected "Move along path", you have to choose a new position to the object, and choose how fast it will move, and choose between route or loop-route. If you've choosed "Move When approach", you need to choose a new position for the object, and how close the player needs to be activate the trigger Spawn Object This will make the closest object to spawn after the selected objective Hide Object This will hide the object after the selected objective, that means that it will disappear Destroy Object This will delete the closest object

10. Tools
The "tools" are functions that are made to help the designer.

Button Function Teleport to Marker Use this to teleport the player to the marked location, so that way you don't have to travel around the map when designing Teleport to objective Using this you can teleport to any objective in the map JetPack This gives you a JetPack (In case you didn't notice that yet) Spawn Test Vehicle Using this you can spawn a test vehicle to drive it Browse Interiors This allows you to browse the interior Play From Selected Use this to play from the selected objective TEXT OPTIONS

If you want to make colored text in your missions, add "+X+" (where "x" is a letter that represents the color) before the text you want. The following colors are available:

• Blue: +b+
• Green: +g+
• Red: +r+
• Purple: +p+
• Yellow: +y+
• White: +w+

So, if you write something like this when designing:

"Go to +y+Glen Park+w+ and kill those +r+Ballas!"

The result when you play the mission will be:

"Go to Glen Park and kill those Ballas!

Note: When writing, you can shorcuts!

Example:
Press CTRL+B, to write +b+. Press CTRL+G to write +g+, press CTRL+P to write +p+, etc.

lso, when you're writing something, you can skip to another line using +n+

If you write:

"+b+Toreno +w+needs help.+n+Go to his ranch in +y+Tierra Robada"

The result in the game will be:
" Toreno needs help.
Go to his ranch in Tierra Robada "

HOTKEYS

1. Press CTRL+P to copy an actor, exactly like the previously created, to the current position

2. Press "H" when selecting vehicles to only browse Helicopters

3. Press "C" when selecting vehicles to only browse Cars

4. Press "P" when selecting vehicles to only browse Planes

4. Press "B" when selecting vehicles to only browse Boats

5. Press "S" when selecting vehicles to only browse special vehicles (Bikes, trailers, etc.)

 

CUSTOM SOUNDS

Since DYOM v7, it's possible to add custom sound to the missions. Here, I'll esplain how:

Every mission you make will have an audio code. What's that? That's a unique random name of the directory where you will add the sound files with ".mp3" extensions.

In order to do it, you need to create a folder with a the name "SD" in the GTA SA User Files directory.

When you design a mission, press "Show Mission audiocode" in the "Mission Menu". You will see something like "SD/XXXXX/" where "XXXXX" is the random name. Now go to the "SD" Folder and create a folder with the name of the audiocode of the mission you want to add sounds.

In the folder named after your mission audiocode, you can add the sounds. Just rename any mp3 file you want to "am.mp3", and it will become the ambience sound of your mission. This file will reproduce during the entire mission as a loop, but you can pause it using ".noa" files. In order to create a ".noa" file, create a ".txt" file, and rename it as "XX.noa", where "XX" is the objective where you want to pause the sound.
So, if you want an ambience sound to reproduce during the mission, except in the objective 02, create a file with the name "02.noa". You can also do something like, create the files "04.noa", "05.noa" and "06.noa" and the sound ambience sound will not reproduce in the objectives 04, 05 and 06. Simple!

You can also have files like "04.mp3", "16.mp3", "23.mp3" etc. This files are sounds that are only reproduced during ONE objective, the one with a number that matches with the file name. So "04.mp3" will reproduce in objective 04, "13.mp3" in objective 13, etc.

HELPFUL LINKS

Links for Tutorials, important topics and other things here:

• Tutorials - by Dutchy3010
• DYOM v7 Sounds - by Arejai
• List of new objects by ProtoZero
• DYOM SFX Pack by Zizo008
• A good way to take good R* style screenshots is this mod: Amazing Screenshots v1.1 by SilentPL
• For better quality in the screenshots, you can use this HiDef Camera by Deji

Note: If you have a suggestion for links to add here, PM me or post here.

FINAL WORDS

Before you ask, yeah, I was going to add the Storyline info in a table, but apparently, if I add more than 8 tables, all the BB codes get messed up. I tried a lot of things. But well, the info is there. It doesn't looks that good, but is understandable enough. Hope it helps!

As always, if you want to make a contribution, find grammar mistakes, or you think I forgot something, PM me or post here.


Thanks to:

• Dutchy3010 - DYOM co-creator
• PatrickW - DYOM co-creator
• Chimpso - For the DYOM v6.1 Tutorial
• The DYOM Community
• You. Thanks for reading this tutorial

Edited August 4, 2014 by AlexanderS4

[Terano]

Awesome Topic Dude!,

It should to pin.

[Alexander]

Hehe, thanks.

It might get pinned, because Chimpso's tut it's good, but for v6.1

[Doublepulse]

Nice tutorial! I might pin it, but to keep things simple I may need to unpin Chimpso's, since the information is almost the same. It's helpful to have a tutorial that has everything in it.

 

So I can either pin yours and unpin Chimpso's, or edit that topic and place the info from your's into that one. Either way nice job.

[Terano]

@DoublePulse

This is new Tutorial of new DYOM version so I think you should to PIN this.

Chimpso's Tutorial is old and it's time to UPGRADE

[Alexander]

@Alokik: Yeah, the other one is a bit old, lol. That's why I made this.

 

@Doublepulse: Well, both ways are good, but I still have some info to add, and I don't want to be asking you to edit the other topic everytime I want to add new content

[kk.]

 

4. Press "A" when selecting vehivles to only browse Planes

 

4. Press "B" when selecting vehivles to only browse Boats

 

5. Press "S" when selecting vehivles to only browse special vehicles (Bikes, trailers, etc.)

 

vehicles, not vehivles.

 

 

If you want to make colored text in your missions, add "+X+" (where "x" is a letter that represents the color) before the text you want. The following colors are available:

 

    Blue: +b+

    Green: +g+

    Purple: +p+

    Yellow: +y+

    White: +w+

 

And you forgot:

Red: +r+

 

I know those are so simple mistakes, but meh whatever. Good guide.

[Alexander]

Oh sh*t. Good find. Fixed

[Dude1]

 

Alex5526, also you forgot the +n+, it allows to skip to a different line of text, try it,you'll know what i mean

[Alexander]

@Dude1: A'ight, I'll try it and update the main post if necesary

[Martin_GDF]

Amazing tutorial Alex, it should be pin!

It shows all the functions, i think it's better than Chimpso's tutorial

[Khausar_Shahrizal]

 

thankyou Jimmy for a long words....wow you really wanna help me...i'll appriace with you...but about the language...d0nt worry...i have a young brother that can help with the language...but anyway thankyou for helping me...but i dont understand wht MOTW??

[Chimpso]

Feel free to remove mine if you wish, it is dated and I really have no intention of updating it anymore.

[ChumCrumpet]

I've got Cleo 3 and DYOM but it just crashes on loading. It didn't do it with Cleo 4, but with Cleo 4 I'd go to type the name of the mission and it crashes

Edited October 21, 2013 by MrPeteyMax

[Satourn]

I've got Cleo 3 and DYOM but it just crashes on loading. It didn't do it with Cleo 4, but with Cleo 4 I'd go to type the name of the mission and it crashes

Are you sure your version of gta_sa.exe supports CLEO and DYOM? As far as I know, only 1.0 version of the .exe does.

[ChumCrumpet]

Are you sure your version of gta_sa.exe supports CLEO and DYOM? As far as I know, only 1.0 version of the .exe does.

 

 

Funnily enough I downgraded to 1.0.1 and it worked fine. I was using Cleo 4, but when I went to type the name of my mission I got the crash.

I thought it was Cleo 4, so I downgraded to Cleo 3 and then I couldn't even boot up San Andreas. I hit DYOM and it just crashes when it gets near the end of loading.

I downgraded the exe to 1.0.0 and it crashes halfway through loading. With Cleo 3 and 4. It must be something to do with Steam.

[Alexander]

Hey everybody. I just wanted to say that I'll update this tutorial soon. Once again, thanks to Dutchy and Patrick, the v8 is awesome.

[Wolf247]

When I tried to end a mission, it just won't end. I mean, I started a mission, and it wouldn't end. Should I put an ending objective or something?

[gheorgheM]

is there a way to change CJ's clothing?

[Huzaifa khan]

is there a way to change CJ's clothing?

 

No I think it is not anyway to change the cj's clothing

Edited February 14, 2014 by Huzaifa khan

[Alexander]

Little update, a bit late I guess, but whatever.

I added some info fof the current version, I'll add some more in a while.

[Revolver1]

Little update, a bit late I guess, but whatever.

I added some info fof the current version, I'll add some more in a while.

You're missing Player Animation mate, just a reminder. If you're just gonna add it later, then ignore this.

[Alexander]

Yeah, I was going to add it yesterday, I didn't had the time. Anyway, thanks for the remind

[Shooticide]

How do you install missions?

[Revolver1]

How do you install missions?

Put the DYOM files (DYOM1.dat, DYOM2.dat, etc) in GTA San Andreas User Files, where you put the DYOM files

[Mr.Propaganda]

I forget my password on Dyom how can ı get my password

[General Scrotum]

Ask Dutchy or Patrick to reset it.

[Hassan_Shah]

Hello AlexandeS4 .. I did everything as you said but when go to the game and click on new game, It doesn't show me 2 options.. It only starts the game from the airport... I am using Dyom V8.1 and using the cleo you told me.. I tried other cleo 4 versions too but doesn't work. I also tried Cleo 3 with Dyom V4.1. Please help me.. It worked a month before but when i tried now it doesn't

Edited February 1, 2015 by Hassan_Shah

[Alexander]

Is probably not installed correctly. You should have in your GTASA User Files, a folder named MPACK, and inside, the MPACK5 that comes in the files you downloaded

[TheBMXMega]

1) Download the latest version of Design Your Own Mission
2) Find the "GTA User Files" Directory in My Documents
3) In "GTA User Files", create a folder, with the name "MPACK"
4) Extract the content of the DYOM ".rip" in the the folder you've just created.

 

I didn't understand number 4 please tell me where do I paste it and in which folder?

 

And when I started new game two options do not come on the game. I need help!

Edited October 8, 2015 by TheBMXMega