# RLM Changelog

**Revision**: 1.5

This document tracks all changes, updates, and improvements made to the Realism Location Marker (RLM) project.

---

## Version 7.3.6
**Release Date**: 23 August 2026

### Fixed
- **Create Building false fail** — a successful MissionChief create no longer shows **Failed - Try Again**. Stable was treating Bootstrap `alert-danger` in the success page as a form reject and never checked `/api/buildings`. Create now confirms a station actually appeared; real failures still show Failed.

Tampermonkey stable loader: **7.3.6**. Check for updates in Tampermonkey or reload the game.

---

## Version 7.3.5
**Release Date**: 20 August 2026

### What's new
- **POI Statistics** — live counts from `/api/poi-stats` (indexed, OSM total, coverage); no more placeholder numbers
- **Start Vehicles** — navbar settings per world from `/api/start-vehicles` (replaces hardcoded US/DE building-type IDs)
- **Discord Panel** — loads through the modular feature system like Dashboard
- **FBI & RNLI POI types** — defined once in `RLMExtraPoiTypes`; FBI on US only, RNLI on UK only
- **Map clustering** — dense city views cluster POIs (400+ in view) instead of dumping thousands of icons
- **Truncation banner** — map warns when the 10 000 POI viewport cap or clustering is in effect
- **Antimeridian support** — POI fetches split at ±180° so Alaska / Pacific / dateline views stay complete

### Fixed
- **Create Building** — retries transport errors, validates real success, shows **Failed - Try Again** instead of stuck “Creating…”
- **Unnamed POIs** — null / blank / “To Be Confirmed” names get **Edit Name**
- **Mixed POI pins** — stale fetch guard + debounced pan/zoom reload (one request per gesture)
- **Names with `%`** — building create no longer throws on percent signs in OSM names
- **Status-edit cooldown** — 409 pending/rejected edits show the same warning modal as name edits
- **Create without jQuery** — building POST and start-vehicle discovery fall back to `fetch`
- **Popup XSS** — POI names, addresses, and edit modals escape HTML; `escapeHtml(undefined)` no longer prints “undefined”
- **Tampermonkey sandbox** — map and Leaflet resolve via `unsafeWindow` / page window helpers
- **Placeholder addresses** — create no longer sends the literal string `placeholder address`
- **Block / cooldown checks** — use GM `apiClient` so CORS cannot skip the warning UI
- **MCID on edits** — name/status edits send the logged-in MissionChief ID reliably
- **Double popup clicks** — Create / Edit handlers bind once per marker popup
- **POI types failure** — dropdown shows **⚠ Failed to load POI types** with retry
- **API timeouts** — 30s timeout on GM requests so hung `/api/pois` calls fail cleanly
- **Navbar detection** — Bootstrap 4/5 and LSSM fallbacks; stops infinite polling on non-map pages
- **Dashboard Back** — closes the overlay instead of calling `history.back()`
- **CSRF on create** — Rails `authenticity_token`, `utf8=✓`, and `X-CSRF-Token` header
- **Usage headers** — feature API calls send `X-RLM-Version` and user/alliance IDs
- **POI emoji** — popup Type line uses API emoji with singular/plural/OSM-tag fallbacks
- **Links** — Changelog menu opens the GitHub wiki; blocked-user appeal uses the current Discord invite

### Known issues (still open)
- **Build dropdown matching** — fire/police can over-match (e.g. Airport Fire); dispatch/prison/RNLI build types may be missing on some worlds (**S5**)
- **Dispatch centres** — string vs number ID mismatch can hide Leitstelle options (**S7**)
- **Name-edit POI type** — review queue may get display labels instead of OSM tags (**S11**)
- **Police / config worlds** — loader `country` can be overwritten; police hosts may get wrong building catalog (**S12**)
- **Version strings** — navbar/logs may still disagree with the loader header until unified (**S13**)
- **POI dropdown placement** — still lives inside Leaflet attribution; can vanish if attribution is rewritten (**S14**)

Tampermonkey stable loader: **7.3.5**. Check for updates in Tampermonkey or reinstall from the [Installation Guide](Installation-Guide).

Full list: [Stable bug checklist](https://github.com/Norbit-Online/Realism-Location-Marker/blob/main/docs/STABLE_RLM_BUGS.md) (internal).

---

## Version 7.0.2
**Release Date**: January 2025

### 🚀 Major Version Update
- **V7.0.2 Release**: Updated all loaders and web interface to version 7.0.2
- **New Stable Loader**: Added dedicated stable loader for V7 modular system
- **Enhanced Documentation**: Updated all documentation to reflect V7 features
- **Web Interface Updates**: Updated all web interface components to V7.0.2
- **Revision Updates**: Incremented all documentation revisions by 1

---

## Version 6.3.2
**Release Date**: January 9, 2025

### 🔗 Installation Improvements
- **Direct Raw Links**: Added one-click installation links to all loader files
- **Simplified Process**: Reduced installation steps from 7 to 4 steps
- **README Enhancement**: Made loader names clickable in the comparison table
- **Path Correction**: Fixed all URLs to point to correct GitHub root directory
- **Documentation Updates**: Updated Installation Guide with direct links and alternative manual method

### 📖 Documentation Updates
- **Installation Guide**: Updated to Revision 1.1 with improved step-by-step process
- **Changelog**: Updated to Revision 1.2 with latest improvements
- **README**: Updated to Revision 1.2 with clickable loader links in comparison table
- **Visual Guide**: Updated to reflect actual GitHub repository structure

---

## Version 6.3.1
**Release Date**: January 9, 2025

### 🔧 Technical Improvements
- **Fixed Tampermonkey Auto-Update URLs**: All loader files now use proper GitHub raw URLs for automatic updates
  - Main loader: Fixed path from root directory to `RLM/loaders/`
  - Beta loader: Changed from local website URL to GitHub URL
  - Dev loader: Changed from local website URL to GitHub URL
- **Improved Update Reliability**: Tampermonkey users will now receive automatic updates directly from GitHub

### 📊 Statistics & Monitoring
- **Live Usage Statistics**: Implemented real-time tracking of loader usage
- **GitHub Badges**: Added live statistics badges to README showing user counts for each loader type
- **Custom RLM Marker Icons**: Integrated custom RLM marker icons into GitHub badges using Custom Icon Badges service
- **Web User Tracking**: Added tracking for web interface users (non-Tampermonkey users)
- **Total User Count**: Added automatic calculation and display of total unique users across all platforms
- **Enhanced Statistics Display**: Improved Discord embed formatting with clearer platform names and update frequency indication

### 🎯 Badge System
- **Main Badge**: Green badge with custom RLM marker icon
- **Beta Badge**: Yellow badge with custom RLM marker icon  
- **Dev Badge**: Red badge with custom RLM marker icon
- **Web Badge**: Blue badge with globe icon for web interface users
- **Live Updates**: Badges update every 30 minutes with current usage statistics

### 🔄 Auto-Update System
- **Enhanced Change Detection**: Improved GitHub auto-update system to accurately detect file changes
- **Detailed Version Reporting**: Discord notifications now show specific version changes (e.g., "6.3.0 → 6.3.1")
- **Proper Terminology**: Wiki/documentation files use "Revision" terminology, loader files use "Version" terminology

### 📝 Documentation
- **Loader Comparison**: Updated comparison table to include Web Interface
- **Installation Guide**: Enhanced with latest information
- **Troubleshooting**: Updated with current solutions

---

## Version 6.3.0
**Release Date**: Previous release

### 🚀 Features
- Multi-language support
- Server-specific building IDs
- Enhanced POI management system
- Improved user interface

### 🔧 Technical
- Database optimizations
- Performance improvements
- Bug fixes and stability enhancements

---

## Previous Versions

For historical changes prior to version 6.3.0, please refer to the project's commit history on GitHub.

---

## How to Read This Changelog

- **Version Numbers**: Follow semantic versioning (Major.Minor.Patch)
- **Loader Types**: 
  - **Main**: Stable release for general use
  - **Beta**: Pre-release testing version
  - **Dev**: Development version with experimental features
- **Categories**: Changes are grouped by type (Features, Technical, Documentation, etc.)
- **Icons**: Used to quickly identify the type of change

---

*This changelog is automatically updated when new versions are released.*