neoStatLinks

neoStatLinks automatically enhances link formatting of Mana Stones in RoM clients by intelligently rewriting structured links with clearer, more informative text. Transform complex encoded links into readable formats that show tier and attribute information at a glance. This is a rewrite of StatLinks by Zhur.

✨ Key Features

• 🔗 Automatic Link Rewriting - Automatically processes and enhances links as they're generated
• 📊 Tier Display - Shows tier information in an easy-to-read format
• 🏷️ Attribute Labeling - Displays attribute names instead of encoded values
• 🏪 Auction House Integration - Enhances auction browse lists by showing stat names directly in the item listings for Mana Stones and other stat items
• 🔄 Smart Detection - Automatically identifies and processes specific link types
• 🐛 Debug Mode - Built-in debugging tools for troubleshooting
• ⚙️ Lightweight - Minimal performance impact with efficient processing
• 💾 Persistent Settings - Your preferences are saved between sessions

🚀 Getting Started

1. Install the addon by extracting it to your interface/addons/ folder
2. Reload your UI or restart the application
3. The addon will automatically start processing links

No configuration required! It works out of the box with sensible defaults.

💬 Commands

All commands can be accessed via /neoStatLinks or the shorter /nsl:

Basic Commands

• /nsl or /neoStatLinks - Show help information
• /nsl toggle - Enable or disable the addon
• /nsl debug - Toggle debug mode for troubleshooting

🎯 What It Does

neoStatLinks intercepts structured link formats and rewrites them to be more informative. Instead of seeing generic link text, you'll see formatted information like:

Before: [Mana Stone Tier 6]
After: [T6 | Triumph of Bravado] or [T6 | Clean]

The format [T{tier} | {attribute}] makes it immediately clear what tier and attribute the link represents, making communication and organization much easier.

Auction House Enhancement

When browsing the auction house (with AAH addon installed), the item listings are automatically enhanced:

• Mana Stones: Display shows just the stat name instead of the generic item name, so you can quickly see what stat each stone has at a glance
• Other Stat Items: Shows the item name followed by the stat name (e.g., "Item Name: Stat Name") for quick identification

This makes browsing and searching for specific items much faster and more efficient!

⚙️ How It Works

The addon uses advanced pattern matching to parse structured link formats and extract:

• Item identifiers
• Tier information
• Attribute data
• Metadata and properties

It then rewrites the display text to show this information in a compact, readable format.

🔧 Configuration

Settings

The addon has two main settings:

• Enabled: Turn the addon on or off
• Debug: Enable detailed logging for troubleshooting

Slash Commands

Toggle the addon:

/nsl toggle

Enable debug mode to see detailed processing information:

/nsl debug

All settings are automatically saved and persist between sessions.

🔌 Compatibility

• Optional Dependency: Works with pylib for enhanced hook management (automatically detects if available)
• AAH Integration: Automatically integrates with AAH (Auction House Addon) to enhance browse listings - supports both older and newer AAH versions
• Fallback Support: Gracefully degrades to direct hooking if optional dependencies aren't present
• AddonManager: Compatible with AddonManager if installed

🐛 Troubleshooting

Debug Mode

If links aren't being processed correctly, enable debug mode:

/nsl debug

This will show detailed information about:

• Link parsing attempts
• Pattern matching results
• Attribute extraction
• Rewriting operations

Common Issues

• Links not being rewritten: Ensure the addon is enabled (/nsl toggle)
• Performance concerns: Debug mode adds overhead; disable when not troubleshooting
• Missing dependencies: The addon works without optional dependencies, but some features may use fallback methods

📋 Technical Details

Link Processing

The addon implements multiple parsing strategies with progressive fallback:

1. Full pattern matching with color encoding
2. Pattern matching without color
3. Simplified vendor link format
4. Color-only variant

This ensures compatibility with various link formats you might encounter.

Performance

• Conditional debug output (no overhead when disabled)
• Optimized pattern matching (tries common formats first)
• Event-driven architecture (only active when needed)
• Minimal memory footprint

📦 Installation

1. Download the latest release
2. Extract the neoStatLinks folder to your interface/addons/ directory
3. Reload your UI or restart the application
4. Start using enhanced links immediately!

📝 Files Included

• neoStatLinks.lua - Main addon code
• neoStatLinks.xml - UI frame definitions
• neoStatLinks.toc - Addon metadata
• README.md - Detailed technical documentation
• LICENSE.txt - MIT License

🛡️ License

MIT License - Do whatever you want but don't sue me. See LICENSE.txt for full details.

👤 Author

Xcalmx

📈 Version

Current Version: 0.1

For bug reports or feature requests, please use the comments section.