⚡ Shadowrun 5e Aid Helpers (sr5-aid-helpers)

Foundry v14 System License: MIT with Attribution i18n

Shadowrun 5e Aid Helpers is a state-of-the-art companion suite for Foundry Virtual Tabletop (v14) and the Shadowrun 5th Edition system (shadowrun5e). Designed with rich cyberpunk aesthetics, glassmorphic UI tokens, and seamless system-native mechanics, it streamlines the most complex aspects of the Sixth World—from high-octane vehicle chases and devastating Chunky Salsa blast waves to cyberware audits, modular weaponry, and automated GM assistant tools.

Preview

🌟 Major Highlights & Core Features

🚗 Interactive Vehicle Chase Manager (ApplicationV2)

Run thrilling, cinematic vehicle chases with interactive range tracking, directional physics, and real-time player socket synchronization. - Multi-Tab Chase Launcher: Manage multiple chases simultaneously with dedicated tabs and rapid + New Chase configuration. - Canvas Token Picker: Click-to-assign Pursuer and Evader drivers and vehicles directly from active canvas tokens (controlToken / targetToken hooks). - Interactive Cyberpunk Range Track: - Horizontal left-to-right range track displaying all 4 SR5 distance bands (Kurz, Mittel, Lang, Maximal). - Glowing visual carets for Start Distance, Live Position, and Target Goal Crosshairs. - SR5 Core Rules Terrain Limits (GRW pp. 202–203): - Speed Mode [Geschwindigkeit] (Highways, Open Sky, Open Water): 0–10m, 11–50m, 51–150m, 151–300m. - Handling Mode (City Streets, Tight Alleys, Canyons): 0–5m, 6–20m, 21–80m, 81–150m. - Directional Movement Physics: Automatically advances or opens distance along the range track based on net hits and driver goals. - Special Vehicle Maneuvers: - Rammen (Ramming): Calculates collision damage ($\text{Attacker Body} + \text{Net Hits}$) and recoil self-damage ($\lceil \text{Attacker Body} / 2 \rceil$), applying physical damage directly to actor condition monitors. - Schneiden (Cut Off): Triggers an immediate Crash Avoidance Test (Unfall vermeiden) threshold check with real-time prompt buttons. - Player Live Viewer & Socket Sync: - Automatically pops open a live tracking HUD for player clients when a chase begins. - GM resolution notes remain secret until escape or goal capture is achieved. - State persists through page reloads and player reconnections.

💥 Chunky Salsa Blast & Shockwave Simulator (ApplicationV2)

Turn deadly enclosed explosions into tactical masterpieces with real-time physics and canvas destruction. - Dual Blast Propagation Models: - Standard SR5 Chunky Salsa: Raytraces reflection vectors bouncing off structural walls, floors, and ceilings; breaches barriers and calculates compounding pressure damage. - Real Shockwave & Kinematics Model: Converts starting DV or TNT explosive mass into peak incident kPa pressure; models arrival groups, duration multipliers, net impulse, and horizontal token throwing velocity. - Live Canvas Interaction & Status Effects: - Automatically applies status effects: knocks tokens Prone, inflicts Temporarily Deafened, or causes Deaf — Ruptured Eardrums (actors with Cyberears are automatically protected). - Throws tokens across canvas grids along shockwave vectors until clear or stopped by standing walls. - Destroys and removes breached scene wall segments in real time. - Click-to-Locate: Clicking any token row in the results list or chat card automatically centers the camera and pings the target on the active scene.

💾 Skillsoft Manager (Skilljacks & Skillwires)

Bring software-driven skills to life with complete hardware audits and rules-accurate roll integration. - Item Sheet Panel Injection: Injects a clean management interface directly into Skilljack item sheets. - Automatic Capacity Auditing: Enforces running soft ratings against skilljack capacity ($\text{Rating} \times 2$, or $\text{Rating} \times 3$ with wireless bonus enabled). - Soft Types & Storage: Add, edit, run, and stop Activesofts, Knowsofts, and Linguasofts as Free Actions. - Native Test Integration & Edge Protection: Dynamically modifies skill action pools and strictly enforces SR5 RAW by blocking Edge use (Push the Limit and Second Chance) on software-driven rolls. - Hardware Diagnostics: Verifies installed Skillwires ratings, detects wireless bonuses, and warns of incompatible bioware.

🔫 HK XM30 Modular Weapon System

Equip the legendary multibarrel weapon platform with on-the-fly mechanical modularity. - Dynamic Configuration Switching: Reconfigure between Assault Rifle, Carbine, Sniper Rifle, and Light Machine Gun (LMG) with accurate SR5 weapon profiles, ranges, recoil, and firing modes. - Integrated Underbarrel Mounts: Mount, inspect, and fire integrated Underbarrel Shotguns or Underbarrel Grenade Launchers. - Dual Ammunition Feeds: Separately tracks and preserves loaded ammunition and spare clips between Standard and Secondary feeds. - Grenade Profile Loader: Load any inventory or compendium grenade profile directly into the grenade launcher with custom round counts. - Bipod Deployment: Toggle deployed bipod for +2 Recoil Compensation on Sniper and LMG configurations. - In-Sheet Reconfiguration Test: Roll Automatics / Armorer + Agility (5, 1 minute) extended tests directly from the weapon panel.

🎲 Native SR5 System Test Engine & Player-Driven Rolls

Say goodbye to detached math rolls—every tool leverages the native shadowrun5e test engine: - Native System Tests: Seamlessly delegates rolls to SkillTest, PilotVehicleTest, and NaturalRecovery* test classes. - Full Edge & 3D Dice Integration: Restores native Edge actions (Push the Limit, Second Chance), wound modifiers, limits, glitches, critical glitches, and Dice So Nice 3D dice animations. - Interactive Player Roll Prompts: Chat cards include clickable roll action buttons (e.g. Roll Crash Avoidance [Handling] or Roll Perception). When clicked by the character's owner, the system test dialog opens directly on their screen. - Vehicle Chase Player Sockets: GMs can click "Request Player Rolls" in the Chase Manager to prompt player clients over sockets, automatically feeding the resulting hits back into the chase track.

🔒 Roll Modes & GM Whispers

Gain absolute control over chat visibility across all tools: - Standardized Visibility Selector: Choose between Public Roll (Everyone), Whisper to GM (Private), Blind GM Roll, or Self Roll Only. - Collapsible GM Secret Information (.sr5-aid-gm-secret): Sensitive details (such as discovered cyberware augmentations or detect enemy caster ranges) are formatted into dedicated secret panels visible only to GM clients.

🛒 sr5-marketplace Availability Bridge

Integrated procurement and black market fencing: - Direct Marketplace Delegation: When sr5-marketplace is enabled, availability checks leverage its authoritative AvailabilityTest and AvailabilityResist engine—automatically applying Contact Connection ratings, Loyalty bonuses, Nuyen price bribing (+25% cost = +1 die, up to +400% / +12 dice max), and delivery schedules. - Native Fallback Engine: If sr5-marketplace is not installed, seamlessly falls back to a built-in negotiation test with threshold calculation and SR5 delivery timelines.

🧰 The Shadowrunner's Toolkit

Access every tool instantly via the Floating Button Displayer above the player list, scene token controls, or hotbar macros:

Tool Focus & Rules Engine
Grenade Scatter Throwing Weapons SkillTest with 1d6/2d6 directional scatter math and blast stats.
Cyberware Scanner Sensor threshold detection with concealed GM-secret augmentation breakdowns.
Detect Enemies Spellcasting test with automated canvas hostile token distance triangulation.
Party Perception Rapid group perception aggregator with individual player roll prompt cards.
SIN Verification Opposed Fake SIN rating vs Scanner rating verification and burn checks.
Downtime Planner Multi-week downtime duration, lifestyle maintenance math, and activity tracking.
Gear Procurement Availability checks, delivery schedules, and black market negotiation.
Fencing Loot Black market resale percentage calculations (25% base + 5% per net hit, capped at 50%).
Addiction Tests Dual Physiological (Body + Logic) and Psychological (Willpower + Logic) resistance tests.
Healing & Recovery Native NaturalRecoveryPhysicalTest, NaturalRecoveryStunTest, and First Aid / Medicine.

🎨 Design System & Aesthetics

  • Crimson & Gold Cyberpunk Palette: High-contrast theme tokens designed to complement modern Foundry v14 interfaces.
  • ThemeService Dynamic Detection: Automatically adapts between .theme-dark and .theme-light without CSS collisions or style bleeding.
  • Protected Chat Cards: Scoped .sr5-aid-card CSS guarantees that chat log messages retain their authentic dark cyberpunk aesthetic regardless of the user's active UI skin.

🌐 Localization / Sprachen

Shadowrun 5e Aid Helpers features complete, out-of-the-box bilingual support: - 🇬🇧 English: Complete localization for all tools, dialogs, cards, prompts, and settings. - 🇩🇪 Deutsch: Vollständige deutsche Übersetzung aller Werkzeuge, Dialoge, Chatkarten, Wurfaufforderungen und Einstellungen.

📦 Installation & Setup

  1. In Foundry VTT, navigate to Configuration and Setup -> Add-on Modules.
  2. Click Install Module.
  3. Enter the Manifest URL: https://github.com/shadows-eye/sr5-aid-helpers/releases/latest/download/module.json
  4. Activate Shadowrun 5e Aid Helpers in your Shadowrun 5e world under Manage Modules.

🤝 Integrations & Compatibility

  • Shadowrun 5e System: Built specifically for shadowrun5e (v0.30+).
  • sr5-marketplace: Automatic two-way bridge for availability checks, contact connection bonuses, and black market pricing.
  • Dice So Nice: Native 3D dice rolling on all interactive and background tests.

📜 Attribution & Credits

  • shadowplays.de: Full module architecture, ApplicationV2 modernization, design tokens, theme engine, native SR5 roll integration, and active maintenance.
  • adzling: Original concept, creative ideas, and early prototyping using ChatGPT (originating from adzlings-sr5e-play-aids).

Run fast, shoot straight, and never make a deal with a dragon, chummer.

Module Image