HandyS11
diff --git a/‎.editorconfig‎
Lines changed: 1 addition & 0 deletions b/‎.editorconfig‎
Lines changed: 1 addition & 0 deletions
diff --git a/‎Directory.Packages.props‎
Lines changed: 3 additions & 2 deletions b/‎Directory.Packages.props‎
Lines changed: 3 additions & 2 deletions
diff --git a/‎RustPlusBot.slnx‎
Lines changed: 1 addition & 0 deletions b/‎RustPlusBot.slnx‎
Lines changed: 1 addition & 0 deletions
diff --git a/‎src/RustPlusBot.Abstractions/Connections/IRustServerQuery.cs‎
Lines changed: 7 additions & 0 deletions b/‎src/RustPlusBot.Abstractions/Connections/IRustServerQuery.cs‎
Lines changed: 7 additions & 0 deletions
diff --git a/‎src/RustPlusBot.Abstractions/Connections/MapDimensions.cs‎
Lines changed: 6 additions & 5 deletions b/‎src/RustPlusBot.Abstractions/Connections/MapDimensions.cs‎
Lines changed: 6 additions & 5 deletions
diff --git a/‎src/RustPlusBot.Abstractions/Connections/MapGrid.cs‎
Lines changed: 77 additions & 0 deletions b/‎src/RustPlusBot.Abstractions/Connections/MapGrid.cs‎
Lines changed: 77 additions & 0 deletions
diff --git a/‎src/RustPlusBot.Abstractions/Connections/MapGridStyle.cs‎
Lines changed: 15 additions & 0 deletions b/‎src/RustPlusBot.Abstractions/Connections/MapGridStyle.cs‎
Lines changed: 15 additions & 0 deletions
diff --git a/‎src/RustPlusBot.Abstractions/Connections/MapMarkerSnapshot.cs‎
Lines changed: 10 additions & 1 deletion b/‎src/RustPlusBot.Abstractions/Connections/MapMarkerSnapshot.cs‎
Lines changed: 10 additions & 1 deletion
diff --git a/‎src/RustPlusBot.Abstractions/Connections/MonumentSnapshot.cs‎
Lines changed: 1 addition & 1 deletion b/‎src/RustPlusBot.Abstractions/Connections/MonumentSnapshot.cs‎
Lines changed: 1 addition & 1 deletion
diff --git a/‎src/RustPlusBot.Abstractions/Connections/WorldSnapshot.cs‎
Lines changed: 6 additions & 0 deletions b/‎src/RustPlusBot.Abstractions/Connections/WorldSnapshot.cs‎
Lines changed: 6 additions & 0 deletions
@@ -392,6 +392,7 @@ roslynator_compiler_diagnostic_fixes.enabled = true
 dotnet_diagnostic.CA1002.severity = none # Do not expose generic lists — API uses List<T> intentionally for protobuf collections
 dotnet_diagnostic.CA1008.severity = none # Enums should have zero value
 dotnet_diagnostic.CA1031.severity = none # Do not catch general exception types (intentional for fail-safe CLI resilience)
+dotnet_diagnostic.CA1054.severity = none # Uri parameters should not be strings — same call as CA1056 below; RustMaps URLs travel as plain strings end to end
 dotnet_diagnostic.CA1056.severity = none # Uri properties should not be strings
 dotnet_diagnostic.CA1303.severity = none # Do not pass literals as localized parameters (literal strings in console output — CLI tool not localized)
 dotnet_diagnostic.CA1308.severity = none # Normalize strings to uppercase
 
@@ -13,8 +13,9 @@
     <PackageVersion Include="Microsoft.Extensions.Hosting.Abstractions" Version="10.0.9" />
     <PackageVersion Include="Microsoft.Extensions.Logging.Abstractions" Version="10.0.9" />
     <PackageVersion Include="Persistord.Core" Version="1.0.0-beta.1" />
-    <PackageVersion Include="RustPlusApi" Version="2.0.0-beta.3" />
-    <PackageVersion Include="RustPlusApi.Fcm" Version="2.0.0-beta.3" />
+    <PackageVersion Include="RustMapsApi" Version="1.0.0-beta.2" />
+    <PackageVersion Include="RustPlusApi" Version="2.0.0-beta.4" />
+    <PackageVersion Include="RustPlusApi.Fcm" Version="2.0.0-beta.4" />
     <PackageVersion Include="Serilog.Extensions.Hosting" Version="10.0.0" />
     <PackageVersion Include="Serilog.Settings.Configuration" Version="10.0.1" />
     <PackageVersion Include="Serilog.Sinks.Console" Version="6.1.1" />
 
@@ -21,6 +21,7 @@
   </Folder>
   <Folder Name="/tools/">
     <Project Path="tools/RustPlusBot.ItemData.Generator/RustPlusBot.ItemData.Generator.csproj" />
+    <Project Path="tools/RustPlusBot.MapParity/RustPlusBot.MapParity.csproj" />
   </Folder>
   <Folder Name="/tests/">
     <Project Path="tests/RustPlusBot.Abstractions.Tests/RustPlusBot.Abstractions.Tests.csproj" />
 
@@ -46,6 +46,13 @@ public interface IRustServerQuery
     /// <returns>The map dimensions, or null when there is no live socket.</returns>
     Task<MapDimensions?> GetMapDimensionsAsync(ulong guildId, Guid serverId, CancellationToken cancellationToken);
 
+    /// <summary>Gets the world size and seed of a connected server, or null when unavailable.</summary>
+    /// <param name="guildId">The owning guild snowflake.</param>
+    /// <param name="serverId">The target server id.</param>
+    /// <param name="cancellationToken">A cancellation token.</param>
+    /// <returns>The world snapshot, or null.</returns>
+    Task<WorldSnapshot?> GetWorldAsync(ulong guildId, Guid serverId, CancellationToken cancellationToken);
+
     /// <summary>Gets the server's monuments, or an empty list when there is no live socket.</summary>
     /// <param name="guildId">The owning guild snowflake.</param>
     /// <param name="serverId">The target server id.</param>
 
@@ -1,7 +1,8 @@
 namespace RustPlusBot.Abstractions.Connections;
 
-/// <summary>The static-per-wipe map size needed to convert world coordinates to a grid reference.</summary>
-/// <param name="Width">Map image width.</param>
-/// <param name="Height">Map image height.</param>
-/// <param name="OceanMargin">The ocean margin around the playable area.</param>
-public sealed record MapDimensions(uint Width, uint Height, int OceanMargin);
+/// <summary>Dimensions of the server-rendered map tile plus the world size.</summary>
+/// <param name="Width">Width of the base map image, in pixels.</param>
+/// <param name="Height">Height of the base map image, in pixels.</param>
+/// <param name="OceanMargin">Ocean border baked into the base map image, in pixels.</param>
+/// <param name="WorldSize">Size of the playable world, in game units (from server info).</param>
+public sealed record MapDimensions(uint Width, uint Height, int OceanMargin, uint WorldSize);
@@ -0,0 +1,77 @@
+using System.Globalization;
+using System.Text;
+
+namespace RustPlusBot.Abstractions.Connections;
+
+/// <summary>
+/// Rust map grid math shared by the map renderer and grid-reference formatting.
+/// One cell is 146.25 game units; the grid is anchored at the world's NORTH-WEST corner
+/// (Rust / RustMaps / companion-app behaviour): columns are lettered west→east from A, rows are
+/// numbered north→south from 0, and the partial edge cell (when the world size is not a whole
+/// multiple of the cell size) sits along the south and east edges.
+/// </summary>
+public static class MapGrid
+{
+    /// <summary>Edge length of one (whole) grid cell, in game units.</summary>
+    public const float CellSize = 146.25f;
+
+    /// <summary>
+    /// How far south of the world's north edge the Rust+/RustMaps grid rows start, in game units.
+    /// Measured exactly (100.0) from RustMaps' own pre-rendered grid tiles across map sizes
+    /// 1500–4500; the in-game (F1) map uses no inset. Columns have no inset in either style.
+    /// </summary>
+    public const float RustPlusRowInset = 100f;
+
+    /// <summary>Gets the row inset (south of the world's north edge) for a grid style.</summary>
+    /// <param name="style">The grid style.</param>
+    /// <returns>The inset in game units.</returns>
+    public static float RowInset(MapGridStyle style) =>
+        style == MapGridStyle.RustPlus ? RustPlusRowInset : 0f;
+
+    /// <summary>
+    /// Number of grid cells per axis, covering the whole world size — <c>ceil(worldSize / CellSize)</c>.
+    /// The last cell (east-most column / south-most row) is a partial edge cell whenever the world size
+    /// is not a whole multiple of <see cref="CellSize"/>; it is still a labelled cell, matching how Rust,
+    /// the Rust+ companion app and RustMaps draw the grid. (A 1500 world → 11 cells: A–K, rows 0–10.)
+    /// </summary>
+    /// <param name="worldSize">The world size in game units.</param>
+    /// <returns>The cell count (at least 1).</returns>
+    public static int CellCount(uint worldSize)
+    {
+        var full = (int)(worldSize / CellSize);
+        var hasPartial = worldSize - (full * CellSize) > 0.5f;
+        return Math.Max(1, hasPartial ? full + 1 : full);
+    }
+
+    /// <summary>Formats a spreadsheet-style column label (0→A … 25→Z, 26→AA …).</summary>
+    /// <param name="index">The zero-based column index.</param>
+    /// <returns>The column letters.</returns>
+    public static string ColumnLetters(int index)
+    {
+        var sb = new StringBuilder();
+        var n = index;
+        do
+        {
+            sb.Insert(0, (char)('A' + (n % 26)));
+            n = (n / 26) - 1;
+        } while (n >= 0);
+
+        return sb.ToString();
+    }
+
+    /// <summary>Formats the grid label ("D7") for a world coordinate.</summary>
+    /// <param name="x">World X (west→east).</param>
+    /// <param name="y">World Y (south→north).</param>
+    /// <param name="worldSize">The world size in game units.</param>
+    /// <param name="style">Which grid convention to bin against (defaults to the in-game map).</param>
+    /// <returns>The grid label, rows numbered from the top; out-of-world coordinates clamp to the edge cell.</returns>
+    public static string LabelFor(float x, float y, uint worldSize, MapGridStyle style = MapGridStyle.InGame)
+    {
+        // Rows bin from the style's row anchor (north edge in-game; 100 units south of it for
+        // Rust+/RustMaps), not the south — with a partial edge cell the two directions disagree.
+        var cells = CellCount(worldSize);
+        var col = Math.Clamp((int)MathF.Floor(x / CellSize), 0, cells - 1);
+        var row = Math.Clamp((int)MathF.Floor((worldSize - RowInset(style) - y) / CellSize), 0, cells - 1);
+        return string.Create(CultureInfo.InvariantCulture, $"{ColumnLetters(col)}{row}");
+    }
+}
@@ -0,0 +1,15 @@
+namespace RustPlusBot.Abstractions.Connections;
+
+/// <summary>
+/// Which map-grid convention to use. The in-game (F1) map and the Rust+ companion app / RustMaps
+/// website disagree on where grid ROWS sit: the in-game map anchors row 0 at the world's north edge,
+/// while Rust+/RustMaps draw the rows 100 game-units further south. Columns are identical in both.
+/// </summary>
+public enum MapGridStyle
+{
+    /// <summary>Match the in-game (F1) map — grid references read exactly like in-game callouts.</summary>
+    InGame = 0,
+
+    /// <summary>Match the Rust+ companion app and rustmaps.com — rows sit 100 game-units south of in-game.</summary>
+    RustPlus = 1,
+}
@@ -1,9 +1,18 @@
 namespace RustPlusBot.Abstractions.Connections;
 
+// Rotation defaults to null so existing call sites stay valid and "no heading" is distinguishable
+// from "heading north" once RustPlusApi beta.4 supplies values.
 /// <summary>One map marker observed in a <c>GetMapMarkers</c> poll.</summary>
 /// <param name="Id">The stable marker id (used to diff polls).</param>
 /// <param name="Kind">The classified marker kind.</param>
 /// <param name="X">World X coordinate.</param>
 /// <param name="Y">World Y coordinate.</param>
 /// <param name="Name">The marker name, if any.</param>
-public sealed record MapMarkerSnapshot(ulong Id, MarkerKind Kind, float X, float Y, string? Name);
+/// <param name="Rotation">Heading in degrees as sent by the server, or null when unavailable.</param>
+public sealed record MapMarkerSnapshot(
+    ulong Id,
+    MarkerKind Kind,
+    float X,
+    float Y,
+    string? Name,
+    float? Rotation = null);
@@ -1,7 +1,7 @@
 namespace RustPlusBot.Abstractions.Connections;
 
 /// <summary>One named monument observed in a <c>GetMap</c> response.</summary>
-/// <param name="Token">The monument token (e.g. <c>oilrig_1</c>, <c>large_oil_rig</c>).</param>
+/// <param name="Token">The monument token (e.g. <c>oil_rig_small</c>, <c>large_oil_rig</c>).</param>
 /// <param name="X">World X coordinate.</param>
 /// <param name="Y">World Y coordinate.</param>
 public sealed record MonumentSnapshot(string Token, float X, float Y);
@@ -0,0 +1,6 @@
+namespace RustPlusBot.Abstractions.Connections;
+
+/// <summary>The world identity of a connected server, used to resolve external map imagery.</summary>
+/// <param name="WorldSize">Size of the playable world, in game units.</param>
+/// <param name="Seed">Procedural map generation seed.</param>
+public sealed record WorldSnapshot(uint WorldSize, uint Seed);