Initial commit: HSPosition plugin and plugin-repo for Gitea

Made-with: Cursor
2026-02-26 22:31:19 -06:00
commit 7987076b60
12 changed files with 546 additions and 0 deletions
@@ -0,0 +1,36 @@
+# HSPosition
+
+A Dalamud plugin for FFXIV that draws a **colored ground ring** under your current target.
+
+**Publishing to your own repo:** See the `plugin-repo/` folder for a single-repo setup (pluginmaster + README) you can push to Gitea so others can add one URL and get all your plugins. The color reflects your positional:
+
+- **Green** = Front  
+- **Amber** = Flank  
+- **Red** = Rear  
+
+So you can see at a glance whether you need to move for positional abilities.
+
+## Build
+
+- .NET 10 SDK and Dalamud dev install (e.g. XIVLauncher with Dalamud, run game once).
+- Build: `dotnet build HSPosition.sln -c Debug` (or Release).
+- Output: `HSPosition/bin/x64/Debug/` (or `Release/`).
+
+## Install (dev)
+
+1. **xlsettings** → Experimental → add the full path to `HSPosition.dll` to **Dev Plugin Locations**.
+2. **xlplugins** → Dev Tools → Installed Dev Plugins → enable **HSPosition**.
+
+## Usage
+
+- Target something; a ring appears under it. Color = your current positional (front/flank/rear).
+- **/hspos** — open configure menu (or use the **Configure** button on the plugin in the installer).
+- Configure: enable/disable, ring radius, line thickness, segments, angle offset/invert, and colors for front/flank/rear.
+
+## Positional angles
+
+- **Front**: ±45° in front of the target.  
+- **Flank**: 45°–135° to the left or right.  
+- **Rear**: 135°–180° behind the target.
+
+Matches FFXIV’s usual ~90° cones for positionals.