explaingit

geanofeefoundry/geanos-gdsa-qol

18JavaScriptAudience · generalComplexity · 2/5Setup · moderate

TLDR

A FoundryVTT module that automates combat rules, magic energy tracking, and roll dialog pre-filling for the German tabletop RPG Das Schwarze Auge version 4.1, with every feature individually toggleable.

Mindmap

mindmap
  root((geanos-gdsa-qol))
    Combat automation
      Unarmed techniques
      Armed techniques
      Initiative bug fix
    Magic tracking
      Spell energy costs
      Failure reductions
      Miracle burnout
    Quality of life
      Auto-fill roll dialogs
      Ability tooltips
      NPC sheet fixes
    Settings
      Per feature toggles
      Group customization
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Automate spell and miracle energy deductions from character sheets so players never manually calculate costs after casting.

USE CASE 2

Pre-fill combat roll dialogs with the correct bonuses and penalties from active traits and status effects before each roll.

USE CASE 3

Toggle individual automation features on or off so your group decides which Das Schwarze Auge rules to handle manually.

Tech stack

JavaScriptFoundryVTT

Getting it running

Difficulty · moderate Time to first run · 30min

Requires FoundryVTT with the GDSA system already installed, this module adds on top of that existing community system.

No license information is provided in this repository.

In plain English

This is an extension module for FoundryVTT, a virtual tabletop application used to run tabletop roleplaying games online. Specifically, it is designed for Das Schwarze Auge (translated as The Dark Eye), a German fantasy roleplaying game, version 4.1. The module works on top of another community-made system called GDSA and adds a large set of automation and quality-of-life improvements for players and game masters running that ruleset. The core focus is automating combat rules that would otherwise require manual calculation. When a player clicks a special ability on their character sheet, the module opens a dialog with the relevant options already filled in. Specific unarmed and armed combat techniques, each with German names drawn from the ruleset, are handled by the module rather than the player having to look them up and apply modifiers by hand. It also corrects a bug in the base system where a certain initiative bonus should be disabled when a character is carrying too much weight. The module tracks magic resource costs automatically. When a spell, liturgy, or miracle is cast, the module reads the result from the chat log and deducts the correct amount of energy from the character sheet, applying reduced costs for failures and permanent burnout for high-tier miracles as the rulebook specifies. Fatigue and overexertion are tracked similarly, with the module applying temporary stat penalties when a character crosses the exhaustion threshold. Other features include pre-filling roll dialogs with bonuses and penalties from a character's active traits and status effects before the roll happens, a tooltip system that shows descriptions of abilities when you hover over them and can be pinned in place by middle-clicking, improvements to how NPC and monster sheets behave, and persistent buttons in chat messages that apply damage fractions even after a page reload. Every automated feature can be turned on or off individually through the module settings, giving groups control over which rules they want handled automatically and which they prefer to manage themselves.

Copy-paste prompts

Prompt 1
I installed geanos-gdsa-qol in FoundryVTT for my Das Schwarze Auge 4.1 campaign. How do I enable automatic fatigue tracking and what game action triggers a stat penalty for my players?
Prompt 2
Our group wants geanos-gdsa-qol to deduct Astralpunkte automatically when a spell is cast. How does it handle reduced costs for failed casts versus a successful casting?
Prompt 3
I'm a GM running Das Schwarze Auge with geanos-gdsa-qol. Which module settings are most useful when managing NPC and monster sheets during combat, and what does the persistent chat damage button do after a page reload?
Prompt 4
I want to use the tooltip system in geanos-gdsa-qol to show ability descriptions during play. How do I pin a tooltip in place and where do the descriptions come from?
Open on GitHub → Explain another repo

← geanofeefoundry on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.