Explanation
Licences, credits and trademarks
What is MIT, what is CC BY 4.0, what is public domain and ODbL, and how a rocket you show carries the right credit.
This package holds work under several licences, and the difference matters when you ship a painted rocket.
Four kinds of work
| What | Licence |
|---|---|
| The code, the code-made meshes and the drawings | MIT |
The painted models in models/ | CC BY 4.0, except one under CC0 and NASA's, which are public domain |
| Starbase's coordinates, outlines and map heights, and the tower's 13 m footprint | © OpenStreetMap contributors, ODbL 1.0 |
| Nothing else from outside | Anything else must be MIT, ISC, BSD or Apache |
The painted models are not MIT: using them means crediting them. The package's own licence line reads MIT AND CC-BY-4.0 AND ODbL-1.0 for that reason.
Find the credit for what you show
check(description).credits lists every licensed model a rocket uses, with usedFor naming the parts. creditLine(id) writes one as a line of text. MODEL_CREDITS is the whole table.
import { check, creditLine } from "@johnmorrisdotca/uchusen-rockets";
const report = check({ rocket: "starship", variant: "v3" });
for (const credit of report.credits) console.log(credit.id, credit.licence, "-", creditLine(credit.id));clarence365-block3 CC BY 4.0 - "SpaceX Starship Block 3" by Clarence365 (https://sketchfab.com/3d-models/spacex-starship-block-3-6f6c6f88a3eb4b4d822fdca66733fbb2), CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Reduced from 913,217 triangles; logos, wordmark and serial number removed; rescaled to sourced sizes; separated into booster and ship; unseen payload bay interior removed; materials merged and renamed.A rocket shown as one part credits that part only. A variant this package paints itself, like Starship Blocks 2 and 4, needs no credit because no licensed model is used: no model is stretched to stand in for another version.
Embeds carry the credit for you
embedCode writes the credit into every painted form, and paintedCredit gives the line on its own, so a page can print it beside the picture.
import { embedCode, paintedCredit } from "@johnmorrisdotca/uchusen-rockets";
const options = { rocket: "falcon-9", variant: "block-5", look: "painted" };
console.log(paintedCredit(options));
console.log(embedCode(options, "element").includes("Stanley"));First stage, Falcon 9 block-5, Second stage, Falcon 9 block-5, Fairing, Falcon 9 block-5: "Falcon 9 - SpaceX" by Stanley Creative (https://sketchfab.com/3d-models/falcon-9-spacex-394f7cf52d124bbd9db69f24d1ff2f08), CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Reduced from 157,889 triangles; the wordmark, logos, flags and mission marks removed with the two textures that carried them; rescaled to sourced sizes; separated into first stage, second stage and fairing; materials merged and renamed.
trueIf you save a picture or a file yourself, keep the credit with it.
NASA's models
NASA's models are named as the source, as its guidelines ask, with no suggestion that NASA endorses this package. No NASA logo, insignia, flag or lettering is shipped. NOTICE.md says what that rests on.
No logos, no marks, no flags
No mesh or drawing carries a maker's logo, wordmark, flag or printed name. A test (test/legal.test.ts) holds it on the generated files and on the models. Rocket names appear only as plain descriptive words. All trademarks belong to their owners, and this project is not affiliated with or endorsed by SpaceX, NASA or any other maker or agency named. See NOTICE.md for each source and what was changed.
Adding a model
A new licensed model needs a row in NOTICE.md, its licence read from its own files, and its page checked for any notice against use. Remove marks first; credit the author with what was changed. That rule is in CONTRIBUTING.md.