FS Modding General Topics

The modDesc From A GIANTS Software Mod

Estimated reading: 19 minutes 2469 views

In this guide, we will explore the modDesc.xml file used in the Silverrun Forest Mod by GIANTS Software.

1. Downloading the Silverrun Forest map

So, to get more into how an accurate modDesc for Farming Simulator 2025 looks, there is a mod by GIANTS Software – one of the maps for previous FS titles, that has a modDesc. And you’ll have to download the mod from the game’s integrated modHub (Downloadable Content) to find the map over there:

1 – Firstly, you’ll browse to this category called OFFICIAL MODS

2 – After clicking on that category, the next page will show the Silverrun Mod.

3 – Download this map from there, and after that, you’ll have to browse to your Farming Simulator 2025 mod folder/directory. 

4 – Unpack the ZIP-file for the mod and remove the ZIP-file *you may move it to another directory OUTSIDE of your mods directory also*

Now you’ll have the mod files available for exploring how this mod looks. And you’ll also have access to the map’s i3d files.

Anyway, I’m going to point out a very important detail here: WHEN you unzip mods in your mods directory, the game WILL display a red information icon that says “there’s an update available for this mod”. DO NOT update the mod. We will only look at this mod and then remove it/re-download it, or remove the mod and replace it with the ZIP file again.

2. Silverrun Forest modDesc XML Code

The XML code for modDesc.xml can be studied by opening the file in a text editor like Notepad++.

I will not show all the XML data here, but I will go through most of it.

3. Line #3 Author – Version – Title

This line is the opening section of the modDesc, containing essential information such as the mod author, mod version, and the mod title in English, between <en> and </en>.

XML
<author>GIANTS Software</author>
    <version>1.0.0.1</version>
    <title>
        <en>Silverrun Forest</en>
    </title>

The version number is added WHEN you plan to make updated versions of your mod. It means that you are RELEASING a new ZIP file of your mod for public downloads IF your mod is to be released on various mod hosting websites OR submitted to modHub for another review by GIANTS.

When making a new mod, the version number may be 1.0.0.0.

The title is unique to your mod. Don’t use the TAB key when coding the modDesc.xml. ALWAYS use the SPACE key on your keyboard. And yes, the title can have a space between the words.

The title can have its supported languages. The code above shows the English title between the EN-tags.

4. Line #8 Description![CDATA[

XML
<en>
<![CDATA[Expand your farming business to the brand-new and lively environment of Silverrun Forest - and bring your new machines to the woods!
Included in the huge expansion is a new map, inspired by the Pacific Northwest with its large forests - ripe with production chains and points of interest that develop based on your delivery of logs.

Number of purchasable fields: 4
Average acre size: 4,8 ha
Number of purchasable forestry land: 39
Water retrieval possible from the large river and smaller streams.

Changelog Version 1.0.0.1:
- Added support for Shipping Container
- Updated texture references 
- Adjusted terrain texture sizes
]]>
        </en>

The description is written for supported languages, as in the example above, where the CDATA-tag is between the language tag, in this case EN. Note how the CDATA-tag is ending.
An updated mod will also include its changelog in the description.

5. Line #43 L10N – Language Localization Files

XML
<l10n filenamePrefix="l10n/l10n" />

This is a filename prefix that points to a file path, in this case, l10n/l10n.

So there’s a folder/directory within the mod that has the l10n – name. But it’s not pointing to a specific l10n XML.

But if we move further down in the modDesc.xml to line 48, we see this information:

XML
<description>$l10n_mapForestry_description</description>

This means:

  • l10n = “localization” (industry-standard abbreviation)
  • filenamePrefix=”l10n/l10n” tells the game:
    • LOOK in the folder /l10n/
    • Load all localization files that start with the prefix l10n (e.g., l10n_en.xml, l10n_de.xml, etc.)

And if we move to that L10N folder, it has the XML files there:

So to understand why line 48 says $l10n_mapForestry_description, we can open up the localisation language file l10n_en.xml and find this line:

XML
<e k="mapForestry_description" v="It's full of Trees!"/>

And note that this line doesn’t have $l10n_ after K=.

Now you might want to look into other mods made by modders to see if you can find any L10N and how they’ve done it. Some mods may not have a L10N at all.

6. Line #45 Maps – Mission – Configuration Files

This line starts with this:

XML
<maps>
        <map id="MapForest" className="Mission00" filename="$dataS/scripts/mission00.lua" configFilename="map/config/map.xml" defaultVehiclesXMLFilename="map/config/vehicles.xml" defaultHandToolsXMLFilename="$data/maps/mapUS/config/handTools.xml" defaultPlaceablesXMLFilename="map/config/placeables.xml" defaultItemsXMLFilename="map/config/items.xml">
            <title>$l10n_mapForestry_title</title>
            <description>$l10n_mapForestry_description</description>
            <iconFilename>map/textures/ui/preview.png</iconFilename>
        </map>
    </maps>

The map ID is a unique ID, and we have the class name “Mission00”, where the mission LUA filepath is declared using the filename. This filepath points to $dataS (SDATAS), which, in short, is the game’s hardcoded EXE.

After the mission00.lua, we’ll find the configuration filepath declarations:

  • map.xml
  • vehicles.xml
  • handTools.xml
  • placeables.xml
  • items.xml

These are all found inside the config folder of this mod:

So GIANTS Software has done this by putting all the mods’ configuration files in the same folder. Sometimes you’ll find a modded map’s main configuration file (e.g., map.xml) outside the config folder. Some modders won’t organise a mod’s files into folders, but it’s highly recommended sometimes “to keep things organised”.

All these configuration files are typically used for a mod to function within Farming Simulator, while some are declared in modDesc.xml and others in map.xml.

7. Line #53 Store Items

This line continues with the following:

XML
<storeItems>
        <!-- PLACEABLES -->
        <storeItem xmlFilename="placeables/brandless/playerHouses/cabin12/cabin12.xml"/>
        <storeItem xmlFilename="placeables/brandless/playerHouses/cabin12/cabin12Preplaced.xml"/>
        <storeItem xmlFilename="placeables/brandless/playerHouses/cabin16/cabin16.xml"/>
        <storeItem xmlFilename="placeables/brandless/playerHouses/cabin17/cabin17.xml"/>
        <storeItem xmlFilename="placeables/brandless/playerHouses/cabin21/cabin21.xml"/>
        <storeItem xmlFilename="placeables/brandless/playerHouses/cabin27/cabin27.xml"/>
        <storeItem xmlFilename="placeables/brandless/playerHouses/damagedBus/damagedBus.xml"/>

        <storeItem xmlFilename="placeables/brandless/productionPointsGeneric/boatyard/boatyard.xml"/>
        <storeItem xmlFilename="placeables/brandless/productionPointsGeneric/barrelFactory/barrelFactory.xml"/>
        <storeItem xmlFilename="placeables/brandless/productionPointsGeneric/fancyFurnitureFactory/fancyFurnitureFactory.xml"/>
        <storeItem xmlFilename="placeables/brandless/productionPointsGeneric/flooringFactory/flooringFactory.xml"/>
        <storeItem xmlFilename="placeables/brandless/productionPointsGeneric/ironFurnace/ironFurnace.xml"/>
        <storeItem xmlFilename="placeables/brandless/productionPointsGeneric/miningShaftTower/miningShaftTower.xml"/>
        <storeItem xmlFilename="placeables/brandless/productionPointsGeneric/miningShaftTower/miningShaftTower_placeable.xml"/>
        <storeItem xmlFilename="placeables/brandless/productionPointsGeneric/petAccessoriesFactory/petAccessoriesFactory.xml"/>
        <storeItem xmlFilename="placeables/brandless/productionPointsGeneric/pictureFrameFactory/pictureFrameFactory.xml"/>
        <storeItem xmlFilename="placeables/brandless/productionPointsGeneric/shingleFactory/shingleFactory.xml"/>
        <storeItem xmlFilename="placeables/brandless/productionPointsGeneric/woodTurner/woodTurner.xml"/>
        <storeItem xmlFilename="placeables/brandless/productionPointsGeneric/sawmillOld/sawmillOldTriggers.xml"/>
        <storeItem xmlFilename="placeables/brandless/productionPointsGeneric/sawmillNew/sawmillNewTriggers.xml"/>

        <storeItem xmlFilename="placeables/brandless/rollercoaster/rollercoaster.xml"/>

        <storeItem xmlFilename="placeables/brandless/sellingStationTrain/sellingStationTrain.xml" />
        <storeItem xmlFilename="placeables/brandless/warehouse/warehouse.xml" />

        <storeItem xmlFilename="placeables/brandless/sellingStationVehicles/sellingStationVehicles.xml"/>
        <storeItem xmlFilename="placeables/brandless/gasStation/gasStation01.xml" />
        <storeItem xmlFilename="placeables/brandless/gasStation/gasStation02.xml" />
        <storeItem xmlFilename="placeables/brandless/gasStation/gasStation03.xml" />

        <storeItem xmlFilename="placeables/rudolfHormann/roundHall/roundHall.xml"/>
        <storeItem xmlFilename="placeables/rudolfHormann/storageHall/storageBuilding.xml"/>
        <storeItem xmlFilename="placeables/rudolfHormann/productionBuilding/productionBuilding.xml"/>

        <storeItem xmlFilename="placeables/brandless/trainSystem/trainSystem.xml"/>
        <storeItem xmlFilename="placeables/brandless/sellingPoints/silverrunMarket/silverrunMarket.xml"/>
        <storeItem xmlFilename="placeables/brandless/sellingPoints/waffleHut/waffleHutTriggerNorth.xml"/>
        <storeItem xmlFilename="placeables/brandless/sellingPoints/waffleHut/waffleHutTriggerSouth.xml"/>
        <storeItem xmlFilename="placeables/brandless/sellingPoints/secondHandClothes/secondHandClothes.xml"/>
        <storeItem xmlFilename="placeables/brandless/sellingPoints/sunnySideCafe/sunnySideCafe.xml"/>
        <storeItem xmlFilename="placeables/brandless/sellingPoints/fireDepartment/fireDepartment.xml"/>
        <storeItem xmlFilename="placeables/brandless/sellingPoints/cityHotel/cityHotel.xml"/>
        <storeItem xmlFilename="placeables/brandless/sellingPoints/hermitsCourt/hermitsCourt.xml"/>
        <storeItem xmlFilename="placeables/brandless/sellingPoints/hermitsCourt/hermitsCourtSouth.xml"/>

        <storeItem xmlFilename="$data/vehicles/train/locomotiveUS/forestryLocomotive.xml" />
        <storeItem xmlFilename="$data/vehicles/train/wagonFlatBedUS/wagonFlatBedUS.xml" />
        <storeItem xmlFilename="$data/vehicles/train/wagonPlanksUS/wagonPlanksUS.xml" />
        <storeItem xmlFilename="$data/vehicles/train/wagonTimberUS/wagonTimberUS.xml" />

        <!-- PALLETS -->
        <storeItem xmlFilename="objects/pallets/armoirePallet/armoirePallet.xml"/>
        <storeItem xmlFilename="objects/pallets/birdHousePallet/birdHousePallet.xml"/>
        <storeItem xmlFilename="objects/pallets/bowlsPallet/bowlsPallet.xml"/>
        <storeItem xmlFilename="objects/pallets/catTreePallet/catTreePallet.xml"/>
        <storeItem xmlFilename="objects/pallets/chairPallet/chairPallet.xml"/>
        <storeItem xmlFilename="objects/pallets/dogHousePallet/dogHousePallet.xml"/>
        <storeItem xmlFilename="objects/pallets/easelPallet/easelPallet.xml"/>
        <storeItem xmlFilename="objects/pallets/floorTilesPallet/floorTilesPallet.xml"/>
        <storeItem xmlFilename="objects/pallets/metalPallet/metalPallet.xml"/>
        <storeItem xmlFilename="objects/pallets/pepperGrinderPallet/pepperGrinderPallet.xml"/>
        <storeItem xmlFilename="objects/pallets/pictureFramePallet/pictureFramePallet.xml"/>
        <storeItem xmlFilename="objects/pallets/shingleGenericPallet/shingleGenericPallet.xml"/>
        <storeItem xmlFilename="objects/pallets/staircaseRailingPallet/staircaseRailingPallet.xml"/>
        <storeItem xmlFilename="objects/pallets/tablePallet/tablePallet.xml"/>

        <!-- PLANTS -->
        <storeItem xmlFilename="foliage/bushes/bushesCaliforniaHazelnut.xml" />
        <storeItem xmlFilename="foliage/bushes/bushesRedosierDogwood.xml" />
        <storeItem xmlFilename="foliage/bushes/bushesMountainMaple.xml" />
        <storeItem xmlFilename="foliage/mediumGroundPlants/mediumGroundPlantsSalmonBerryBush.xml" />
        <storeItem xmlFilename="foliage/mediumGroundPlants/mediumGroundPlantsStarryFalseSolomonsSeal.xml" />
        <storeItem xmlFilename="foliage/mediumGroundPlants/mediumGroundPlantsSwordFern.xml" />
        <storeItem xmlFilename="foliage/mediumGroundPlants/mediumGroundPlantsDeerFern.xml" />
        <storeItem xmlFilename="foliage/townGroundPlants/townGroundPlantsFeatheryCassia.xml" />
        <storeItem xmlFilename="foliage/townGroundPlants/townGroundPlantsFicusMicrocarpa.xml" />
        <storeItem xmlFilename="foliage/townGroundPlants/townGroundPlantsJapaneseBarberry.xml" />
        <storeItem xmlFilename="foliage/townGroundPlants/townGroundPlantsLythrumSalicaria.xml" />
        <storeItem xmlFilename="foliage/townGroundPlants/townGroundPlantsTownShrub.xml" />
        <storeItem xmlFilename="$data/foliage/decoBush/paintable_decoBush_small.xml" />
        <storeItem xmlFilename="$data/foliage/decoBush/paintable_decoBush_medium.xml" />
        <storeItem xmlFilename="$data/foliage/decoBush/paintable_decoBush_big.xml" />
        <storeItem xmlFilename="$data/foliage/decoBush/paintable_decoBush_superBig.xml" />
        <storeItem xmlFilename="$data/foliage/meadow/meadowUS/paintable_meadow.xml" />
    </storeItems>

Some of these store items are organised into commented categories, such as PLACEABLES and PALLETS.

Now you probably already know, as a Farming Simulator user, that store items are a part of the game’s integrated SHOP or VEHICHLE STORE, where we buy/lease the vehicle, tools, farm houses, farm buildings, and also items to decorate our farm and so on.

Now we see that the last lines say /foliage/, which means decoration items like decoration bushes.
We also find /pallets/ where the line for these says something like:

XML
<storeItem xmlFilename="objects/pallets/bowlsPallet/bowlsPallet.xml"/>

So the declaration for the file path (Filename) here is interesting. Why so? Because some of these declarations use $data (SDATA).
The SDATA tells us that the game engine (GIANTS Engine) is using the game’s assets, NOT the mod’s assets.
Because, as shown in the example above, there’s no SDATA to be found.

This means the asset (a pallet) is located inside the mod.

If we go back to the mod’s folder/directory, we’ll find a folder called objects. And inside that folder, we find another folder called pallets.

So all these XML lines for store items point to other XMLs, and that’s all this section of modDesc does.

8. Line #143 Fill Types

This is somewhat more of an advanced topic, so I will not cover in detail everything about fill types and density maps. I’ll do that in some knowledge guides later on. But anyway, this line contains the following information:

XML
 <fillTypes filename="fillTypes.xml"/>
    <densityMapHeightTypes filename="map/config/densityMapHeightTypes.xml"/>

The file path here is not an SDATA, which means…
*it’s files within the mod*

Note that this file path doesn’t have any folder name before “fillTypes.xml”.
It means that where modDesc.xml is located, fillTypes.xml is also to be found.

If it were a part of the folder named foliage, the XML code would be:

XML
<fillTypes filename="foliage/fillTypes.xml"/>

I’m just informing you about this, since anything that has to do with file paths and file names for making mods for Farming Simulator is SO COMMON that there is NO ESCAPE from this topic AT ALL.
As a modder, you’ll have to get used to this one way or another.

And as a NEWBIE *yes, we hate that title for sure*… this is where you start: WRITING ACCURATE file paths…
Because IF we don’t, GIANTS Engine and GIANTS Editor will GO CRAZY… *somewhat crazy* Enjoy the emotional moments it provides… 

The next line:

XML
<densityMapHeightTypes filename="map/config/densityMapHeightTypes.xml"/>

…is also a configuration file within the mod’s directories.

9. Line #146 Dependencies (Required Mods)

I forgot to highlight this line, so I’m going to do that now:

XML
<dependencies>
        <dependency>FS25_harvester911</dependency>
        <dependency>FS25_volvoPack</dependency>
    </dependencies>

These dependencies are other mods required for the Silverrun Forest mod to work. Usually, these mods are GIANTS Software-made and can be downloaded from the game’s integrated modHub.

If there are mods outside of modHub, there’s usually some information about them attached to the mod on the mod hosting website. If not…oh well…that’s a BIG problem.

Note that these dependencies are not declared as FS25_harvester911.zip. They DO NOT use a .zip ending.

10. Line #151 Placeable Types (Specialisation *with Z* LUA)

XML
<placeableTypes>
        <type name="productionPointHeapSpawner" parent="simplePlaceable" filename="$dataS/scripts/placeables/Placeable.lua">
            <specialization name="productionPoint" />
            <specialization name="infoTrigger" />
            <specialization name="heapSpawner" />
        </type>
    </placeableTypes>

Probably doesn’t tell us much, but anyway…

The file path uses SDATAS, pointing to a Lua file containing the specialisation strings. SDATAS means…?

Here’s a short reminder:

* SDATAS – game’s EXE
* SDATA – game’s data directory (not the mod’s directory)

So yeah, this is how a modDesc inside a GIANTS Software mod may look. And studying that XML file may help you set up things correctly when making modded maps for Farming Simulator 25.