FS25 Maps Adding A Vanilla Placeable Estimated reading: 16 minutes 2365 views This guide will show you how I moved a placeable asset (US Oil Mill) from one of the vanilla FS25 maps to another map. 1. Zielonka Light – Overview This sample mod map for Farming Simulator 2025 has a file and directory structure. All these files have unique roles and can be viewed as a family tree. The directory setup isn’t the default one, and may look different from those used by other modded maps. 2. Zielonka Light – Download The Map Before we can place the placeable by moving it from one Farming Simulator 25 map to another, we have to have an alternative version of the FS25 Zielonka. I’ve made that one for you. Pleae unzip this file and move it to your Farming Simulator 25 mods folder. Download Map (ZIP File 145 MB) 3. XML And Directory Structure A typical vanilla map for Farming Simulator use directories, XML files, i3D files and other files that is associated with graphics such as textures, layers and more. Common files and folders inside a map mod are: modDesc.xml (mod configuration file) config (folder) data (folder) placeables (folder) textures (folder) mapEU.i3D (i3D file that can be modified inside GIANTS Editor) mapEU.xml (the map’s main configuration file) sounds.xml (other XML files within the mapEU folder) 4. Why are mods for Farming Simulator packed into ZIP files? All mods for Farming Simulator are packed into ZIP files for distribution through websites and ModHub itself (in-game ModHub described as “Downloadable Content” from the game’s startup menu after the game trailer. Downloadable Content is the integrated ModHub for mods placed into Farming Simulator, or that can be downloaded and installed directly in the game itself. If mods are installed manyally, then this means that a ZIP-file is placed inside the mods folder. The ZIP file itself is not made by zipping a folder, but by selecting all files of a mod and making a new ZIP file with the naming standard FS25_MyMod.zip, for example. The game engine can read ZIP files directly, but mods need to be placed in a specific folder called mods found at MyGames/FarmingSimulator2025 in MyDocuments or Documents (depending on your operative system).The mod folder is not a part of the game’s directory. All saves done by the player inside Farming Simulator is written to another location. 5. modDesc.xml This XML file contains essential information about the mod, such as the author, description, mod versions (e.g., 1.0.0.0), and buyable store items, such as vehicles, production points (factories), selling points, decoratives, pallets, and buildings such as sheds, farmhouses, and so on. This XML file points to other XML files, such as the map’s parent XML file (mapEU.xml), placeables.xml, vehicles.xml, items.xml, handTools.xml, described as follows with code: XMLconfigFilename="maps/mapEU/mapEU.xml" defaultVehiclesXMLFilename="maps/mapEU/config/vehicles.xml" defaultHandToolsXMLFilename="maps/mapEU/config/handTools.xml" defaultPlaceablesXMLFilename="maps/mapEU/config/placeables.xml" defaultItemsXMLFilename="maps/mapEU/config/items.xml">configFilename="maps/mapEU/mapEU.xml" defaultVehiclesXMLFilename="maps/mapEU/config/vehicles.xml" defaultHandToolsXMLFilename="maps/mapEU/config/handTools.xml" defaultPlaceablesXMLFilename="maps/mapEU/config/placeables.xml" defaultItemsXMLFilename="maps/mapEU/config/items.xml"> Store items may look like this with code: XML <storeItems> <storeItem xmlFilename="cultivatedBrush.xml" /> <storeItem xmlFilename="plowedBrush.xml" /> <storeItem xmlFilename="stubbleTillagedBrush.xml" /> <storeItem xmlFilename="ridgedBrush.xml" /> <storeItem xmlFilename="maps/mapEU/placeables/oilPlantUS.xml" /> </storeItems> <storeItems> <storeItem xmlFilename="cultivatedBrush.xml" /> <storeItem xmlFilename="plowedBrush.xml" /> <storeItem xmlFilename="stubbleTillagedBrush.xml" /> <storeItem xmlFilename="ridgedBrush.xml" /> <storeItem xmlFilename="maps/mapEU/placeables/oilPlantUS.xml" /> </storeItems> For the first XMLs, the filename points directly to the XML file (cultivatedBrush.xml), while the last one (oilPlantUS.xml) uses the path maps/mapEU/placeables to reach the XML file. The first line tells us that cultivatedBrush.xml is in the same folder as modDesc.xml, whereas oilPlantUS.xml is in a different folder. The modDesc also contains an icon or thumbnail picture of the mod, a logo, or an image with text. This icon/picture will appear in-game when the user has installed the mod and wants to use it during their game session—selecting it from the in-game mod page when starting a new game or saving. The icon is created in an image editor such as Paint.net. XML<iconFilename>icon.png</iconFilename><iconFilename>icon.png</iconFilename> The modDesc will also hold information about whether the mod supports multiplayer or not, given by this line of code: XML<multiplayer supported="true"/><multiplayer supported="true"/> One of the more important lines of code this XML-file contains is this one: XML<modDesc descVersion="93"><modDesc descVersion="93"> 6. maps/mapEU (folder) This is the main folder for a map mod for Farming Simulator 2025. It may also have other names, such as a map or different names. When GIANTS Editor generates a sample map for you, it uses default folder names, such as maps, mapUS, and mapAS. So let’s open up mapEU and look at what’s inside: 6.1 Assets So, assets are just one way I name my folders for what types of files that is inside the folder. I use that naming convention because I associate it with game assets, which can be almost anything. But inside this folder, you’ll find children such as carDealerStorage, grainElevator, and residential, which are also asset folders. Inside these are i3D files (3D/visual/XML), XML files, and texture files (.PNG/. DDS). It also contains SHAPES-files (.shapes), which aren’t editable but always stay with the i3D-file, using the same name as the i3D. Example: carDealerStorage.i3d and carDealerStorage.i3d.shapes. 6.2 config It’s such an easy name to read that it shouldn’t be hard to tell what this folder contains. Here you’ll find many configuration files, such as: aiSystem.xml – I have no information… collectibles.xml – the golden apples are spread around as collectables for player rewards in cash. colorGrading.xml – lighting configuration, daytime, to change the global lighting inside the 3D environment. colorGradingNight.xml – lighting configuration, nighttime. environment.xml – another lighting configuration file with many settings for weather conditions, daylight, nightlight, clouds and more. farmlands.xml – a very important configuration file related to ownership of farmland (fields), its unique ID (like field 22) and the price of the field. This file also links to a densityMap called infoLayer_farmlands.png (or .grle) that is outside the config and in a different folder named data. fieldGround. xml – another configuration file related to density maps. fields.xml – I have no idea what this configuration file is for, aside from the fact that I think it’s related to the player’s default farm property fields. footballField.xml – configuration file related to the football field on the Zielonka map. It has something to do with…football. items.xml – this file doesn’t contain much information. It’s linked to defaultItemsXML in modDesc. For Farming Simulator 19, it was named defaultItems.xml several years ago, ShyWizard – YouTube. pedestrianSystem.xml – does what it says with the opening tag <pedestrianSystem> for the NPCs walking around in the streets, type of pedestrian, gender, body, clothing and animation. placeables.xml is one of the more critical files you’ll be coding for a mod map. It’s mainly for any kind of placeables, such as marketplaces, stores, production factories and production areas, farmhouses, gas stations, other filling stations, decoratives and so on. storeItems.xml – It may sound similar to items.xml, but it is mainly for store/shop items that are related to buyable placeables. It means that when the player opens the store in-game or wants to construct something on the map, then this XML file will give the pathway to the placeable’s file location, for example: XML<storeItem xmlFilename="maps/mapEU/placeables/oilPlantUS.xml" /><storeItem xmlFilename="maps/mapEU/placeables/oilPlantUS.xml" /> When this XML line above doesn’t start with $data, it points to a file location inside the mod. That’s the only information this configuration file holds. Every single line of code points to other XMLs. $data should be considered a pathway tag to the game’s main folder called data. This is useful when you want to use the game’s vanilla XML, i3D, and texture files (PNG/DDS). It’s all about file relations in a family tree. Or like components of a car engine. It’s about where the water flows… trafficSystem.xml – configuration file for NPC vehicles – mainly the NPC traffic on the roads. It’s only to be associated with NPC vehicles and has nothing to do with the AI-helper system or anything like that. vehicles.xml – a specific configuration file related to farming vehicles that will spawn in at the player’s starting farm. It’s mainly the vehicles the player already owns when starting a new game/save. It also includes information about the vehicle’s attached tools, such as sowings machines, seeders, cultivators, and more. weed.xml—This XML file points to an info layer related to weed: infoLayer_weed.png/.grle. GIANTS Editor usually does not generate this info layer when generating a new mod from a vanilla map (e.g., from mapEU). That file is way more important if you change the dimensions of a mod map.With some information, I’ll likely return to this section with more details later. 6.3 data This folder is not to be associated with $data. $data always points to the folder inside the game’s default data directory: Farming Simulator 25 > data. So, for this map mod, this folder contains layers, density maps, and weights associated with ground textures painted on the terrain plane of the mod map. It’s as simple as information stored as pixels instead of code. The map’s dem-file (dem.png) doesn’t look particularly interesting, but it is a visual image with grayscale colours where bright and dark colours represent the elevation of the terrain. The darker, curved line in the image is the river in Zielonka.This dem for Zielonka has a default dimension of 2049 x 2049 pixels. When we look at the weight layer for grass – grass01_weight.png, it shows way more visual information. All the grayscale colours and every pixel of this image instruct the game engine inside Farming Simulator, where grass will be rendered at ground level. Black and dotted black areas are where grass foliage isn’t present. The visual image dimensions of this weight layer are 2048 x 2048 pixels. In a subfolder called masks, we’ll find GEN_roadsMask.png, which looks like nice, minimalist artwork but is better considered pixelated art for the game engine. I speculate that this one will tell the game engine where not to render snow at ground level during the winter season, especially on trafficked NPC roads. You’ll also find .grle-files that can be converted to PNG-files using a GRLE-converter from GDN: https://gdn.giants-software.com/downloads.php (requires user registration to download files). Please read the included README.txt file for using such tools. 6.4 placeables As mentioned before, from another perspective, placeables are to be considered assets/objects for decoration or interaction. It is interactive objects such as production points (factories), small production points and so on. They may also include animated visual elements to be considered visuals. The player interacts with triggers in-game, such as a floating icon above ground level or a specially marked area. In this folder for this Zielonka Light sample mod, you’ll find files associated with the placeable oil plant—a placeable production factory inside the game that will be loaded from the mod itself. The i3D-files go by name, where some may be treated as children: oilPlantUS.i3d – parent oilPlantUSProps.i3d – children oilPlantUSSign.i3d – children Then we have .shapes-files (that we don’t edit or open since they don’t contain XML data). After that, you’ll find texture files ending with PNG/DDS (.png/.dds): oilPlantUS_diffuse.dds – the visual texture itself in colours. oilPlantUS_height.dds – grayscale layer where one pixel represents its height (relative to its surface). oilPlantUS_mask.dds – to be considered a layer mask related to in-game seasons. oilPlantUS_normal.dds – normal layer usually does somewhat the same as _height. oilPlantUS_specular.dds – specular layer representing the reflection/lighting from the surface. Some of these textures will have all five (diffuse, height, mask, normal, and specular), and some will not. The mask depends on whether the placeable object is an outdoor or indoor object (e.g., a garage or an interior chair). Rooftops of a building will very likely have a mask layer, and so on.The dimensions of these textures are 2048 x 2048 and 1024 x 4096 pixels.As you probably know, 1024 pixels will be multiplied by 2: 1024 x 2 = 2048 (square, 1024 width, 1024 height) 2048 x 2 = 4096 (square, 2048 width, 2048 height) 2048 x 2048 pixels is considered square, and 1024 x 4096 pixels are considered rectangular. This can come in handy when scaling textures. 7. Placeable Oil Plant (Vanilla US Placeable) Per say everything works when the family is united… That’s a simple quote for this chapter since we are now going to explore one of the most critical things that can cause errors and warnings related to a mod map. I have been struggling with this ‘family’ as well, since they are so uniquely connected.The unique thing about this family is the relationship between each family member. Let’s start with each member’s name: modDesc.xml placeables.xml – found in ‘maps/mapEU/config’ mapEU.xml – parent XML file storeItems.xml – found in ‘maps/mapEU/config’ 7.1 Modding mapEU.xml for correct file path to storeItems.xml First make sure that mapEU.xml is pointing to our storeItems and not $data. Line number 17 in mapEU.xml will then say: XML<storeItems filename="maps/mapEU/config/storeItems.xml" /><storeItems filename="maps/mapEU/config/storeItems.xml" /> It is using the full file path to storeItems.xml from the root folder called ‘maps’. When GIANTS Editor generates a map for you, it will use the $data file path instead. So when your placeables isn’t showing up, please check line 17 in mapEU.xml with the beginning tag storeItems. If your parent XML file uses other names like map.xml for example, then you know where to look. 7.2 Modding placeables.xml to use placeable from the mod’s file folders When you’re done editing your mod map’s parent XML file, navigate to maps/mapEU/config and open placeables.xml.Please go to line 85 where it says: XML<!-- US productionPoint --> <placeable filename="$mapdir$/maps/mapEU/placeables/oilPlantUS.xml" position="-127.3 56.0 596.1" rotation="-180 -0.16 -180.0" canBeDeletedOverwrite="false"> <customImage filename="$mapdir$/maps/mapEU/placeables/mapIcon_oilPlantUS.png"/> </placeable><!-- US productionPoint --> <placeable filename="$mapdir$/maps/mapEU/placeables/oilPlantUS.xml" position="-127.3 56.0 596.1" rotation="-180 -0.16 -180.0" canBeDeletedOverwrite="false"> <customImage filename="$mapdir$/maps/mapEU/placeables/mapIcon_oilPlantUS.png"/> </placeable> This is where everything changes drastically. It’s no drama really, but take a look at what the filename says: XML$mapdir$/maps/mapEU/placeables/oilPlantUS.xml$mapdir$/maps/mapEU/placeables/oilPlantUS.xml This (dollarsign)mapdir(dollarsign) – is a specific tag that tells the GIANTS engine to read the file path differently because most file paths in a mod usually consist of folder/directory names and the filename with its ending filetype (.xml.) The “written thumb rule” is that modified placeables that are content of the modded map and not $data-placeables MUST use $mapdir$ for the file path. You will likely extract content from vanilla placeables and modify these for your mod. Just so you know, you will do that ONLY if you change the content inside the placeable’s files, which are the I3D file, textures and the XML file of the placeable. The thing about the oil plant is that I have modified its production data inside oilPlantUS.xml – since this is a production point as well as a selling point. It means that the player can use the oil plant to produce new products inside Farming Simulator 2025 after buying this oil plant. When the player doesn’t own the facility, it’s treated as a selling point: Okey.. Other things that follows the filename is: XMLposition="-127.3 56.0 596.1" rotation="-180 -0.16 -180.0"position="-127.3 56.0 596.1" rotation="-180 -0.16 -180.0" This is where the oil plant screams: Here I AM!This is a geographical 3D (XYZ) location on the map. In other words, where on the terrain surface of the map will the placeable show up? Answer: position=”-127.3 56.0 596.1″ – XYZ coordinates.The rotation is the same: -180 degrees around the X-axis, -0.16 degrees around the Y-axis and so on.The next line that follows is this one: XML <customImage filename="$mapdir$/maps/mapEU/placeables/mapIcon_oilPlantUS.png"/> <customImage filename="$mapdir$/maps/mapEU/placeables/mapIcon_oilPlantUS.png"/> The mapIcon is also using $mapdir$. The map icon itself looks like this: This icon will also appear when you want to PLACE the Oil Mill inside the game while running the game. We will return the details of placeables.xml later on. Let’s go to the next one: 7.3 Modding modDesc.xml for terrain paint brushes (mod within mod store items) In some cases you will find store items inside this XML-file, like these lines: XML<storeItem xmlFilename="cultivatedBrush.xml" /> <storeItem xmlFilename="plowedBrush.xml" /> <storeItem xmlFilename="stubbleTillagedBrush.xml" /> <storeItem xmlFilename="ridgedBrush.xml" /><storeItem xmlFilename="cultivatedBrush.xml" /> <storeItem xmlFilename="plowedBrush.xml" /> <storeItem xmlFilename="stubbleTillagedBrush.xml" /> <storeItem xmlFilename="ridgedBrush.xml" /> These are the XML files from another mod, a so-called prefab made by a modder named eLp. It’s a mod within my mod, where this is a brush that can paint fields as cultivated fields. Since the xmlFilename points directly to the files themselves, it shows us that these files are at the same location as modDesc.xml. 7.4 Modding storeItems.xml for the oil mill In this XML file at line 18 the oil plant is listed: This filepath is using maps/mapEU/placeables and links to the parent XML-file of the placeable, that usually has the name oilPlantUS.xml such as oilPlantUS.i3d and so on. 8. Summary These filepaths are easy to mess up, since many beginners to modding doesn’t know about that special $mapdir$. It’s nowhere to be found in XML-files inside the main game folder, data (where the game’s EXE-file is located). That’s it for this chapter.I hope that this map showed you how a placeable was copied over to another Farming Simulator 25 map, between the mapUS and mapEU. Tagged:GIANTS Editori3DmapmodDescModHubmodsplaceableXMLZIP