Auto-Cards

Made by LewdLeah ❤️

Overview

Auto-Cards is a plug-and-play scenario 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 utilize

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! ❤️

Scenario Script Installation Guide

Use the AI Dungeon website on PC (or view as desktop if mobile-only)
Create a new scenario or edit one of your existing scenarios
Open the DETAILS tab at the top while editing your scenario
Scroll to the bottom and select EDIT SCRIPTS
Select the Input tab on the left
Delete all code within said tab
Copy and paste the following code into your empty Input tab:

// Your "Input" tab should look like this
const modifier = (text) => {
  // Your other input modifier scripts go here (preferred)
  text = AutoCards("input", text);
  // Your other input modifier scripts go here (alternative)
  return {text};
};
modifier(text);

Select the Context tab on the left
Delete all code within said tab
Copy and paste the following code into your empty Context tab:

// Your "Context" tab should look like this
const modifier = (text) => {
  // Your other context modifier scripts go here (preferred)
  [text, stop] = AutoCards("context", text, stop);
  // Your other context modifier scripts go here (alternative)
  return {text, stop};
};
modifier(text);

Select the Output tab on the left
Delete all code within said tab
Copy and paste the following code into your empty Output tab:

// Your "Output" tab should look like this
const modifier = (text) => {
  // Your other output modifier scripts go here (preferred)
  text = AutoCards("output", text);
  // Your other output modifier scripts go here (alternative)
  return {text};
};
modifier(text);

Select the Library tab on the left
Delete all code within said tab
Open my full Library code (hyperlink below) in a new browser tab

Library code

Copy my full code from the page above and paste into your empty Library tab
Click the big yellow SAVE button in the top right corner
And you're done!
Keep in mind that any adventures played from your scenario will include Auto-Cards (this also applies retroactively)

Useful Links

Simple demo scenario

Auto-Cards

My AI Dungeon profile page

LewdLeah

Auto-Cards discussion thread

Auto-Cards script testing & feedback
AI Dungeon official Discord server invite (required to access the first link)
Just ping me any time @LewdLeah to talk

3.9 KiB Raw Permalink Blame History