SPAWN OVERHAUL - KO-FI SHOP WEBSITE v0.2
======================================

WHAT WAS FIXED
- Original website displayed 00 ship types when config.js had JavaScript errors.
- Invalid price syntax such as priceUsd: 2.99$ causes config.js to fail entirely.
- The new website displays a visible error banner + diagnostics log instead.
- Removed the "NO IN-GAME BUTTON PRESSES" tag.
- Changed Xenon N from a three-ship bundle to ONE fighter at $0.99 each.
- Added per-item quantity + and - buttons, an editable number field, and live totals.
- Kept the $9.99 Xenon K and $14.99 Kha'ak Ravager example prices.
- The website is a storefront preview, NOT connected to payments or X4 yet.

QUICK START
1. Extract the entire website folder to any directory on your Windows PC.
2. Double-click website\index.html.
3. The cards and quantity selectors should display instantly, even with no Ko-fi links.
4. In website\config.js you will see entries like:
     priceUsd: 0.99,
     itemUrl: '',
   Do NOT type a dollar sign inside the price number.
5. Create ONE Ko-fi Shop item for ONE Xenon N at $0.99,
   ONE Xenon K at $9.99, and ONE Kha'ak Ravager at $14.99.
   In Ko-fi Shop > each item's settings, ENABLE "Allow buyers to choose a quantity".
   Use ONE ship per unit -- no three-ship Xenon N bundle.
6. Copy each individual Ko-fi Shop PRODUCT URL (for example https://ko-fi.com/s/PRODUCTCODE)
   into the appropriate itemUrl: '...'. Save config.js, refresh the site (Ctrl+R).
7. On your website buyers choose quantity, view estimated total and click Continue.
   They MUST choose THE SAME QUANTITY AGAIN inside Ko-fi before paying.
   Ko-fi does not document a way to prefill a shop item's purchase quantity via URL.
   The Ko-fi checkout amount, not this website's preview, is authoritative.
8. Open the "Website setup & diagnostics" section in the page if a card is missing.
   Use "Download diagnostics (.txt)" to save a shareable troubleshooting report.

IMPORTANT - NOT YET A LIVE PAYMENT-TO-SPAWN SYSTEM
- This website does not collect payments or read payment status.
- Its quantity selector displays an estimate; it cannot prefill Ko-fi quantities.
- Ko-fi handles payment on the Ko-fi website.
- The next stage needs a secure HTTPS Ko-fi webhook receiver. It must:
    * verify the secret verification_token server-side (NEVER in public JS)
    * accept genuine Shop Order events only
    * map shop_items by Ko-fi direct_link_code, read purchased quantity
    * validate charged currency, prices and purchased quantities
    * deduplicate by message_id/transaction id
    * securely relay confirmed orders to the Twitch/X4 bridge
- Your current Twitch Channel Points "Spawn 3 Xenon N" reward is UNCHANGED.
- For paid orders, each unit of "1 Xenon N" will need a new game queue mapping.
- Do not enable real paid spawning based on website button clicks.
- Extreme quantities of capital ships can overload X4. Consider reasonable Ko-fi Shop limits.

To host publicly, upload website/index.html and website/config.js side by side
using a static host. No Node.js/Python is required to OPEN OR EDIT this preview.

Official Ko-fi sources:
https://help.ko-fi.com/hc/en-us/articles/360009712917-Ko-fi-Shop-Sell-digital-physical-products
https://help.ko-fi.com/hc/en-us/articles/360004162298-Does-Ko-fi-have-an-API-or-webhook


NEW IN v0.3
- Added local ship preview images for Xenon N, Xenon K and Kha'ak Ravager.
- Added a separate file named KoFi_Setup_Tutorial.html with a step-by-step Ko-fi walkthrough and picture examples.
- Tutorial page is separate and does NOT replace the storefront page.


CRITICAL v0.3.1 FIX
- Fixes undefined JavaScript variable 'art' that prevented product cards from rendering.
- For Ko-fi digital listings without a quantity selector, enable Pay What You Want at the single-item minimum.
- Buyers choose a quantity in our website; they must enter the calculated total manually on Ko-fi.
- Do NOT mislabel intangible game events as physical goods just to access shipping/quantity.
- Automatic payment-to-X4 spawning is NOT enabled yet. A secure webhook must validate payment amount, currency, shop product, transaction ID, and order intent.
- Bundled artwork is illustrative, not an exact X4 ship screenshot. You can replace any picture in assets/ with your own capture using the same filename.