chineseclass/ClassGenSystem

ClassGenSystem - Game-Ready JSON Content

This folder contains all textbook content structured as JSON files ready to be loaded into the classGen game system.

Structure

Each book has its own subfolder with JSON files:

ClassGenSystem/
├── Kouyu/          # Speaking chapters as JSON
├── Hanyu/          # Composition chapters as JSON
├── LEDU/           # Reading chapters as JSON
├── Tingli/         # Listening chapters as JSON
└── Xiezuo/         # Writing chapters as JSON

JSON Format

Each chapter JSON includes:

• Metadata: id, name, difficulty, estimated hours, prerequisites
• Vocabulary: Words with pronunciation, type, meaning, examples
• Grammar: Patterns with explanations and examples
• Texts: Main reading/listening content with questions
• Exercises: Various exercise types (character inference, comprehension, etc.)
• Games: 3 games per chapter
  • Game 1: Vocabulary challenge
  • Game 2: Grammar/pattern practice
  • Game 3: Production game

Game Structure

Each chapter must have 3 games:

"games": [
  {
    "id": "game1-vocab",
    "type": "vocabulary-matching",
    "title": "Vocabulary Challenge",
    "data": { /* game-specific data */ }
  },
  {
    "id": "game2-grammar",
    "type": "sentence-builder",
    "title": "Grammar Practice",
    "data": { /* game-specific data */ }
  },
  {
    "id": "game3-production",
    "type": "speaking-challenge",
    "title": "Production Game",
    "data": { /* game-specific data */ }
  }
]

Workflow

Markdown content (Content/)
  → Structure as JSON with metadata
  → Add 3 games per chapter
  → Save here (ClassGenSystem/)
  → Load into classGen app

Current Status

Book	JSON Files	Status
LEDU	Chapters 1-4	✓ Exists with full structure
Hanyu	0/13	Need to create
Kouyu	0/12	Need to create
Tingli	0/30	Need to create
Xiezuo	0/6	Need to create

Reference

See ledu-chapter1.json for a complete example of proper JSON structure.

Book metadata file: ledu-book.json shows how to structure a book overview.

Notes

• Follow the LEDU format for consistency
• Each game should be playable and engaging
• Vocabulary should include pronunciation (pinyin) and examples
• Grammar patterns need clear explanations and multiple examples