Instance Journal
Instance Journal is a reimagining of World of Warcraft's original Encounter Journal, built for Turtle WoW.
You can access the journal by pressing Shift+J by default, or by rebinding the key in the key binding menu.
Features
- Lists all dungeons and raids, including custom Turtle WoW content
- Details every boss's abilities and loot
- Displays all available quests for an instance, including their pre-quest requirements
- Allows linking abilities, loot, and quests in the chat
- Provides a search bar for quickly finding any item, ability, instance, or boss
- Marks instance entrances and boss locations on the world map; click any boss to open their encounter in the journal
- Improves the overall world map experience
- Localized in enUS, deDE, esES, frFR, ptBR, ruRU, and zhCN
Screenshots
More Screenshots
Installation
Turtle WoW Launcher (Recommended)
- Open the Turtle WoW Launcher and navigate to the
ADDONStab at the top. - Click the
Add new addonbutton and paste the following URL into the field:https://github.com/Arthur-Helias/InstanceJournal.git. - Enable the addon from the addons menu on the character selection screen.
Manual Installation
- Download the latest version of the addon.
- Extract the archive.
- Rename the folder from "InstanceJournal-master" to "InstanceJournal".
- Copy the renamed folder into
WoW-Directory\Interface\AddOns. - Enable the addon from the addons menu on the character selection screen.
Compatibility
This addon was designed and tested for Turtle WoW, and is incompatible with the following addons:
- Cartographer
If you encounter any incompatibilities that are not listed here, please report them through the Issues tab on this repository.
Extra Features
Some features are enhanced when certain third-party mods are installed alongside Instance Journal.
| Mod | Minimum Version | Enhanced Feature |
|---|---|---|
| Nampower | 4.6.0 | Improved quest detection using quest IDs for more accurate and reliable quest tracking. |
If a listed mod is not installed, or if the installed version is below the minimum required, the original behaviour is used as a fallback automatically.
Known Issues
- Some instance maps do not display the full zone area (LBRS/UBRS, Scholomance, ...). Unfortunately, this is a current engine limitation.
- Some lore descriptions may be inaccurate or incomplete.
- Most encounter abilities are incomplete, and some may have incorrect details.
Please report any issues you encounter through the Issues tab on this repository.
Planned Features
- Finishing the abilities for every encounter
- A marker for each boss in an instance on the world map indicating if they have already been killed or not
- A companion addon that adds customization options, a minimap button, chat commands, and more
Contributing
This addon covers a large amount of data, and any help maintaining accuracy is appreciated!
If you notice any of the following, please consider opening an issue or submitting a pull request:
- Incorrect lore or story elements, such as boss descriptions or instance lore summaries
- Missing, outdated, or incorrect abilities for a boss's encounter
- Loot inaccuracies, such as items missing, assigned to the wrong boss, attributed with the wrong equipment slot or type, or otherwise incorrect
- Quest inaccuracies, such as missing quests, incorrect rewards, missing requirements, inaccurate starting and ending points, or incorrect faction, skill, or class filtering
Even small corrections are helpful. If you're unsure how to contribute, opening an issue with the details is already a great help.
Addon Recommendations
Here are a few addons that complement this one without conflicts:
- Magnify - Adds the ability to zoom on the world map
- ModernMapMarkers - Places markers on the world map to show the locations of instances, world bosses, and transportation
- ZonesLevel - Adds zone level ranges to your world map
- Better Character Panel - Improves the character and inspect panel
Attribution
No original Blizzard Encounter Journal code was used; the addon was recreated from scratch using screenshots and gameplay as reference. Some UI elements were repurposed from Blizzard's original journal.
Credits
Walter Bennet - Addon creation
Blizzard - Original Encounter Journal, UI elements
Speedz - Boss artwork assistance
cat-nep - Ability writing assistance
byCFM2 - AtlasTW Data
tilare
Aeliren - Boss stories lore fact-checking and assistance
License
The code in this project is dedicated to the public domain under the Unlicense.
You are free to copy, modify, and distribute it for any purpose, with or without attribution.
Please note that some UI assets used in this addon are the intellectual property of Blizzard Entertainment and are included without their explicit authorization. These assets are not covered by the Unlicense and remain subject to Blizzard's own copyright. This project is a fan-made, non-commercial addon with no affiliation with or endorsement by Blizzard Entertainment or Turtle WoW.