Titan Quest Studio
Complete User Guide — Professional Mod Editor for Titan Quest Anniversary Edition
v0.1.0 · 2024Requirements
The Game
- Titan Quest Anniversary Edition — installed through Steam (App ID 475150)
- The game must have been launched at least once so that
Database.arzis present on disk
Titan Quest Studio
- The TitanQuestStudio_Setup.exe installer — available from enigmaprojects.org
Installation
- Download TitanQuestStudio_Setup.exe from enigmaprojects.org
- Run the installer and follow the on-screen wizard
- Choose an install location (the default is fine) and click Install
- Optionally tick "Create a desktop shortcut" on the tasks page
- Click Finish — the app is ready to launch
Starting the App
Launch Titan Quest Studio from the Start Menu shortcut or your Desktop shortcut (if you ticked that option during install).
A dark-themed window opens. On the very first launch, the Setup Wizard starts automatically to configure your game path and workspace.
First-Time Setup Wizard
The wizard runs once on first launch. You can re-run it at any time via Help → Run Setup Wizard…
Page 1 — Detect the Game
The wizard searches for Titan Quest automatically via the Windows registry and Steam's library config file. Two outcomes:
- Found automatically — the game path is shown. Click Next.
- Not found — click Browse and navigate to your TQ:AE folder manually, e.g.:
C:\Program Files (x86)\Steam\steamapps\common\Titan Quest Anniversary Edition
Page 2 — Create a Project
A project is a workspace folder where all your edits are stored.
- Type a project name (e.g.
MyMod— this becomes the mod name when you build) - Click Browse and choose (or create) a folder on disk for this project
- Click Next
Page 3 — Done
The wizard saves your settings and loads the application. The Database Explorer fills with the game's full record tree.
Understanding the Main Window
┌──────────────────────┬─────────────────────────────────┬───────────────────┐ │ DATABASE EXPLORER │ EDITOR TABS (centre) │ PROPERTY │ │ │ │ INSPECTOR │ │ Virtual file tree │ Each .dbr you open gets │ │ │ of all 74 000+ │ its own tab here. │ Shows the fields │ │ game records │ Edit fields directly │ of whatever you │ │ │ in the table. │ clicked on. │ │ │ │ Read-only │ │ │ │ preview. │ ├──────────────────────┴─────────────────────────────────┴───────────────────┤ │ SEARCH │ CONSOLE / LOG │ │ Find records by name, field, value, etc. │ Shows save/index messages │ └──────────────────────────────────────────────┴─────────────────────────────┘
- All four panels are dockable — drag their title bars to rearrange, float, or snap them.
- Each panel can be shown or hidden from the View menu.
Menu Bar Overview
| Menu | Key actions |
|---|---|
| File | New / Open project, Open .dbr, Open Database.arz, Save All, Quit |
| Build | Build Mod, Extract Database, Re-index Database |
| View | Show/hide each dock panel |
| Help | Run Setup Wizard again, About |
Database Explorer — Browsing Records
The left panel shows the full contents of Database.arz as a virtual folder tree (over 74 000 records). It loads instantly because it only reads the archive's index, not the record data itself.
Navigating the Tree
- Click the ▶ arrow on a folder to expand it
- Keep drilling down:
records → creatures → monster → satyr → … - The tree mirrors the exact folder structure inside the archive
Filtering the Tree
Type in the "Filter records…" box at the top of the panel.
- The tree narrows to only entries whose name contains what you typed
- Clearing the box restores the full tree
Opening a Record
| Action | Result |
|---|---|
Single-click a .dbr | Previews it in the Property Inspector (right panel) — read-only |
Double-click a .dbr | Opens it in a full editor tab in the centre |
The ✏ Edited Toggle
In the header of the Explorer there is a small ✏ toggle button.
- When on (glows gold): the tree shows only records you have already saved in this project
- When off: shows the full 74 000-entry tree
- Records you have edited show a gold pencil icon next to their name
Refreshing the Tree
Click the ↻ button in the header to rescan your project folder and update which records show the pencil icon.
Opening and Editing a Record
How to Open
Double-click any .dbr in the Database Explorer or Search panel. The record opens as a new tab in the centre.
The Editor Tab Layout
┌─────────────────────────────────────────────────────────────┐ │ record_name database/Templates/Monster.tpl ● unsaved Save │ ├─────────────────────────────────────────────────────────────┤ │ Filter fields… 1048 fields │ ├──────────────────┬──────────┬────────────────────────────────┤ │ Field │ Type │ Value │ ├──────────────────┼──────────┼────────────────────────────────┤ │ templateName │ str │ database/Templates/Monster.tpl│ │ characterLife │ float │ 1200 │ │ characterSpeed │ float │ 6 │ │ ... │ ... │ ... │ └──────────────────┴──────────┴────────────────────────────────┘
Editing a Field
- Find the field you want — use the "Filter fields…" box to search by name
- Double-click the value in the Value column to start editing
- Type the new value and press Enter (or click elsewhere to confirm)
- The row turns amber/orange — field changed but not yet saved
- The header shows ● unsaved
Field Types
| Type shown | What to type |
|---|---|
str | Any text |
int | A whole number, e.g. 1200 |
float | A decimal number, e.g. 6.5 |
bool | true or false (or 1 / 0) |
| List | Separate multiple values with ; — e.g. 10;20;30 |
Filtering the Field List
Records often have 1000+ fields. Use the "Filter fields…" bar below the record header:
- Type
life→ shows only fields with "life" in the name - Type
resist→ shows resistance fields - Clear to see everything again
Multiple Tabs & Closing
You can have as many tabs open as you want. Switch by clicking the tabs. Click the × on a tab to close it — if there are unsaved changes you will be asked to save, discard, or cancel.
Property Inspector — Quick Preview
The right panel gives a formatted, grouped, read-only preview of any record.
- Single-click a record in the Explorer or Search to load it here
- When you switch editor tabs, the Inspector automatically updates to match
- Fields are grouped into collapsible sections — click a section header to collapse/expand
- Fields that reference other records show a link — click it to jump to that record
Search Panel — Finding Records
Basic Search
- Click the Search tab at the bottom
- Type a name or path fragment — e.g.
satyr_warrior - Press Enter or click Search
- Results appear below — up to 500 matches
Filter by Template
To find all records of a specific type, type in the Template box:
Monster.tpl— all monster recordscharacter.tpl— all character records- Combine with a name search for narrower results
Filter by Field and Value
- Type the field name in the Field box — e.g.
monsterClassification - Optionally type a value in the Value box — e.g.
Boss - Press Search
- Only matching records are returned
Show Only Edited Records
Check the ✏ Edited checkbox in the filter row. Results are filtered to only records that exist in your project folder (records you have already saved).
Opening a Search Result
| Action | Result |
|---|---|
| Single-click | Previews in the Property Inspector |
| Double-click | Opens in a full editor tab |
Results that have been edited show a gold pencil ✏ icon.
Saving Your Changes
Save the Current Record
- Press Ctrl+S, or
- Click the Save button in the editor tab header
Save All Open Records
- Press Ctrl+Shift+S, or
- Go to File → Save All
Where Files Are Saved
<your project folder>/records/<original path in archive>
For example, if you edit records/creatures/monster/satyr/satyr_warrior01.dbr, it is saved to:
C:\YourProject\records\creatures\monster\satyr\satyr_warrior01.dbr
Database.arz is never modified. Your project folder only holds the files you have changed.Automatic Backups
Every time you overwrite an existing file in your project folder, the old version is copied to <project>/backups/ before it is replaced. You can always recover a previous version from there.
What Happens After Saving
- The amber highlight clears — the row returns to normal
- The ● unsaved indicator disappears from the tab header
- The ✏ pencil icon appears on that record in the Explorer and Search results
- The SQLite search index updates automatically
Tracking Edited Records ✏
A gold pencil icon ✏ appears on any record that has been saved to your project folder. It shows in three places:
| Location | What you see |
|---|---|
| Database Explorer | Pencil on the .dbr leaf item in the tree |
| Search results | Pencil next to the result name |
| Explorer "Edited only" view | Click ✏ in Explorer header to filter to only your records |
This makes it easy to see at a glance which records are part of your mod and which are untouched base-game records.
Building the Mod
When your edits are ready, build them into a mod archive:
- Go to Build → Build Mod…
- Choose an output folder (e.g. your Desktop, or a mod staging folder)
- Click Build
- The tool packs all records in your project's
records/folder into a.arcarchive named after your project - The Console panel logs how many records were packed and where the file was written
Installing the Built Mod
Copy the .arc file to your Titan Quest mods directory:
Documents\My Games\Titan Quest - Anniversary Edition\CustomMaps\<YourModName>\
Or follow the standard TQ mod installation instructions for your version of the game.
Project Folder Structure
When you create a project at e.g. C:\Mods\MyMod, it looks like this:
MyMod/
project.json ← project name, game path, author, and settings
records/ ← only the records YOU have saved (mirrors ARZ structure)
creatures/
monster/
satyr/
satyr_warrior01.dbr
cache/
index.db ← SQLite search index (auto-built; safe to delete)
backups/ ← automatic pre-overwrite backups, named with timestamps
You can open an existing project at any time with File → Open Project… — just point it to the project folder.
Keyboard Shortcuts
.dbr file from diskDatabase.arz filePractical Examples
Increase a Monster's Health
- In the Search panel type
satyr_warrior01and press Enter - Double-click the result to open the record
- In the field filter bar type
life - Find the field
characterLife— double-click its value - Change it from
1200to2400 - The row turns amber — press Ctrl+S to save
- The pencil icon appears on the record in the tree and search results
Find All Boss Monsters and Check Their Resistances
- In the Search panel, fill Field =
monsterClassificationand Value =Boss - Click Search — every boss record is listed
- Single-click one to preview it in the Property Inspector
- Scroll to the resistance fields in the inspector to compare values
- Double-click the one you want to edit it in a full tab
See Everything You Have Changed So Far
Option 1 — Database Explorer:
Click the ✏ toggle button in the Explorer header. The tree instantly filters to show only records in your project folder.
Option 2 — Search Panel:
Check the ✏ Edited checkbox and click Search. The list shows only your edited records, with a pencil icon on each.
Recover an Accidental Edit
- Navigate to your project folder in Windows Explorer
- Open the
backups/subfolder - Find the backup copy of the file (named with a timestamp)
- Copy it back over the file in
records/to restore the old version
Work on Multiple Mods Simultaneously
Create a separate project for each mod:
- Use File → New Project… (or Help → Run Setup Wizard…)
- Give it a different name and a different folder
- Switch between projects with File → Open Project…
Each project has completely independent records, backups, and search index.
Troubleshooting
The app does not start
- Try running it as Administrator (right-click the shortcut → Run as administrator)
- If Windows Defender or your antivirus blocked it, add an exception for the install folder
- Uninstall and re-run
TitanQuestStudio_Setup.exeto repair the installation
"No database loaded" or the tree is empty
The game path was not configured. Go to Help → Run Setup Wizard… and re-enter the path to the TQ:AE folder. Alternatively use File → Open Database.arz… to manually select the archive.
The Setup Wizard can't find Titan Quest automatically
Steam's registry entry may be missing. Click Browse in the wizard and navigate manually to:
<Steam library>\steamapps\common\Titan Quest Anniversary Edition\
Search returns no results after saving
The SQLite index updates in the background. Wait a few seconds and search again. If it still doesn't appear, go to Build → Re-index Database to force a full rebuild.
The ✏ pencil icon does not appear after saving
Click the ↻ Refresh button in the Database Explorer header. This rescans the project folder and updates all icons.
A record I edited does not appear in the Explorer's "Edited only" view
The edited-only filter shows files that physically exist in your project's records/ folder. Make sure you saved the record with Ctrl+S — amber rows mean not saved yet.
How do I undo a change before saving?
While the row is still amber (not saved), close the tab and choose Discard when prompted. The original value is never touched until you click Save.
How do I undo a change after saving?
Check the backups/ folder inside your project. Every save backs up the previous version with a timestamp. Copy it back to restore the prior state.
The index is taking a long time
The first run has to scan all 74 000+ records — this is normal and takes a few minutes. Progress is shown in the status bar. You can browse and edit records while it runs. Subsequent launches are instant because already-indexed records are skipped.
cache/index.db file is always safe to delete. The next launch will rebuild it automatically. This is a good first step when troubleshooting any search or indexing issue.