Map development: Difference between revisions

From Spring
Jump to navigationJump to search
← Older editNewer edit →
Line 105: Line 105:
In time, the mapinfo tags will be documented and this will like to that page. As it is the tags and values are pretty easy to figure out for the most part.
In time, the mapinfo tags will be documented and this will like to that page. As it is the tags and values are pretty easy to figure out for the most part.


<div><code>--------------------------------------------------------------------------------</code></div><div><code>--------------------------------------------------------------------------------</code></div><div><code>-- mapinfo.lua</code></div><div><code>--</code></div><div><br/></div><div><code>local mapinfo = {</code></div><div><code>name &nbsp; &nbsp; &nbsp; &nbsp;= "EvoRTS - Craggy Creek -",</code></div><div><code>shortname &nbsp; = "",</code></div><div><code>description = "",</code></div><div><code>author &nbsp; &nbsp; &nbsp;= "",</code></div><div><code>version &nbsp; &nbsp; = "v08",</code></div><div><code>--mutator &nbsp; = "deployment";</code></div><div><code>--mapfile &nbsp; = "", --// location of smf/sm3 file (optional)</code></div><div><code>modtype &nbsp; &nbsp; = 3, --// 1=primary, 0=hidden, 3=map</code></div><div><code>depend &nbsp; &nbsp; &nbsp;= {"Map Helper v1", "Spring Features 1.0"},</code></div><div><code>replace &nbsp; &nbsp; = {},</code></div><div><br/></div><div><code>--startpic &nbsp; = "", --// deprecated</code></div><div><code>--StartMusic = "", --// deprecated</code></div><div><br/></div><div><code>maphardness &nbsp; &nbsp; = 800,</code></div><div><code>notDeformable &nbsp; = false,</code></div><div><code>gravity &nbsp; &nbsp; &nbsp; &nbsp; = 130,</code></div><div><code>tidalStrength &nbsp; = 0,</code></div><div><code>maxMetal &nbsp; &nbsp; &nbsp; &nbsp;= 1,</code></div><div><code>extractorRadius = 150,</code></div><div><code>voidWater &nbsp; &nbsp; &nbsp; = false,</code></div><div><code>autoShowMetal &nbsp; = true,</code></div><div><br/></div><div><br/></div><div><code>smf = {</code></div><div><code>minheight = -100,</code></div><div><code>maxheight = 900,</code></div><div><code>--smtFileName0 = "",</code></div><div><code>--smtFileName1 = "",</code></div><div><code>--smtFileName.. = "",</code></div><div><code>--smtFileNameN = "",</code></div><div><code>},</code></div><div><br/></div><div><code>sound = {</code></div><div><code>--// Sets the _reverb_ preset (= echo parameters),</code></div><div><code>--// passfilter (the direct sound) is unchanged.</code></div><div><code>--//</code></div><div><code>--// To get a list of all possible presets check:</code></div><div><code>--// &nbsp; [https://github.com/spring/spring/blob/master/rts/System/Sound/EFXPresets.cpp https://github.com/spring/spring/blob/master/rts/System/Sound/EFXPresets.cpp]</code></div><div><code>--//</code></div><div><code>--// Hint:</code></div><div><code>--// You can change the preset at runtime via:</code></div><div><code>--// &nbsp; /tset UseEFX [1|0]</code></div><div><code>--// &nbsp; /tset snd_eaxpreset preset_name &nbsp; (may change to a real cmd in the future)</code></div><div><code>--// &nbsp; /tset snd_filter&nbsp;%gainlf&nbsp;%gainhf &nbsp;(may &nbsp; &nbsp;" &nbsp; " &nbsp;" &nbsp;" &nbsp; &nbsp;" &nbsp;" &nbsp; " &nbsp; &nbsp;" &nbsp; )</code></div><div><code>preset = "default",</code></div><div><br/></div><div><code>passfilter = {</code></div><div><code>--// Note, you likely want to set these</code></div><div><code>--// tags due to the fact that they are</code></div><div><code>--// _not_ set by `preset`!</code></div><div><code>--// So if you want to create a muffled</code></div><div><code>--// sound you need to use them.</code></div><div><code>gainlf = 1.0,</code></div><div><code>gainhf = 1.0,</code></div><div><code>},</code></div><div><br/></div><div><code>reverb = {</code></div><div><code>--// Normally you just want use the `preset` tag</code></div><div><code>--// but you can use handtweak a preset if wanted</code></div><div><code>--// with the following tags.</code></div><div><code>--// To know their function & ranges check the</code></div><div><code>--// official OpenAL1.1 SDK document.</code></div><div></div><div><code>--density</code></div><div><code>--diffusion</code></div><div><code>--gain</code></div><div><code>--gainhf</code></div><div><code>--gainlf</code></div><div><code>--decaytime</code></div><div><code>--decayhflimit</code></div><div><code>--decayhfratio</code></div><div><code>--decaylfratio</code></div><div><code>--reflectionsgain</code></div><div><code>--reflectionsdelay</code></div><div><code>--reflectionspan</code></div><div><code>--latereverbgain</code></div><div><code>--latereverbdelay</code></div><div><code>--latereverbpan</code></div><div><code>--echotime</code></div><div><code>--echodepth</code></div><div><code>--modtime</code></div><div><code>--moddepth</code></div><div><code>--airabsorptiongainhf</code></div><div><code>--hfreference</code></div><div><code>--lfreference</code></div><div><code>--roomrollofffactor</code></div><div><code>},</code></div><div><code>},</code></div><div><br/></div><div><code>resources = {</code></div><div><code>grassBladeTex &nbsp; &nbsp;= "grassbladetex.bmp",</code></div><div><code>--grassShadingTex &nbsp;= "grassshading.bmp",</code></div><div><code>--detailTex = "",</code></div><div><code>specularTex = "specularmap.bmp",</code></div><div><code>splatDetailTex = "splattex.tga",</code></div><div><code>splatDistrTex = "splatdistribution.tga",</code></div><div><code>--skyReflectModTex = "",</code></div><div><code>--detailNormalTex = "detailtex.bmp",</code></div><div><code>--lightEmissionTex = "",</code></div><div><code>},</code></div><div><br/></div><div><code>splats = {</code></div><div><code>TexScales={ 0.006, 0.006, 0.006, 0.0005 },</code></div><div><code>TexMults={ 0.3, 0.3, 0.2, 0.1 },</code></div><div><code>},</code></div><div><br/></div><div><code>atmosphere = {</code></div><div><code>minWind &nbsp; &nbsp; &nbsp;= 1.0,</code></div><div><code>maxWind &nbsp; &nbsp; &nbsp;= 30.0,</code></div><div><br/></div><div><code>fogStart &nbsp; &nbsp; = 0.7,</code></div><div><code>fogEnd &nbsp; &nbsp; &nbsp; = 1.0,</code></div><div><code>fogColor &nbsp; &nbsp; = {0.8, 1, 1},</code></div><div><br/></div><div><code>sunColor &nbsp; &nbsp; = {1.0, 1.0, 1.0},</code></div><div><code>skycolor &nbsp; &nbsp; = { 0.1, 0.15, 0.7 },</code></div><div><code>skyDir &nbsp; &nbsp; &nbsp; = {0.0, 0.0, -1.0},</code></div><div><code>skyBox &nbsp; &nbsp; &nbsp; = "",</code></div><div><br/></div><div><code>cloudDensity = 0.5,</code></div><div><code>cloudColor &nbsp; = {1.0, 1.0, 1.0},</code></div><div><code>},</code></div><div><br/></div><div><code>grass = {</code></div><div><code>bladeWaveScale = 1.0,</code></div><div><code>bladeWidth &nbsp;= 0.5,</code></div><div><code>bladeHeight = 6.0,</code></div><div><code>bladeAngle &nbsp;= 1.57,</code></div><div><code>bladeColor &nbsp;= {0.59, 0.81, 0.57}, --// does nothing when `grassBladeTex` is set</code></div><div><code>},</code></div><div><br/></div><div><code>lighting = {</code></div><div><code>--// dynsun</code></div><div><code>sunStartAngle = 0.0,</code></div><div><code>sunOrbitTime &nbsp;= 1440.0,</code></div><div><code>sundir &nbsp; &nbsp; &nbsp; &nbsp;= { 0, 0.50, -1 },</code></div><div><br/></div><div><code>--// unit & ground lighting</code></div><div><code>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;groundambientcolor &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;= { 0.8, 0.8, 0.85 },</code></div><div><code>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;grounddiffusecolor &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;= { 1.0, 0.9, 0.8 },</code></div><div><code>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;groundshadowdensity &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; = 1.3,</code></div><div><code>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;unitambientcolor &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; = { 0.5, 0.5, 0.5 },</code></div><div><code>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;unitdiffusecolor &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; = { 1.0, 0.9, 0.8 },</code></div><div><code>&nbsp; &nbsp; &nbsp; &nbsp; &nbsp;unitshadowdensity &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;= 0.8,</code></div><div><code>specularsuncolor &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; = { 0.6, 0.7, 0.9 },</code></div><div></div><div><code>specularExponent &nbsp; &nbsp;= 100.0,</code></div><div><code>},</code></div><div></div><div><code>water = {</code></div><div><code>damage = &nbsp;0.0,</code></div><div><br/></div><div><code>repeatX = 0.0,</code></div><div><code>repeatY = 0.0,</code></div><div><br/></div><div><code>absorb &nbsp; &nbsp;= { 0.05, 0.05, 0.05 },</code></div><div><code>basecolor = { 0.5, 1, 0.5 },</code></div><div><code>mincolor &nbsp;= { 0.1, 0.1, 0.10 },</code></div><div><br/></div><div><code>ambientFactor &nbsp;= 1.0,</code></div><div><code>diffuseFactor &nbsp;= 1.0,</code></div><div><code>specularFactor = 1.0,</code></div><div><code>specularPower &nbsp;= 20.0,</code></div><div><br/></div><div><code>planeColor = {0.0, 0.5, 0.0},</code></div><div><br/></div><div><code>surfacecolor &nbsp;= { 0.5, 0.9, 0.5 },</code></div><div><code>surfaceAlpha &nbsp;= 0.1,</code></div><div><code>diffuseColor &nbsp;= {1.0, 1.0, 1.0},</code></div><div><code>specularColor = {0.8, 0.7, 0.65},</code></div><div><br/></div><div><code>fresnelMin &nbsp; = 0.2,</code></div><div><code>fresnelMax &nbsp; = 0.8,</code></div><div><code>fresnelPower = 4.0,</code></div><div><br/></div><div><code>reflectionDistortion = 1.0,</code></div><div><br/></div><div><code>blurBase &nbsp; &nbsp; &nbsp;= 2.0,</code></div><div><code>blurExponent = 1.5,</code></div><div><br/></div><div><code>perlinStartFreq &nbsp;= &nbsp;8.0,</code></div><div><code>perlinLacunarity = 3.0,</code></div><div><code>perlinAmplitude &nbsp;= &nbsp;0.9,</code></div><div><code>windSpeed = 1.0, --// does nothing yet</code></div><div><br/></div><div><code>shoreWaves = true,</code></div><div><code>forceRendering = false,</code></div><div><br/></div><div><code>--// undefined == load them from resources.lua!</code></div><div><code>--texture = &nbsp; &nbsp; &nbsp; "",</code></div><div><code>--foamTexture = &nbsp; "",</code></div><div><code>--normalTexture = "",</code></div><div><code>--caustics = {</code></div><div><code>--"",</code></div><div><code>--"",</code></div><div><code>--},</code></div><div><code>},</code></div><div><br/></div><div><code>teams = {</code></div><div><code>[0] = {startPos = {x = 7779, z = 2147}},</code></div><div><code>[1] = {startPos = {x = 353, z = 1982}},</code></div><div><code>},</code></div><div><br/></div><div><code>terrainTypes = {</code></div><div><code>[0] = {</code></div><div><code>name = "Default",</code></div><div><code>hardness = 1.0,</code></div><div><code>receiveTracks = true,</code></div><div><code>moveSpeeds = {</code></div><div><code>tank &nbsp;= 1.0,</code></div><div><code>kbot &nbsp;= 1.0,</code></div><div><code>hover = 1.0,</code></div><div><code>ship &nbsp;= 1.0,</code></div><div><code>},</code></div><div><code>},</code></div><div><code>},</code></div><div><br/></div><div><code>custom = {</code></div><div><code>fog = {</code></div><div><code>color &nbsp; &nbsp;= {0.26, 0.30, 0.41},</code></div><div><code>height &nbsp; = "80%", --// allows either absolue sizes or in percent of map's MaxHeight</code></div><div><code>fogatten = 0.003,</code></div><div><code>},</code></div><div><code>precipitation = {</code></div><div><code>density &nbsp; = 30000,</code></div><div><code>size &nbsp; &nbsp; &nbsp;= 1.5,</code></div><div><code>speed &nbsp; &nbsp; = 50,</code></div><div><code>windscale = 1.2,</code></div><div><code>texture &nbsp; = 'LuaGaia/effects/snowflake.png',</code></div><div><code>},</code></div><div><code>},</code></div><div><code>}</code></div><div><br/></div><div><code>--------------------------------------------------------------------------------</code></div><div><code>--------------------------------------------------------------------------------</code></div><div><code>-- Helper</code></div><div><br/></div><div><code>local function lowerkeys(ta)</code></div><div><code>local fix = {}</code></div><div><code>for i,v in pairs(ta) do</code></div><div><code>if (type(i) == "string") then</code></div><div><code>if (i ~= i:lower()) then</code></div><div><code>fix[#fix+1] = i</code></div><div><code>end</code></div><div><code>end</code></div><div><code>if (type(v) == "table") then</code></div><div><code>lowerkeys(v)</code></div><div><code>end</code></div><div><code>end</code></div><div></div><div><code>for i=1,#fix do</code></div><div><code>local idx = fix[i]</code></div><div><code>ta[idx:lower()] = ta[idx]</code></div><div><code>ta[idx] = nil</code></div><div><code>end</code></div><div><code>end</code></div><div><br/></div><div><code>lowerkeys(mapinfo)</code></div><div><br/></div><div><code>--------------------------------------------------------------------------------</code></div><div><code>--------------------------------------------------------------------------------</code></div><div><code>-- Map Options</code></div><div><br/></div><div><code>do</code></div><div><code>local function tmerge(t1, t2)</code></div><div><code>for i,v in pairs(t2) do</code></div><div><code>if (type(v) == "table") then</code></div><div><code>t1[i] = t1[i] or {}</code></div><div><code>tmerge(t1[i], v)</code></div><div><code>else</code></div><div><code>t1[i] = v</code></div><div><code>end</code></div><div><code>end</code></div><div><code>end</code></div><div><br/></div><div><code>getfenv()["mapinfo"] = mapinfo</code></div><div><code>local files = VFS.DirList("mapconfig/mapinfo/", "*.lua")</code></div><div><code>table.sort(files)</code></div><div><code>for i=1,#files do</code></div><div><code>local newcfg = VFS.Include(files[i])</code></div><div><code>if newcfg then</code></div><div><code>lowerkeys(newcfg)</code></div><div><code>tmerge(mapinfo, newcfg)</code></div><div><code>end</code></div><div><code>end</code></div><div><code>getfenv()["mapinfo"] = nil</code></div><div><code>end</code></div><div><br/></div><div><code>--------------------------------------------------------------------------------</code></div><div><code>--------------------------------------------------------------------------------</code></div><div><br/></div><div><code>return mapinfo</code></div><div><br/></div><div><code>--------------------------------------------------------------------------------</code></div><div><code>--------------------------------------------------------------------------------</code></div><div><br/></div>
== MapInfo.lua ==
[[Map_Making:_MapInfo.lua|MapInfo.lua]]


= SSMF Mapmaking Tutorial (Using JK's Blueprint) =
= SSMF Mapmaking Tutorial (Using JK's Blueprint) =

Revision as of 07:36, 10 March 2012

Development < Map development

Getting Started (Tools)

Blueprint: https://github.com/jk3064/Map-Blueprint 

The only other tool really needed is "Mapconv". The other tools available are there simply to make your life easier. A list of common mapping tools are as follows:

Mapconv

SMFED (Depreciated, no longer useful)

Grout (Depreciated, no longer useful unless texture was generated with L3dt utilizing tiles)

SMD Creator (Depreciated, no longer useful)

Start Position Editor

Das Bruce's Mapconv frontend

These tools have been compiled into a zip available here: http://springfiles.com/spring/tools/mapping-tools

Keep in mind that mapconv is still being developed, so it may be necessary to update the included Mapconv to a later version, located here: http://springrts.com/phpbb/viewtopic.php?f=56&t=21458

The Components of a Map

Texture Map

Heightmap

Metal Map

Feature Map

Compiling a Map (MapConv)

Texture Specifications

Texture map size is related in pixels and in spring map size. 2x2 MapSquares in spring are equal to 1024x1024 Pixels. Texture maps must be in multiples of 2. I.E. 2x2, 6x10, 12x16, 16x16, etc. No odd sizes are allowed (Example: 15x10).


Height Map dimensions are Texture Map size / 8 + 1 pixel. In other words, if your texture map is 8192x8192 (16x16), 8192 / 8 + 1 = 1025x1025


Metal Map dimensions are Texture Map size / 8 + 1 pixel. In other words, if your texture map is 8192x8192 (16x16), 8192 / 8 + 1 = 1025x1025


Feature Map dimensions are Texture Map size / 8. In other words, if your texture map is 8192x8192 (16x16), 8192 / 8 = 1024x1024

Using MapConv

MapConv is a command line program that is generally started via a batch file .

Below is an example set of parameters given to mapconv:

MapConv -i -l -c 0 -x 101 -n 100 -o EvoRTS-Craggy_Creek-v01.smf -t terrain.png -a height6.png -m metal.png -f feature.png -z "nvdxt.exe -dxt1a -nmips 4 -Sinc -quality_highest -file"

Once compiled, you will get 2 new files: <mapname.smt> and <mapname.smf>

Utilizing Blueprint

Unzip the blueprint archive into your Spring Maps folder.

mapcontainer.jpg

You will notice a new folder called "mapcontainer.sdd". The .sdd ending on the folder name is very important for testing as <foldername>.sdd tells spring to load map files from that folder. This way you can work on your maps without having to zip them up over and over again.

mapcontainer.sdd

Inside the map container folder you have the following file/folder structure.


LuaGaia
mapconfig
maphelper
maps
mapinfo.lua
mapoptions.lua

Now, copy your compiled map files into the "maps" folder.

Texture Splatting using SSMF

SSMF mapping is adding detail textures all over the map based upon specified distribution areas. This will make your map infinitely more detailed and beautiful.

Adding SSMF to a map consists of the following steps:

Distribution Map

Detail Textures

Specular Map

Grass Shading Map

Placing Features

As previously mentioned, features can now be placed via LUA based upon a coordinate system that looks similar to this:

local features = { 
unitlist = {
},
buildinglist = {
},
objectlist = {
{ name = 'btreeclo_4', x = 7760, z = 112, rot = "0" },
{ name = 'btreea_3', x = 2520, z = 6904, rot = "0" },
{ name = 'btreeblo_5', x = 7736, z = 536, rot = "0" },
{ name = 'btreeclo_1', x = 2504, z = 7112, rot = "0" },
{ name = 'geovent', x = 177, z = 192, rot = "0" },
},
}
return features

Of course, features can be placed by editing the set.lua file in a text editor, but that would take an extremely long time. Enter FeaturePlacer.

Feature Placer

Feature Placer

Configuring Map Parameters (Mapinfo.lua)

Admittedly, the default values used in blueprint mapinfo are awful. It may be wise for you to download another map that has used blueprint and copy and paste it's mapinfo contents into yours. However, you are also free to use the default or use the provided example.

In time, the mapinfo tags will be documented and this will like to that page. As it is the tags and values are pretty easy to figure out for the most part.

MapInfo.lua

MapInfo.lua

SSMF Mapmaking Tutorial (Using JK's Blueprint)

*A Note to wiki Editors*

The below listed tutorial needs to be pulled apart and separated into proper pages following an outline, making it much easier for future addition and proper documentation separation.

Creating a Map using Blueprint

Skyboxes


Mutators

Mutators are files that add new content to exiting game files. "Spring Features" is an example of a mutator.

This section needs a proper description.

http://springrts.com/phpbb/viewtopic.php?f=13&t=21808

Tools

  • Frostregen's SpringMapEdit. 3D editing, Compiles and import SM2 directly. Beginner friendly but still powerful.
  • MapConv Map converter program, compiles maps.
  • MapConvNG Rewrite of MapConv that works on linux / 64 bit.
  • Maps:Map Designer (Outdated, Depreciated) Hugh's 3D map designer. Splatting, heightmap editing, splat painting, SM3
  • Starting position creator: Or you can always find out the hard way which x/y coordinates are good by starting spring and having a look at the mouse cursor coordinates.
  • Coordinate Helper widget A small widget that helps you with finding coordinates ie for start positions. Every time you put down a marker it will log its position in Infolog.txt and also in MAPNAME_coordinates.txt Helpfull if you need to get lots of map coordinates and do not want to write them down by hand. (it writes SpawnResource in front of the coordinates but you can ignore or edit the widget)

Depreciated and Outdated Map Making Documentation

Depreciated Map Making Guides




Retrieved from "https://springrts-wiki.p2004a.com/mediawiki/index.php?title=Map_development&oldid=13345"