Jump to content
  • catty-cb
    catty-cb

    DAMN Tutorial by Paeng

    Article was originally created on the SimPeg website by Paeng, website now deleted and Paeng has given permission for it to be on Simtropolis.

    Step 1 - Installing DAMN

    This should be pretty straight forward as it comes with an installer.

    01ClickDAMNInstaller.jpg.3fb6293188f02184cddc385bf3b23fbb.jpg
     

    Default options for each menu - DAMN Installer, DAMN Options and DAMN Extras

    02DAMNInstallerWindow.jpg.d16b564fb5023fb4d41eca658183450a.jpg

    3-DAMNOptionsforHideConfiguration.jpg.141903fb14a367a5121d7ad74e675000.jpg

    DAMNExtras.jpg.e7283108311c8baebac7096e8414e252.jpg

    Watch for the install path - it is important that DAMN is installed into the proper place.

    Normally, SC4 is installed into

    c:\programs\Maxis\SimCity 4\

    When you open that folder, you see a subfolder 'Plugins' - that's the one we're after.

    So when you have run the installer, open

    c:\programs\Maxis\SimCity 4\Plugins\

    and you should see a new subfolder 'DAMN' - open this and see two further subfolders 'Root' and 'Support'.

    Root is the place where all your custom menu definitions will be stored. Some samples are already there (e.g. SG Canals) - we'll deal with that later.

    Support - there are a number of files in there as well... leave them alone for the moment.

    So if we're in tune up to here, you could start the game now for a little test.

    Open the 'News PopUp' by clicking at the blue link at the bottom or by clicking the button at bottom right.

    damn01.jpg.968a274c558f122550b3a8d8550e7dcf.jpg

    In the popup, click the blue link to open the menu. This is what the menu window looks like - just disregard the listing in the lower window - those are my menu definitions, so you'll see something different and much less (e.g. you'd see again those SG Canals).

    Clicking on them will probably not work (yet) - unless you have those canals installed.

    damn02.jpg.4301d8166ddf41dbed51f57c6e56d152.jpg

    Anyway - all we wanted to check is if the menu system is properly installed and visible... so you can close the game again.


    Part 2 - Installing SSP Tool and the SSP Tool DAMN Plugin

    A) SSP Tool  = https://sc4devotion.com/csxlex/lex_filedesc.php?lotGET=2191

    Okay, after unzipping the archive you'll have a folder

    SSPTool_Complete

    which contains all program files. It doesn't really matter where you put it - for me, I got all my SC4 related tools (like LE, Reader etc.) at

    c:\programs\SC4_utilities\

    so this one goes there as well. Now when you open this folder, you'll see a file called 'SSPTool.bat' - that's for starting the program. I put a shortcut to this *.bat file on my desktop.

    Notice also that there is a subfolder 'plugins' - keep that in mind, because we'll want to go there in a mo.

    From the readme:

    The tool is implemented in JAVA, so you need the JAVA Runtime Environment (JRE Version 6), which can be downloaded from Sun: http://java.sun.com

    Most probably you got all that and won't have to fiddle around with it...

    B) SSP Tool DAMN Plugin = https://sc4devotion.com/csxlex/lex_filedesc.php?lotGET=2450

    Again, unpack the downloaded archive and you should have a folder

    SSPTool-Plugin-DAMN

    with lots of stuff inside that does not really need to concern you - just take this complete folder as is and move it into the plugins folder mentioned in the previous step (the subfolder 'plugins' inside 'SSPTool_Complete').

    That's it. We're now ready to configure this thing and then start setting up our menus.


    Part 3 - Setting up your own menus

    In order to start with a clean slate, here is my suggestion: Go back to the Root folder of the DAMN -

    c:\programs\Maxis\SimCity 4\Plugins\DAMN\Root\

    and clean it out... throw away those sample definitions or move them out for safekeeping - just make sure the folder is empty.

    Okay, now fire her up... remember how? Yes, doubleclick that 'SSPTool.bat' (easy if you prepared the suggested shortcut ;-). It may take a little moment to start up, then comes a welcome screen, click 'Ok' and finally the tool is open. If you followed the steps, the current screen should show the readme for using the DAMN plugin.

    damn11.jpg.adcc2a621bbecab2568e5d65a1e40988.jpg

    Before anything else, lets check a few things - from the menubar at top open the menu 'Tools' and go into the 'Options'.

    damn10.jpg.6d490cad9a228873af04bd1fb872a037.jpg

    For the moment just check the paths - one is the install path for SC4, the other one for your Plugins (the one in 'MyDocuments'). Check that both are correct. Leave the other options alone until you are familiar with the basic functions of the program. Click 'Ok' to leave this dialog.

    At the bottom of the main window you see four large buttons. We don't need the 'Installer' anymore, we're done with that. The 'Options' and 'Extras' - again, leave them alone until you are familiar with the program and its basic functions.

    So that leaves the 'Manager' - hit it. Lets look at the mainscreen:

    damn03.jpg.f5ece02534ed1ebec49574fed89c8088.jpg

    On top left (1) you see your current plugins (in 'My_Documents'). Bottom left (2) shows your 'DAMN\Root' (which should be empty now).

    Now it's time to choose the first plugin to turn into a DAMN menu. For this demo I decided to use the SPAR set (because it is big and organized in several subfolders). If you are a SPAM BetaTester, you might even have that set in your Plugins as well and can follow my steps exactly.

    So I click my way through the tree -

    damn04.jpg.4cbce07f4a64efe2b519c876708d5726.jpg

    Now you should do some thinking - how do you want to organize your menus? Remember - whatever you set up in the folder 'Root' is the hierarchy for your custom menus. It is completely independent from your plugins, which will not be changed or influenced by the way you set up your menus! So you have all freedom to arrange things in a logical way that makes things easy to find.

    Back to the SPAR - it is dependent of the SPAM (as will be other sets), so I want to start with a folder SPAM. Hit the + button in the Root window (2), enter SPAM, hit Ok.

    damn05.jpg.c839e8e0c753f6ecb5eb1056b9ca6f1c.jpg

    Since the SPAR set is nicely organized in subsets, I want to keep that - so I copy the hierarchy (keep on adding subfolders as described). When done, it should look like this:

    damn06.jpg.f592027f0ec153cfffacf795f427cfff.jpg

    Now you can fill those menus. In window 1, select 'SPAR_Candy'. You'll see the details of all associated lots in the window beside it (1a).

    * Note: Normally you'd also see a preview of the currently selected lot in the last window (1b) - here you don't, because I have removed the preview PNG from the lots to keep the file size down.

    damn07.jpg.5578e50971da95b27b08c40311a392ca.jpg

    Okay, the first lot is already highlighted - press SHIFT and click on the last lot, so all of them are now selected.

    Make sure that in window 2 the folder 'Candy' is selected as well!

    damn08.jpg.43c9a92b123b3168dec9d9bfd9a88f0f.jpg

    Finally click on the 'Dice' button to add the selected lots to the menu.

    The result should look like this:

    damn09.jpg.61028d7e32fedb961883a757413e8ea0.jpg

    That's it... repeat these steps for each subset, always making sure that you have highlighted the corresponding folders in window 1 and window 2.

    When everything is done, hit the button 'Apply' at the bottom of the window. The prog will shake, rattle and hum for a while and finally alert you that everything is done: "Index successfully generated!"

    You can now take a peek at the DAMN\Root\ folder - you'll see there exactly the folders that you have set up for your menu (in window 2).

    At this point some words about this Root folder - you should not try to add things there directly. However, you can tweak things like changing the name of a folder or rearranging them. Keep in mind though - if ever you decide to do this, you need to re-index the whole thing (that's what the prog did automatically during the shake, rattle and hum). So how do you re-index manually?

    Look at the DAMN folder's second subfolder - 'Support'. In there you'll find a file called 'DAMN-Indexer.cmd' - double click that to re-index manually (might as well prepare a second shortcut on your desktop). So whenever you change things around outside the program (not using the 'Apply' button), hit that 'DAMN-Indexer.cmd'!

    Depending on what you have your size and columns set to in here

    02DAMNInstallerWindow.jpg.d16b564fb5023fb4d41eca658183450a.jpg

    Will determine how the DAMN menu will look in-game - some examples

    2 Columns x Width 300 (Size 600x450)

    Ex01_2Col_W300_Size600x450.jpg.62732db86378438e5c546c634e045856.jpg

    1 Column x Width 300 (Size 300x700)

    Ex02_1Col_W300_Size300x700.jpg.4e4a4105ac039e2776dea94d24e0a6c1.jpg

    1 Column x Width 300 (Size 300x1000)

    Ex03_1Col_W300_Size300x1000-1.jpg.32f61b41e0c22838c8b6c57c85ccef99.jpg

    DAMN_Docu_thread.txt

    damn_tutorial.txt


      Edited by catty-cb  



    User Feedback


    Sorry the pictures seem to have got all jumbled up, I'll see if I can locate the original tutorial and sort this out

    EDIT: Hopefully pictures are back in the right order  :read:


      Edited by catty-cb  

    Updated post

    Share this comment


    Link to comment
    Share on other sites

    The SSP tool doesn't work as I want it to. After it opens and I have selected the language, it closes. What can be the reason? 

    Share this comment


    Link to comment
    Share on other sites
    On 26/12/2022 at 1:35 PM, Dacki90 said:

    What can be the reason? 

    Sorry I can't help as have never used the DAMN, just inherited Paeng's tutorials when he left the SC4 community

    Share this comment


    Link to comment
    Share on other sites


    Sign In or register to comment...

    To comment in reply, you must be a community member

    Sign In  

    Already have an account? Sign in here.

    Sign In Now

    Create an Account  

    Sign up to join our friendly community. It's easy!  

    Register a New Account


  • Recently Browsing   0 members

    No registered users viewing this page.

×

Thank You for the Continued Support!

Simtropolis depends on donations to fund site maintenance costs.
Without your support, we just would not be in our 24th year online!  You really help make this a great community. *:thumb:

But we still need your support to stay online. If you're able to, please consider a donation to help us stay up and running. This helps sustain a platform where we can share our community creations for years to come.

Make a Donation, Get a Gift!

Expand your city with the best from the Simtropolis Exchange.
Make a Donation and get one or all three discs today!

STEX Collections

By way of a "Thank You" gift, we'd like to send you our STEX Collector's DVD. It's some of the best buildings, lots, maps and mods collected for you over the years. Check out the STEX Collections for more info.

Each donation helps keep Simtropolis online, open and free!

Thank you for reading and enjoy the site!

More About STEX Collections