Auto-Cards/README.md
2025-05-17 18:35:06 -04:00

31 lines
2 KiB
Markdown

# Auto-Cards
Made by LewdLeah ❤️
## Overview
Auto-Cards is a plug-and-play script for AI Dungeon that watches your story and automatically writes plot-relevant story cards during normal gameplay. My primary goal was to address the "object permanence problem" by extending story cards and memories with deeper automation. Auto-Cards builds a living reference of your adventure's world as you go.
## Main Features
- Object permanence! (sort of)
- Simple and easy to use, full background automation allows you to focus on gameplay
- Detects named entities from your story and periodically writes new cards
- Smart long-term memory updates and summaries for important cards
- Fully customizable AI card generation and memory summarization prompts
- Suitable for both free and premium AI Dungeon users alike
- Optional in-game commands to manually direct the card generation process
- Optional in-game scripting interface (LSIv2)
- Optional API for other creators to use
## Permission
Auto-Cards is both free and open source for anyone to use within their own scenarios or scripts, even including published works. General-purpose usefulness and compatibility were my top design priorities. You have my full permission to use, copy, or modify Auto-Cards. Please enjoy! ❤️
## Installation Guide
1. Sign-in on the [AI Dungeon website](https://aidungeon.com/)
- Scripts cannot be *added* via the AID mobile app! Though they can still be *played*
- Adding scripts via the AID mobile website is an enormous pain in the ass
2. Create a new scenario or edit an old scenario (Scenarios are not adventures!)
3.
## Useful Links
### Minimal demonstration
- https://play.aidungeon.com/scenario/Ddt0Akd-lVtj/auto-cards
### My AI Dungeon profile page
- https://play.aidungeon.com/profile/LewdLeah
### Auto-Cards discussion thread
- https://discord.com/channels/903327676884979802/1347300413652734064/1347300413652734064
- https://discord.gg/VJXwe7bj3A (AI Dungeon main Discord server, required to access the link above)
- Just ping me any time @LewdLeah to talk