celestiamobile / celestia.mobi

Partial source code for celestia.mobi
8 stars 3 forks source link

Add-on Submissions 2023 #50

Closed DaveBowman2001 closed 1 year ago

DaveBowman2001 commented 1 year ago

Submit your add-ons in this link below, thanks for your contribution! This is the new format introduced since 2022-Dec-28

https://celestia.mobi/submit-addon

How to Submit an Addon through the Link?

Read the new ReadMe file on the Addon Validator here:

https://github.com/levinli303/celestia-addon-validator

For Updates to Existing Add-ons

For updates to existing add-ons, do not forget to attach the ID of the addon you want to update, and only provide details written above that needs to be updated

The id is part of the link to the add-on: For example, this addon below has an id of A4577B17-4C60-0C1E-CAB5-92A604FF0EC3 https://celestia.mobi/resources/item?item=A4577B17-4C60-0C1E-CAB5-92A604FF0EC3

For Removing Outdated Add-ons

In removing addons, just simply check the box labeled Remove this Add-on? and enter the ID of that addon to be removed from the official mobi list image

Check Before Uploading an Add-on

Your add-on will be running on Android/iOS/macOS/Windows, to enable maximum compatibility, please ensure that:

  1. File names referenced in models, ssc, dsc files, etc. are exactly the same as the actual file names (some file systems are case sensitive. For example if in your .ssc there is Mesh "Progress.cmod", then the file name should be exactly Progress.cmod not progress.cmod).
  2. Textures should have width/height of power of 2 (for example: 1024 512, a texture of 1000 500 will not work on many mobile devices).
  3. If your add-on requires specific Celestia versions, please mention in the description. Please also ensure that your add-on should not crash running on other versions.
  4. If you are updating an existing add-on, note that existing users will not see an update button, so it might be a good idea to include version history in the description.
  5. Please try to use smaller files for image/thumbnail/other metadata. For example, use JPG if alpha value is not needed.
  6. All images need to be in JPEG (you either choose to screenshot in JPEG in Celestia or convert using tools)
  7. The add-on archive should not include system files or hidden files (macOS is notorious for adding hidden system files to archives, avoid using macOS's default archive utility) this issue is found in many add-ons @Anthony-B-Russo10 uploaded
  8. The add-on archive must have a flat folder structure (It should try to have fewer level of folders, do not do things like A/A/A) this issue is found in many add-ons @SpaceExplorer2008 uploaded

Submitting Addons Without an Apple ID Account

If you have difficulties accessing the link above because of problems with your Apple ID account (or none at all), you can still submit a new addon or update an existing one by compiling them in a ZIP file in the format below. Everything with an asterisk * means it is mandatory:

title.txt *
description.txt *
authors.txt
release_date.txt *
last_update_date.txt
category.txt *
demo_object_name.txt *
localized_titles.json
localized_descriptions.json
addon.zip *
cover_image.jpg *
id_requirement.txt

rich_description (folder, optional, if provided, those marked * are mandatory)
- base.txt *
- notes.txt
- cover_image.jpg *
- cover_image.txt
- youtube_ids.txt
- detail_image_x.jpg
- detail_image_x.txt
- additional_leading.html
- additional_trailing.html

DOWNLOAD TEMPLATE.ZIP HERE

What should be the Content of Each File Above?

BASE FILES

FOR THE RICH DESCRIPTION:

Rich description will look like

base
NOTES:
- note 1
- note 2
cover image
cover image caption
additional leading HTML
youtube links
detail image 1
detail image caption 1
detail image 2
detail image caption 2
additional trailing HTML

Additional Important Notes

levinli303 commented 1 year ago

For add-ons submitted to https://celestia.mobi/update-addon, please follow the process mentioned here https://github.com/levinli303/celestia-addon-validator

DaveBowman2001 commented 1 year ago

Week 1

Just a placeholder for my submissions on the link so that the IDs generated would not get lost in case I forget it and/or pull requests have failed

EXOPLANETS

FICTIONAL

HYPOTHETICAL & DISPROVEN

NEBULAE

SOLAR SYSTEM

SPACECRAFT

STARS

levinli303 commented 1 year ago

OK I found that there is an issue with the validator, please do not use it until further notice.

levinli303 commented 1 year ago

Should be fixed now, please try again.

SpaceExplorer2008 commented 1 year ago

Update Cassini-Huygens addon. After the default update of spacecraft body frames, the addon was updated to not generate duplicates. Also updated the model, with normal maps.

Link to download: https://drive.google.com/file/d/1cJ9CWvFumH8h5GVuLWfQ6dNAw_Mkhemw/view?usp=drivesdk

levinli303 commented 1 year ago

Update Cassini-Huygens addon. After the default update of spacecraft body frames, the addon was updated to not generate duplicates. Also updated the model, with normal maps.

Link to download: https://drive.google.com/file/d/1biWGVVExDUNUU5duANv2rH2YFm1lIxVh/view?usp=drivesdk

the format is wrong. the .zip containing addon content should always be named addon.zip

SpaceExplorer2008 commented 1 year ago

Fixed

levinli303 commented 1 year ago

For ZIP format, one can create pull request with the zip file under pending_zip folder which will start a similar validation process. However GitHub does not allow uploading file directly to repositories, which means that it has to be done via git clients.

https://github.com/levinli303/celestia-addon-validator#zip-format

levinli303 commented 1 year ago

Please help test submitting with this one, https://celestia.mobi/submit-addon , it has support for automatic PR creation. after you login with both Apple ID and GitHub account

DaveBowman2001 commented 1 year ago

Please help test submitting with this one, https://celestia.mobi/submit-addon , it has support for automatic PR creation. after you login with both Apple ID and GitHub account

I think it's working! https://github.com/levinli303/celestia-addon-validator/pull/45

levinli303 commented 1 year ago

Please help test submitting with this one, https://celestia.mobi/submit-addon , it has support for automatic PR creation. after you login with both Apple ID and GitHub account

I think it's working! levinli303/celestia-addon-validator#45

nice. I wish I could also automate validation log posting in pull request

DaveBowman2001 commented 1 year ago

Yesterday, I sent some 4 PRs requesting to remove some outdated addons (example). All of them were successfully merged, but it is still visible on the mobi list and author's list to this day

EXAMPLE:

From Exoplanets: H list image

From SolanaBogon's list image

levinli303 commented 1 year ago

Yesterday, I sent some 4 PRs requesting to remove some outdated addons (example). All of them were successfully merged, but it is still visible on the mobi list and author's list to this day

EXAMPLE:

From Exoplanets: H list image

From SolanaBogon's list image

ok turned out to be a bug in OpenCloudKit, fixed. please re-submit these

SpaceExplorer2008 commented 1 year ago

Fixed categories of the following addons:

2018 LA Link to download: https://drive.google.com/file/d/1ffV7iRqR2Cb3mSGufKyJuUdef4Awobzy/view?usp=drivesdk

Dwarf Planets Textures Link to download: https://drive.google.com/file/d/1fr4Kb9UHGAdzCCEI78ny-nQzocCzoJLl/view?usp=drivesdk

levinli303 commented 1 year ago

Please test https://celestia.mobi/submit-addon which add support for zip generation and automatic PR creation

If...

Apple ID ✅ GitHub ✅ Will submit via CloudKit record, and then create PR Apple ID ✅ GitHub ❌ Will submit via CloudKit record, record ID will be displayed Apple ID ❌ GitHub ✅ Will submit via zip, and then create PR with zip Apple ID ❌ GitHub ❌ Will submit via zip, zip file will be downloaded

DaveBowman2001 commented 1 year ago

(Working?)

  • Apple ID ✅ GitHub ❌ Will submit via CloudKit record, record ID will be displayed

(Not Working?)

  • Apple ID ✅ GitHub ✅ Will submit via CloudKit record, and then create PR

(Not yet Tested)

  • Apple ID ❌ GitHub ✅ Will submit via zip, and then create PR with zip
  • Apple ID ❌ GitHub ❌ Will submit via zip, zip file will be downloaded
DaveBowman2001 commented 1 year ago

I can't seem to logout my Apple ID from the addon form, I couldn't test the latter two

DaveBowman2001 commented 1 year ago
  • Apple ID ✅ GitHub ✅ Will submit via CloudKit record, and then create PR

OK....upon submitting two new addons (#71 and #72), the validator fails somehow image

DaveBowman2001 commented 1 year ago
  • Apple ID ✅ GitHub ❌ Will submit via CloudKit record, record ID will be displayed

The generation of ID works as usual, but manually creating PRs for them is now lost

levinli303 commented 1 year ago

I can't seem to logout my Apple ID from the addon form, I couldn't test the latter two

you can use a incognito session

  • Apple ID ✅ GitHub ❌ Will submit via CloudKit record, record ID will be displayed

The generation of ID works as usual, but manually creating PRs for them is now lost

fixed now

DaveBowman2001 commented 1 year ago

The page for manually creating PRs still doesn't work (Page Not Found) image image

levinli303 commented 1 year ago

The page for manually creating PRs still doesn't work (Page Not Found) image image

for some reason, placeholder.txt is removed causing the directory to be gone. I added back.

DaveBowman2001 commented 1 year ago

I confirm that both of these two methods are working perfectly again!

levinli303 commented 1 year ago

as whoever want to submit add-on here should already have GitHub account now. So for all normal add-ons please submit via https://celestia.mobi/submit-addon with either of the GitHub ✅ flows. Only post here if you want customization.

DaveBowman2001 commented 1 year ago

Seems like the new form does not automatically recognize <sup>superscripts</sup> on titles like on the Psi1 Draconis addon Here's the customized title below:

levinli303 commented 1 year ago

Seems like the new form does not automatically recognize <sup>superscripts</sup> on titles like on the Psi1 Draconis addon Here's the customized title below:

this will not work. HTML is not supported in title. you should find special character in unicode that represent it instead of using mark-ups.

levinli303 commented 1 year ago

Use

Psi¹

not

Psi<sup>1</sup>
DaveBowman2001 commented 1 year ago

Ohhh ok....Titles can read unicodes but not htmls, got it ⁰¹²³⁴⁵⁶⁷⁸⁹ ₀₁₂₃₄₅₆₇₈₉

DaveBowman2001 commented 1 year ago

Week 2

Just a placeholder for my submissions on the link so that the IDs generated would not get lost in case I forget it and/or pull requests have failed

(EXOPLANETS)

(FICTIONAL)

(NEBULAE)

(SPACECRAFT)

Week 3

Just a placeholder for my submissions on the link so that the IDs generated would not get lost in case I forget it and/or pull requests have failed

(COMETS)

(EXOPLANETS)

(HYPOTHETICAL & DISPROVEN)

(SPACECRAFT)

SpaceExplorer2008 commented 1 year ago

@DaveBowman2001 Did you remove the sprite models of the Ring Nebula (M57) and Eskimo Nebula (NGC 2392)?

SpaceExplorer2008 commented 1 year ago

Update "M 57 (Ring Nebula)" addon

Link to download: https://drive.google.com/file/d/1jqfJOsUQJeWMk7V0JvwEJxx9el4Sm4SY/view?usp=drivesdk

levinli303 commented 1 year ago

Update "M 57 (Ring Nebula)" addon

Link to download: https://drive.google.com/file/d/1jqfJOsUQJeWMk7V0JvwEJxx9el4Sm4SY/view?usp=drivesdk

Submit on https://celestia.mobi/submit-addon with GitHub account logged in (Apple ID is optional now)

SpaceExplorer2008 commented 1 year ago

I was able to generate the ID, what do I do now? Is validation automatic or is another process required?

And for new submissions, can it still be submitted without the form, just here in the issue?

DaveBowman2001 commented 1 year ago

@DaveBowman2001 Did you remove the sprite models of the Ring Nebula (M57) and Eskimo Nebula (NGC 2392)?

Yes, I did...see PRs #49 and #50 due to them lagging in mobile compared to jll's as reported negatively by the commenters...

I was able to generate the ID, what do I do now? Is validation automatic or is another process required?

The validation is only automatic IF AND ONLY IF you logged in both Apple and GitHub accounts. If you're only logged in on either one of the accounts only, then you still need to copy the IDs so that a proper PR can be created, else nothing will happen

And for new submissions, can it still be submitted without the form, just here in the issue?

I'd recommend to post any add-ons you've submitted to the form here so that I can keep track of what's the "newest" uploaded to mobi for the news articles

SpaceExplorer2008 commented 1 year ago

@DaveBowman2001 Did you remove the sprite models of the Ring Nebula (M57) and Eskimo Nebula (NGC 2392)?

Yes, I did...see PRs #49 and #50 due to them lagging in mobile compared to jll's as reported negatively by the commenters...

But why not include them anyway? On my device they work fine. As I am experiencing some difficulties in sending, please send them back as I sent them for the first time.

Other addons also make Celestia slow or crash on some devices, such as the ISS addon or exoplanets with high resolution textures.

SpaceExplorer2008 commented 1 year ago

The validation is only automatic IF AND ONLY IF you logged in both Apple and GitHub accounts. If you're only logged in on either one of the accounts only, then you still need to copy the IDs so that a proper PR can be created, else nothing will happen

Yes, I copied the ID. Where is it necessary to insert it?

levinli303 commented 1 year ago

automatic PR creation and validation only requires Github account.

levinli303 commented 1 year ago

also do not revert changes. it does not work that way.

SpaceExplorer2008 commented 1 year ago

But I also want to know if it's still possible to make new addon submissions just with everything in a zip file.

levinli303 commented 1 year ago

But I also want to know if it's still possible to make new addon submissions just with everything in a zip file.

https://github.com/levinli303/celestia-addon-validator#zip-format

SpaceExplorer2008 commented 1 year ago

I'm not referring to that, I'm referring to the submission made here in the issue itself, with everything in a zip file. The submission method prior to the form. It felt complicated at first, but get used to it.

levinli303 commented 1 year ago

I'm not referring to that, I'm referring to the submission made here in the issue itself, with everything in a zip file. The submission method prior to the form. It felt complicated at first, but get used to it.

no

SpaceExplorer2008 commented 1 year ago

@DaveBowman2001 Please add back the sprite models of M57 and NGC 2392, as an alternative version of jll's addon.

DaveBowman2001 commented 1 year ago

As much as possible, we shouldn't be uploading different addon versions of the same object separately. The M57 and NGC2392 models by ttcz doesn't even look anything like their real counterparts (no offense to the author, he did have some good looking models, like NGC 6826 and NGC 6164/6165, the latter of which are yet to be added to mobi).

If only 3D modelled add-ons can be handled as easily like what AltSurfaces do on different versions of certain exoplanet/solar system addons, we could probably allow them co-existing in one form. But that is currently not possible, so for nebulae, spacecraft, asteroids, etc. we should only pick and post their best looking version out of many different iterations...

DaveBowman2001 commented 1 year ago

Listing all submitted add-ons from Week 4 to 6

Week 4

(ASTEROIDS and NEOs)

Week 5

(DWARF PLANETS)

(EXOPLANETS)

(SPACECRAFT)

(TRANS-NEPTUNIAN OBJECTS)

Week 6

(COMETS)

(EXOPLANETS)

(SPACECRAFT)

DaveBowman2001 commented 1 year ago

Listing all successfully submitted add-ons starting Week 7

Week 7

(ASTEROIDS and NEOs)

(FICTIONAL)

Week 10

(EXOPLANETS)

(STARS)

Week 11

(ASTEROIDS and NEOs)

(COMETS)

(EXOPLANETS)

(UNCONFIRMED EXOPLANETS)

(FICTIONAL)

(SPACECRAFT)

(STARS)

Week 12

(ASTEROIDS & NEOs)

(EXOPLANETS)

(FICTIONAL)

(SPACECRAFT)

DaveBowman2001 commented 1 year ago

Listing all successfully submitted add-ons starting Week 13

Week 13

(2001: A SPACE ODYSSEY)

(ASTEROIDS & NEOs)

(EXOPLANETS)

(SPACECRAFT)

(TRANS-NEPTUNIAN OBJECTS)

Week 14

(EXOPLANETS)

Week 15

(EXOPLANETS)

(SPACECRAFT)

Week 16

(EXOPLANETS)

(STARS)

DaveBowman2001 commented 1 year ago

Closing this one as addon submission tracking will now be handled by #65