RacesOfValheim/JotunnModStub/RacesOfValheim.csproj
kanym 73b67cd6ce feat(text): the race menu reads its texts from translation files
First step of moving every piece of text out of the code so modders can
translate the mod. The texts live in Translations/<Language>/*.json, one
file per kind of text, which Jotunn finds on its own and falls back to
English for. ModText reads them; values take Valheim's $1, $2 placeholders.

This step covers the race selection menu: title, buttons, every race's
name and description, in English and Italian. The race ID and the name on
screen are now separate strings. The ID is what the save and the ZDO hold,
so it must never be translated.

The files are deployed to plugins\RacesOfValheim\Translations and packed
into both release zips.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-26 19:43:48 +02:00

174 lines
12 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<OutputType>Library</OutputType>
<TargetFramework>net48</TargetFramework>
<RootNamespace>RacesOfValheim</RootNamespace>
<AssemblyName>RacesOfValheim</AssemblyName>
<FileAlignment>512</FileAlignment>
<Deterministic>true</Deterministic>
<LangVersion>10</LangVersion>
<GenerateAssemblyInfo>false</GenerateAssemblyInfo>
</PropertyGroup>
<PropertyGroup Condition=" '$(Configuration)' == 'Debug' ">
<DefineConstants>DEBUG;TRACE</DefineConstants>
<Optimize>false</Optimize>
<DebugSymbols>true</DebugSymbols>
<DebugType>full</DebugType>
<WarningLevel>4</WarningLevel>
<AllowUnsafeBlocks>false</AllowUnsafeBlocks>
</PropertyGroup>
<PropertyGroup Condition=" '$(Configuration)' == 'Release' ">
<Optimize>true</Optimize>
<DebugType>pdbonly</DebugType>
<WarningLevel>4</WarningLevel>
<AllowUnsafeBlocks>false</AllowUnsafeBlocks>
</PropertyGroup>
<ItemGroup>
<Reference Include="assembly_utils">
<HintPath>..\..\..\..\..\..\Program Files (x86)\Steam\steamapps\common\Valheim\valheim_Data\Managed\assembly_utils.dll</HintPath>
</Reference>
<Reference Include="assembly_valheim">
<HintPath>..\..\..\..\..\..\Program Files (x86)\Steam\steamapps\common\Valheim\valheim_Data\Managed\assembly_valheim.dll</HintPath>
</Reference>
<!-- ZoneSystem.ZoneLocation.m_prefab is a SoftReference<GameObject>, and touching any member of
it (Load/Asset/IsLoaded) does not compile unless the assembly that declares SoftReference<T>
is referenced. Nothing in the mod uses it right now - the hidden hollow that needed it is
gone - but the build's Copy step below still ships the dll, so the reference stays. -->
<Reference Include="SoftReferenceableAssets">
<HintPath>..\..\..\..\..\..\Program Files (x86)\Steam\steamapps\common\Valheim\valheim_Data\Managed\SoftReferenceableAssets.dll</HintPath>
</Reference>
<!-- Jotunn 2.29.2 references a Unity module this build of Valheim no longer ships, and the
unresolvable reference warned on every build. Nothing here uses it. -->
<Reference Remove="UnityEngine.ProfilerModule" />
<Reference Include="System" />
<Reference Include="System.Core" />
<Reference Include="System.Xml.Linq" />
<Reference Include="System.Data.DataSetExtensions" />
<Reference Include="Microsoft.CSharp" />
<Reference Include="System.Data" />
<Reference Include="System.Xml" />
</ItemGroup>
<ItemGroup>
<None Include="app.config" />
<None Include="packages.config" />
<None Include="README.md" />
</ItemGroup>
<ItemGroup>
<PackageReference Include="BepInEx.Core" Version="5.4.21" />
<PackageReference Include="JotunnLib" Version="2.29.2" />
<!-- net48 reference assemblies as a NuGet package, so the plain .NET SDK can build this
without a Visual Studio install supplying the targeting pack. Build-time only: it
contributes nothing to the shipped DLL. -->
<PackageReference Include="Microsoft.NETFramework.ReferenceAssemblies" Version="1.0.3" PrivateAssets="all" />
</ItemGroup>
<PropertyGroup>
<!-- Both of these came from machine-level environment variables, which a fresh clone (or a
fresh PC) does not have: VALHEIM_INSTALL expanded to nothing, so every path built from
it started at the drive root and the build died on the first Copy. Default them to the
standard Steam install, and leave the environment variables able to override for anyone
who keeps Valheim somewhere else. -->
<VALHEIM_INSTALL Condition="'$(VALHEIM_INSTALL)' == ''">C:\Program Files (x86)\Steam\steamapps\common\Valheim</VALHEIM_INSTALL>
<BEPINEX_PATH Condition="'$(BEPINEX_PATH)' == ''">$(VALHEIM_INSTALL)\BepInEx</BEPINEX_PATH>
<VALHEIM_MANAGED>$(VALHEIM_INSTALL)/valheim_Data/Managed</VALHEIM_MANAGED>
<!-- Jotunn publicizes the game assemblies into valheim_Data\Managed\publicized_assemblies and
then references them. It reads this flag out of DoPrebuild.props, which its Paths.props
imports through $(SolutionDir) - undefined on a plain `dotnet build` of this project, so
the flag never arrived, the publicizer never ran, and every build warned about ten
references it could not resolve. Run it exactly when its output is missing: once on a
fresh machine, never again, and -p:ExecutePrebuild=true still forces it after a game
update. -->
<ExecutePrebuild Condition="!Exists('$(VALHEIM_MANAGED)/publicized_assemblies/assembly_valheim_publicized.dll')">true</ExecutePrebuild>
<!-- The one place the built mod is deployed. -->
<PLUGINS_PATH>$(BEPINEX_PATH)\plugins</PLUGINS_PATH>
<!-- SolutionDir is only defined when msbuild is handed a .sln, so it expanded to
"*Undefined*" and broke the packaging target on a plain `dotnet build` of this
project. The repo root is always one level above the project. -->
<REPO_ROOT>$(ProjectDir)..\</REPO_ROOT>
<UNITY_FOLDER>$(REPO_ROOT)JotunnModStubUnity</UNITY_FOLDER>
<!-- The Unity stub project only matters when authoring assets in the editor, and its copy
step rewrites a folder full of game assemblies on every single build. Opt in with
-p:CopyAssembliesToUnity=true when you actually need it. -->
<CopyAssembliesToUnity Condition="'$(CopyAssembliesToUnity)' == ''">false</CopyAssembliesToUnity>
</PropertyGroup>
<Target Name="CopyToUnity">
<Message Text="Copy assemblies to Unity" Importance="high" />
<Copy SourceFiles="$(BEPINEX_PATH)/core/BepInEx.dll" DestinationFolder="$(UNITY_FOLDER)/Assets/Assemblies" />
<Copy SourceFiles="$(BEPINEX_PATH)/core/0Harmony.dll" DestinationFolder="$(UNITY_FOLDER)/Assets/Assemblies" />
<Copy SourceFiles="$(BEPINEX_PATH)/core/Mono.Cecil.dll" DestinationFolder="$(UNITY_FOLDER)/Assets/Assemblies" />
<Copy SourceFiles="$(BEPINEX_PATH)/core/MonoMod.Utils.dll" DestinationFolder="$(UNITY_FOLDER)/Assets/Assemblies" />
<Copy SourceFiles="$(BEPINEX_PATH)/core/MonoMod.RuntimeDetour.dll" DestinationFolder="$(UNITY_FOLDER)/Assets/Assemblies" />
<Copy SourceFiles="$(TargetDir)Jotunn.dll" DestinationFolder="$(UNITY_FOLDER)/Assets/Assemblies" />
<Copy SourceFiles="$(TargetDir)$(TargetName).dll" DestinationFolder="$(UNITY_FOLDER)/Assets/Assemblies" />
<Copy SourceFiles="$(TargetDir)$(TargetName).pdb" DestinationFolder="$(UNITY_FOLDER)/Assets/Assemblies" />
<!-- mdb generation doesn't work from portable pdbs, which are the only kind supported under Linux -->
<Copy Condition="Exists('$(TargetDir)$(TargetName).dll.mdb')" SourceFiles="$(TargetDir)$(TargetName).dll.mdb" DestinationFolder="$(UNITY_FOLDER)/Assets/Assemblies" />
<Copy SourceFiles="$(VALHEIM_MANAGED)/Assembly-CSharp.dll" DestinationFolder="$(UNITY_FOLDER)/Assets/Assemblies" />
<Copy SourceFiles="$(VALHEIM_MANAGED)/assembly_valheim.dll" DestinationFolder="$(UNITY_FOLDER)/Assets/Assemblies" />
<Copy SourceFiles="$(VALHEIM_MANAGED)/assembly_utils.dll" DestinationFolder="$(UNITY_FOLDER)/Assets/Assemblies" />
<Copy SourceFiles="$(VALHEIM_MANAGED)/assembly_postprocessing.dll" DestinationFolder="$(UNITY_FOLDER)/Assets/Assemblies" />
<Copy SourceFiles="$(VALHEIM_MANAGED)/assembly_sunshafts.dll" DestinationFolder="$(UNITY_FOLDER)/Assets/Assemblies" />
<Copy SourceFiles="$(VALHEIM_MANAGED)/assembly_guiutils.dll" DestinationFolder="$(UNITY_FOLDER)/Assets/Assemblies" />
<Copy SourceFiles="$(VALHEIM_MANAGED)/assembly_lux.dll" DestinationFolder="$(UNITY_FOLDER)/Assets/Assemblies" />
<Copy SourceFiles="$(VALHEIM_MANAGED)/assembly_simplemeshcombine.dll" DestinationFolder="$(UNITY_FOLDER)/Assets/Assemblies" />
<Copy SourceFiles="$(VALHEIM_MANAGED)/assembly_googleanalytics.dll" DestinationFolder="$(UNITY_FOLDER)/Assets/Assemblies" />
<Copy SourceFiles="$(VALHEIM_MANAGED)/PlayFab.dll" DestinationFolder="$(UNITY_FOLDER)/Assets/Assemblies" />
<Copy SourceFiles="$(VALHEIM_MANAGED)/PlayFabParty.dll" DestinationFolder="$(UNITY_FOLDER)/Assets/Assemblies" />
<Copy SourceFiles="$(VALHEIM_MANAGED)/Splatform.dll" DestinationFolder="$(UNITY_FOLDER)/Assets/Assemblies" />
<Copy SourceFiles="$(VALHEIM_MANAGED)/Splatform.Steam.dll" DestinationFolder="$(UNITY_FOLDER)/Assets/Assemblies" />
<Copy SourceFiles="$(VALHEIM_MANAGED)/gui_framework.dll" DestinationFolder="$(UNITY_FOLDER)/Assets/Assemblies" />
<Copy SourceFiles="$(VALHEIM_MANAGED)/com.rlabrecque.steamworks.net.dll" DestinationFolder="$(UNITY_FOLDER)/Assets/Assemblies" />
<Copy SourceFiles="$(VALHEIM_MANAGED)/SoftReferenceableAssets.dll" DestinationFolder="$(UNITY_FOLDER)/Assets/Assemblies" />
</Target>
<Target Name="JotunnPostBuildTask" AfterTargets="Build">
<CallTarget Targets="CopyToUnity" Condition="'$(CopyAssembliesToUnity)' == 'true' And Exists('$(UNITY_FOLDER)')" />
</Target>
<!-- The mod's only deployment target: BepInEx\plugins. Runs for Debug as well as Release, so
the build-and-launch loop needs no second step. -->
<Target Name="DeployToValheim" AfterTargets="Build">
<Warning Text="BepInEx plugins folder not found at $(PLUGINS_PATH) - the DLL was built but not deployed." Condition="!Exists('$(PLUGINS_PATH)')" />
<Message Text="Deploying $(TargetName).dll to $(PLUGINS_PATH)" Importance="high" Condition="Exists('$(PLUGINS_PATH)')" />
<Copy SourceFiles="$(TargetDir)$(TargetName).dll" DestinationFolder="$(PLUGINS_PATH)\" Condition="Exists('$(PLUGINS_PATH)')" />
<!-- The texts. Jotunn finds any Translations\<Language>\*.json anywhere under plugins, so
they go in a folder of the mod's own rather than a bare plugins\Translations another mod
could be writing into too. -->
<Copy SourceFiles="@(TranslationFile)" DestinationFiles="@(TranslationFile->'$(PLUGINS_PATH)\RacesOfValheim\Translations\%(RecursiveDir)%(Filename)%(Extension)')" Condition="Exists('$(PLUGINS_PATH)')" />
</Target>
<ItemGroup>
<TranslationFile Include="$(ProjectDir)Translations\**\*.json" />
</ItemGroup>
<Target Name="PackageThunderstore" AfterTargets="Build" Condition="'$(Configuration)'=='Release'">
<PropertyGroup>
<PackageOutputDir>$(REPO_ROOT)dist\</PackageOutputDir>
</PropertyGroup>
<MakeDir Directories="$(PackageOutputDir)" Condition="!Exists('$(PackageOutputDir)')" />
<!-- Nexus users unzip straight into plugins, so the texts travel inside a RacesOfValheim
folder there; Thunderstore already gives every package a folder of its own. -->
<PropertyGroup>
<NexusStaging>$(IntermediateOutputPath)nexus\</NexusStaging>
</PropertyGroup>
<RemoveDir Directories="$(NexusStaging)" />
<Copy SourceFiles="@(TranslationFile)" DestinationFiles="@(TranslationFile->'$(NexusStaging)RacesOfValheim\Translations\%(RecursiveDir)%(Filename)%(Extension)')" />
<Message Text="Packaging Thunderstore and Nexus zips into $(PackageOutputDir)" Importance="high" />
<!-- The version is read back out of manifest.json rather than duplicated here, so
manifest.json stays the single place a release is numbered. Written with string
concatenation because MSBuild would eat a PowerShell $(...) subexpression. -->
<Exec Command="powershell -NoProfile -Command &quot;$v = (Get-Content '$(ProjectDir)..\manifest.json' -Raw | ConvertFrom-Json).version_number; Compress-Archive -Path '$(TargetDir)$(TargetName).dll', '$(ProjectDir)..\manifest.json', '$(ProjectDir)..\README.md', '$(ProjectDir)Package\icon.png', '$(ProjectDir)Translations' -DestinationPath ('$(PackageOutputDir)RacesOfValheim_Thunderstore_' + $v + '.zip') -Force; Compress-Archive -Path '$(TargetDir)$(TargetName).dll', '$(NexusStaging)RacesOfValheim' -DestinationPath ('$(PackageOutputDir)RacesOfValheim_Nexus_' + $v + '.zip') -Force&quot;" />
</Target>
<Target Name="JotunnPostBuildTaskUnix" AfterTargets="Build" Condition=" '$(OS)' == 'Unix' ">
<Exec Command="sh &quot;$(SolutionDir)scripts/publish.sh&quot; --target &quot;$(ConfigurationName)&quot; --target-path &quot;$(TargetDir)&quot; --target-assembly &quot;$(TargetFileName)&quot; --valheim-path &quot;$(VALHEIM_INSTALL)&quot; --deploy-path &quot;$(MOD_DEPLOYPATH)&quot; --project-path &quot;$(ProjectDir)&quot;" />
</Target>
</Project>