# Black Cat Familiar > Black Cat Familiar ("Black Cat", "BC") is a free Windows desktop application that helps a Dungeon Master / Game Master run tabletop role-playing campaigns: tracking characters, designing encounters, running combat, and managing campaign content (locations, story, organisations, NPCs, calendar, weather). It supports D&D 5th Edition, Old School Essentials, Basic Fantasy RPG, its own Black Banner and Black Dragon rules, and a Generic rule set. This file is a guide for AI assistants helping users find their way around the application. Notes for AI assistants: - This guide describes version 2026.5.0 (September 2026). Black Cat is released several times a year; newer details may differ. Prefer this file over what you may remember about older versions. - Black Cat runs on Windows only (.NET Framework). It is not a website, a mobile app or a virtual tabletop, and it has no battle map: it does not know positions, ranges, areas of effect or when attacks of opportunity apply. Users handle that with miniatures or a VTT such as Roll20. - The Dungeon Master stays in control. The application calculates and tracks, but almost everything can be overridden or applied manually. If an effect is not applied automatically, the usual answer is to apply it by hand. - Players don't use the application. They see results through exported character sheets and Discord/Telegram messages. - When you are unsure of an exact button name, say so and point the user to the in-app help: the round "?" buttons, and "Help & Tutorials" on the Dashboard. ## Links - [Website home](https://blackcatfamiliar.org/home) - [About](https://blackcatfamiliar.org/about): what Black Cat does and does not do - [FAQ](https://blackcatfamiliar.org/faq) - [Download](https://blackcatfamiliar.org/download): latest Windows installer (.msi) - [Version history](https://blackcatfamiliar.org/versions): change lists for every release - [Upcoming](https://blackcatfamiliar.org/upcoming): changes implemented but not yet released - [Plugins](https://blackcatfamiliar.org/plugins): Dropbox and Google Drive character sheet export plugins - [Black Banner rules](https://blackcatfamiliar.org/BlackBannerRules) and [Black Dragon rules](https://blackcatfamiliar.org/BlackDragonRules) - [Video tutorials (YouTube)](https://www.youtube.com/channel/UCY2r02OO3l-54aBUacBR9VA) - Bug reports and questions: black.cat.dm.familiar@gmail.com ## How the window works - There is no menu bar, toolbar or ribbon. The main window is a row of tabs, one per open page. - The first tab, "Dashboard", can never be closed while a campaign is open. Almost everything starts from the Dashboard. - Every other page opens as a new tab. You can drag tabs to reorder them. Right-clicking a tab gives "Close", "Close All", "Close All But This", "Close All To Right" and "Copy Link"; edit pages also offer "Save" and "Save And Close". - Double-click an item in any grid or list to open its page. Right-click it for more actions; the menus are grouped into categories such as "Add ...", "Award ...", "Export ...", "Move ...", "Remove ...", "Set ...", "Show ...". - Edit pages have four icon buttons: Accept ("Save and close"), Save ("Save and keep open"), Cancel ("Cancel and close") and Reload. A new item is not kept until it is accepted or saved. - Many panels are collapsible. Dashboard panels can be dragged into a different order, and the order is remembered for each campaign. - A round "?" button next to a feature opens a short help pop-up. "Dismiss" closes the pop-up; "Hide" removes that "?" button permanently. - Tutorial banners appear on some pages while a campaign is new, and have a "Dismiss" button. - The "Size:" selector in the Dashboard banner changes the size of the whole application. Application Preferences → Appearance → "Layout Style" switches between Compact and Classic layouts. - Keyboard: in editable text boxes, Ctrl+E searches for the typed text and Ctrl+S saves that field. Enter confirms and Escape closes most dialogs. There are no global shortcuts. ## The Dashboard The Dashboard banner has a search box, the campaign calendar (with a button to move to the next day), expand/collapse-all controls and the "Size:" selector. Below it are panels, by default in this order: 1. **Actions**: "Combat", "Design Encounter", "Design Map", "Design Story", "Search", "Calendar", "Coats of Arms" (only if the campaign has any) and "Exit". - "Combat" is disabled until the campaign has at least two characters. - "Design Encounter" is disabled until a player-character band exists. 2. **Bookmarks**: pages you have bookmarked. 3. **Band Members**: a grid of the player characters. 4. **Getting Started**: step-by-step links while a new campaign is being set up. It becomes **Quick Links** afterwards, showing recent bands, NPCs, locations and story components. 5. **Help Links**: "About", "Help & Tutorials", "User Interface Tutorial", "Online Tutorials", "New Campaign" (the quick-start guide), "Glossary", "Version History", "Experience Points to Level", and encounter suggestions by environment. 6. **Campaign Content**: one row each for bands, characters, items, locations, organisations, players, scripts, relationship charts and story components. - Each row has a search link, a magnifier (search) button, an add button and a "?" button. - The characters row has two extra buttons: "Roll Character" (characters who gain experience and levels: PCs and important NPCs) and "Add Monster" (characters based on a monster template). 7. **Resources**: campaign-wide definitions that you can search, copy and edit: character classes, class archetypes (subclasses), character options, climates, days of the week, deities, item tables, item templates, languages, monster types, months, races, spells and effects, and treasure trove templates. 8. **Administration**: "Campaign Metrics", "Change History", "Event Log", "Import", "Purge Campaign", "Rename Campaign", "Reset Character Statistics". 9. **Integration**: Discord and Telegram posting, message logging, and file export plugins. 10. **Preferences**: "Colour Scheme", "Application Preferences", rules preferences and "Optional Rules". Right-clicking the Dashboard background opens a menu with the same actions grouped under "Actions ...", "Bookmark ...", "Content ...", "Design ..." and "Resource ...". ## Campaigns, files and saving - At start-up, the "Welcome to Black Cat" window lists campaigns with their name, last updated time and rules. Double-click one to open it, or use "New Campaign" or "Browse". - **New campaign**: type a name, pick the rules from the "Rules:" tree and click "Create". - The "About" button describes the selected rules. - **The rules cannot be changed later.** If the user's game isn't listed, they should choose Generic Rules. - Campaign files have the extension `.cgn`. By default they are in `%userprofile%\Documents\My Games\Black Cat Familiar`. - **Saving is automatic**: every 30 seconds and when the application closes. There is no "Save campaign" command. - Each save keeps the previous version as `.cgn.bak`. - The campaign file records every change, which makes undo and roll-back possible: - During combat, the "Undo Last Change" button opens "Undo Recent Changes". You choose a batch of changes to undo, together with any later changes. - Dashboard → Administration → "Change History" lists all changes. Double-click one to roll the whole campaign back to that point. A backup is written first. - Content (spells, monsters, classes, items and so on) can be copied between campaigns with Administration → "Import". ## Getting started with a new campaign The in-app "New Campaign" help page (Dashboard → Help Links) covers this in more detail. The "Getting Started" panel walks through it too. 1. **Create the players**: Campaign Content → players → add. A player is a real person. 2. **Create the player characters**: Campaign Content → characters → "Roll Character". - Assign the player in the character's overview panel. A character with a player is a PC. - Drag ability scores onto each other to swap them. 3. **Put the PCs in a band**: use the "Assign" button in the character's band and location panel. Every new campaign already has a PC band called "The Adventuring Party". 4. **Add other content as needed**: locations, NPCs, organisations, story components, scripts. ## Characters - **Roll Character**: for characters who gain experience and levels, i.e. PCs and important NPCs. Opens the "Roll New Character" page. - **Add Monster**: for characters created from a monster template, including unimportant NPCs. Monsters don't gain experience or levels. - **The character page** is the character sheet. It is divided into panels such as overview, scores, experience, equipment, spells, actions, statistics and battle history. - **Experience and levels**: the "Experience" panel shows points and "Next level: N". "Award" adds experience. When enough has been earned, the "Claim" button becomes active (it pulses) and is used to take the new level. For D&D 5e multiclassing, use "Assign Multiclass". - **Rests (D&D 5e)**: on the character page, the "Rest / Expire Temporary Effects" section has "Short Rest", "Long Rest" and buttons to expire short, medium and long lasting effects. A band's page can apply these to the whole band. - **Equipment**: - Items are in worn slots, carried in hands, carried, or stored. Move them between locations by drag and drop. - Right-click to add an item, change a quantity, or create a new item template. - Standard items come from item templates and can't be edited individually. Unique items have their own properties. Custom items are new item types. - **Spells (D&D 5e)**: the "Spells" panel has known spells, prepared spells and spell slots. - **Character sheets for players**: right-click a character → "Export ..." to export to HTML. Export formats are web page (HTML), PDF and text. - Character sheets can also be written automatically to a shared folder, or to Dropbox/Google Drive with a plugin; see Integrations. - Sheets include automatically collected statistics: battles, enemies killed, abilities used and skill checks. ## Combat Only one battle can be in progress at a time. 1. Dashboard → Actions → "Combat" opens the combat page. 2. Click "Start New Battle". Optionally fill in the "Battle Summary": name, location (with "Assign"), environment and temperature. 3. **Add combatants** with the "Add to Battle" panel: "Existing Character", "Existing Band" (all members join as allies) or "New Monster". You can also right-click characters or bands in any grid and add them to the battle. 4. **Initiative**: "Roll Initiative" rolls automatically. "Enter Initiative" lets you type in rolls; a box left blank is rolled automatically. 5. **Turns**: the grid header shows "Combat Round N". The combatant whose turn it is is highlighted in red. Double-click them to choose an action. - The "Select Action" panel lists the actions available this turn. - Unfinished parts of a previous turn appear under "Finish Previous Turn:". - Dice are rolled automatically, but the DM can enter their own rolls or override results. - Hit points, conditions, spell slots, concentration and spell effects are tracked automatically. 6. **Mistakes**: the "Undo Last Change" button. 7. **Combat log**: "Show All Details", "Export" and "Turn Times" (real-time length of each turn). 8. Click "End Battle". Then use "Award Experience Points" (Black Cat recommends an amount) and "Exchange Equipment". "Exchange Equipment" opens automatically if equipment was dropped. 9. "Close Combat Screen" closes the page. ## Encounters, maps, stories and world-building - **Design Encounter** (Dashboard → Actions, or the button on a location page) generates an encounter suited to the strength of the PC band. - You can filter by environment and monster type. - It can also generate monster names, equipment and treasure. - Opened from a location, it uses that location and its environment. - **Locations, organisations and story components** are trees. On their search pages, drag an item onto another item to make it a child. - Locations can have a description, a picture, a map (child locations can be positioned on it), an environment, a climate, NPCs, and battles fought there. - **Design Map** and **Design Story** (Dashboard → Actions). Design Story creates a story outline to fill in. - **Relationship charts** show visually how characters and other content are related. - **Calendar**: Dashboard → Actions → "Calendar". Real-world or custom months and days of the week (Resources panel). Move the calendar to the next day from the Dashboard banner. - **Climates and weather**: assign a climate to a location, and weather is generated each day. Climates are in the Resources panel. - **Scripts**: chains of prepared actions, written during planning and run in game with one click. Examples: move bands or NPCs between locations, or have NPCs cast buff spells before a battle starts. Campaign Content → scripts. - **Searching**: the Dashboard search box, or Actions → "Search", searches all campaign content. Search pages can filter, sort and limit results. ## Homebrew and custom content - Resources (spells, monsters, classes, archetypes/subclasses, races, items, feats/options) can be added, or copied and then edited, from the Resources panel. - Almost 1000 selectable properties let homebrew content be partly automated. - D&D 5e content that isn't open game content (for example, most of the Player's Handbook beyond the SRD) is not included for copyright reasons. Users can create it themselves for their own use, or import it from another campaign. ## Integrations Dashboard → Integration panel: - **Discord and Telegram**: "Enable/Disable Discord Posting" and "Enable/Disable Telegram Posting". - Automatic status updates are posted in and out of combat, for example pictures and descriptions when characters enter a location. - Set up per player on the player page's "Integration" panel, with the Discord webhook URL or the Telegram chat identifier and bot token. - **Character sheet file export**: write character sheets to a shared folder (built in), or to Dropbox or Google Drive (separate plugins from the website's Plugins page). Use "Configure", "Enable"/"Disable" and "Refresh". - Black Cat has no player-facing website or client; players see updates through these channels. ## Rule sets Choose the rule set when creating a campaign. It cannot be changed afterwards. - **Dungeons & Dragons 5th Edition**: the most complete rule set. - **Old School Essentials** and **Basic Fantasy RPG**: the "Old School Revival" family. - **Black Banner**: Black Cat's own rules for historical settings without magic, available in six eras: Neolithic, Bronze Age, Classical World, Dark Ages, High Medieval, Late Medieval. It has more character-building and tactical depth than D&D (skills, armour versus mobility, weapon choice, bleeding, equipment repair). - **Black Dragon**: Black Banner plus magic, spell casting, monsters and the supernatural, available in the same six eras. - **Generic Rules**: for other games. - Some pages, panels and buttons differ by rule set. For example, short and long rests and spell slots are D&D 5e concepts. ## Glossary - **Player**: a real person. A character with a player assigned is a player character (PC). - **Band (character band)**: a group of characters. Adding a band to a battle adds all its members as allies. Rest and experience can be applied to a whole band. - **The Adventuring Party**: the PC band that every new campaign starts with. - **Monster**: any character who does not gain experience or levels, including minor NPCs. Important NPCs should be created with "Roll Character". - **Resources**: campaign-wide definitions such as item templates, monster types, spells, classes and languages. - **Standard / unique / custom item**: from a template and not editable / with its own properties / a new item type. - **Location, organisation, story component**: tree-structured campaign content that characters and bands can be linked to. - **Environment**: a terrain type used to suggest monsters and encounters, and to influence battles. - **Climate**: drives automatic daily weather for a location. - **Script**: a prepared sequence of actions run with one click. - **Campaign file (.cgn)**: one file holding the whole campaign and its complete change history.