Text Adventure

Major Update: Modular Refactor, DF Mode Improvements, Stability Fixes, and New Command Systems

This release is one of the largest structural updates to Text Adventurer so far. The main focus was breaking the addon out of one massive file into a cleaner module-based architecture, improving performance, fixing cross-module bugs, and preparing the project for future expansion.

Text Adventurer is now much easier to maintain, extend, debug, and package for future Classic versions.

Highlights

Massive Modular Refactor

The addon has been heavily reorganized into dedicated modules. Large systems were extracted out of the main file and moved into their own focused files.

New and expanded modules include:

• Terminal and text-mode systems
• DF mode tactical map systems
• Terrain and map-cell math
• Quest routing and quest narration
• Vendor, inventory, mail, taxi, and economy commands
• Combat narration and swing timer systems
• Warlock DPS, Paladin DPS, and ML XP recommendation systems
• Character, equipment, skill, and status reports
• Settings, performance, profiler, and ticker systems
• Screenshot filtering and streaming integration

This makes the addon cleaner internally and reduces the risk of future features breaking unrelated systems.

DF Mode and Performance Improvements

DF mode received several performance and responsiveness improvements.

Changes include:

• Better grid rendering performance
• Reduced unnecessary calculations
• Cached terrain and distance data
• Improved movement responsiveness
• Better target and nameplate refresh behavior
• Optimized terrain lookups
• Cleaner DF mode update logic

DFDanger Disabled by Default

DFDanger is now disabled by default for new installs until it is more stable.

Existing users with DFDanger already enabled will keep their saved setting.

You can toggle it with:

dfdanger on
dfdanger off

New Reset Defaults Command

A new reset command has been added for users who want to wipe Text Adventurer settings and start fresh.

reset defaults
reset defaults confirm
reset defaults cancel

This clears TextAdventurerDB and reloads the UI after confirmation.

Self-Test Improvements

The self-test and pattern self-test systems now print a numbered failure recap at the end.

This makes debugging much easier because individual failures will no longer get lost in fast-scrolling terminal output.

Some protected or unsafe test commands were also removed from the pattern self-test to reduce taint and protected API issues.

Stability Fixes

This update fixes several bugs caused by moving code into separate modules.

Many functions that were previously file-local were promoted to proper global functions where needed so other modules can access them safely.

Fixed issues include:

• Cross-module nil errors
• Shadowed local functions
• Swing timer visibility bugs
• Exploration and path memory access bugs
• Performance-frame suppression scope bugs
• Combat narration callback issues
• Terminal input execution scope issues
• Classic API compatibility warnings

These fixes should reduce random runtime errors after the modular split.

New and Improved Command Areas

Several command systems were added or improved, including:

Mail Commands

Added support for mail-related command handling.

Taxi Commands

Added commands for reporting and taking flight nodes.

Social Prompt Commands

Added support for common social prompts, including:

• Resurrection prompts
• Duel prompts
• Group invites
• Spirit release prompts

Paladin Commands

Added Paladin-related combat helpers, including weapon dance and swing timer commands.

Trainer and Recipe Commands

Trainer, recipe, and range narration systems were moved into a dedicated module and cleaned up.

Streaming and External Integration

Text Adventurer now includes improved external streaming support.

The /tastream system allows the addon to emit structured data for external tools or streaming overlays.

Supported command pattern:

/tastream on
/tastream off
/tastream test
/tastream status

This is an early foundation for Twitch, overlay, and external viewer-facing integrations. Companion addon to be released soon.

Terminal and Text Mode Improvements

The terminal system has been extracted into its own module and cleaned up.

Improvements include:

• Better panel show/hide behavior
• Text-mode overlay syncing
• Cleaner command execution
• Multi-line terminal input support
• Help overview and topic support
• Safer command handling

CurseForge and Release Packaging

This release also improves the packaging workflow.

Changes include:

• CurseForge project metadata
• .pkgmeta packaging rules
• GitHub Actions release workflow
• Cleaner packaged builds
• Multi-flavor Classic interface support

This should make future CurseForge releases easier and more consistent.

Developer Notes

This release completed multiple tiers of modular extraction. The main addon file has been significantly reduced, while major systems now live in purpose-built modules.

The project is now in a much better position for:

• Future Classic Era updates
• TBC/Wrath adaptation work
• Streaming integrations
• Larger command expansions
• Safer AI/ML experimentation
• Easier debugging and profiling