An open API service indexing awesome lists of open source software.

https://github.com/martin-papy/coc7-qol

A companion module for the Call of Cthulhu 7th Edition system on FoundryVTT.
https://github.com/martin-papy/coc7-qol

coc7 foundry-vtt foundryvtt foundryvtt-module

Last synced: 14 days ago
JSON representation

A companion module for the Call of Cthulhu 7th Edition system on FoundryVTT.

Awesome Lists containing this project

README

          

# CoC7 QoL Improvements

A module for the Call of Cthulhu 7th Edition (CoC7) system on FoundryVTT. Adds easy setting of dice roll visibility, image popouts, AI-powered weapon and NPC generation, and bulk card management for GMs.

## Have an idea or a feedback ?

If there's a workflow that annoys you, a small thing that could be smoother, or a feature you keep wishing existed β€” feel free to open a [GitHub issue](https://github.com/martin-papy/coc7-qol/issues) and describe it. A short note is plenty.

Buy Me a Coffee at ko-fi.com

## What's inside

| Feature | What it does | For |
|---|---|---|
| [🎲 Roll Visibility Selector](#-roll-visibility-selector) | Easily pick public / private / blind per roll β€” and remember your last choice | Everyone |
| [πŸ—‚οΈ Close All Cards](#-close-all-cards) | Sweep stale chat cards out of the way in one click | GM |
| [πŸ–ΌοΈ Item Image Popouts](#-item-image-popouts) | Click any item portrait to see it full size, draggable, resizable | Everyone |
| [✨ AI Generation](#-ai-generation) | Conjure fully-statted weapons and NPCs from a one-line description | GM |

---

## 🎲 Roll Visibility Selector

The CoC7 bonus/penalty dialog now sports a **visibility** dropdown β€” public, private, or blind. Makes the use Private/Blind rolls way easier. Your last choice sticks per user and is preserved across the standby.

Small change. Big difference once you've made fifty rolls in a session.

![Roll Visibility Selector](images/Roll-Visibility.png)

[**Read more β†’**](docs/features/roll-visibility.md)

---

## πŸ—‚οΈ Close All Cards

Open the Keeper's toolbar (the tentacle-strike icon), click **Close All Cards**, and pick exactly which lingering chat cards to dismiss β€” listed by type, actor, and timestamp. Particularly useful when accumulated open cards start blocking new rolls.

![Close All Cards selection dialog](images/Close-Cards-2.png)

[**Read more β†’**](docs/features/close-all-cards.md)

---

## πŸ–ΌοΈ Item Image Popouts

Players can finally click on an item's portrait and see the actual art β€” no GM-only file picker getting in the way. Works on the item sheet itself and on the small icons in the Gear & Cash tab. GMs keep their default editing behavior where it makes sense.

![Item image popout from the Gear & Cash tab](images/Popup-Image.png)

[**Read more β†’**](docs/features/item-image-popouts.md)

---

## ✨ AI Generation

Open the Create Item dialog, pick **Weapon**, and a sparkle icon appears. Type *"A worn 1920s revolver, .38 calibre, 6-shot cylinder, wood grip"* and get a fully-statted CoC7 weapon back β€” skill, damage, range, ammo, malfunction. Or pick **NPC** in the Create Actor dialog and describe a character (*"A nervous pharmacist in 1920s Arkham, middle-aged, hides a laudanum habit"*) to get the full stat block, skills resolved against the official CoC7 compendium, weapons, possessions, biography, and Keeper notes β€” ready to drop on the canvas.

Plug in your own key for **Anthropic Claude**, **OpenAI GPT**, or **Google Gemini** under **Settings β†’ Module Settings β†’ CoC7 QoL Improvements**. Your prompt goes straight to the provider you chose β€” the module doesn't proxy your traffic.

![Generated weapon stats](images/Create-Weapon-3.png)

[**Read the full walkthrough β†’**](docs/features/ai-generation.md)

---

## Internationalization

All user-visible strings flow through FoundryVTT's i18n system. Currently shipping with:

- **English** (en)
- **FranΓ§ais** (fr)

Dialogs, buttons, settings, and notifications follow your configured Foundry language. PRs for additional languages are very welcome.

## Installation

### From FoundryVTT

1. Go to **Settings > Manage Modules > Install Module**
2. Paste the manifest URL:
```
https://github.com/martin-papy/coc7-qol/releases/latest/download/module.json
```
3. Click **Install**

### Manual

1. Download the latest release from the [Releases](https://github.com/martin-papy/coc7-qol/releases) page
2. Extract into your `Data/modules/` directory
3. Restart FoundryVTT

## Compatibility

- **FoundryVTT:** v13+
- **System:** Call of Cthulhu 7th Edition (CoC7) β€” v8.x

## License

[MIT](LICENSE)