¶ THJLogParser Wiki
THJLogParser is a powerful log parsing and analysis tool tailored for The Hero's Journey. Originally based on EQLogParser, it has been extensively customized to support THJ’s unique spells and abilities. The parser automatically loads your most recent log file and provides real-time overlays for DPS and other combat stats. It also features an advanced trigger system inspired by Gina Triggers, enabling you to create, manage, and test custom in-game alerts and automated responses—all within the application.
¶ Getting Started
The parser is automatically installed by the THJ patcher and kept up to date as new versions are released. By default, all necessary files are placed in the THJ/THJ Log parser folder. Do not move the parser executable or its folder, as it relies on its directory structure to read spell files and ensure accurate parsing.
- Click the launch button on the THJ Patcher (recommended and easiest)
- Launch it directly from its installed location
- Create a shortcut to
THJLogParser.exeon your desktop or taskbar for easier access—just make sure the shortcut points to the original folder and not a copied file
No manual setup is required.
To enable combat logging: Edit the EQClient.ini file in your EverQuest installation folder. Locate the Log setting and change it from FALSE to TRUE. You can also enable logging in-game on a session-by-session basis using the commands /log on and /log off. Combat logs will then be located under your EverQuest installation folder, in the \Logs directory.
¶ Features
- Automatic Installation & Updates: The THJ patcher automatically installs and keeps the parser up to date, ensuring you always have the latest features and fixes with no manual intervention required.
- Real-Time Log Parsing: Instantly processes your most recent log file, providing up-to-date combat statistics and event tracking as you play.
- Damage Meter Overlay: Displays a real-time DPS meter overlay in-game, with configuration options available from the parser's menu. The overlay defaults to [DPS] for intuitive use and can be customized to your preferences.
- Advanced Triggers System: The built-in trigger system (inspired by Gina Triggers) allows you to create, manage, and test custom alerts for in-game events. Triggers can be configured and tested directly within the application, making it easy to set up notifications and automated responses for important log messages.
- Labeled Log Breaks: You can now add labeled breaks to the log list by typing
/say log_break labelin your log. This feature lets you insert custom context into the logs, making it easier to track different parsing activities, such as when testers are running through various combinations of abilities and skills. It can also be used to break up an active fight into segments for more granular analysis. - THJ-Specific Customization: The parser is tailored for The Hero's Journey, with support for its unique spells, abilities, and log formats, ensuring accurate parsing and reporting.
- User-Friendly Launch Options: Launch the parser directly, via a desktop/taskbar shortcut, or with a single click from the THJ Patcher for maximum convenience.
- Additional Search Options for Logs: Enhanced log searching capabilities have been added, allowing you to filter and search logs more efficiently. These new options provide greater flexibility and speed when reviewing combat data, triggers, and labeled log breaks, making it easier to find the information you need.
¶ Damage Meter Overlay
The damage meter overlay is an in-game meter designed to provide a quick, mid-fight reference for your current combat target. The overlay is automatically hidden after combat ends, so it does not clutter your screen outside of active encounters.
- Important: The overlay requires real combat data in your logs to function. If there is no recent combat activity, the overlay may briefly flash and then disappear.
- To use the overlay, open the View menu and hover over Damage Meter.
- Ensure the overlay is enabled to display it during combat.
- Use Reset Position to move the overlay to a default location if it is off-screen or misplaced.
- Choose Set Up to customize the overlay's colors, size, and appearance to your preference.
The overlay is intended as a real-time tool for monitoring your performance during fights, not as a persistent display. For detailed breakdowns and analysis, refer to the main parser window after combat.
¶ Labeled Log Breaks
You can add labeled breaks to your log list by typing /say log_break label in your log file. This feature lets you insert custom context into the logs, making it easier to track different parsing activities, such as when testers are running through various combinations of abilities and skills. It can also be used to break up an active fight into segments for more granular analysis. These labeled breaks will appear in the parser, helping you organize and review your log data more effectively.
Tip: This feature is especially useful if you want to exclude 'pull time' from a boss parse, such as when it takes extra time to get the boss into position before the real fight begins. By inserting a labeled break at the start of actual combat, you can ensure your parse reflects only the relevant portion of the encounter.
¶ GINA Style Triggers
The integrated GINA Style Triggers system allows you to create, manage, and test custom triggers for in-game events directly within the parser. Triggers can be set up to watch for specific log messages, keywords, or patterns, and can respond with alerts, notifications, or automated actions. The trigger editor provides an intuitive interface for adding new triggers, editing existing ones, and testing their behavior in real time. This system is fully integrated and designed to help you stay on top of important events, warnings, or opportunities as you play—without the need for external tools.
- Select View → Triggers → Triggers Manager to open the trigger management window.
- Right-click inside the triggers panel, choose New, and select Trigger to create a new trigger.
- You can also create folders to organize your triggers for better management.
- Right-clicking a trigger gives you options such as renaming, deleting, and setting overlays for that trigger.
- Once your trigger is created, you can assign it to the appropriate overlay or folder.
- For best results, copy the relevant line from your log and paste it into the Matched Pattern field to ensure accurate matching.
- Use View → Triggers → Trigger Log to test and verify that your triggers will match the intended log lines.
- The Text to Display option determines what message will be shown on screen when the trigger activates.
- You can use the Trigger Tester to test all your triggers at once. Simply copy your log file into the tester to see which triggers will match and how they will behave.
- You can also create timer triggers that activate when a timer ends, allowing for even more advanced alerting and automation.
There are so many options for customizing your triggers and alerts—explore the interface to discover all the ways you can tailor notifications to your needs!
Note: For triggers to display notifications on your screen:- "Timer" triggers require a Timer overlay with "Default Overlay" enabled.
- "Text" triggers require a Text overlay with "Default Overlay" enabled.
By default, the parser creates one Timer overlay and one Text overlay for you, so trigger notifications will work out of the box. If you remove these overlays or change their settings, you may need to re-enable or recreate them to see trigger alerts.
¶ Performance Improvements
THJLogParser is continuously optimized for speed and efficiency. Recent updates have improved log processing times, reduced memory usage, and enhanced the responsiveness of overlays and the user interface. Notably, the parser now runs on .NET 8, providing significant performance and stability improvements over previous versions. These enhancements ensure smooth operation even with large log files or during intense gameplay sessions.
¶ Fixes & Improvements
The parser receives regular bug fixes and quality-of-life enhancements. These include more accurate spell and damage parsing, better auto-sorting in breakdown panels, improved overlay defaults, and UI consistency updates. For a detailed list of changes, see the Changelog section below.
¶ Troubleshooting
- If the parser does not auto-load your log file, ensure your EverQuest log directory is set correctly and that the log file exists.
- If overlays are not visible, check that they are enabled in the parser and not hidden behind other windows. Also, verify that the required overlays (Timer/Text) are present and set as default for triggers.
- For trigger issues, confirm that your overlays have not been deleted or disabled. Recreate them if needed.
- Always use the THJ patcher to update the parser to the latest version for best results.
- For additional help or to report a bug, please use the GitHub Issues section.
¶ Feature Requests
Have an idea for a new feature or improvement? We welcome your suggestions! Please submit feature requests using the GitHub Issues section and tag your post with [Feature Request]. This helps us track and prioritize new ideas for future development.
¶ Contributing
A special thank you to Melkor for all the hard work in developing EQLogParser and making it accessible to the community—this build is fully based on Melkor's foundation.
An even bigger thanks to Castleguard, who has dedicated countless hours to this project. Nearly all major features and most improvements in this build are thanks to Castleguard's ongoing contributions.
Contributions, feedback, and bug reports are welcome! Please use the GitHub repository to submit issues or pull requests. Help improve the parser for the whole THJ community.
¶ Changelog
Below is a summary of recent changes.
¶ Version 1.0.1.0 (May 24, 2025)
New Features- Auto-load Recent Log: Parser now automatically loads your most recently-opened log file when started
- In-game Damage Meter: Damage meter overlay now functions including configuration (available via View -> Damage Meter menu)
- Header Menu Consistency: Header menu consistency cleaned up
- TRIGGERS!: Gina Triggers functionality is now operational via View -> Triggers menu. Check Wiki for documentation.
- DPS Meter Overlay Default: DPS meter overlay now selects [DPS] by default to correct unintuitive usability on first use
- Trigger Panel Resize: Added resize sliders to Trigger configuration panel edges
- Labeled Log Breaks: Added the ability to add labeled breaks to the log list by typing
/say log_break labelin your log. This allows you to add context to the logs for tracking parsing activities or breaking up active fights into segments. - Additional Search Options for Logs: Enhanced search and filtering features have been added to the log viewer, improving the ability to find and review specific log entries, combat events, triggers, and labeled breaks.
- Upgraded to .NET 8 for improved speed and stability
- More performance improvements
- Fixed damage breakdown auto-sorting so that it actually auto-sorts by total damage when the panel opens rather than lying to you
- General Quality of Life (QoL) Improvements: Various usability enhancements throughout the parser, including more intuitive navigation, better overlay defaults, and streamlined workflows.
¶ Version 1.0.0.0
New Features- One-click Screenshot: Fast screenshots with frames via the "Copy Parse to Clipboard" button on Breakdown views
- Pet Tracking Improvement: Now correctly tracks and includes "Pets of Pets" (such as swarm proc weapons)
- Additional Data Column: New "Min Damage" column option available in damage breakdowns to show minimum hit values
- Optimized Log Processing: Significantly faster parsing and processing of log files
- Enhanced DPS Calculation: More accurate DPS calculations based on actual damage-per-encounter-time
- Spell Classification: Spells now correctly categorized as Direct Damage (DD) vs Damage over Time (DoT) based on the game's spell dictionary