RA Rich Presence Previewer

A web-based tool for previewing RetroAchievements Rich Presence scripts. This tool allows you to test and visualize how your Rich Presence scripts will appear before deploying them to the site.

Features

• Script Parsing: Parses Rich Presence scripts with Lookup, Format, and Display sections
• File Upload: Drag-and-drop or browse to upload .txt script files
• Manual Input: Paste scripts directly into the textarea
• Automatic Number Handling: Uses default ranges (0-99) for all numeric formats
• Random Generation: Generate multiple preview lines to test various scenarios
• Enhanced Warning System: Highlights potential issues with macro usage and provides contextual warnings
• Improved Macro Handling: Better support for time formats and built-in macros
• Responsive Design: Clean, modern interface with dark theme

Usage

1. Upload or Paste: Either drag a .txt file containing your Rich Presence script, or paste it directly into the textarea
2. Parse Script: Click "Parse Script" to analyze your code
3. Generate Previews: View 10 random preview lines showing how your Rich Presence might appear
4. Review Warnings: Check for any macro warnings that might affect in-game rendering
5. Reroll: Click the dice button to generate new random variations

Script Format

The tool expects standard RetroAchievements Rich Presence script format:

Lookup:MyLookup
1=Option A
2=Option B
3=Option C

Format:MyFormat
FormatType=VALUE

Display:
?condition?Your @MyLookup(0x1234) goes here
Playing @MyFormat(0x4567) for @Seconds(0x7890)

Development

This is a pure client-side web application built with:

• HTML5
• CSS3 with modern features
• Vanilla JavaScript (no dependencies)

Running Locally

1. Clone or download this repository
2. Start a local web server:

   python -m http.server 8000

3. Open http://localhost:8000 in your browser

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contributing

Contributions are welcome! Feel free to submit issues and enhancement requests.