### Handle Build Errors and Configuration Issues in Bash

Source: https://context7.com/rcav8tr/cs2-modding-instructions/llms.txt

Commands and instructions for diagnosing and resolving common build errors such as exceeding screenshot limits or missing Paradox account configuration files. These bash commands help developers troubleshoot build process failures by identifying root causes and providing remediation steps.

```bash
# Error: Too many screenshots (more than 10)
# Edit PublishConfiguration.csproj to add more Screenshot entries

# Error: Paradox account data file not found
# Create the file at: %LOCALAPPDATA%\Colossal Order\ParadoxAccount.txt
# Format: Username;AdditionalData
```

--------------------------------

### Generate Paradox Mods Publishing Configuration using MSBuild

Source: https://context7.com/rcav8tr/cs2-modding-instructions/llms.txt

Creates an XML configuration file for uploading mods to the Paradox Mods platform. This MSBuild target automatically processes screenshot files, reads changelog and readme content, and generates a complete publishing configuration with all necessary metadata for the Paradox publishing system. It requires importing 'PublishConfiguration.csproj' into your main project file.

```xml
<!-- In your main .csproj file -->
<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <AssemblyName>BetterEconomy</AssemblyName>
    <Version>1.0.5</Version>
    <Title>Better Economy Mod</Title>
    <Description>Enhances economic simulation with realistic mechanics</Description>
  </PropertyGroup>

  <Import Project="PublishConfiguration.csproj" />
</Project>
```

```text
# Directory structure for publishing assets
Properties/
  ├── Thumbnail.png (max 2.1MB)
  └── Screenshots/
      ├── screenshot1.png
      ├── screenshot2.png
      └── gameplay.png

# ReadMe.md (supports markdown subset)
# Better Economy Mod

This mod improves the economic simulation in Cities: Skylines II.

```

--------------------------------

### Configure Mod Publishing Metadata in XML

Source: https://context7.com/rcav8tr/cs2-modding-instructions/llms.txt

Define core mod publishing configuration including mod ID, display name, descriptions, version, and external links in the PublishConfiguration.xml file. This XML structure is auto-generated from MSBuild properties and contains all metadata required by the Paradox Mods platform for mod publication.

```xml
<Publish>
    <ModId Value="0" />
    <DisplayName Value="Better Economy Mod" />
    <ShortDescription Value="Enhances economic simulation with realistic mechanics" />
    <LongDescription>
# Better Economy Mod

This mod improves the economic simulation in Cities: Skylines II.

## Features
- Realistic tax calculations
- Dynamic demand modeling
- Enhanced budget controls
</LongDescription>
    <Thumbnail Value="Properties/Thumbnail.png" />
    <Screenshot Value="Properties\Screenshots\screenshot1.png" />
    <Screenshot Value="Properties\Screenshots\screenshot2.png" />
    <Screenshot Value="Properties\Screenshots\gameplay.png" />
    <Tag Value="Code Mod" />
    <ModVersion Value="1.0.5" />
    <GameVersion Value="1.*" />
    <Dependency Id="" />
    <RequiredDLC Value="" />
    <ChangeLog>
## Version 1.0.5
- Fixed tax calculation bug
- Improved performance

## Version 1.0.0
- Initial release
</ChangeLog>
    <ExternalLink Type="github" Url="https://github.com/YourUsername/CS2Mod-BetterEconomy" />
</Publish>
```

--------------------------------

### Generate mod.json Configuration using MSBuild

Source: https://context7.com/rcav8tr/cs2-modding-instructions/llms.txt

Generates the 'mod.json' file essential for Cities: Skylines II to load mods. This build target reads the Paradox account username from a local text file and combines it with project properties to create the JSON configuration. Dependencies can be manually added to the generated file or by extending the build target.

```xml
<!-- In your main .csproj file -->
<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <AssemblyName>TrafficManager</AssemblyName>
    <Version>2.1.0</Version>
    <PDXAccountDataPath>$(LocalAppData)\Colossal Order\ParadoxAccount.txt</PDXAccountDataPath>
  </PropertyGroup>

  <Import Project="mod.json.csproj" />
</Project>
```

```text
# Contents of ParadoxAccount.txt (semicolon-separated format)
YourUsername;YourEmailOrOtherData
```

```json
// Generated file at UI/mod.json
{
    "id": "TrafficManager",
    "author": "YourUsername",
    "version": "2.1.0",
    "dependencies": []
}
```

```json
// The game automatically reads this file when loading mods
// To add dependencies, manually edit the generated file or extend the build target:
{
    "id": "TrafficManager",
    "author": "YourUsername",
    "version": "2.1.0",
    "dependencies": ["SomeOtherModId", "AnotherDependency"]
}
```

--------------------------------

### Extend Screenshot Support in MSBuild Configuration

Source: https://context7.com/rcav8tr/cs2-modding-instructions/llms.txt

Add additional Screenshot entries beyond the default limit in PublishConfiguration.csproj and update error conditions to allow more screenshot files. This configuration demonstrates how to extend the template to support more than 10 screenshots by adding new conditional screenshot entries and adjusting validation error thresholds.

```xml
<Screenshot11 Condition="$(ScreenShotFileCount) >= 11">
    %3CScreenshot Value=%22$([System.String]::Copy($(ScreenShotFileList)).Split(';')[10])%22 /%3E%0D%0A
</Screenshot11>

<Error Condition="$(ScreenShotFileCount) >= 12" Code="PC0001"
    Text="Error adding screenshots -- Too many screenshot files. Edit PublishConfiguration.csproj." />
```

--------------------------------

### Define Mod Dependencies and DLC Requirements in XML

Source: https://context7.com/rcav8tr/cs2-modding-instructions/llms.txt

Configure required mod dependencies and DLC requirements within the GeneratedText section of PublishConfiguration.csproj. This XML configuration specifies which mods and DLC expansions are required for the mod to function. Multiple dependencies and DLC values can be added as separate entries.

```xml
<Dependency Id="RequiredModId123" />
<Dependency Id="AnotherDependency456" />
<RequiredDLC Value="Beach Properties" />
<RequiredDLC Value="Modern Architecture" />
```

--------------------------------

### Generate Assembly Information in C# using MSBuild

Source: https://context7.com/rcav8tr/cs2-modding-instructions/llms.txt

Automatically creates a C# class with assembly metadata (name, version, title, description) as constant strings. This generated class is derived from properties defined in the main .csproj file and can be used to programmatically access mod metadata at runtime. It requires importing 'ModAssemblyInfo.csproj' into your main project file.

```xml
<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <AssemblyName>MyAwesomeMod</AssemblyName>
    <Version>1.2.3</Version>
    <Title>My Awesome CS2 Mod</Title>
    <Description>Adds amazing new features to Cities: Skylines II</Description>
  </PropertyGroup>

  <Import Project="ModAssemblyInfo.csproj" />
</Project>
```

```csharp
// Generated file at ModAssemblyInfo/ModAssemblyInfo.cs
// DO NOT MODIFY THIS FILE.
// This entire file was automatically generated by ModAssemblyInfo.csproj.

namespace MyAwesomeMod
{
    /// <summary>
    /// Make assembly info available as constant strings.
    /// </summary>
    public class ModAssemblyInfo
    {
        public const string Name        = "MyAwesomeMod";
        public const string Version     = "1.2.3";
        public const string Title       = "My Awesome CS2 Mod";
        public const string Description = "Adds amazing new features to Cities: Skylines II";
    }
}
```

```csharp
// Usage in your mod code
using MyAwesomeMod;

public class ModInitializer
{
    public void Initialize()
    {
        Console.WriteLine($"Loading {ModAssemblyInfo.Title} v{ModAssemblyInfo.Version}");
        Console.WriteLine($"Description: {ModAssemblyInfo.Description}");
    }
}
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.