Installation Guide

Installation Guide

Welcome to the Realism Location Marker (RLM) installation guide! This comprehensive guide will walk you through installing RLM on all major browsers.

Table of Contents

• Prerequisites
• Quick Installation Guide
• Browser-Specific Installation
  • Chrome
  • Firefox
  • Edge
  • Safari
  • Opera
• Loader Selection
• Verification
• Troubleshooting

Prerequisites

Before installing RLM, ensure you have:

• A modern web browser (Chrome, Firefox, Edge, Safari, or Opera)
• Administrative privileges to install browser extensions
• Access to MissionChief game website
• Basic understanding of browser extensions

Quick Installation Guide

📋 Step-by-Step Process

1. Install Tampermonkey: Get the Tampermonkey extension for your browser
2. Choose Your Loader: Click the direct link for your preferred version:
   • 🟢 Stable: Install Stable Loader
   • 🟡 Beta: Install Beta Loader
   • 🔴 Dev: Install Dev Loader
3. Install: Tampermonkey will automatically detect the script and show installation dialog
4. Confirm: Click "Install" in the Tampermonkey dialog
5. Play: Visit MissionChief and enjoy enhanced gameplay!

🎯 Alternative Method (Manual Navigation)

If you prefer to navigate manually:

1. Go to GitHub: Visit our repository
2. Find Loader Files: Look for the loader files in the root directory:
   • loader.stable.user.js (Stable)
   • loader.beta.user.js (Beta)
   • loader.dev.user.js (Dev)
3. Choose Your Loader: Click on your chosen loader file
4. Click Raw: Click the "Raw" button to view script source
5. Install: Tampermonkey will detect and offer to install the script
6. Confirm: Click "Install" in the Tampermonkey dialog

🎯 Visual Guide

Step 1: Install Tampermonkey from your browser's extension store Step 2: Go to GitHub repository (files are in the root directory) Step 3: Click on your chosen loader file (loader.stable.user.js, loader.beta.user.js, or loader.dev.user.js) Step 4: Click the "Raw" button (top-right corner) Step 5: Tampermonkey will automatically detect the script Step 6: Click "Install" when prompted Step 7: Verify installation in your browser's extension settings

Browser-Specific Installation

Chrome

Step 1: Install Tampermonkey

1. Open Chrome and navigate to the Chrome Web Store
2. Search for "Tampermonkey"
3. Click on the official Tampermonkey extension by Jan Biniok
4. Click "Add to Chrome"
5. Click "Add extension" when prompted

Step 2: Enable Developer Mode

1. Open Chrome and go to chrome://extensions/
2. Toggle "Developer mode" in the top-right corner
3. This enables advanced extension features needed for userscripts

Step 3: Install RLM Loader

1. Go to GitHub Repository: Navigate to our GitHub repository
2. Navigate to Loaders: Click on the RLM folder, then loaders folder
3. Choose Your Loader: Click on your chosen loader file:
   • loader.stable.user.js (Stable - Public access)
   • loader.beta.user.js (Beta - Restricted access)
   • loader.dev.user.js (Dev - Restricted access)
4. Click Raw Button: Click the "Raw" button (top-right) to view the script source
5. Install Script: Tampermonkey will automatically detect the script and show an installation dialog
6. Confirm Installation: Click "Install" in the Tampermonkey dialog
7. Verify Installation: Go to chrome://extensions/ and ensure the RLM script is listed under Tampermonkey

---

Firefox

Step 1: Install Tampermonkey

1. Open Firefox and navigate to addons.mozilla.org
2. Search for "Tampermonkey"
3. Click on the official Tampermonkey add-on
4. Click "Add to Firefox"
5. Click "Add" when prompted

Step 2: Enable Developer Mode

1. Open Firefox and go to about:addons
2. Click the gear icon (⚙️) in the top-right
3. Select "Debug Add-ons"
4. This enables developer features for userscripts

Step 3: Install RLM Loader

1. Go to our GitHub repository
2. Click on your chosen loader file:
   • loader.stable.user.js (Stable - Public access)
   • loader.beta.user.js (Beta - Restricted access)
   • loader.dev.user.js (Dev - Restricted access)
3. Click "Raw" to view the script source
4. Tampermonkey will automatically detect the script and show an installation dialog
5. Click "Install" to confirm

Step 4: Verify Installation

1. Go to about:addons
2. Find Tampermonkey and click on it
3. Check the "User Scripts" tab to see your installed RLM script

---

Edge

Step 1: Install Tampermonkey

1. Open Edge and navigate to the Microsoft Edge Add-ons Store
2. Search for "Tampermonkey"
3. Click on the official Tampermonkey extension
4. Click "Get"
5. Click "Add extension" when prompted

Step 2: Enable Developer Mode

1. Open Edge and go to edge://extensions/
2. Toggle "Developer mode" in the left sidebar
3. This enables advanced extension features needed for userscripts

Step 3: Install RLM Loader

1. Go to our GitHub repository
2. Click on your chosen loader file:
   • loader.stable.user.js (Stable - Public access)
   • loader.beta.user.js (Beta - Restricted access)
   • loader.dev.user.js (Dev - Restricted access)
3. Click "Raw" to view the script source
4. Tampermonkey will automatically detect the script and show an installation dialog
5. Click "Install" to confirm

Step 4: Verify Installation

1. Go to edge://extensions/
2. Find Tampermonkey and click "Details"
3. Ensure the RLM script is listed under "Installed userscripts"

---

Safari

Step 1: Install Tampermonkey

1. Open Safari and navigate to the Mac App Store
2. Search for "Tampermonkey"
3. Click on the official Tampermonkey app
4. Click "Get" or "Install"
5. Wait for installation to complete

Step 2: Enable Developer Mode

1. Open Safari and go to Safari → Preferences → Advanced
2. Check "Show Develop menu in menu bar"
3. Go to Develop → Allow Unsigned Extensions
4. This enables userscript functionality

Step 3: Install RLM Loader

1. Go to our GitHub repository
2. Click on your chosen loader file:
   • loader.stable.user.js (Stable - Public access)
   • loader.beta.user.js (Beta - Restricted access)
   • loader.dev.user.js (Dev - Restricted access)
3. Click "Raw" to view the script source
4. Tampermonkey will automatically detect the script and show an installation dialog
5. Click "Install" to confirm

Step 4: Verify Installation

1. Open Tampermonkey from your Applications folder
2. Check the "Installed userscripts" tab to see your RLM script

---

Opera

Step 1: Install Tampermonkey

1. Open Opera and navigate to the Opera Add-ons Store
2. Search for "Tampermonkey"
3. Click on the official Tampermonkey extension
4. Click "Add to Opera"
5. Click "Install" when prompted

Step 2: Enable Developer Mode

1. Open Opera and go to opera://extensions/
2. Toggle "Developer mode" in the top-right corner
3. This enables advanced extension features needed for userscripts

Step 3: Install RLM Loader

1. Go to our GitHub repository
2. Click on your chosen loader file:
   • loader.stable.user.js (Stable - Public access)
   • loader.beta.user.js (Beta - Restricted access)
   • loader.dev.user.js (Dev - Restricted access)
3. Click "Raw" to view the script source
4. Tampermonkey will automatically detect the script and show an installation dialog
5. Click "Install" to confirm

Step 4: Verify Installation

1. Go to opera://extensions/
2. Find Tampermonkey and click "Details"
3. Ensure the RLM script is listed under "Installed userscripts"

---

Loader Selection

🟢 Stable Loader (loader.stable.user.js)

• Access: Public - No restrictions
• Features: All stable features, building existence checks, POI management
• Recommended for: All users who want a reliable, feature-complete experience

🟡 Beta Loader (loader.beta.user.js)

• Access: Restricted - Authorization required
• Features: Latest stable features + pre-release testing
• Requirements: Error reporting and bug finding
• Recommended for: Users who want to test new features before public release

🔴 Dev Loader (loader.dev.user.js)

• Access: Restricted - Authorization required
• Features: Cutting-edge features + experimental functionality
• Requirements: Developer discretion only
• Recommended for: Developers and advanced users testing bleeding-edge features

Verification

How to Verify RLM is Working

1. Navigate to MissionChief: Go to your MissionChief game website
2. Check for RLM Interface: Look for the RLM dropdown menus at the bottom of the page
3. Test Functionality: Try selecting different POI types to ensure they appear on the map
4. Check Console: Open browser developer tools (F12) and look for RLM-related messages

Expected Behavior

• Stable Loader: Should work immediately with full functionality
• Beta/Dev Loaders: May show access restriction message if not authorized
• All Loaders: Should display version information in browser console

Troubleshooting

Common Issues

Script Not Installing

• Solution: Ensure Tampermonkey is properly installed and enabled
• Check: Developer mode is enabled in your browser
• Verify: You clicked "Raw" on the GitHub script file

Script Not Working

• Solution: Refresh the MissionChief page after installation
• Check: Script is enabled in Tampermonkey dashboard
• Verify: No browser extensions are blocking the script

Access Denied (Beta/Dev)

• Solution: Request access through our Discord server
• Process: Join Discord → Navigate to RLM-HUB → Contact @Madpugs
• Requirements: Provide your MissionChief ID (MCID)

Performance Issues

• Solution: Clear browser cache and restart browser
• Check: Disable other conflicting extensions
• Verify: You're using the latest version of Tampermonkey

Getting Help

If you encounter issues not covered in this guide:

1. Discord Support: Join our Discord Server and navigate to RLM-HUB
2. GitHub Issues: Report bugs on our GitHub Issues page
3. Documentation: Check our Troubleshooting Guide for more detailed solutions

---

This guide covers installation for all major browsers. If you're using a different browser, the process should be similar - install Tampermonkey first, then install the RLM loader script.