GTA3-DYOM
"Design your own Mission" for GTA3 game.
 Version: 1.0.5.2.alpha.pre-release
	 Written by Seve267.
 Date created: @2025-2026

 The next generation of GTA3 Mission mods.

* This is the first In-Game Mission builder Mod in GTA3 *
 This is a Recreation project of DYOM mod from GTA San Andreas and recreated it to the GTA3 game.

Download link:
GTA3-DYOM Download link


Credit to the most inspired DYOM Creators and Developers:
Dutchy3010, PatrickW, and Miran.


 NOTE
*This is a alpha release version, some features are not available in this version,
and the alpha/pre-release created missions might not work in the final release*


# OVERVIEW
DYOM (Design your own Mission) is a GTA mod that allows the user
to create, build, share and design their own missions in-game without writing a single line of SCM script.

 * Enhanced DYOM editor (vs. original DYOM)
 * Fast objective processing (vs. original DYOM)
 * Classical mission design
 * Compatibility support for Widescreenfix mods. (for other users)
 * And more.

Checkout the Changelogs.txt inside the zip-archive to see what are the changes.

MISSION FEATURES (for this alpha build)

Limits:
* 99 Objectives
* 99 Actors
* 99 Cars
* 49 Pickups
* Text input char limit: 59 chars

Objective types:
* Checkpoint > with customizable checkpoint radius and colors.
* Actor > Single enemy gang group only
* Car > Enter car only
* Pickups > Single counting only, and single parameter value system.
* Player teleport > with customizable properties.
* Timeout > with basic properties

Other features in this mod:
* Support customization of Mission name/Author name text, and text formatting '~ ~'
* Objective text support
* Actor animations, Actor type properties, Actor weapon system.
* Basic car creation setup
* Mission Save/Load operations.


Hotkeys:
* Y - DYOM Menu
* CTRL+SHIFT+Q - Start/Abort Mission
* F4 - Refresh all mission elements to update
* F8 - Sets the Default Mission author name
* F9 - Change Menu Theme

REQUIREMENTS FOR THIS MOD
* CLEO 2.1.1+ Plugin for GTA3 + CLEO IniFiles Plugin
* GTA3 v1.0 EXE (see: https://www.moddb.com/downloads/grand-theft-auto-3-original-10-exe-for-steam)


RECOMMENDATIONS
* The Sprint key should be mapped to the SPACE key


INSTALLATION OF THE MOD
(For those who had installed modloader plugin, follow these steps)
1: Copy the "gta3_dyom_v1.0.5.2" folder, and paste it into the "modloader" folder
2: Copy all the contents inside the "userfiles" folder, go to your "My documents" folder,
and paste all the contents into the User files folder (like this: "GTA3 User files"),
3: Then, run GTA3 and start the game.

(For those who had NOT installed modloader plugin, follow these steps)
1: Create a backup copy of "main.scm" file from "GTA3\data" directory (in case when you restore the original "main.scm" file)
2: Open the folder "gta3_dyom_v1.0.5.2", copy the "main.scm" file, go to the GTA directory (where the "GTA3\" directory),
Open the "data" folder, then paste the file "main.scm" file inside of the folder. (make sure you have a backup copy of the orignal "main.scm" file)
3: Copy all the contents inside the "userfiles" folder, go to your "My documents" folder,
and paste all the contents into the User files folder (like this: "GTA3 User files"),
4: Then, run GTA3 and start the game.

*Take note: CLEO 2.1.1+ plugin is required to run this mod, so you must download the plugin from the website "https:\\cleo.li"*


TROUBLESHOOTING
Common issues:
* Missing "gta3dyom_main.mdb" file:
 Check that "gta3dyom_main.mdb" file is in the userfiles directory, `

* DYOM Menu background is bad (Default theme only):
 Disable any WidescreenFix mods to fix this issue.

* When activating DYOM menu on DYOM editor, the game frozen:
 Change the Menu theme to 'Classic theme' by pressing 'F9' key on your
 keyboard to solve the issue. (It will shows what theme has selected.)

* The user changed the theme into Default or Classic, after restart the game, the theme is not been changed:
 Goto your GTA3 Userfiles directory, open User settings ini file 'GTA3-DYOM User settings.ini',
 edit the third Key value (named: MISC_WIDESCREENFIX_COMPAT_MODE) to 0, then restart the game.


This project has started about April 2025, and actually, this is my first GTA3 mod that I've ever made.
Thank you for using this mod, and welcome to the next generation of GTA3 Mission mods.

Seve267 - AM (The Independent GTA Modder)