============================================================
  DARK DESIRES — README & SETUP GUIDE
  BlackBazaar.store
  For Adults 18+ Only
============================================================

Thank you for purchasing Dark Desires — an AI-powered adult
roleplay game where you write the fantasy and the AI brings
it to life in explicit, immersive detail.

------------------------------------------------------------
  CONTENTS OF THIS PACKAGE
------------------------------------------------------------

  install.bat       — Double-click to install the game
  uninstall.bat     — Double-click to uninstall the game
  DarkDesires\      — The game files (do not delete)
  README.txt        — This file

------------------------------------------------------------
  STEP 1 — INSTALL THE GAME
------------------------------------------------------------

1. Double-click  install.bat

2. When prompted, type  Y  and press Enter to confirm you
   are 18 years of age or older.

3. The installer will:
   - Copy the game to:
       C:\Users\[YourName]\AppData\Local\DarkDesires\
   - Create a Desktop shortcut  (Dark Desires)
   - Create a Start Menu shortcut
   - Automatically open config.py in Notepad

4. Leave Notepad open — you need it for Step 2.

------------------------------------------------------------
  STEP 2 — GET YOUR FREE API KEY
------------------------------------------------------------

Dark Desires uses the Grok AI (by xAI) to generate your
story. You need a free API key to connect to it.

1. Open your web browser and go to:
       https://console.x.ai

2. Create a free account and log in.

3. Click  API Keys  in the left sidebar.

4. Click  Create API Key  — give it any name you like.

5. Copy the key that appears (it looks like: xai-ABC123...)

   IMPORTANT: Copy it now — you may only see it once.

------------------------------------------------------------
  STEP 3 — ADD YOUR API KEY
------------------------------------------------------------

1. Go back to Notepad (it opened config.py in Step 1).
   If you closed it, open this file manually:

       C:\Users\[YourName]\AppData\Local\DarkDesires\config.py

   (Replace [YourName] with your actual Windows username)

2. Find this line:

       GROK_API_KEY = ""

3. Paste your API key between the quotes, like this:

       GROK_API_KEY = "xai-YourKeyHere"

4. Save the file (Ctrl + S) and close Notepad.

------------------------------------------------------------
  STEP 4 — LAUNCH THE GAME
------------------------------------------------------------

Double-click the  Dark Desires  icon on your Desktop.

The app will open with a black and red interface.
You should see:  API key loaded. Press [ NEW GAME ] to begin.

If you see a warning about the API key, double-check that
you saved config.py correctly in Step 3.

------------------------------------------------------------
  HOW TO PLAY
------------------------------------------------------------

STARTING A NEW GAME
-------------------
Click  [ NEW GAME ]  in the top bar to begin a fresh story.

The game will ask you four setup questions one at a time.
Take your time — the more detail you give, the better the
story will be.

  Question 1 — WHO ARE YOU?
  Describe yourself: your name, age, gender, and physical
  appearance. Be as detailed as you like — height, build,
  hair, features, clothing, personality.

  Question 2 — WHO IS YOUR PARTNER?
  Describe your partner (or partners): name, age, gender,
  and appearance. Again, the more vivid the detail the
  better the AI can write them.

  Question 3 — YOUR DESIRES & KINKS
  Tell the AI what you want woven into the story. Be
  specific and bold — fetishes, scenarios, dynamics,
  anything you want explored. Nothing is off limits.

  Question 4 — THE OPENING SCENARIO
  Set the stage. Where are you? What is already happening
  or about to happen? Describe the situation you want to
  open in.

After all four questions the AI will write a rich, explicit
opening scene built entirely around your answers.

MAKING CHOICES (TTRPG STYLE)
-----------------------------
Dark Desires plays like a tabletop RPG. After each scene
beat the story pauses and presents you with choices:

  ══ What do you do? ══
  [1] Option one
  [2] Option two
  [3] Option three
  [4] (write your own action)

Type the number of your choice and press Enter, or type
your own action entirely — the AI will follow your lead.

The story escalates naturally. You are always in control
of where it goes.

TYPING YOUR OWN ACTIONS
------------------------
You are never locked into the numbered choices. Type
anything you want to do and the AI will incorporate it
into the story. Be as specific or as creative as you like.

INPUT PANEL
-----------
  Enter           — Send your message / choice
  Shift + Enter   — Add a new line without sending

You can resize the input panel by dragging the red bar
that separates it from the story area.

------------------------------------------------------------
  SAVING & LOADING STORIES
------------------------------------------------------------

SAVING
------
At any point during a story click  [ SAVE ]  in the top bar.

On your first save you will be asked to give the story a
name (e.g. "Sarah at the cabin"). After that, pressing
[ SAVE ] again silently overwrites the same file.

Saves are stored as files in:
  C:\Users\[YourName]\AppData\Local\DarkDesires\saves\

LOADING
-------
Click  [ LOAD ]  in the top bar to open the save browser.

The browser shows all your saved stories with the date
and a short preview. Click a save to select it, then:

  [ LOAD ]    — Resume the story exactly where you left off
  [ RENAME ]  — Change the name of a save
  [ DELETE ]  — Permanently delete a save (asks to confirm)

You can also double-click a save to load it immediately.

When you load a save the full story reappears on screen
and the AI remembers everything that happened — you can
continue as if you never stopped.

------------------------------------------------------------
  SPECIAL COMMANDS
------------------------------------------------------------

Type these into the input box at any time:

  STOP    — Pause the current scene. The story holds and
            you are given options to continue, change
            scenario, or end the session.

  MENU    — Return to the start screen (begins a new game).
            Note: this does not auto-save — save first if
            you want to keep the current story.

------------------------------------------------------------
  TIPS FOR THE BEST EXPERIENCE
------------------------------------------------------------

- The more detail you put into the setup questions, the
  more personalised and immersive the story will be.

- Don't just pick numbered choices — type your own actions
  to take the story exactly where you want it.

- Save often. Stories can get long and you don't want to
  lose progress.

- If the AI response seems slow, it is just the Grok API
  processing — longer scenes take a few seconds. The text
  will stream in as it is generated.

- You can have multiple saved stories on the go at once —
  different characters, different scenarios, pick up any
  of them whenever you like.

------------------------------------------------------------
  API KEY COSTS
------------------------------------------------------------

Your free xAI account comes with a starting credit.
After that, Grok API usage is charged per token (per word
roughly). At typical play rates a few dollars of credit
goes a very long way.

You can top up credit at:  https://console.x.ai

Dark Desires itself has no subscription — you paid once
and own it forever. Only the AI usage has any ongoing cost.

------------------------------------------------------------
  TROUBLESHOOTING
------------------------------------------------------------

"No API key set" warning on launch
  → Open config.py (see Step 3 above) and make sure your
    key is pasted correctly between the quotes with no
    extra spaces.

App opens then immediately closes
  → Make sure you are running DarkDesires.exe from the
    Desktop shortcut or from:
    C:\Users\[YourName]\AppData\Local\DarkDesires\
    Do NOT run it from inside the zip file.

"API Error" message in the story window
  → Check your API key is correct and that you have credit
    remaining at console.x.ai

Story text stops mid-sentence
  → This is usually a temporary API timeout. Type anything
    and press Enter to prompt the AI to continue.

Can't find config.py
  → Press  Win + R, type:
      %LOCALAPPDATA%\DarkDesires
    and press Enter. config.py is in that folder.

------------------------------------------------------------
  UNINSTALLING
------------------------------------------------------------

Double-click  uninstall.bat  (included in this zip) or find
it in:  Start Menu → Dark Desires → Uninstall Dark Desires

This removes all game files and shortcuts. Your save files
are stored inside the install folder and will be deleted
too — copy them out first if you want to keep them.

------------------------------------------------------------
  SUPPORT
------------------------------------------------------------

  Website:  https://blackbazaar.store
  Email:    support@blackbazaar.store

------------------------------------------------------------
  LEGAL
------------------------------------------------------------

Dark Desires contains explicit adult content.
For adults 18 years of age or older only.
All characters and scenarios are entirely fictional.
Any resemblance to real persons is purely coincidental.

© 2026 BlackBazaar.store — All rights reserved.
============================================================
