NFS Underground 2 - Unlimiter
v3.1.1.1337

Source Code: https://github.com/nlgxzef/NFSU2Unlimiter/
------------------------------------------------------------------------------------------------------------
Description:

NFSU2 Unlimiter is a script mod which fixes some issues and makes some improvements for added cars and events.

Features:
+ Fixes visibility and crash issues for added cars.
+ Fixes disappearing wheels issue.
+ Expands memory pools.
+ Fixes a crash issue related with world map markers.
+ Adds options to change car render information. (See UnlimiterData\_General.ini file.)
+ Fixes missing objects for options and stuff in FNGs by cloning them.
+ Allows the events to have specific engage messages in any stage. (The game did it only for Stage 0 by default.)
+ Adds new customization items to the menu. (Fully configurable via car-specific or general ini files.) (Parts should get added by modders.)
+ Restores cut customization options from the game: Trunk Audio Paint, Cabin Neon, Hood Decals, etc.
+ Lets modders add custom rim brands. (Fully configurable via ini file.)
    - [RimBrands] RemoveRimSizeRestrictions: Removes the outer radius restriction to make any rim available for all cars.
	- [BrandX] NoRimSize: Disables rim size checks for a specific brand.
	- [BrandX] HideBrandName: Hides brand name on rim selection screen for a specific brand.
+ Allows decal dummy parts to have "NUM_DECALS" attribute to declare the number of slots.
+ Adds custom attributes to allow even more customization options: (Extra Customization needs to be enabled to make custom attributes work.)
    - SHOWENGINE (Boolean) : Allows the player to see engine and neon through the hood.
    - SHOWTRUNK (Boolean) : Allows the player to see trunk audio components and neon through the trunk.
    - TRUNKUNDER (Key) : Sets the under part of the trunk. Works like the HOODUNDER attribute, which is available for hoods.
	- NUMSLOTS (Integer) : Declares the number of component slots a Trunk Audio Layout has. If not present, the "default" hardcoded values from the game will be used.
	- FRONT_TIRE_OFFSET (Floating) : Adds offset (spacers) to the front wheels. This attribute can be added to Fender and Wide Body parts.
	- REAR_TIRE_OFFSET (Floating) : Adds offset (spacers) to the rear wheels. This attribute can be added to Quarter Panel and Wide Body parts.
+ Implements use of strings for AI Opponent names like later games and adds 150+ names from credits. (RACERNAME_000-999)

Also check out:
- NFS Mods with Unlimiter (v3+) & Extended Customization Support: https://docs.google.com/spreadsheets/d/1BYqui01raMMtRGrJ63-2B-Agh9ag6RdPB-bd07pDIKI/edit#gid=0

Bonus:
- Unlimiter Logo.png: You can add this logo on your mod preview to show that your mod utilizes Extra Customization features in the Unlimiter.

------------------------------------------------------------------------------------------------------------
Installation:

! Before installation, make sure that you're using v1.2 speed2.exe (4,57 MB (4.800.512 bytes)).
If not, just search "NFS Underground 2 v1.2 NO CD Crack HOODLUM" on Google, Bing or any search engine you like.

Now you can install the script. Just follow these steps:

1) Open the archive you downloaded and extract it anywhere.
2) Copy the contents of "Main Files" folder into your NFSU2 Installation Folder.
3) Install the string and texture data for the new menu options using Binary: (Compatible with v2.5.5 and up)
	1) Download and install the latest version of Binary: https://nfsmods.xyz/mod/1638
	2) Run Binary as administrator.
	3) Select User Mode. (Tap/click the icon on left.)
	4) Select the "Unlimiter-Setup-Binary.end" from the dialog and tap/click OK.
	5) Select your game installation directory.
	6) Wait for it to get installed.
	7) Confirm the save prompt.
	8) Quit Binary.
4) (Optional) Edit the configuration files (NFSU2UnlimiterSettings.ini, \UnlimiterData\*.ini) as you like.
5) Run the game!


! IMPORTANT: If your game is installed in a restricted directory (For example: C:\Program Files (x86)\EA GAMES\Need for Speed Underground 2), you have 3 options to make the mod work properly:
1) Run your game as administrator.
2) Move your whole game installation to somewhere unrestricted. (Like, E:\Games\NFSU2)
3) Take ownership of your game directory. (Check out: https://www.intowindows.com/add-take-ownership-to-right-click-menu-in-windows-10/ )
4) Copy the configuration (*.ini) files into the Virtual Store. (%LOCALAPPDATA%\VirtualStore\Program Files (x86)\EA GAMES\Need for Speed Underground 2\scripts(\UnlimiterData))

------------------------------------------------------------------------------------------------------------
Changelog: (+ Addition, * Change, ! Attention, - Deletion)

v3.1.1.1337 (Build 3.1; Rev.00) :
+ Added quantizer values to fix various issues with online gameplay and stuff.
* Made LOD A brakes render in the game world. (@Archie)
* Reorganized code caves.

v3.1.0.1339 (Build 3.1; Rev.00) :
* Fixed an issue which caused the cars in shops to go dark.

v3.1.0.1338 (Build 3.1; Rev.00) :
* Optimized the rim availability check to reduce the loading time of the Rims menu.

v3.1.0.1337 (Build 3.1; Rev.00) :
+ Added an option to hide rim brand names on rim selection screen.
+ Added an option to remove rim size restrictions.
+ Added "Random Name Hook". It uses RACERNAME_XXX strings to un-hardcode the AI opponents names for Quick Race events. Also added over 150 names from the credits with the installation script.
* Reworked the crash fix for Performance Config.
+ Added some comments for the ini files in UnlimiterData to explain the options in detail.

v3.0.0.1337 (Build 3; Rev.00) :
+ Added "Extra Customization".
+ Added configuration file for rim brands.
+ Added a configuration file to fix missing objects for options and stuff in FNGs by cloning them.
+ Allowed the events to have specific engage messages in any stage.
* Transferred and improved cut customization features from Extra Options.
* Reorganized the code.

v2.0.0.1337 (Build 2; Rev.00) :
* Initial unlock status and AI availability can now be set per car.
* Expand Memory Pools option is now enabled by default.

v1.2.0.1337 (Build 1.2; Rev.00) :
* Added an option to fix crashes with triggers in game world.

v1.1.0.1337 (Build 1.1; Rev.00) :
* Fixed a crash when the user enters the Car Lot. (Unlocks Crash)
* Fixed a crash when the user wants to join any Stage 2+ event with an add-on car. (Performance Config)
* Fixed a crash with RemoveCentreBrakeWithCustomSpoiler option.
+ Disabled the rendering of TIREMASK texture on menus.

v1.0.0.1337 (Build 1; Rev.00) :
+ Initial release.
------------------------------------------------------------------------------------------------------------
Credits:

Main Developer:
- nlgxzef

Contributors:
- 379Felipe
- Archie
- ASC
- Aven
- BlueSkyWestSide
- elaymm4
- GhostRider
- P A I N
- RedCarDriver
- rnz
- trackmaniamatt

Former testers: (Thanks for your work from earlier!)
- David
- MaxHwoy
- NyxVeliona

Special thanks to:
- 379Felipe and Speedyheart: Letting me know about the car limit in executable.
- Archie: Great help and inspiration for the Extra Customization functionality.
- Aero_ and Berkay2578: Expanding memory pools.
- GhostRider: Their great help with the new icons.
- Hex-Rays: IDA PRO.
- MaxHwoy: Binary.
- NFSU2 Olympic Imports users: Reporting issues and testing the fixes for them.
- EA Black Box: Accidentally adding symbols into NFSU2 Gamecube NTSC build.
...and others (if I've forgotten any) for other stuff.
------------------------------------------------------------------------------------------------------------

See ya!
©2023 nlgxzef @ ExOpts Team - No rights reserved. ;)