Fractal Softworks Forum

Please login or register.

Login with username, password and session length
Advanced search  

News:

Starsector 0.97a is out! (02/02/24); New blog post: Simulator Enhancements (03/13/24)

Author Topic: How To: Host your Version Checker file on Github  (Read 5891 times)

Wispborne

  • Captain
  • ****
  • Posts: 400
  • Discord: wispborne
    • View Profile
How To: Host your Version Checker file on Github
« on: August 29, 2020, 07:01:43 PM »

As of the the time of writing, BitBucket has made a change on their side that is incompatible with Version Checker. This means that a mod's myMod.version file may not be hosted on BitBucket anymore. One of the best alternatives is GitHub, which is free and has been working nonstop with Version Checker for years.

This short guide does not require any knowledge of coding or git. We'll simply move a myMod.version file over to be hosted on GitHub instead of BitBucket.


If your online masterVersionFile is located in the "Sources" part of BitBucket (ie in git), not the "Downloads" part, then your job is even simpler.

1. Follow these steps here: https://gist.github.com/mandiwise/5954bbb2e95c011885ff#gistcomment-1833787(credit to Histidine for finding this)
Spoiler


[close]

2. Continue from step 6 below by clicking to open your .version file.



Otherwise, if your version file is located in the "Downloads" tab of Bitbucket, not the "Sources" tab.

1. Create a GitHub account at https://github.com/join.

2. Create a new repository by heading to https://github.com/new.
  a. Set the name to your mod's name.
  b. Ensure the repository is public (this is the default).
  c. Click Create Repository.
Spoiler
[close]

3. Next, click the button to upload a file.
Spoiler
[close]

4. And now, drag and drop to upload your myMod.version file (click "Choose your files" if that doesn't work).
Spoiler
[close]

5. Almost done. Add a short description of what we just did, like "Added version checker file.", and then click "Commit changes".
Spoiler
[close]

6. Click on the file we just uploaded to open it in the GitHub viewer.
Spoiler
[close]

7. Then click "Raw" to open the pure text file.
Spoiler
[close]

8. Now, just copy the url. For example, https://raw.githubusercontent.com/yourUserName/my-mod/master/myMod.version. That's the new, permanent online location for your version file.

9. You'll need to take that url and put it into your myMod.version file, replacing the old BitBucket url, and then repeat the file upload process with the newly edited file so that the myMod.version file on GitHub has "masterVersionFile" as a link to GitHub.
Spoiler
[close]

10. And, last step, the next release of your mod should have this new myMod.version file with the now-working Version Checker file.
« Last Edit: August 30, 2020, 06:39:35 AM by Wispborne »
Logged
Mod: Persean Chronicles | Mod Manager: SMOL | Tool: VRAM Estimator | Tool: Forum+Discord Mod Database | If I'm inactive for 3 months, anyone can use any of my work for anything (except selling it or its derivatives).

Thaago

  • Global Moderator
  • Admiral
  • *****
  • Posts: 7174
  • Harpoon Affectionado
    • View Profile
Re: How To: Host your Version Checker file on Github
« Reply #1 on: August 29, 2020, 07:04:19 PM »

Fantastic, thanks for the guide!
Logged