RESONANCE TRACKER

Locate other players in real-time on the Vintage Story map at any distance. Fully customizable with an interactive color picker and built with server performance in mind.

Entity Tracking Bypass

• Minimal Data Footprint: Instead of syncing the entire entity structure, the server gathers only three coordinates (X, Y, Z) and a rotation angle (Yaw) of active players.
• Broadcasting Tick Rate: Runs a dedicated server tick listener. Admins can adjust this interval (e.g., set to 1000ms or 2000ms) to scale networking to their hardware capacity.
• Cairo Surface Rendering: The client mod renders the player markers into custom textures using Cairo on a separate map layer. This avoids heavy constant translation tasks on the main rendering pipeline.

1. In-Game settings (GUI)

Type .resonance gui (client-side) or /resonance gui (server-side) to open the configuration panel:

• Visual Color Pickers: Click "Edit" next to Fill or Border colors to open a full H/S/V slider block and fine-tune your marker colors or type your favorite Hex codes.
• Real-time Preview: The dialog features a real-time rendering preview of the player icon as you choose colors before saving.
• Server Controls (Admins only): Expandable panel to configure Update Rate in milliseconds and toggle Hide Sneaking (players who are crouching are hidden from the map for stealth gameplay).

2. JSON Config Files

Configurations are saved in the standard ModConfig/ folder of your Vintage Story directory:

{
  "OwnFillColorHex": "#FFFFFF",
  "OwnBorderColorHex": "#000000",
  "OtherFillColorHex": "#C0C0C0",
  "OtherBorderColorHex": "#4D4D4D"
}

{
  "UpdateIntervalMs": 1000,
  "HideCrouchingPlayers": false
}

A Note on Mod Development

Some of the code in this mod was written with the help of AI tools, but this is far from a "vibe-coded" project. As a developer, I have invested hours of my own life orchestrating, analyzing, and directing this implementation. Every line of code, recipe modification, and asset patch was carefully designed, verified, and heavily tested in-game to meet the high standards of how this mod should look, feel, and behave.

This process has been an incredible learning experience for me. I am constantly diving deep into Vintage Story's modding patterns, and I am completely open to feedback! If you are a more experienced developer, please feel free to inspect the codebase directly on GitHub and suggest improvements or best practices.