Sneak peak at big new feature for BetterDungeon V2.1. An AI agent capable of improving and modifying your adventures, so you can play better, without the hassle.
More info coming soon. ;)

Hey everyone! It's computerK here, and the day has finally come. BetterDungeon V2 is officially out, right now. This is by far the biggest release I've ever shipped for the BetterEcosystem. It's been months of work under the hood, and I could not be more excited to finally put it in your hands. Let's get into it.

Where Can I Get It?

BetterDungeon is now properly cross-platform, available on both browsers and mobile phones, day one:

• Chrome: Available on the Chrome Web Store - Click the link or search "BetterDungeon" in the store.
• Firefox: Available on the Firefox Add-ons store - Click the link or search "BetterDungeon" in the store.
• Android: Available as a downloadable APK on my GitHub Releases page, or in the BetterDungeon Discord thread pins section.

What's BetterDungeon?

BetterDungeon is an all-in-one browser extension and mobile app for AI Dungeon that enhances the experience with QOL additions and brand new features. It's a toolkit built for everyone: players, writers, scenario creators, and scripters. It adds new ways to play, smarter creation tools, rich formatting, useful automations, and an entirely new scripting bridge called Ultrascripts. Whether you just want your stories to look and read better, or you want to build scripts that break out of the sandbox entirely, BetterDungeon has something for you. And as always, the whole project is open source for anybody to read and contribute to.

What's New?

I've written up a whole blog post detailing everything that's new in BetterDungeon V2. If you're interested, check it out here.

Thank You

Thank you all so much for the patience and support while I worked on this. This has been the biggest project I've ever tackled, and the love you've all shown genuinely kept me going. I hope V2 was worth the wait, now go try it out and tell me what you think!

Much love. 🖖
computerK

Stateboy: AI-Assisted State Management for AI Dungeon

AI Dungeon’s greatest strength is that it is an infinite, extremely flexible storyteller.

But that flexibility comes with a tradeoff: you lose rigidity and structure.

Want a level system? Good luck making sure the story model consistently tracks your XP, abilities, levels, stamina, inventory, wounds, quest flags, relationships, reputation, time of day, or any other persistent state.

If your scenario needs to track anything over time, the model can forget it, drift away from it, or contradict it.

Grounding the story model with real, persistent, easily editable states could drastically improve prose, consistency, and scenario design.

Scripts like True Auto Stats try to solve this, but they are forced to rely on NLP and hardcoded systems. That can work for simpler RPG stats, but it becomes inaccurate or too rigid once you want anything more abstract than a basic leveling system.

What Is Stateboy?

This is why I’m creating Stateboy, one of three showcase scripts powered by my Ultrascripts system in BetterDungeon.

Stateboy is a plug-and-play state tracking script that uses the power of the Ultrascripts AI module to maintain and update scenario states.

Scenario creators define initial states. Players can add, edit, or remove states at any time. Then Stateboy helps keep those states accurate during play.

Before Ultrascripts, stat tracking scripts were mostly limited to pure math, commands, or NLP. Those approaches can be useful, but they are also limited and inflexible.

Stateboy takes a different approach.

Instead of forcing every state into a rigid command system, or hoping a parsing algorithm correctly guesses intent from messy natural language, Stateboy works from a readable Story Card that acts like a living state sheet.

It is still editable by hand, but it can also be interpreted and updated by AI with structure.

Example State Sheet

For example, a Stateboy card could look like this:

## Player Stats

XP: 500/1000 (The current XP of the player)

Level: 67 (The current level of the player)

Stamina: 88% (How tired the player is)


## Party

Relationship: Good (How the party feels about you)

Inventory: Lint Roller, Frying Pan, 27 Ice Cubes (Shared inventory)


## World State

Time: Night (The current time of day)

QuestStatus: In Progress (The main quest's current state)

That gives you immediate benefits:

• If the player earns XP, Stateboy can update XP.
• If the party starts hating the player, Relationship can shift from Good to Hostile.
• If a quest is completed, QuestStatus can become Completed.
• If the player is exhausted, Stamina can drop to 32%.

Because the AI is working from a structured state sheet instead of free-floating assumptions, it can keep the story model grounded in the actual values of your scenario.

Beyond Basic Stats

Stateboy is not just for HP and XP.

Imagine a sci-fi scenario with more abstract states:

## Crew Status

Morale: Stable (Crew morale)

Suspicion: 0.25 (How much the crew distrusts you)

HullIntegrity: 91% (The ship's current condition)


## Research

ArtifactAnalysis: Partial (How much of the artifact has been decoded)

SignalLock: False (Whether the signal is currently stable)


## Factions

UnionReputation: Neutral (Your standing with the Union)

PirateThreat: High (How dangerous the pirate presence is)

This is the kind of thing simple stat scripts usually struggle with.

It is not just health, mana, and level. It is relationships, narrative flags, world conditions, partial progress, reputation, hidden tension, and custom states that do not fit neatly into one narrow system.

That is where Stateboy is meant to shine.

Why AI Matters Here

The real advantage of using AI is that anything can be a state.

Stateboy is not just doing math. It is interpreting story context and proposing meaningful updates to whatever state system your scenario actually needs.

That means it is not limited to hardcoded mechanics or shallow keyword detection. It can support custom systems that are dense, weird, abstract, or genre-specific without forcing the creator to rebuild the script from scratch.

Want an RPG? That works.

Want a mystery scenario? That works.

Want a political simulator, survival game, relationship drama, sci-fi crew management story, kingdom tracker, corruption system, investigation board, or weird custom mechanic? That should work too.

Anything and everything can be a state.

Creator Control Still Matters

The state sheet is still readable by humans.

Stateboy does not turn your scenario into a black box. You can open the card, inspect the values, edit them by hand, rename them, add new ones, remove old ones, and keep full control over what exists in the system.

The AI helps maintain the structure, but the structure still belongs to the creator.

That is the combination I think makes Stateboy interesting.

It is not so rigid that it breaks when your scenario becomes unusual, and it is not so loose that the story drifts into nonsense. It is a middle ground between manual tracking and blind automation.

In other words, Stateboy is meant to make state feel native to the story instead of bolted onto it.

And that is why I think it has real potential. Not because it tracks stats, but because it can track almost anything while staying readable, editable, and story-first.

Feedback Wanted

I’m still shaping the design, so I’d love feedback from AI Dungeon players and scenario creators.

A few questions:

• Would you use a system like this in your own scenarios?
• Is the readable Story Card format clear enough?
• What kinds of states would you want to track?
• Should Stateboy focus first on RPG stats, inventories, quests, relationships, or broader world-state tracking?
• Would you want the AI to auto-apply changes, or should there be an approval mode?
• What safeguards would make you trust AI-assisted state updates?
• How much state should be shown through widgets before it becomes cluttered?

I’m especially interested in weird use cases. If you have a scenario idea with unusual stats, abstract progress, hidden flags, or custom systems that normal scripts struggle with, I’d like to hear about it.

BetterDungeon V2 is ALMOST here (and it's really sick)

Hey everyone! It's computerK here, and I've come bearing great news. I am excited to annouce that the V2 major revamp of BetterDungeon is almost here.
It's been over 3 months since my last update, and I imagine a lot of you have been wondering whether BetterDungeon was dead or abandoned. But the honest answer is that it was just a lot of work under the hood. I can finally say it out loud though: BetterDungeon V2 is nearly finished, and it's shipping alongside BetterRepository V1.7.

This is the biggest release I've shipped for what I am calling the "BetterEcosystem", and most of the silent months were spent on one thing: Ultrascripts. This post is to say that I'm still alive and kicking, and and I'm going to dive into what I've gotten done and what you can get excited for.

What is Ultrascripts??

Ultrascripts is my brand new two way communication system between the BetterDungeon extension and AI Dungeon scripts. I have always wanted a way to build on the scripting system, to unshackle it (like what I tried with BetterScripts), and I can proudly say that Ultrascripts is genuinely capable.

Instead of embedding protocol messages within the story text, it exposes native, permission-gated modules that scenario scripts can call directly. Two-way request/response, a write queue, heartbeat discovery, and state-card dispatch allow scripts to gain superpowers, and it's all powered by AI Dungeon's own story card system.

What does this mean for scenario creators and scripters? It means your scripts can now reach real browser capabilities from inside a script, and BetterDungeon handles the transport, lifecycle, and permissions for them. You can call another AI model, generate real, interactive UI widgets. search the web, and more. Your scripts are no longer limited by the sandbox, and this enables truly remarkable capabilities.

Just as an example, during testing, I created a fork of Auto Cards that utilizes my AI module for its functionality. It was more intelligent, could handle a larger quantity of context, and was entirely silent. This is what really gets me excited. Ultrascripts is a genuinely powerful tool for script creators, and it enables them to do some incredible things.

With the V2 launch, I am releasing 9 fully documented modules for any scenario creator and scripter to play with, on BetterRepository. To go along with that, I will be releasing 3 brand new scripts to showcase Ultrascripts capabilities. I'll be teasing them in some posts later down the line. Just know that they will knock your socks off.

BetterDungeon is Cross Platform?

A target that I have been meaning to hit for a while is making BetterDungeon cross-platform. Well, I am extremely excited to say, that V2 will be launching with Firefox and Android releases, day one.

The Firefox release will be posted on the Firefox Browser Add-ons store when V2 officially releases, so no more installing as a temporary extension. It's properly here now.

The Android release is going to be posted as a downloadable APK file for you to install. Just check out the GitHub releases tab when V2 drops to get access.

An Android release was a target for BetterDungeon from the very beginning, so I am very pleased to say that it's finally here. I hope you all will enjoy. As usual, BetterDungeon's Mobile port is entirely open source for anybody to read and contribute to.

What Else is Here?

I didn't just want BetterDungeon V2 to just be Ultrascripts and cross platform. I have gone back and refreshed and polished over 5 features for BetterDungeon:

• Story Card Scanner, Story Card Dashboard, Trigger Highlighting:
  • I've spent a lot more time diving into the GQL systems of AI Dungeon and I have returned with knowledge and a bunch of feature polish! The Story Card Scanner used to use fragile DOM scraping to do what it needs to do, but I have reworked it to use GQL to instantly acquire all information from every story card in a scenario. This means that the Dashboard is always accurate and trigger highlighting no longer requires a wait.
• Markdown:
  • It was Leah who told me "a well-made Markdown system would get a lot of attention", so I've decided to go back and rework my first ever feature, using my improved knowledge of prompt engineering. Markdown has been improved from the ground up, with less refusals, more focused prose, and 6 unique instruction sets to allow for any scenario to have rich formatting.
• Character Presets:
  • A fan favorite feature of mine has gotten a pretty major bump in quality and versatility, thanks to my rework of the system. Rather than the stupid simple KV pair system I was using before, Character Presets now allow you to describe your characters in natural language, and use my AI module (powered by Gemini) to provide high quality, accurate suggestions to answer scenario prefill questions.
  • Character Presets is one of the features I am most proud of here. It's surprisingly helpful in speeding up scenario creation, and it's intelligent enough to know when to defer back to the player.
  • To use the new and improved Character Presets feature, simply configure the Gemini API key in the AI module in Ultrascripts, and you should be good to go.
• Auto See:
  • Auto See has received a little love with V2, using GQL messages to send out See requests, instead of using DOM manipulation. This should be less interrupting, though I am looking for feedback :)

Okay, but What Features are New?

BetterDungeon V2 isn't just polishing old features, you know. I've created 2 brand new features to improve the lineup, and they are sick:

• Custom Dynamic:
  • Big thanks to Zoocata for allowing me to use his PRISM extension as inspiration for this feature!
  • Custom Dynamic allows YOU to configure your own Custom model, by setting up a pool of models that the system will choose from. It's a great, unintrusive feature, adding a feature many have been desiring.
• Text to Speech:
  • Using the speech engines provided in Chromium, Firefox, and Android, the Text to Speech feature allows for my extension to automatically narrate recent story context for you, to create the feeling of reading along with an audio book.

What's Coming Next?

For the sake of ensuring BetterDungeon V2 doesn't drag on even longer, I have finalized everything for the most part.

I will, however, be working on 3 brand new scripts to showcase the power of Ultrascripts. As work continues on them, I will be posting teasers to showcase my progress and show what they can do.

My 3 ideas are:

• Brainiac:
  • Brainiac is an automatic Story Card generation, NPC brain manager, and NPC intent generator. Combining the concepts and ideas layed out by Auto Cards, Inner Self, Living Characters, MemorAID, Slowburn, Soleil and MindForge, Brainiac leverages the powers unlocked by the AI module, for a truly intelligent and capable NPC script.
  • I have not yet landed on the specifics of what this script will do, but I intend on creating a truly great AI/NPC management script.
  • What's really great is that the AI module means we aren't limited by AI Dungeon. We don't need to hijack the story like Auto Cards or pollute the story context with zero-width encoded characters like Inner Self. It's more seamless and more intelligent. Win win win.
• Stateboy:
  • A flexible and fluid state management script. Stateboy leverages my Widget module and AI module to manage a JSON schema of relevant states, allowing for proper state management and tracking, to enhance and ground AI responses in real scenario states.
  • You'll be able to easily modify what states are tracked and displayed, and my goal is for this to be plug-and-play for any scenario, to enable easy and intuitive state management.
  • In this case, "states" is any tracked stat/variable that the user or scenario has designated to track. Thanks to the AI module (I know, you hear that a lot... it's just so useful), we don't need to rely on NLP, meaning any state can be easily tracked and modified by both the player and a separate AI.
• Chronos V2:
  • An improvement on my surprisingly popular existing timekeeper script, Chronos V2 will enhance and improve the existing systems. It will be an all-around upgrade and should be quite exciting.
  • Just as an example, Chronos V2 will be able to sync to your real world time and your real world weather, for maximum immersion if you so choose.
  • This will be the only showcase script that is only "enhanced" by Ultrascripts, meaning it will still function just fine for those not using BetterDungeon.

When Can I Get BetterDungeon V2?

BetterDungeon V2 (and BetterRepository V1.7) aren't here yet, but they are very close to being done. While I don't have an exact date, you can expect it to be releasing within the coming weeks.

I want to thank all of you for the support and love you've shown me while I've worked on this project! This project (and this update) have easily been the biggest projects I've tackled ever, and it is genuinely incredible to see the love you all have shown me. I hope BetterDungeon V2 will be worth the wait, and I cannot wait for you all to check it out.

Much love. 💝

- computerK