Troubleshooting & Support

Common Issues

API Key Errors

Problem: Error messages about invalid or missing API key

Solutions:

• Ensure your API key is valid and hasn't expired
• Verify your API key has faction permissions enabled
• Copy the API key again from Torn settings to avoid extra spaces
• Re-enter your API key in the WarPay settings panel

Faction ID Errors

Problem: Script can't find faction data

Solutions:

• Verify your faction ID is correct (found in your faction URL)
• Ensure you're using just the numeric ID, not the full URL
• Check that you have appropriate permissions in your faction

Data Loading Issues

Problem: War data won't load or loads slowly

Solutions:

• Check your internet connection
• Wait for the fetching modal to complete (long wars take time)
• Try using the manual refresh button to re-fetch data
• Clear your browser cache and reload the page
• Check if Torn's API is experiencing issues

Payment Failures

Problem: Unable to process payments through the payment modal

Solutions:

• Ensure you have sufficient faction funds in the vault
• Verify you have vault permissions in your faction
• Check that member names match exactly (use the search function)
• Refresh the page and try again

Calculation Errors

Problem: Payouts don't seem correct

Solutions:

• Double-check your payout method settings
• Verify total winnings input is correct
• Ensure armory costs and deductions are accurate
• Review the tier breakdown or points display to verify calculations
• Try toggling between points/hits view (Weighted method) to verify correlations

Error Messages

"API Key Not Set"

Meaning: The script doesn't have your API key configured
Solution: Open the settings panel (⚙️ button) and enter your API key

"Faction ID Not Set"

Meaning: The script doesn't know which faction to query
Solution: Enter your faction ID in the settings panel

"No War Data"

Meaning: The script can't find war data on the current page
Solution: Ensure you're on a valid ranked war report page

"Payment Failed"

Meaning: The payment couldn't be processed
Solution: Check faction funds, member names, and your vault permissions

"API Rate Limit Reached"

Meaning: You've hit Torn's API request limit
Solution: Wait a few minutes - the script will automatically handle this with decaying request delays

Browser Console Errors

If you're experiencing issues, checking the browser console can provide helpful information:

1. Open your browser's developer tools (F12 or right-click → Inspect)
2. Click the "Console" tab
3. Look for error messages (usually in red)
4. Take a screenshot and share with Scolli03 for support

Performance Issues

Slow Loading on Long Wars

Long wars with thousands of attacks can take time to fetch. The fetching modal will show progress. Be patient and wait for completion. If it seems stuck:

• Check the browser console for errors
• Try the manual refresh button
• Clear cached data and reload the page

Browser Memory Issues

If your browser becomes sluggish with very long wars:

• Close other browser tabs to free up memory
• The script uses compression and IndexedDB to minimize memory usage
• Consider processing war data on a desktop instead of mobile

Getting Help

What to Include When Reporting Issues

To help me fix problems faster, please include:

• Script Version: Check the version number in settings
• Browser & Userscript Manager: Which browser and extension (Tampermonkey/etc)
• Error Message: Exact error text or screenshot
• Console Logs: Screenshot of browser console if available
• Steps to Reproduce: What you were doing when the error occurred
• War Details: Approximate size of war (number of hits)

Feature Requests

Have an idea for a new feature or improvement? I'm always interested in making WarPay Calculator better! Contact me with your suggestions. Popular requests may be added in future updates.

Known Limitations

• API Rate Limits: Torn's API has rate limits. The script handles this automatically, but very large wars may take time
• Browser Compatibility: Designed for modern browsers (Chrome, Firefox, Edge). Older browsers may have issues
• Torn PDA: Some features may work differently on mobile via Torn PDA

Best Practices

Before Running Calculations

• Ensure you have the correct total winnings amount
• Verify armory costs if applicable
• Double-check revive and merc costs
• Review your payout method settings

Before Processing Payments

• Review the payout table carefully
• Verify total calculated matches expected amount
• Ensure faction has sufficient funds in vault
• Use the search function to find specific members quickly
• Mark payments as you go to track progress

Regular Maintenance

• Keep your script updated to the latest version
• Export your settings as backup
• Clear old cached data periodically (manual refresh)
• Test new payout methods on old wars before using on live payouts

Update History

Version 3.7.2

• Enhanced payout data management for better performance
• Added player search functionality in payment modal
• Improved async/await handling for smoother operation
• Introduced leader and co-leader percentage settings (Percentage method)
• Added static payment rates for outside hits and assists (Percentage method)
• Enhanced payout table to display outside hits and assists
• Updated calculation logic to include static payments and leadership cuts