2026-03-21 10:32:06 +08:00
2026-03-21 10:32:06 +08:00
2026-03-21 10:32:06 +08:00
2026-03-21 05:54:24 +08:00
2026-03-21 04:45:28 +08:00
2026-03-21 10:32:06 +08:00
2026-03-21 10:32:06 +08:00
2026-03-21 10:32:06 +08:00
2026-03-21 04:45:28 +08:00
2026-03-21 04:45:28 +08:00
2026-03-21 10:32:06 +08:00
2026-03-21 04:45:28 +08:00
2026-03-21 04:45:28 +08:00
2026-03-21 04:45:28 +08:00
2026-03-21 10:10:19 +08:00

Instance Journal

Instance Journal is a reimagining of World of Warcraft's original Encounter Journal, built for TurtleWoW.
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 TurtleWoW content
  • Details every boss's abilities and loot
  • Provides a search bar for quickly finding any item, ability, instance, or boss
  • Integrates instance entrances and bosses onto 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

Instance List dungeons-tab raids-tab
Instance Tabs instance-overview-tab abilities-tab instance-loot-tab boss-loot-tab search-result
World Map Additions map-world-entrances map-instance-bosses

Installation

  1. Open the Turtle WoW Launcher and navigate to the ADDONS tab at the top.
  2. Press the Add new addon button and paste the following URL into the field: https://github.com/Arthur-Helias/InstanceJournal.git.
  3. Enable the addon from the addons menu on the character selection screen.

Manual installation

  1. Download the latest version of the addon.
  2. Extract the archive.
  3. Rename the folder from "InstanceJournal-master" to "InstanceJournal".
  4. Copy the renamed folder into WoW-Directory\Interface\AddOns.
  5. Enable the addon from the addons menu on the character selection screen.

Compatibility

This addon was designed and tested for TurtleWoW. It should be compatible with virtually every addon. If this isn't the case, please report it through the Issues tab on this repository.

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
  • Most encounter abilities are missing and some may have incorrect details

Please report any issues you encounter through the Issues tab on this repository.

Planned Features

  • Linking abilities into the chat
  • Finishing the abilities for every encounter
  • A tab listing of all the quests related to a specific instance
  • A marker for each boss in an instance on the world map indicating if they have already been killed or not

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 equipment type, or otherwise incorrect

Even small corrections are helpful. If you're unsure how to contribute, opening an issue with the details is already a massive 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

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.

S
Description
World of Warcraft's original instance journal re-imagined for Turtle WoW.
Readme Unlicense
54 MiB
Languages
Lua 100%