# 240

**Repository Path**: pu-ze/240

## Basic Information

- **Project Name**: 240
- **Description**: 由长安大学四位热爱编码的同学编写的小游戏，欢迎大家下载体验

- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2025-10-21
- **Last Updated**: 2025-12-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# League of Chang'an - PvE Campaign

A turn-based role-playing game set in the Tang dynasty, featuring legendary heroes and strategic combat.

## Overview

Legends of Chang'an is a PvE campaign game where players assemble a team of 3 heroes from a roster of legendary characters, battle through multiple levels, and collect rewards to strengthen their team. The game features turn-based combat, hero selection, skill management, and progress saving.

## Features

- **Hero Selection**: Choose 3 heroes from 10 available characters, each with unique skills and attributes
- **Turn-based Combat**: Engage in strategic battles with different enemies across 5 levels
- **Progression System**: Earn rewards after each level to enhance hero abilities
- **Save System**: Save your progress and continue from where you left off
- **Status Effects**: Various buffs and debuffs that affect battle outcomes
- **Equipment System**: Collect and equip items to boost hero attributes

## Gameplay

1. **Save Selection**: Start a new game or load an existing save
2. **Hero Selection**: Choose 3 heroes from the available roster
3. **Combat**: Battle through 5 levels of increasing difficulty
4. **Rewards**: Receive equipment after each level to strengthen your team
5. **Progression**: Game automatically saves after each level completion

## Hero Classes

Each hero belongs to a specific class with unique abilities:

- **Assassin**: High damage, single-target focus (e.g., Li Bai)
- **Mage**: Area damage and crowd control (e.g., Wu Zetian)
- **Warrior**: Balanced offense and defense (e.g., Sikong Zhen)
- **Taoist**: Healing and support (e.g., Fang Xuanling)
- **Marksman**: Precision damage (e.g., Di Renjie)

## Controls

- **Mouse Click**: Select heroes, choose actions in battle, navigate menus
- **Quit**: Close the game window to exit

## Project Structure

```
240/
├── main.py               # Main game entry point
├── constants.py          # Game constants and configurations
├── utils/
│   └── file_io.py        # File input/output utilities
├── hero/
│   ├── base.py           # Base Champion class
│   ├── specific.py       # Specific hero implementations
│   └── status_effects.py # Status effects for heroes
├── scene/
│   ├── select.py         # Hero selection scene
│   ├── battle.py         # Battle scene (implied)
│   ├── save_select.py    # Save selection scene
│   └── reward.py         # Reward scene (implied)
├── item/
│   ├── base.py           # Base Item class
│   └── specific.py       # Specific item implementations
└── save/
    └── save_manager.py   # Save management (implied)
```

## Dependencies

- Pygame: For game graphics and input handling

## Installation

1. Ensure Python is installed on your system
2. Install Pygame: `pip install pygame`
3. Clone or download the game files
4. Run `python main.py` to start the game

## Development Notes

- The game currently includes 5 levels, but can be extended by modifying the range in `main.py`
- New heroes can be added by creating new classes in `hero/specific.py` that inherit from `Champion`
- New items can be added by extending the `ITEMS` list in `item/specific.py`
- Status effects can be extended by adding new classes in `status_effects.py`

## Known Features

- Auto-save after each level completion
- Hero skills with cooldown systems
- Equipment system with stat bonuses
- Status effect system (silence, defense up, attack down, etc.)
- Persistent game state across sessions

Enjoy your journey through the Legends of Chang'an!