This document outlines known limitations, constraints, and error messages you may encounter when using CCTool.

Known Limitations

Single Instance

CCTool allows only one running instance at a time. Attempting to launch a second instance will exit with a warning message. This prevents concurrent access conflicts and data corruption.

Workaround: Close the existing CCTool window or use the taskbar/Alt+Tab to switch to it.

One-Click Updates

App updates require manual confirmation from the user. Automatic silent updates are not supported.

Impact: Users must monitor startup notifications for update availability.

Save File Compatibility

CCTool supports only save files that are:

1. From a local profile folder (not Steam Cloud).
2. In the standard ETS2/ATS save format.
3. Not encrypted with third-party tools.

Incompatible saves will be skipped during import.

Profile Size

While no hard limit is enforced, very large profiles (>500 MB combined save data) may experience:

1. Longer import/export times.
2. Temporary UI freezing during processing.
3. Higher disk space usage during intermediate operations.

Recommendation: Keep active profiles under 300 MB for optimal performance.

OneDrive and Cloud Sync

If Documents folder is synchronized to OneDrive or similar cloud storage, CCTool may encounter:

1. File lock conflicts during read/write.
2. Delayed file availability during sync.
3. Permission errors on encrypted folders.

Workaround: Move profile folders to local storage or disable cloud sync for game profiles.

Steam Cloud Saves

CCTool does not work with Steam Cloud saves. Profiles using Steam Cloud synchronization will not be detected.

Required action: Disable Steam Cloud for ETS2/ATS and keep profiles in local Documents folder.

Network Connectivity

Import/export operations require stable internet. If connection drops mid-operation:

1. Operation may timeout or fail partially.
2. Temporary files may be left in logs/temp dirs (safe to delete).
3. You may need to retry the operation.

Recommendation: Ensure stable internet during critical operations; avoid VPN/proxy if possible.

API Rate Limiting

The CCTool server enforces rate limits to prevent abuse. If you hit rate limits:

1. Export operations will fail with HTTP 429 error.
2. Retry after waiting 1-5 minutes.
3. Repeated rapid requests may temporarily block your team's IP.

Recommendation: Avoid exporting the same profile more than once per minute.

Discord Role Mapping Delays

Role mapping changes in Discord may take up to 5 minutes to sync with CCTool due to cache refresh intervals.

Workaround: Wait 5 minutes or manually log out and back in to force sync.

Import Profile Name Decoding

Profile folder names are hex-encoded by the game. CCTool decodes them when possible, but:

1. Unusual or corrupted folder names may display as hex strings.
2. Manual renaming of profile folders may break imports.

Best practice: Use the game UI to manage profile names; do not rename profile folders manually.

Missing Map DLC Behavior

If you import a save but do not own the DLC for the map where the convoy is located:

1. The save loads but it is not playable.
2. If you enter the missing DLC area, you may fall through the map ("abyss").

Limitation: There is no workaround. You must own the map DLC to spawn in those areas.

Passcode Protection

Passcode-protected profiles have the following constraints:

1. Passcode is case-sensitive.
2. No account recovery — if forgotten, the profile cannot be unlocked by the importer.
3. Only the team that exported the profile can modify or delete it.

Important: Coordinate passcodes with your team owner/manager.

Automatic CC Message Helper

The automation feature is subject to:

1. Game detection must be active (app must detect ETS2/ATS running).
2. Game window must remain focused or accessible.
3. Google Sheets must be publicly accessible and not require authentication.
4. Message interval minimum of 15 seconds (to avoid spam).

Limitation: Automation stops if the game window is minimized and regains focus elsewhere.

Profile and Save Size Limits

No hard limits are enforced by CCTool, but practical constraints exist:

If you approach or exceed these limits, contact support for guidance.

Game Compatibility Notes

Supported Games

• Euro Truck Simulator 2 (all versions)
• American Truck Simulator (all versions)
• Both games must be installed in default Document locations or custom paths configured in CCTool

Unsupported Games

• Older versions of Euro Truck Simulator 2 and American Truck Simulator

DLC Considerations

• CCTool does not disable or enable DLC for you.
• If a convoy uses an unsupported DLC, import succeeds but gameplay may fail.
• Missing DLC results in the "abyss" behavior described above.

Game Updates

CCTool is compatible with game updates. However:

1. Major game updates may change save file format.
2. If a save becomes incompatible, reimport from the server profile.

Common Error Messages

Authentication and Login

"Failed to validate token"

• Cause: Discord OAuth token is invalid or expired.
• Solution: Log out and log in again.

"Access denied: You do not have permission to view this team"

• Cause: Your Discord role is not mapped to the correct CCTool level.
• Solution: Ask your team owner/manager to verify role mappings using /role list and /access check commands.

"Discord auth not available"

• Cause: Discord OAuth configuration is incomplete.
• Solution: Check internet access and retry after restarting CCTool.

Import and Export

"Profile not found"

• Cause: Selected profile has been deleted from server or you lost access.
• Solution: Ask owner/manager to re-export the profile or verify team membership.

"Local path does not exist"

• Cause: Selected game data path, profile, or save slot folder was deleted.
• Solution: Refresh and select a valid path.

"Insufficient disk space"

• Cause: Not enough free space to complete import/export.
• Solution: Free up disk space (at least 2x the profile size) and retry.

"HTTP 429: Rate limit exceeded"

• Cause: Too many export requests in a short time.
• Solution: Wait 1-5 minutes and retry.

"HTTP 409: Convoy/Profile conflict"

• Cause: Profile with same name exists or concurrent edit detected.
• Solution: Use a unique profile name or remove conflicting profile first.

"Decryption failed"

• Cause: game.sii or info.sii is corrupted or not a valid ETS2/ATS save.
• Solution: Verify the save loads in game; otherwise use a different save.

"Import timeout"

• Cause: Network drop or server unresponsive during import.
• Solution: Check internet, wait briefly, then retry.

Filesystem

"Access denied: Cannot read/write profile folder"

• Cause: File permissions issue or Windows Defender blocking access.
• Solution: Run as Admin, add exclusions, and verify folder is writable.

"OneDrive sync conflict detected"

• Cause: OneDrive controls Documents folder.
• Solution: Move profiles to a local non-synced folder.

"File is locked by another process"

• Cause: Game or another app is using the save file.
• Solution: Close the game and retry.

Game Detection

"Game not detected"

• Cause: ETS2/ATS is not running or path is incorrect.
• Solution: Start the game first and verify path configuration.

"Game folder not accessible"

• Cause: Game path changed or missing.
• Solution: Set the game data path manually in Local Save Target.

Automatic CC Message Helper

"Google Sheets not accessible"

• Cause: URL is invalid, private, or requires authentication.
• Solution: Ensure public sharing and valid range URL.

"Messages failed to load from Google Sheets"

• Cause: Sheet format invalid or request timed out.
• Solution: Use Column A for CC number and B for message.

"Automation stopped unexpectedly"

• Cause: Game window lost focus or CCTool was closed.
• Solution: Keep game window active or restart automation.

Error Code Reference

Error codes may appear in logs or error messages. Here is a quick reference:

When to Contact Support

Contact the CCTool support team if:

1. Error messages persist after suggested solutions.
2. You encounter an error code not listed above.
3. Import/export fails without a clear error message.
4. Performance is extremely slow for small profiles (<50 MB).
5. You suspect data corruption or loss.
6. Security or authentication issues cannot be resolved.

When contacting support, include:

1. Your app version (shown in About tab).
2. Team and role context.
3. The exact error message (screenshot if helpful).
4. Steps to reproduce the issue.
5. Relevant log excerpts from C:\Users\<YourUsername>\AppData\Local\CCTool\logs\app.log.

Support Channel: Official CCTool Discord server in the support/issues channel.