Zoltons Auspecs

Zolton's Auspecs - Arma Reforger Real-Time Map App
Live player positions, kill feed, and mission tracking on your phone!
📱 Download the App
Android: https://drive.google.com/file/d/12fXl4sg8toQSocQrBuuKJ1BMZ2NzMirb/view?usp=sharing
iOS: Coming Soon! 🍎
🚀 Quick Setup Guide
For Server Owners
Step 1: Install the Mod
Download ZoltonsAuspecs mod.
Add to your server's addons folder and addon.gproj dependencies.
Step 2: Set Up the Relay Server
The relay server bridges game data to phone apps.
Option A: Pre-built Relay Server (Recommended)
Download: https://drive.google.com/file/d/1_N1G_hEj0TM9M-mMUn8Rv38ZkTmJgZyZ/view?usp=sharing
Extract and run start-relay.bat (Windows) or ./start-relay.sh (Linux). Port 2595 will open.
Option B: Build Your Own (Advanced)
Install Node.js, clone the repository, run npm install then npm start. Configure port and API key in .env.
Step 3: Configure the Mod
Open Workbench -> your scenario/game mode.
Add AuspecsGameModeComponent to the Game Mode entity.
Configure settings:
Relay URL: http://YOUR_SERVER_PUBLIC_IP:2595
API Key: Set a secure password.
Enable Features: Toggle data to track.
Save and export your scenario.
Step 4: Configure the Relay Server
Open the relay server's .env file.
Set AUSPECS_API_KEY to match Step 3 and PORT to 2595. Restart.
Step 5: Open Firewall Ports
Allow Port 2595 (TCP) for the relay and Port 7777 (UDP) for Arma Reforger.
Step 6: Connect the Phone App
Open the Android app.
Enter your Server Name, Relay URL (http://YOUR_SERVER_PUBLIC_IP:2595), and API key. Tap "Connect".
🔧 Configuration Options
Relay URL: Relay server link (Default: http://YOUR_SERVER_IP:2595)
API Key: Authentication key (Default: YOUR_SECRET_API_KEY_HERE)
Track Positions / Kills / Mission State: Broadcast game data (Default: Enabled)
Track Chat / AI: (Default: Disabled due to 1.7 compatibility)
Position / Mission Interval: Update frequencies (Default: 3.0 / 10.0 seconds)
Debug Logging: Print logs to server (Default: Disabled)
📊 What Gets Tracked
✅ Working (Arma Reforger 1.7)
Player Positions: Real-time map tracking.
AI Kill Tracking: Players killing AI units.
Player Connect/Disconnect & Mission State: Joins, leaves, player counts, elapsed time.
⚠️ Disabled in 1.7 (API Changes)
Player Kill Tracking: PvP kills (callback signature changed).
AI Position / Chat Tracking: Removed or changed APIs (World.GetEntities, SCR_ChatComponent).
🐛 Troubleshooting
App Won't Connect: Check relay status via browser at http://YOUR_SERVER_IP:2595. Confirm Port 2595 TCP is open and API keys match.
No Data Showing: Verify mod is in server addons and AuspecsGameModeComponent is active. Enable debug logging.
Relay Won't Start: Check that port 2595 is free, Node.js is installed, .env exists, and run as admin.
📝 Technical Details & Security
Architecture: Arma Server -> HTTP POST -> Relay Server -> WebSocket -> Phone App
Performance: ~1-2% CPU overhead, ~1-2 KB/sec network usage per player. Best for 10+ players.
Security: Use strong keys, keep relay updated, restrict firewall access, use HTTPS in production.
Discord: https://discord.gg/bA3vfCnB4q (Report bugs/features here or GitHub).
License: Provided as-is.
🔄 Version History
v1.7.0: 1.7 compatibility update. Disabled broken tracking APIs. Fixed GUID formatting.
v1.0.0: Original full feature set for pre-1.7.
⚠️ Hosted Server Owners (GGHost, etc.)
Hosted providers usually block extra background services. Your options:
Option A (Best): Rent a cheap $5/mo VPS (DigitalOcean, Linode), cloud instance, or run it on a stable home PC. Point the mod config to this separate IP.
Option B: Use automated external relay/bot hosting solutions if available.
Option C: Ask GGHost support if they can host the relay server binary for you.
For Self-Hosted Server Owners
(Configure your local network firewall and ports as shown in Steps 4 & 5).