COMPLETE ADVENTIA SYSTEM TUTORIAL
=================================

System for creating interactive fiction games in Gemini format
Version: 1.0
Author: Assistant

REQUIRED FILES
==============

1. game.dat     - Main game information
2. pages.dat    - All pages and content
3. genindex.sh  - Script that generates index.gmi
4. genpag.sh    - Script that generates .gmi pages

GAME.DAT STRUCTURE
==================

The game.dat file contains global game information:

gametitle: Your game's title
gameauthor: Your name as author
gameascii: Optional ASCII art for the cover
===GAMEINFO_START===
Game description that players will see
before starting. Can be multi-line.
===GAMEINFO_END===
gameversion: Game version (optional)
com: Comments (not processed)

Complete example:

gametitle: My Epic Adventure
gameauthor: Creative Author
gameascii:    🏰⚔️🐉
   EPIC
   ADVENTURE
     ✨📖✨
===GAMEINFO_START===
Welcome to an adventure full of mystery
and excitement. Your decisions will shape the destiny.
===GAMEINFO_END===
gameversion: 1.0
com:	My first Adventia game

PAGES.DAT STRUCTURE
===================

Each page has this structure:

id:	Unique number (01, 02, 03...)
name:	Page title
ascii:	Optional ASCII art
desc:	Page description and text
	Can contain {{id}} for links
	Can be multi-line
com:	Comments (not processed)

Page example:

id:	01
name:	The Beginning
ascii:   🌅🚶‍♂️🌲
   JOURNEY
   BEGINS
     🎒🗺️🎒
desc:	You wake up in a mysterious forest. You don't remember how you got here.
	You can {{02}} explore the forest or {{03}} seek help.
com:	Initial page with two options

NAVIGATION SYSTEM
=================

Links are created with {{ID}} in descriptions:

- Single {{id}} = Linear path
  desc:	Text {{02}}

- Multiple {{id}} = Player decisions
  desc:	What do you do? {{02}} or {{03}} or {{04}}

- No {{id}} = Story ending
  desc:	Game over. Thanks for playing!

GAME GENERATION
===============

Once game.dat and pages.dat are created:

1. Give execution permissions:
   chmod +x genindex.sh genpag.sh

2. Generate index.gmi:
   ./genindex.sh

3. Generate all pages:
   ./genpag.sh

4. Game will be ready in .gmi files

RESULTING FILE STRUCTURE
========================

index.gmi    - Main page with cover
01.gmi       - Game page 1
02.gmi       - Game page 2
...
map.gmi      - Connection map (automatically generated)

BEST PRACTICES
==============

1. Use consecutive IDs (01, 02, 03...)
2. Keep ASCII art simple and readable
3. Test all possible paths
4. Include multiple endings for replayability
5. Use comments (com:) for documentation

BASIC GAME EXAMPLE
==================

game.dat:
---------
gametitle: The Lost Treasure
gameauthor: Novice Adventurer
gameascii:   💎🗺️🏴‍☠️
   LOST
   TREASURE
    ⚓🌊⚓
===GAMEINFO_START===
Search for the legendary treasure of Captain Blackbeard.
Your decisions will determine if you find the fortune.
===GAMEINFO_END===

pages.dat:
----------
id:	01
name:	The Beach
ascii:   🏝️🌊👣
   DESERTED
   BEACH
    🐚🌴🐚
desc:	You arrive at a deserted beach. Find a bottle with a message.
	You can {{02}} open the bottle or {{03}} keep walking.
com:	Initial page

id:	02
name:	The Message
ascii:   📜💌🔍
   SECRET
   MESSAGE
    🕵️‍♂️📖🕵️‍♂️
desc:	The message reveals the treasure location. You're getting closer!
	{{04}} follow the clues.
com:	Treasure path

id:	03
name:	Explore the Beach
ascii:   🚶‍♂️🏝️🔍
   EXPLORATION
   NO REWARDS
    🍂🐚🍂
desc:	You walk along the beach but find nothing interesting.
	End of this adventure.
com:	Boring ending

id:	04
name:	The Treasure
ascii:   💰🎉🏆
   TREASURE
   FOUND
    ✨💎✨
desc:	You find the treasure chest! You're rich.
	End of adventure - Epic Ending.
com:	Successful ending

ADVANCED TIPS
=============

1. Create branches that reconnect later
2. Use variables in descriptions (> Item obtained)
3. Design puzzles with multiple solutions
4. Include secrets and easter eggs
5. Maintain story consistency

ADDITIONAL RESOURCES
====================

- Gemini format documentation
- Text editors for ASCII art
- Interactive fiction communities
- Game testing tools

HAPPY CREATING!
===============

With Adventia, you can create exciting adventures
without complex programming.

Share your creations with others and have fun!
