Add files via upload

v2.1

README.md

@@ -0,0 +1,111 @@
+# Wasteland Conquest
+
+Wasteland Conquest is a free, browser-based strategy game inspired by Risk and the Fallout universe. 
+
+**Note on Naming:** This project was formerly titled "RobCo OS: Strategic Simulation." We have officially rebranded to **Wasteland Conquest** as of the latest version. This game is an independent project and has no affiliation with the "Wasteland Conquest" mod or any other software sharing the same name.
+
+Play right now in your browser: https://linology.tech/risk/
+
+*Linology is the official host, chosen for its safety and reliability. While other websites are free to host the game, this is the only link guaranteed to be secure and fully updated.*
+
+
+### Downloading and Offline Play
+You can download the game to play offline by simply saving the `index.html` file from this repository or the live site. Please note that the game's music tracks are not included in the standalone HTML download and require an active internet connection to stream if playing from thhe main site.
+
+### Source Code and Support
+The primary source code for this project is hosted on GitHub: https://github.com/threememories/FalloutRisk/
+
+A mirrored backup of the repository is maintained at: https://git.linology.tech/threememories/FalloutRisk
+
+The mirror exists for redundancy and archival purposes. All active development and updates are performed on the GitHub repository.
+If you find a bug, have a feature request, or want to suggest a balance change, please submit them via the [Issues](https://github.com/threememories/FalloutRisk/issues) page.
+
+---
+
+## **Features**
+
+### **Combat and V.A.T.S.**
+The game uses a V.A.T.S. interface to handle battles. Before you attack, the system shows your win probability based on troop counts, environmental hazards, and your chosen difficulty (Easy, Normal, or Hard). An integrated **Vault-Tec Action Log** tracks all combat, though events happening inside the Fog of War will be scrambled into vague "Sensor Anomalies."
+
+### **Game Modes**
+You can play with standard Risk rules or use presets to change how the game works:
+* **Classic Conquest:** Normal Risk rules. No special hazards or heroes. Uses simple card-trading for extra troops.
+* **Wasteland Survival:** Adds Fog of War, radstorms, and feral ghouls. You'll need to manage Bottle Caps to buy reinforcements.
+* **Heroes of the Wasteland:** Enables unique Faction Perks and Commander units. If your Commander dies, you lose.
+* **Apocalypse Now:** A high-difficulty mode with frequent hazards and nuclear weapons enabled.
+* **Alliance Warfare:** You start with a permanent ally. You win or lose together. Features unique abilities like **Emergency Asylum**, **Vertibird Airlifts** for landlocked troops, and a **Signal Ally** menu to coordinate strikes.
+* **Covert Warfare:** Focuses on stealth. Maximum Fog of War and faction perks that help you move unseen.
+* **Nuclear Option:** A race to find launch codes and take control of silos to wipe out enemy garrisons.
+* **Custom Rules:** Mix and match any of the above settings.
+
+### **Economy & Diplomacy**
+Instead of just trading cards, most modes use a Bottle Cap economy. You earn caps from your territories each turn and spend them to recruit troops, hire mercenaries, or engage in wasteland politics. 
+* **Negotiations:** Send Envoys to offer Caps or troops in exchange for a temporary Ceasefire (limited to 1 active Truce at a time).
+* **Extortion:** If your army dwarfs your neighbor, demand tribute to force a "Locked" Extortion Truce.
+* **Betrayal:** Breaking a ceasefire early incurs a permanent Betrayal Tax and triggers a global "Spite Bounty," causing AI factions to aggressively target you.
+
+### **Commander Units**
+Assign a Commander to your army. They have their own HP and AP (Action Points) and provide massive 20% defensive combat bonuses to their stationed territory. Keep them alive—losing your leader ends your game.
+* **Convert Territory:** Commanders can spend AP to initiate a 3-turn siege to flip an enemy territory to your control.
+* **Looting:** Defeating an enemy Commander allows you to loot their held Stimpaks and Bobbleheads.
+
+### **Nukes (Scorched Earth)**
+Control Nuclear Silos and find 4 hidden launch codes to gain access to nukes. You can use them to clear out enemy territories or vaporize rival Commanders.
+* **Collateral Damage:** Nuclear strikes instantly destroy all units at ground zero, while inflicting 50% casualties and severe radiation to all adjacent territories.
+* **Disruption:** A nuclear launch takes 3 turns to impact. You can abort an enemy's launch sequence by capturing their specific origin silo before the timer expires.
+
+### **Hazards and Random Events**
+The map isn't static.
+* **Radstorms:** Radioactive clouds that move across the map and kill a percentage of troops.
+* **Wild Ghouls:** Neutral territories can spawn ghouls that multiply if you don't clear them out.
+* **Encounters:** Randomly discover abandoned Vaults or radio signals to find Caps, Stimpaks, or powerful **Bobbleheads** (which sit in your 'INV' tab and can be activated for massive 1-turn buffs).
+
+### **RobCo OS Terminal & UI**
+* **Save/Load System:** Export your current simulation to a local JSON file (Holotape) to resume your conquest later.
+* **Survival Guide:** A fully immersive, multi-page RobCo Terminal acts as the game's manual, dynamically typing out rules and storing patch notes.
+* **Mobile Support:** The UI dynamically shifts to support landscape-oriented mobile browsers.
+* **Turbo Mode:** A toggle to vastly accelerate AI turns and skip animations.
+
+---
+
+## **Factions and Perks**
+There are 18 factions available (including custom options), each with a unique gameplay bonus:
+
+* **Brotherhood of Steel**: Power Armor Infantry (+5% win chance in all combat).
+* **The Enclave**: Vertibird Assault (Move troops between any two owned territories during Maneuver).
+* **Vault 87 Mutants**: F.E.V. Infection (25% of defeated enemies convert to your troops on conquest).
+* **Wasteland Raiders**: Chem Frenzy (Sacrifice troops for a massive combat bonus).
+* **BOS Outcasts**: Technology Overdrive (Spend Caps to grant all attacking armies +10% win chance).
+* **Reilly's Rangers**: Ranger Network (Defensive bonus for connected friendly territories).
+* **New California Republic**: Logistical Superiority (+50% troop bonus for holding continents).
+* **Caesar's Legion**: Scourge of the East (Move all surviving troops after conquest, no 1-troop minimum).
+* **New Vegas Securitrons**: Predictive Simulation (Undo failed attacks and restore all lost troops).
+* **Mojave Brotherhood**: Elder's Edict (Lock down a territory from all actions/attacks for 3 turns).
+* **Great Khans**: Guerrilla Tactics (Pass through one enemy territory during Maneuver, inflicting damage).
+* **The Fiends**: Chem-Fueled Raids (30% chance to steal caps/items or enslave survivors on conquest).
+* **The Minutemen**: Mercenary Contracts (Spend caps to instantly deploy 6-12 elite troops to reserves).
+* **The Institute**: Synth Replacements (Lost troops have a 10% chance to respawn in your reserves).
+* **The Railroad**: Rapid Relocation (Receive 5 separate troop movements during Maneuver).
+* **The Gunners**: Mercenary Contracts (Fast-cooldown version of the Minutemen perk).
+* **Nuka-World Raiders**: Tribute Chest (+10 Bottle Caps for every continent controlled).
+* **Custom Faction**: Mysterious Stranger (When projected to lose a battle, the Stranger may appear and grant a sudden +25% combat bonus).
+
+---
+
+## Saving and Loading
+Strategic progress can be saved at any time using the **Save Holotape**, which downloads your current game state as a JSON file. To resume your conquest, use the **Load Holotape** option to upload your saved file back into the terminal.
+
+---
+
+## Mobile Support
+The simulation fully mobile-friendly and responsive. It is best played on a desktop or in Landscape Mode on larger mobile devices, but still very playable on small screens and mobile devices.
+
+---
+
+## Credits
+*   **Developer**: threememories
+*   **Inspiration**: Fallout (Bethesda) and Risk (Hasbro).
+*   **ORIGINAL ENGINE ARCHITECTURE**: This simulation was heavily modified from the original Risk framework created by Vinayak Vedantam (https://github.com/vvedanta).
+*   **License**: Open Source. Feel free to host or modify the code.
+
+War... War never changes.

UPDATE_HISTORY.md

@@ -0,0 +1,150 @@
+# Update History: Wasteland Conquest Changes
+
+This log covers the major changes of Wasteland Conquest (index.html).
+
+## v2.4 [THE COMPANION & COGNITION UPDATE]
+
+* **New Companion System (Dogmeat):** Added a rare, multi-stage quest to find and rescue Dogmeat. Players can choose to take him in an 'Injured' state (which incurs debuffs) or heal him with resources to unlock powerful combat, loot-finding, and mine-defusing buffs.
+* **Scorched Earth Overhaul:** Ground Zero is no longer permanently destroyed. Nuked territories now suffer severe, 10-turn radiation attrition (80% initial losses) that slowly cools off. The launch engine now supports simultaneous nuclear strikes from multiple factions.
+* **V.A.T.S. Action Validator:** V.A.T.S. now displays high-visibility warning banners explaining exactly why a tactical action is blocked (e.g., 'OUT OF RANGE', 'TERRITORY FROZEN SOLID'). It also tracks active nuclear impact countdowns.
+* **Advanced Relic Targeting:** Fat Man and Cryolator strikes are now strictly limited to a range of 3 territories from your borders. Added theme-colored map icons for planted Mines, Frozen zones, Blockades, and active Expeditions.
+* **Progression Polish:** The Level-Up system has been refined to prevent offering duplicate non-stackable perks, and now clearly labels upgrades for stackable abilities (e.g., Rank 2, Rank 3).
+* **Deployment Protocols:** Introduced Classic Manual and Semi-Auto initial placement phases to the boot menu for deep strategic starts.
+* **Advanced AI Brain:** Artificial Intelligence rewritten to prevent suicidal attacks, aggressively consolidate continents, perform continuous 'Blitz' sweeps, and utilize cooldown-based perks multiple times.
+* **Relic & Hazard Parity:** Wasteland Relics now function as intended. Jet grants an extra turn, Stealth Boys hide your territories from AI radar, the G.E.C.K. clears Radstorms, and RadAway properly blocks weather attrition.
+* **Tactical Backbriefs:** Turbo Mode now generates a dynamic, immersive intelligence summary at the end of the AI cycle instead of clogging the action log with AI-vs-AI combat spam.
+* **Wasteland Fixes:** Added Maxson's Brotherhood (FO4), resolved the 'Missing Caps' truce bug, and ensured AI respects Cryolator freezes and Silver Shroud blockades.
+
+---
+
+## v2.3 [Leveling & Mobile Update]
+
+* **Progression Overhaul:** Implemented a new player leveling system featuring uncapped XP for continuous character growth.
+* **Mobile Deployment:** Completely overhauled the mobile interface with adaptive UI scaling and a specialized mission log for small screens.
+* **Artifact Database:** Integrated Bobbleheads and Relics into the core simulation with active perks and inventory tracking.
+* **Biometric Monitor:** Added a dynamic Vault-Boy biometric display to the terminal that visually updates based on commander health.
+* **Stability Fixes:** Resolved several critical logic bugs including AI turn lockups, SVG map layering, and script crashes.
+* **Mode Balance:** Balanced specialized mechanics like Nukes and Radstorms to ensure consistency across all game modes.
+
+---
+
+## v2.2 [System Hotfixes & UI Polish]
+
+* **Classic Mode Fix:** Fixed a critical open stash bug in Classic mode.
+* **AP Bar Ping:** Added a ping function to the AP bar to easily locate valid territories.
+* **Dynamic Cursor:** Added a no-action cursor to visually indicate when actions are unavailable.
+* **Hover UI Fix:** Fixed modal button text colors blending into the background when hovered over.
+* **AI & Perk Logic:** Fixed several logic bugs regarding Faction Perks and Bobbleheads for both Player and AI.and AI.
+
+---
+
+### **v2.1 [ALLIANCE, DIPLOMACY & COMBAT EVOLUTION]**
+
+* **Alliance Warfare Expansion:** Added the 'Signal Ally' menu to request coordinated strikes, reinforcements, or Emergency Asylum. Landlocked troops can now be airlifted across allied territory via Vertibird.
+* **Advanced Diplomacy & Extortion:** Factions are now strictly limited to 1 active truce. Demanding Caps without a fair trade creates a 'Locked' Extortion Truce that cannot be backstabbed. The AI will now proactively offer truces and extort weaker neighbors.
+* **Commander Conversions & Combat:** Commanders can now spend AP to convert enemy territories (a 3-turn siege). Turn phase order has been updated to prioritize Battles before Commander movement. Defeated factions now drop their Stimpaks and Bobbleheads to the victor.
+* **Scorched Earth Disruption:** Active nuclear launches can now be aborted by capturing the specific origin silo before impact. Added a flashing crosshair to targeted territories and full-screen warning modals for aborts. Nuke codes now have escalating drop rates.
+* **The 'logFog' Engine:** The Vault-Tec Action Log is now fully integrated with Fog of War. Battles and troop movements in hidden sectors will display as scrambled 'Sensor Anomalies'.
+* **V.A.T.S. & UI Polish:** VATS now accurately warns of environmental hazards, locked truces, and Commander defense buffs. The 'INV' tab logic has been overhauled to only pulse when items are immediately usable. The Survival Guide now natively hosts patch notes.
+* **Faction Balance Pass:** Minutemen/Gunners now spawn 6-12 troops. BOS Outcasts' Overdrive cost is capped at 30 Caps. Nuka-World Raiders tribute increased to +10 Caps.
+* **Major Bug Fixes:** Fixed soft-locks with converting Commanders, resolved Agility Bobblehead maneuver limits, corrected multi-commander duel targeting, and ensured Bobblehead cooldowns reset when stolen.
+
+
+---
+
+### v2.0 [WASTELAND CONQUEST UPDATE]
+
+This was a major overhaul of the game's mechanics and interface.
+- Bottle Cap Economy: Territories now produce Bottle Caps each turn. You can use these to buy troops from the recruitment terminal instead of relying only on card trades.
+- Game Mode Presets: Added several new ways to play, like Survival, Apocalypse, and Alliance Warfare. Each mode toggles different rules automatically.
+- Random Encounters: Territories can now trigger events like finding loot caches, radio transmissions, or creature attacks.
+- Faction Perks: Every faction now has a unique gameplay bonus (e.g., the Institute's synth respawns or the Enclave's vertibird moves).
+- Improved Commanders: Commanders now have HP and AP stats. You can use Stimpaks to heal them. If they die in battle, your game is over.
+- Nukes: Players can now capture Nuclear Silos and find launch codes to destroy enemy territories.
+- Visibility: Added Fog of War and a Perception system. You'll need items like the Perception Bobblehead to see through the fog.
+- Save/Load System: You can now save your game as a JSON file and load it back up later.
+- Map Icons: Replaced the old text symbols with custom SVG icons for each faction.
+- Terminal Overhaul: The help system was rewritten as a multi-page terminal with detailed info on all mechanics.
+- Mobile Layout: Added better support for mobile browsers with a landscape-specific UI.
+- Turbo Mode: Added a toggle to speed up AI turns.
+
+---
+
+## Legacy v1.9 [MOBILE PORT & HOTFIXES]
+
+- Commander Combat Adjustments: Assassinations are much harder. Troop damage to Commanders is reduced, ambushes are limited to once per turn, and entrenched Commanders require taking the territory first.
+- Advanced AI Tactics: AI commanders now retreat at 50% HP, avoid crowded territories, hold defensive chokepoints, and navigate home intelligently if stranded.
+- Turbo Mode Auto-Skip: The game now automatically advances the phase when your AP depletes.
+- Smart UI & Map Upgrades: The map perfectly renders multiple VIP stars and adds V.A.T.S. hover warnings for entrenched targets.
+- New Holotape Loaded: Added Fallout 4 (The Commonwealth) to the theme selector.
+
+---
+
+## Legacy v1.8 [MOBILE PORT & HOTFIXES]
+
+- Hardware Port: RobCo OS now natively supports handheld (mobile) terminals. Device must be rotated to Landscape mode to initialize.
+- Threat Patch: Resolved a logic error preventing the Wild Ghouls subsystem from properly infesting unclaimed sectors at boot.
+- The Status and Directive terminal readouts have been completely overhauled.
+- Commanders now receive heavy home-turf damage resistance and can flip enemy territories after a ten-phase siege.
+- When a faction's Commander is killed, their entire empire completely collapses into unowned, neutral wasteland.
+- Wasteland diplomacy dynamically scales Ceasefire negotiations, trading exact Bottle Cap amounts for equal rounds of peace.
+- The interface and map graphics have been optimized to provide a more stable, readable, and streamlined visual experience during gameplay.
+- Shout-out to Alex for helping me debug.
+
+---
+
+## Legacy v1.7 [SCORCHED EARTH & COMMANDERS]
+
+- Scorched Earth: Optional Nuke Protocol. Secure Launch Codes and hold highly-defensible Command Silos to unleash permanent radiation.
+- Commander Protocol: Each faction is led by a VIP (100 HP). If they die, you lose. Manage AP, Stimpaks, and map movement to survive.
+- Wasteland Diplomacy: Implemented the ability to offer Caps to rivals for a 3-Round Ceasefire.
+- Wasteland Karma: Breaking a truce now incurs a permanent "Betrayal Tax" and triggers retaliatory AI Spite Alliances.
+
+---
+
+## Legacy v1.6 [SECURITY & UI PROTOCOLS]
+
+- Anti-Hacking Patch: Implemented advanced input sanitization to block malicious code injection at the boot terminal.
+- OS Version History: Initialized scrolling telemetry window to track simulation patch notes.
+
+---
+
+## Legacy v1.5 [SYSTEMS UPGRADE]
+
+- V.A.T.S. Upgrade: Hover targeting now utilizes Gambler's Ruin algorithms to calculate total victory probability (capped at 95%).
+- Customization: Faction color override matrix added to Boot Sequence.
+- Cap Economy: Reserve pool expanded to 50, featuring dynamic "Wasteland Salvage" forging.
+- UI Refinement: Overhauled the Survival Guide into a compact, tactical layout.
+
+---
+
+## Legacy v1.4 [COMBAT & LOOT PROTOCOLS]
+
+- Tactical Routing: Commanders may now dictate exact troop garrison sizes post-victory.
+- Wasteland Justice: Eradicating a rival faction now instantly transfers their entire Cap stash to your inventory.
+- Neutral Threat: Feral Ghouls now dynamically multiply based on active simulation difficulty.
+- Logistics: "Fixed Reinforcements" (Always 3) trade rule added to boot options.
+
+---
+
+## Legacy v1.3 [ENVIRONMENTAL HAZARDS]
+
+- Meteorology: Radstorms added to the simulation.
+- Fauna: Wild Ghouls (Neutral Threat) optional hazard integrated into the map.
+- Comms: Pip-Boy Wasteland Radio frequency scanner initialized.
+
+---
+
+## Legacy v1.2 [HOLOTAPE INTERFACE]
+
+- Telemetry: Vault-Tec Action Log implemented for real-time combat and event tracking.
+- Immersion: Randomized wasteland encounter logs integrated into the turn cycle.
+- System Clock: Holiday protocol initialized to trigger date-specific wasteland encounters.
+- UI: Dynamic HP (Territorial Health) and AP (Action Point) tracking gauges added to the Commander's dashboard.
+- Performance: Turbo Mode toggle added to bypass V.A.T.S. rendering for accelerated AI processing.
+
+---
+
+## Legacy v1.1 [PIP-BOY SCREEN AND UI]
+
+- Themes: Capital Wasteland and Mojave holographic overlays loaded.