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

---  Welcome to the next generation of GTA3 Mission mods.  ---

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

-------------------------------------------------------------
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
* 99 Objects
* Text input char limit: 99 chars (Increased)

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
* Cutscene > with basic properties.


Other features in this mod:
* Customizable Player/Actor model skin with Special models.
* Support customization of Mission name/Author name text, and text formatting '~ ~'
* Objective text support.
* Actor route points support.
* Actor animations, Actor type properties, Actor weapon system.
* Custom objects support.
* Basic car creation setup.
* Mission Save/Load operations.
* and more...


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
* TAB+T - Toggle Noclip/Airbreak mode

###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" 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", 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"*


######HOW TO AVOID EDITOR GLITCHES
1: Player stuck in the starting player position
(Solution: Press F4 key to Refresh all the mission elements, or try do Airbreak mode by pressing TAB+T)



#######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):
  Press F9 Key on your keyboard to change the Menu theme into Classic (No background),
  or Disable any WidescreenFix mods to fix this issue.

-------------------------------------------------------------------

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)