SC4 Devotion Forum Archives

SimCity 4 Devotion Custom Content Showcase => Network Addon Mod (NAM) => NAM 37 Release Candidate Support => Topic started by: Tarkus on April 23, 2020, 05:34:38 AM

Title: NAM 37 Release Candidate - General Information
Post by: Tarkus on April 23, 2020, 05:34:38 AM
(https://sc4devotion.com/csxlex/images/beximg/thumbs/nam37rclogo.jpg)

The NAM Team is pleased to announce the public pre-release of the 37th edition of the Network Addon Mod, NAM 37.

The NAM 37 Release Candidate is not the final, full release version of NAM 37, which will come later, but is instead designed to give the general public an opportunity to try out the new features and improvements, and provide feedback and report any issues that may arise, allowing us to produce a better final product.  This subforum is designed specifically for such purposes.

Note that this version has major, substantial changes in terms of file architecture and installation procedure.

Disclaimer

Release Candidates are not finished products.  While the team engaged in an extremely lengthy alpha testing phase (11 builds, this is Build 12) and has attempted to iron out any glaring instabilities, some issues may still be present.

Please note that the documentation has not yet been updated.

NAM 36 will remain available for the time being, but the NAM Team will be focused forward, on improving the NAM 37 Release Candidate into a finalized build of NAM 37, rather than on addressing any concerns with NAM 36.

Availability

The NAM 37 Release Candidate (RC) build is hosted here at SC4 Devotion, on the LEX. 

This Release Candidate marks the introduction of the NAM's new cross-platform Java-based installer, designed by daeleyPlease ensure that you have the latest version of the Java Runtime Environment (JRE) installed. (https://www.oracle.com/java/technologies/javase-jre8-downloads.html)

Download Link
SC4D LEX (Cross-Platform) (https://sc4devotion.com/csxlex/lex_filedesc.php?lotGET=3960)

Release Notes
Note that the NTCore 4GB Patch is REQUIRED if using this mod on a system with 4GB RAM or more, and due to the installer change, is no longer installed by default. Failure to patch the game accordingly may cause Crash-to-Desktop (CTD) errors. The patch can be found inside the download, or downloaded directly from NTCore here (https://ntcore.com/?page_id=371), where further instructions on use of the patch can be found. Also due to this installer change, the NAM Controller Compiler is no longer run as part of the installation process. All users will be initially given a full NAM Controller, which has a substantial size. Users not using all features wishing to have a smaller controller can still run the Controller Compiler manually, as it is available in the download.

The NAM is also now using a Java-based installer, designed by daeley, which is cross-platform (meaning no more separate Mac versions, and Linux support without WINE). As such, the Java Runtime Environment (JRE) is now REQUIRED to run the NAM installer. It was previous recommended for users wishing to utilize the NAM Traffic Simulator Configuration Tool (TSCT). The JRE can be downloaded from Oracle here (https://www.oracle.com/java/technologies/javase-jre8-downloads.html).

With the new installer, the old NAM installation is no longer removed automatically, so users should manually remove the "Network Addon Mod" and "z___NAM" folders from their Plugins directory. It is recommended, particularly with this Release Candidate, that you back those folders up in a location that is not in your Plugins folder. The "z___NAM" folder has been eliminated, and all files are now installed to the "Network Addon Mod" directory.

The RealRailway (RRW) standard for Rail is now the default and only option. The original Maxis Rail specification will be supported via a Legacy Plugin, downloaded separately. Also note that a number of cosmetic-oriented NAM plugins, such as the El-Rail Alternate Implementation, the Bullet Train Mod, and some advanced texture options (largely deprecated) have been removed from the installer. The Alternate El-Rail and BTM will be made available separately. Please note that, much like Maxis Rail, these Plugins are effectively in "Legacy" status, and may not be actively maintained or supported by the NAM Team going forward. Both the original Maxis Highways (MHW) and the "Maxis Highway Override/Project Symphony" (MHO) remain available.

The Station Locator, Updater, and Reconstruction Project (SLURP) is also no longer handled by the new installer. A scaled down version of the old installer will be made at a later date to handle SLURP routines. Users wishing to retain SLURPed stations should retrieve them from the "z___NAM\Mass Transit Lots\Station Overrides" folder in their existing NAM installation, where they will be found in the "Mass Transit Lots" subfolder. Note that users running the 64-bit version of SimCity 4 on macOS may wish to refrain from retrieving SLURP stations, as there have been some encoding issues with stations that cause that version of the game to CTD.

The new installer also no longer performs a version check. Please note, however, that for Windows users, Version 1.1.638 and above are still required, as Versions 1.1.610 and 1.1.613 have notable instabilities that may have a significant negative impact on the use of this mod. Copies purchased from the Origin Store may still not meet this requirement, and support will not be offered to users with "unofficial" copies of the game.

Features List


Installation

When one initially opens the NAM package after downloading, there will be several items present, besides the document you are now reading: the installer itself is NetworkAddonMod_Setup_Version37-RC.jar

4gb_patch.exe is the NTCore 4GB Patch, the Controller Compiler folder contains the NAM Controller Compiler, the Documentation is loose in the folder (and in the "feature-guides", "images", and "old" folders--this has not been substantially updated since NAM 36, but will receive updates for the finalized NAM 37 release), and the Traffic Simulator Configuration Tool folder, which contains the Traffic Simulator Configuration Tool (TSCT).</p>
            
NetworkAddonMod_Setup_Version37-RC.jar is the NAM Installer, which you will need to run to install the NAM.  If User Access Control (UAC) is enabled on your system, Windows may ask you to approve running the file with a simple "Yes"/"No" prompt.  Click "Yes" to allow the installer to run.
                        
In order to progress through the installer, simply click on each tab.  Note that the license agreement must be agreed to before subsequent tabs can be accessed.  The "Cleanup" tab (under "Setup") allows one to remove any residual files from old NAM releases, and pre-NAM transit mods that might cause conflicts, and is loaded with the old Cleanitol list that shipped with NAM 36.

Upgrading from a Previous Version

If you are upgrading from a previous version of the NAM, MANUALLY MOVE YOUR OLD NAM INSTALLATION OUT FROM YOUR PLUGINS FOLDER, INTO A SAFE LOCATION (note that this has changed from previous NAM releases).  The NAM installer can no longer detect your previous installation options by reading the existing folder structure.  It is recommended that you check your existing installation, to determine which features you presently have installed.

Generally speaking, the NAM Team makes every effort to ensure that new versions at least retain some form of "legacy support", such that cities built with any previous NAM version will continue to function well with the latest version.

If you have consolidated your NAM files using a tool such as SC4DatPacker or JDatPacker, please read the note in the "Read First" document, which is also attached to this post.

This release is dedicated to David Edgren (dedgren) and his family--we wish you the best.

And thank you to all the members of the SC4 community for their patience, through this record-long development cycle, and for the continued support of the NAM Team, now (as of the 24th) in its 16th year of operation!

-The NAM Team