3 Commits
4 changed files with 200 additions and 33 deletions

No files matched your search

+137 -28
View File
@@ -1,97 +1,206 @@
# Rifle Scope \# Rifle Scope
A stronger rifle scope for Sons of the Forest. Aiming down the rifle scope zooms A stronger rifle scope for Sons of the Forest. Aiming down the rifle scope zooms
5x further than the vanilla scope and shows a full screen scope view with a 5x further than the vanilla scope and shows a full screen scope view with a
crosshair reticle, mil dots and a rangefinder instead of the red dot. crosshair reticle, mil dots and a rangefinder instead of the red dot.
## Multiplayer
\## Multiplayer
Client side only. Nothing gets installed on a dedicated server, and other players Client side only. Nothing gets installed on a dedicated server, and other players
do not need the mod. do not need the mod.
## Installation
### Easy install
\## Installation
\### Easy install
Close the game, open PowerShell and paste: Close the game, open PowerShell and paste:
```powershell ```powershell
irm https://raw.githubusercontent.com/JustinOros/sotf-riflescope/main/Install.ps1 | iex irm https://raw.githubusercontent.com/JustinOros/sotf-riflescope/main/Install.ps1 | iex
``` ```
It finds your game, installs RedLoader if needed, and installs the latest It finds your game, installs RedLoader if needed, and installs the latest
RifleScope. Run it again any time to update. RifleScope. Run it again any time to update.
### Manual install
#### Step 1: Install RedLoader
[RedLoader](https://github.com/ToniMacaroni/RedLoader/releases/latest) is the mod \### Manual install
\#### Step 1: Install RedLoader
\[RedLoader](https://github.com/ToniMacaroni/RedLoader/releases/latest) is the mod
loader for Sons of the Forest. The game cannot load any mod without it, so loader for Sons of the Forest. The game cannot load any mod without it, so
install it first. You only have to do this once. install it first. You only have to do this once.
1. Download `RedLoader.zip` from the
[latest RedLoader release](https://github.com/ToniMacaroni/RedLoader/releases/latest)
2. Extract it into your Sons of the Forest folder, the one containing
`SonsOfTheForest.exe`, usually
`C:\Program Files (x86)\Steam\steamapps\common\Sons Of The Forest`
3. Launch the game once and wait until you reach the main menu. The first launch
takes a few minutes while RedLoader processes the game files
4. Check that `MODS` appears on the main menu, then quit
#### Step 2: Install RifleScope
1. Download `RifleScope.zip` from the 1\. Download `RedLoader.zip` from the
[latest release](https://github.com/JustinOros/sotf-riflescope/releases/latest)
2. Extract it into the `Mods` folder inside your game folder   \[latest RedLoader release](https://github.com/ToniMacaroni/RedLoader/releases/latest)
3. You should end up with:
2\. Extract it into your Sons of the Forest folder, the one containing
  `SonsOfTheForest.exe`, usually
  `C:\\Program Files (x86)\\Steam\\steamapps\\common\\Sons Of The Forest`
3\. Launch the game once and wait until you reach the main menu. The first launch
  takes a few minutes while RedLoader processes the game files
4\. Check that `MODS` appears on the main menu, then quit
\#### Step 2: Install RifleScope
1\. Download `RifleScope.zip` from the
  \[latest release](https://github.com/JustinOros/sotf-riflescope/releases/latest)
2\. Extract it into the `Mods` folder inside your game folder
3\. You should end up with:
``` ```
Mods\RifleScope.dll
Mods\RifleScope\manifest.json Mods\\RifleScope.dll
Mods\\RifleScope\\manifest.json
``` ```
## Usage
\## Usage
Equip the rifle and aim. Once zoomed in, the rifle model is hidden and the scope Equip the rifle and aim. Once zoomed in, the rifle model is hidden and the scope
view is shown. Your shot goes where the crosshair is. view is shown. Your shot goes where the crosshair is.
The red number at the bottom left of the scope is the range in meters to whatever The red number at the bottom left of the scope is the range in meters to whatever
is under the crosshair. is under the crosshair.
The reticle has 10 mil dots in each direction. At 5x each dot is 2 mils, which The reticle has 10 mil dots in each direction. At 5x each dot is 2 mils, which
covers 20 cm at 100 m. At 10x and higher each dot is 1 mil. Use them to hold over covers 20 cm at 100 m. At 10x and higher each dot is 1 mil. Use them to hold over
or to the side at long range. or to the side at long range.
Press F1 to open the console, then use these commands: Press F1 to open the console, then use these commands:
| Command | Action | | Command | Action |
| --- | --- | | --- | --- |
| `scope` | Show whether the mod is on or off |
| `scope off` | Turn the mod off and go back to the vanilla scope |
| `scope on` | Turn the mod back on |
| `scopezoom` | Show the current zoom | | `scopezoom` | Show the current zoom |
| `scopezoom 5` | Set the zoom as a multiple of the vanilla scope, 1 to 50. The default is 5 | | `scopezoom 5` | Set the zoom as a multiple of the vanilla scope, 1 to 50. The default is 5 |
| `scopetrim` | Show the current vertical trim | | `scopetrim` | Show the current vertical trim |
| `scopetrim 50` | Set the vertical trim, -200 to 200. Positive moves hits down, negative moves hits up. The default is 50 | | `scopetrim 50` | Set the vertical trim, -200 to 200. Positive moves hits down, negative moves hits up. The default is 50 |
| `scopewind` | Show the current windage | | `scopewind` | Show the current windage |
| `scopewind 20` | Set the windage, -200 to 200. Positive moves hits right, negative moves hits left. The default is 0 | | `scopewind 20` | Set the windage, -200 to 200. Positive moves hits right, negative moves hits left. The default is 0 |
| `scopedebug` | Toggle a debug readout above the range | | `scopedebug` | Toggle a debug readout above the range |
The zoom, trim and windage are saved to `UserData\RifleScope.txt` in your game
Trim and windage are angle adjustments, so a setting that is right at one range
stays right at every range.
The on or off setting, zoom, trim and windage are saved to `UserData\\RifleScope.txt` in your game
folder. Setting the zoom to 1 keeps vanilla zoom and the normal scope view, folder. Setting the zoom to 1 keeps vanilla zoom and the normal scope view,
without the red dot. without the red dot.
## Building from source
\## Building from source
Requires the .NET 8 SDK and RedLoader installed with its game assemblies Requires the .NET 8 SDK and RedLoader installed with its game assemblies
generated. generated.
```powershell ```powershell
.\build.ps1 -Install
.\\build.ps1 -Install
``` ```
Use `-Package` to build `RifleScope.zip` for a release. Pass `-GameDir "path"` if Use `-Package` to build `RifleScope.zip` for a release. Pass `-GameDir "path"` if
the game is not found automatically. the game is not found automatically.
## Troubleshooting
Check `_RedLoader\Latest.log` in your game folder. RifleScope logs a line when it
\## Troubleshooting
Check `\_RedLoader\\Latest.log` in your game folder. RifleScope logs a line when it
loads. loads.
+61 -3
View File
@@ -23,6 +23,7 @@ public class RifleScope : SonsMod
private const float DefaultTrimCm = 50f; private const float DefaultTrimCm = 50f;
private const float MaxTrimCm = 200f; private const float MaxTrimCm = 200f;
private const float MaxWindCm = 200f; private const float MaxWindCm = 200f;
private const float TrimReferenceRange = 50f;
private const int MilDotCount = 10; private const int MilDotCount = 10;
private const float MilDotSize = 0.4f; private const float MilDotSize = 0.4f;
private const float MinDotPx = 7f; private const float MinDotPx = 7f;
@@ -42,6 +43,8 @@ public class RifleScope : SonsMod
private static float _trimCm = DefaultTrimCm; private static float _trimCm = DefaultTrimCm;
private static float _windCm; private static float _windCm;
private static bool _debug; private static bool _debug;
private static bool _enabled = true;
private static readonly List<(Renderer Renderer, int Slot, Material Original)> RedDotSlots = new();
private static string _configPath; private static string _configPath;
private static RifleAnimatorController _rifle; private static RifleAnimatorController _rifle;
@@ -98,6 +101,9 @@ public class RifleScope : SonsMod
private static void Tick() private static void Tick()
{ {
if (!_enabled)
return;
if (!_rifle || !_rifle.gameObject.activeInHierarchy) if (!_rifle || !_rifle.gameObject.activeInHierarchy)
{ {
_rifle = null; _rifle = null;
@@ -196,8 +202,9 @@ public class RifleScope : SonsMod
} }
CenterPoint(cam, out var point); CenterPoint(cam, out var point);
point -= cam.transform.up * (_trimCm * 0.01f); var scale = Vector3.Distance(cam.transform.position, point) / TrimReferenceRange;
point += cam.transform.right * (_windCm * 0.01f); point -= cam.transform.up * (_trimCm * 0.01f * scale);
point += cam.transform.right * (_windCm * 0.01f * scale);
var dir = point - _projectile.position; var dir = point - _projectile.position;
if (dir.sqrMagnitude < 0.0001f) if (dir.sqrMagnitude < 0.0001f)
return; return;
@@ -267,6 +274,7 @@ public class RifleScope : SonsMod
var mat = mats[i]; var mat = mats[i];
if (!mat || HiddenIds.Contains(mat.GetInstanceID()) || !mat.shader || mat.shader.name != RedDotShader) if (!mat || HiddenIds.Contains(mat.GetInstanceID()) || !mat.shader || mat.shader.name != RedDotShader)
continue; continue;
RedDotSlots.Add((renderer, i, mat));
mats[i] = HiddenFor(mat); mats[i] = HiddenFor(mat);
changed = true; changed = true;
} }
@@ -275,6 +283,34 @@ public class RifleScope : SonsMod
} }
} }
private static void RestoreRedDot()
{
foreach (var (renderer, slot, original) in RedDotSlots)
{
if (!renderer || !original)
continue;
var mats = renderer.sharedMaterials;
if (slot >= mats.Length || !mats[slot] || !HiddenIds.Contains(mats[slot].GetInstanceID()))
continue;
mats[slot] = original;
renderer.sharedMaterials = mats;
}
RedDotSlots.Clear();
}
private static void Disable()
{
SetZoomed(false, null);
if (_rifle)
{
var settings = _rifle._fovChangeSettings;
if (settings != null && OriginalOffsets.TryGetValue(settings.Pointer, out var original))
settings._FieldOfViewTargetOffset_k__BackingField = original;
}
RestoreRedDot();
_rifle = null;
}
private static Material HiddenFor(Material original) private static Material HiddenFor(Material original)
{ {
var id = original.GetInstanceID(); var id = original.GetInstanceID();
@@ -632,6 +668,26 @@ public class RifleScope : SonsMod
return tex; return tex;
} }
[DebugCommand("scope")]
private static void ScopeCommand(string args)
{
args = (args ?? string.Empty).Trim().ToLowerInvariant();
if (args == "on" || args == "off")
{
_enabled = args == "on";
Save();
if (_enabled)
_rifle = null;
else
Disable();
Say($"RifleScope {(_enabled ? "on" : "off")}");
return;
}
Say($"RifleScope is {(_enabled ? "on" : "off")}. Usage: scope on or scope off");
}
[DebugCommand("scopezoom")] [DebugCommand("scopezoom")]
private static void ScopeZoomCommand(string args) private static void ScopeZoomCommand(string args)
{ {
@@ -732,6 +788,8 @@ public class RifleScope : SonsMod
_trimCm = trim; _trimCm = trim;
if (parts.Length > 2 && float.TryParse(parts[2], NumberStyles.Float, Inv, out var wind) && wind >= -MaxWindCm && wind <= MaxWindCm) if (parts.Length > 2 && float.TryParse(parts[2], NumberStyles.Float, Inv, out var wind) && wind >= -MaxWindCm && wind <= MaxWindCm)
_windCm = wind; _windCm = wind;
if (parts.Length > 3)
_enabled = parts[3] != "0";
} }
catch (Exception e) catch (Exception e)
{ {
@@ -743,7 +801,7 @@ public class RifleScope : SonsMod
{ {
try try
{ {
File.WriteAllText(_configPath, $"{_zoom.ToString(Inv)} {_trimCm.ToString(Inv)} {_windCm.ToString(Inv)}"); File.WriteAllText(_configPath, $"{_zoom.ToString(Inv)} {_trimCm.ToString(Inv)} {_windCm.ToString(Inv)} {(_enabled ? "1" : "0")}");
} }
catch (Exception e) catch (Exception e)
{ {
+1 -1
View File
@@ -6,7 +6,7 @@
<LangVersion>latest</LangVersion> <LangVersion>latest</LangVersion>
<AssemblyName>RifleScope</AssemblyName> <AssemblyName>RifleScope</AssemblyName>
<RootNamespace>RifleScope</RootNamespace> <RootNamespace>RifleScope</RootNamespace>
<Version>1.0.0</Version> <Version>1.0.1</Version>
<NoWarn>CS0436;CS1701;CS1702;MSB3277;MSB3106</NoWarn> <NoWarn>CS0436;CS1701;CS1702;MSB3277;MSB3106</NoWarn>
</PropertyGroup> </PropertyGroup>
+1 -1
View File
@@ -3,7 +3,7 @@
"id": "RifleScope", "id": "RifleScope",
"name": "RifleScope", "name": "RifleScope",
"author": "JustinOros", "author": "JustinOros",
"version": "1.0.0", "version": "1.0.1",
"description": "Stronger rifle scope magnification and a crosshair reticle", "description": "Stronger rifle scope magnification and a crosshair reticle",
"gameVersion": "1.0.0", "gameVersion": "1.0.0",
"platform": "Client", "platform": "Client",