mirror of
https://github.com/LewdLeah/Auto-Cards.git
synced 2025-07-07 22:20:27 -04:00
37 lines
2.2 KiB
Markdown
37 lines
2.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! ❤️
|
|
## Basic Installation Guide
|
|
1. Use the [AI Dungeon website](https://aidungeon.com/) on PC (or view as desktop if mobile-only)
|
|
2. [Create a new scenario](https://help.aidungeon.com/faq/what-are-scenarios) or edit one of your existing scenarios
|
|
3. Open the "DETAILS" tab at the top while editing your scenario
|
|
4. Scroll to the bottom and select "EDIT SCRIPTS"
|
|
5. Select "Input" on the left
|
|
6. Delete everything you see there
|
|
7. Copy + paste [this stuff](/input.js) inside:
|
|
```javascript
|
|
// Hello
|
|
```
|
|
8. Test
|
|
## 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
|