Hello dungeon crawlers,
Today I want to share a little side project I started next to actually playing the game. As you probably noticed already, I really enjoy Dungeon Cities so far. But while playing I kept running into small things I was missing.
It is a small dev team, I think one or two people working on it, and they clearly have big expansion plans. So I totally get that quality of life features are not always top priority.
But then I thought… why not just build it myself? 😄
I like the challenge and I mainly wanted it for my own progression anyway.
Why I Started The Dungeon Cities Companion
One thing I kept missing was a clear overview of:
- Which monster drops which item
- Where I can find that monster
- What I still need to fully discover
When you are grinding floors and cities, you forget quickly where that one specific resource dropped. So I decided to create a small public open source project that helps with exactly that.
And that is how the Dungeon Cities Companion was born.
If you just want to take a look, here is the live version:
👉 https://dungeoncities-next.vercel.app
It is based on my progression. I upload my static data once in a while, so what you see reflects my MonsterDex progress.
Monster Overview And Loot Drops
On the home page you see all the monsters I have discovered so far and their loot drops.
You can search by:
- Item name
- Item ID
That makes it super easy if you are hunting for one specific resource.
If a monster is fully discovered, you will also see the drop chances and drop quantity.
If not, you will get a message that the monster is not fully discovered yet.
So it also gives you a nice reminder that you still need to grind that one a bit more.
The Forge Feature
Now comes my favorite part of the project.
The Forge 🔥
At the moment it only supports Druantia, but once I progress further I will expand it to Brighthollow and Elaria as well.
Inside the Forge section you can:
- See which keys you can craft
- See which resources are required
- Click on a resource
Instantly see which monster drops it needs.
Instead of thinking
“Wait… where did that drop again?”
You just click and you know.
Undiscovered Monsters
This feature is mainly built for myself, but it is also really nice to see which monsters I still need to grind. I already noticed I skipped a few in Aldoria. At some point I will have to go back there and clean up my MonsterDex properly 😄
Using It With Your Own Data
For most players the online version will probably be enough.
But if you want to use it with your own MonsterDex data, you can. The project is fully open source.
GitHub repo:
https://github.com/gamerbeaker007/dungeoncities-next
You will need Node.js installed:
https://nodejs.org/en/download
Once you cloned or downloaded the repo:
- Run
npm installto install all packages - Copy
.env.exampleto a new file called.env - Fill in your API token
You can get your bearer token by:
- Logging into Dungeon Cities on your PC
- Opening the browser inspect tool
- Looking for the bearer token in the network requests
or via localstorage:
Keep in mind that this token is short lived, so it is only valid for a limited time.
After that, run:
npm run sync:monster-datanpm run dev
Then open your browser and go to:
http://localhost:3000/
Now you will see your own MonsterDex data inside the companion app.
Happy days 😎
Closing Notes
This project is mainly meant as a static data companion. I am not planning to turn it into a big database system or start storing player data.
It is just a helpful tool for overview and planning.
I will try to update the site when I progress further, and if I find the time I might expand it with more features.
If you have ideas, let me know. I am always open to cool suggestions.
For now I am just enjoying building and grinding at the same time.
Beaker signing off 👋
If you want to jump into the action yourself check out the links below.
Official Game Site: https://dungeoncities.com/
Official Game Discord: https://discord.gg/8YYbuvMA3t
If you decide to join feel free to use my referral link and support the grind
https://play.dungeoncities.com/login?ref=beaker007
See you in the dungeons 🔥