Mapdev:Tutorial Finalizing

From Spring
Jump to navigationJump to search

Finalizing

This page describes how to compile some of the texture files into the smf smt files, test your map, archive the map using 7zip and upload to springfiles.com

Review

Following stage one of the beginners tutorial you will have some intermediary files ready to convert into the SMF and SMT map format:

  • heightmap.png
  • metalmap.png
  • diffuse.png
  • mini.bmp
  • grassmap.png

There is also the terrain type map but thats not covered in these tutorials

Compiling the smf and smt files

springMapConvNG (Windows/Linux)
  1. Open up the terminal and navigate to your working directory
  2. Generate the mymapname.smf and mymapname.smt files by runing mapconv with these options:
    springMapConvNG -t diffuse.png -h heightmap.png -m metalmap.png
    -v grassmap.png -minimap mini.bmp -ct 1 -o mymapname
  3. Copy the smf and smt files to the ./mymapname.sdd/maps/ directory (Do not rename!)
smf_tools (Windows/Linux)
  1. Open up the terminal and navigate to your working directory
  2. Generate the mymapname.smt and mymapname.smt.csv (tilemap) with this command:
    smt_convert -vf --smt -o mymapname.smt --tilesize 32x32 diffuse.png
  3. Generate the mymapname.smf file with this command:
    smf_cc -vf --height height.png --metal metal.png --map mymapname.smt.csv --grassmap grassmap.png --minimap minimap.png mymapname.smt
  4. Copy the smf and smt files to the ./mymapname.sdd/maps/ directory (Do not rename!)
MapConv (Windows)
  1. In mapconv directory: right click, new file, mymapname.bat
  2. Edit in text editor, put in these options:
    MapConv -i -c 0 -x 256 -n 10 -o mymapname.smf -t diffuse.png -a 
    heightmap.png -m metalmap.png -v grassmap.png
  3. Depending on the desired quality add:
    Fastest compile, lowest quality:
    
     -z "nvdxt.exe -dxt1a -nmips 4 -quick -file"
    
    Medium speed, good quality: (CUDA version, requires nvidia 8 or higher series gfx card)
    
     -q
    
    Slow, great quality: (Nothing)
    
    Slower, best possible quality:
    
    -z "nvdxt.exe -dxt1a -nmips 4 -Sinc -quality_highest -file"
  4. Make sure mini.bmp is in the same directory as the mymapname.bat
  5. Generate the mymapname.smf and mymapname.smt files by executing mymapname.bat file
  6. Copy the smf and smt files to the ./mymapname.sdd/maps/ directory (Do not rename!)
Mac FIXME:

Testing the map

Copying the sdd directory to your spring maps folder will allow spring to recognise it as a map, this way you can tweak parameters and test things before archiving it for distribution.

Archiving

Archiving the map creates a single file with smaller overall size for easy distribution.

  1. Create a new 7zip archive containing the contents of the sdd folder.(see below for platform specific instructions)
  2. Copy the archive to maps folder to test
Icon-caution.png Caution
Make sure that you have not created the archive with the "solid archive" option, or spring will not recognise it.
Linux
  1. Open a terminal and navigate to your sdd directory
  2. Run the following command:
7z a -ms=off mymapname.sd7 *
Windows Examplearchivewith7zip.jpg
Mac FIXME:

Uploading to springfiles.com

  1. Head on over to springfiles.com and create an account
  2. Select upload from the main horizontal menu
  3. Fill out as much as you can
  4. Post to map creation subforum with something like "[new map]" in the subject line so as to increase visibiity.

Congratulations

Your map is set free into the wilds of the internet. We sincerely hope its well loved.

Please browse the Map Development wiki pages for more ways to make awesome maps. Please help us make this wiki as comprehensive as possible, if you see something missing don't hesitate to jump in and add it.

Additionally, now you have gotten into maps, perhaps other areas of spring development may interest you. Check out the Game development pages.

For help and discussions please visit the forums

Good Luck.