Troubleshooting Issues - massif-press/compcon GitHub Wiki

COMP/CON doesn't seem to be working properly!

You're in the right place! Before anything else, please check that your COMP/CON version is 2.3.0 or higher (you can find this on the main page of COMP/CON). If COMP/CON is on a version older than 2.3.0, please follow the steps below to update to the latest version of COMP/CON. If you are on the latest version of COMP/CON and your issue persists, please check the entries below for additional help.

COMP/CON seems to be missing images or icons!

Consider whitelisting compcon.app in your adblocker or similar browser extensions that affect what content can load on a webpage. If this doesn’t solve your issue, please check the other troubleshooting questions for additional guidance.

How do I verify my COMP/CON account?

If you closed the verification box or need to request a new verification code, follow these steps:

  1. Open CompCon’s main page.
  2. Click “Log In".
  3. Enter the email used to make your COMP/CON account into the email box.
  4. Click “Click here to use a verification code.”
  5. Verify the email on the new dialog box matches the one previously entered.
  6. If you need to request a new code, click "Re-send Verification Code". Check your email and/or spam for a verification code from COMP/CON.
  7. Enter your verification code in the space provided and click “Submit”.

COMP/CON says my account doesn't exist!

If you created a COMP/CON account prior to March 30, 2022, your COMP/CON username may be case-sensitive (especially if you created your account while using a mobile device). If this is the case, try logging in with the first letter of your email address capitalized (e.g. [email protected] should be [email protected]).

To prevent future headaches regarding username capitalization, it is recommended to migrate your account's content to an account with an all-lowercase username. Accounts created after March 30, 2022 have all-lowercase, case-insensitive usernames.

COMP/CON is stuck on an older version than 2.3.0! How do I update to the latest version?

Usually, COMP/CON automatically checks for updates and lets the user know when an update is available. However, on some older versions of COMP/CON (v2.2.35 in particular), COMP/CON becomes "stuck" and cannot update to the latest version. This is due to an old Service Worker issue from an older version of COMP/CON. Do the following steps:

  1. Open up your browser's devtools (ctrl+shift+i).
  2. Navigate to the Application Tab -> Service Workers.
  3. Click "Unregister".
  4. Refresh the page.

Mobile users on Chrome

Navigate to the URL chrome://serviceworker-internals and unregister the Service Worker for compcon.app.

All other mobile users

  1. Ensure your pilot data is backed up either to a local .compcon backup or to the cloud.
  2. Clear your browser data for compcon.app.
  3. Reload compcon.app and sign in again, and you should be on the latest version.

My Pilot or NPC changes keep reverting!

The Smart Sync for COMP/CON v2.3.10 is bugged; whenever COMP/CON automatically syncs (e.g., on log in, or when closing the page), it sometimes thinks the cloud is more up-to-date than more recent local changes. Here's the workaround in the meantime:

  1. Navigate to the Cloud Account menu ("Connected" button on the main page or the Cloud icon in the top right navbar elsewhere).
  2. Expand either pilots, NPCs, encounters, or missions.
  3. Select all content you wish to save to the cloud (there is a "Select All" button at the top left of the list).
  4. Scroll to the bottom of the list, and click "Overwrite Cloud". This will force local changes for the selected content to save to the cloud.
  5. Repeat steps 2-4 for any other desired categories.

COMP/CON gives me a long error mentioning “someMutation”; what does this mean?

Check the amount LCP content you have installed, as well as number of pilots, NPCs, and encounters. You may have run out of local memory on your browser for storing that data.

COMP/CON relies on your browser’s Local Storage to stash and deliver content while you are logged out or offline. Local Storage can only hold so much data at a time. If you find that you have a lot of content installed, try installing COMP/CON as a Progressive Web App (PWA) through a browser that supports it (e.g. Chrome, Edge), as a PWA can manage a larger amount of data within its Local Storage.

My pilots are missing/My stuff is gone!

Before you panic, check the following information:

Navigate away from the current page and back again.

Sometimes content retrieved from Cloud storage needs time to load before it can be displayed. Changing your page (e.g. navigating to the Pilot Roster before heading back to your pilot) may properly refresh the site.

Check Content Management.

After updating to a new LCP, some pilots may be flagged for using an old version of an LCP. If this is the case, there will be a red crossed folder icon on the Content Management bar on the main page. Check under Content Management to see which pilots are affected and follow the instructions provided. Usually, if a pilot is disabled due to using data from an out-of-date LCP, and you have the latest version of that LCP already installed, you can safely force the pilot to load and reappear in your Pilot Roster.

All of your COMP/CON data is gone - Pilots, NPCs, encounters, and installed LCPs.

This is typically caused by clearing your cache or cookies, or running COMP/CON inside a private/incognito window. It can also be caused by privacy extensions in your browser, or disk cleaning utilities like CCleaner. There is really nothing we can do about this - COMP/CON stores its data in your browser's local storage, and if it gets wiped there is no backup unless you made one (see below). If you have a Cloud account and are currently logged out, you can retrieve a copy of your Cloud data by logging back in and performing a Smart Sync. Alternatively, if you use COMP/CON on different browsers (e.g. mobile and desktop), you may be able to create a local or Cloud backup using data from one of your other browsers.

Can I make a local backup of my data?

You can save a local backup of all of your COMP/CON data by clicking CREATE DATA BACKUP on the main page. This will download a .compcon file, which is a snapshot of everything you have in COMP/CON, including settings and installed LCPs. Clicking LOAD DATA BACKUP on the main page will let you upload a .compcon file and completely overwrite your COMP/CON data with the contents of the file.

image

You can also manage your data and backups within the OPTIONS menu, also available from the main page.

Additional Help

We're currently working on more help resources for COMP/CON, especially for new players and GMs. In the meantime, please stop by Pilot NET discord (and specifically the #comp-con channel) if you have a question or comment for the developers.

I found something wrong! Or there's something I'd like to see added.

Before making a report, check the Issues Page to see if your issue is already known. Otherwise, a quick link to the bug report form can be found within the HELP menu on COMP/CON's main page.