PEARL PLANET PACK - a Kopernicus planet pack in progress
========================================================

WHAT THIS IS
This adds three new bodies to the stock Kerbol system:

  - Pearl       Borrows the moon Pol's terrain untouched. The
                original "does the pipeline work at all" test.
  - Strawberry  Borrows Gilly's small, lumpy terrain, but re-textured
                (from orbit / in the map view) to look like the
                strawberry-skinned elephant photo.
  - Canopy      Borrows Dres's full-planet-sized terrain, re-textured
                to look like the forest-canopy photo.

Strawberry and Canopy use your own uploaded photos as their map-view
texture (see StrawberryElephantPlanets.cfg and the PluginData folder).
Up close, walking on the actual ground, they'll still look like Gilly
and Dres's stock terrain - only the "from space" appearance is themed
so far. Giving the walkable ground itself a matching custom texture
is a further step (see NEXT STEPS below).

REQUIREMENTS (install these BEFORE launching KSP with this mod)
- Kerbal Space Program 1
- Kopernicus - easiest way is through CKAN: search for "Kopernicus"
  and install it. CKAN will automatically pull in everything Kopernicus
  itself needs (ModuleManager, Harmony, ModularFlightIntegrator,
  KSPTextureLoader) - you don't need to hunt those down separately.

INSTALL
1. Open your KSP install folder and find the GameData subfolder.
   (Steam default on Windows:
   ...\steamapps\common\Kerbal Space Program\GameData)
2. Confirm Kopernicus and its dependencies are already in there
   (installed via CKAN as above, or manually).
3. Copy the "PearlPlanetPack" folder (this one) into GameData, so the
   end result looks like:
       GameData\PearlPlanetPack\PearlPlanetPack.cfg
       GameData\PearlPlanetPack\PearlPlanetPack.version
       GameData\PearlPlanetPack\StrawberryElephantPlanets.cfg
       GameData\PearlPlanetPack\PluginData\Strawberry_colormap.png
       GameData\PearlPlanetPack\PluginData\Strawberry_normalmap.png
       GameData\PearlPlanetPack\PluginData\Canopy_colormap.png
       GameData\PearlPlanetPack\PluginData\Canopy_normalmap.png
4. Launch KSP.

VERIFY IT WORKED
Open the Tracking Station (or the map view from the VAB) and zoom out.
You should see three new bodies orbiting the Sun: Pearl (between Duna
and Dres), Strawberry (between Dres and Jool), and Canopy (past Jool).
Strawberry and Canopy should be colored using your two photos.

IF IT DOESN'T SHOW UP
- Open KSP.log or Player.log (in your KSP install folder) in a text
  editor and search for "Kopernicus" or "ModuleManager" - errors there
  will usually say exactly what's wrong (e.g. a missing dependency or
  a typo in the .cfg).
- Double-check Kopernicus, ModuleManager, Harmony, ModularFlightIntegrator
  and KSPTextureLoader are all actually present in GameData.
- If you edited the .cfg and your changes don't seem to apply, delete
  GameData\ModuleManager.ConfigCache and relaunch - ModuleManager
  caches patched configs between launches.
- Config files are picky about matching curly braces. If KSP fails to
  load entirely, that's the first thing to check.

NEXT STEPS, ROUGHLY IN ORDER
1. Give Pearl its own map-view texture too (it's still just Pol's,
   unlike Strawberry/Canopy) - same technique as the other two.
2. Give the walkable ground itself real matching terrain instead of
   borrowing it (the PQS node - needs a grayscale heightmap image,
   and ideally a texture built for tiling rather than a single photo).
3. The normal maps right now are flat/neutral placeholders (no actual
   bump data) - a real normal map would make the surfaces catch light
   more convincingly.
4. Add science values and biomes so missions there are worth flying.
5. Consider an atmosphere, rings, or a moon of its own.
6. Once it's in a state you're happy with, publish it - see
   "PUBLISHING TO CKAN" below.

PUBLISHING TO CKAN
CKAN doesn't host mods itself or accept uploads directly - it indexes
mods that live somewhere else and installs them for people. The
standard, no-YAML-required path is through SpaceDock:

1. Pick a license. SpaceDock requires one, and CKAN records it too.
   Common choices for KSP mods: MIT, CC-BY-SA-4.0, or All Rights
   Reserved if you'd rather not let others redistribute/modify it.
2. Create an account at spacedock.info and start a new mod listing.
3. Fill in the name, description, and which KSP version(s) it's
   compatible with (SpaceDock's own field for this is what CKAN will
   use - the .version file included here is a bonus for the separate
   KSP-AVC checker some players use, not a requirement).
4. IMPORTANT: mention "Requires Kopernicus" somewhere in the
   description. SpaceDock doesn't have a structured dependency field,
   so this is how the human reviewer (next step) knows to add that
   relationship to your mod's CKAN metadata.
5. Upload PearlPlanetPack.zip (this exact file - CKAN expects a
   normal zip, and it already has the right internal folder layout).
6. There's a checkbox on the upload screen to add the mod to CKAN.
   Check it.
7. That's it from your side. Checking the box automatically opens a
   pull request against CKAN's indexing repository (NetKAN). A CKAN
   team member reviews it, fixes anything needed, and merges it - this
   isn't instant, expect it to take a few days. Once merged, your mod
   shows up in everyone's CKAN client on the next refresh.

If you'd rather not use SpaceDock (e.g. you want to host on GitHub
instead), the alternative is opening an issue at
github.com/KSP-CKAN/NetKAN/issues with your mod's details, or writing
the .netkan metadata file yourself - happy to help with either if you
go that route.

REFERENCE
Full Kopernicus config syntax: https://kopernicuswiki.github.io/
