Foundry refinement

user-facing/productivity-and-creation/foundry-vtt.md

@@ -1,42 +1,56 @@
-# Foundry VTT — Virtual Tabletop for TTRPGs
+# Foundry VTT: Virtual Tabletop for TTRPGs
 
-**Foundry Virtual Tabletop (VTT)** is a subscription-free virtual tabletop for playing tabletop role-playing games like Dungeons & Dragons, Pathfinder, and more. It provides maps, tokens, dice rolling, and real-time collaboration.
+**Foundry Virtual Tabletop (VTT)** is a subscription-free virtual tabletop for playing tabletop role-playing games like Dungeons & Dragons, Pathfinder, Call of Cthulhu, and more. Hosted directly on **The Nest**, Foundry provides interactive maps, dynamic lighting, integrated character sheets, soundscapes, and real-time multiplayer collaboration.
-
-## Access
-
-- **Web UI:** <https://foundry.mynest.love>
-- **Internal (home network):** <http://foundry-vtt.k3s.home.nest:30000>
-
-## Features
-
-- Interactive maps with fog of war and dynamic lighting
-- Token movement and combat tracking
-- Dice rolling with chat integration
-- Module and system support for multiple TTRPG rulesets
-- Real-time collaboration — multiple players join the same session
-
-## Getting Started
-
-1. Open <https://foundry.mynest.love> in your browser.
-2. Click **Sign In** and choose **Sign in with The Nest**.
-3. If this is your first time, you'll be prompted to create a world or join an existing one.
-4. Share the session link with your players.
-
-## How It Works
-
-Foundry VTT runs as a single-instance server in The Nest. All players connect via WebSocket to the same game world. No separate client software is required — everything runs in the browser.
-
-## Tips
-
-- **Worlds:** Each "world" is a separate campaign. Create one per group or setting.
-- **Modules:** Install modules for additional rulesets, maps, and tools. Admin-managed module library may be available.
-- **Performance:** Foundry VTT is CPU-intensive. If you experience lag, try reducing map detail or closing other browser tabs.
-- **Mobile players:** Players can join from phones or tablets via the web UI — no app required.
-
-## Related Services
-
-- [Keycloak](../technical/security-and-identity.md) — Handles authentication for Foundry VTT
 
 ---
 
-*TODO: Add screenshot of a Foundry VTT combat map with tokens.*
+## 1. Web Access & Initial Setup
+
+1. Open **[foundry.mynest.love](https://foundry.mynest.love)** in your Web browser.
+2. Click **Sign In** and log in using your standard Nest passkey.
+3. Select your assigned **User Profile** from the campaign dropdown menu and enter your player passcode (if set by your GM).
+
+---
+
+## 2. Core Concepts: Worlds, Systems, and Modules
+
+To get the most out of Foundry VTT, it helps to understand its three primary layers:
+
+* **Game Systems:** The underlying rules engine (e.g., *D&D 5e*, *Pathfinder 2e*, *Alien RPG*). Systems define character sheet statistics, automated combat rolls, and rules calculations.
+* **Worlds:** The individual campaign instance containing scenes (maps), actors (player characters and NPCs), roll tables, and journal entries.
+* **Modules:** Community-created add-ons that enhance functionality (such as 3D dice animations, automation macros, UI tweaks, or map effects).
+
+---
+
+## 3. Running Your Own Game on The Nest
+
+Want to run a campaign or one-shot for your gaming group on The Nest?
+
+> [!IMPORTANT]
+> **Single-Instance Server & Admin Access**
+> Foundry VTT runs as a single service on The Nest, which means **only one World (campaign) can be actively hosted at any given time**.
+> 
+> * **Admin Password:** Switching active campaign Worlds or installing new Game Systems and Modules requires the server's admin password.
+> * **Requesting GM Access:** Reach out to an administrator on Matrix to get the administrative password and receive a quick setup overview.
+> * **Session Scheduling:** Be sure to schedule game times with other GMs on Matrix to avoid schedule overlaps or accidental world switching during live sessions!
+
+---
+
+## 4. Tips for Players & GMs
+
+* **Hardware Acceleration:** Foundry uses WebGL to render dynamic lighting, fog of war, and canvas effects. Ensure **Hardware Acceleration** is turned **ON** in your browser settings (`chrome://settings` or Firefox settings) for smooth performance.
+* **Recommended Devices:** While mobile devices can technically access the web interface, a desktop, laptop, or tablet with a dedicated mouse/trackpad is strongly recommended for managing map vision and token navigation.
+* **Performance Tuning:** If you experience lagging or high fan noise, lower the **Maximum Frame Rate** or disable soft shadows under **Settings → Configure Settings → Core Settings**.
+* **Audio & Video Setup:** Foundry includes native browser WebRTC for audio and video calls. Be sure to grant camera and microphone permissions when prompted by your browser.
+
+---
+
+## 5. Service Summary & Related Links
+
+| Component | Endpoint / URL | Access Method | Purpose |
+| :--- | :--- | :--- | :--- |
+| **Foundry Web UI** | [foundry.mynest.love](https://foundry.mynest.love) | Web Browser | Connect to active tabletop campaign worlds |
+| **Official Documentation** | [foundryvtt.com/kb](https://foundryvtt.com/kb/) | External Link | Official Foundry VTT Knowledge Base and user guides |
+
+### Related Nest Documentation:
+* **[Matrix Chat](../communication-and-security/matrix.md):** Coordinate game night schedules with other GMs or request admin credentials.