Compare commits
2 Commits
fd8c091872
...
main
| Author | SHA1 | Date | |
|---|---|---|---|
| 0b2968e33f | |||
| 4eea1dcec7 |
164
docs/classes.md
164
docs/classes.md
@@ -2,25 +2,163 @@
|
||||
|
||||
## Game
|
||||
|
||||
Основной класс игры. Управляет игровым циклом, загрузкой данных, обработкой команд игрока, перемещением, взаимодействием с сундуками, NPC и боевой системой.
|
||||
Основной класс игры. Управляет игровым циклом, загрузкой данных, отображением карты, обработкой команд игрока, взаимодействием с объектами и переходами между локациями.
|
||||
|
||||
### Поля
|
||||
|
||||
| Поле | Тип | Описание |
|
||||
|---|---|---|
|
||||
| ------------ | --------------------- | ---------------- |
|
||||
| player | Player | Игрок |
|
||||
| locations | vector<Location> | Список игровых локаций |
|
||||
| itemDatabase | vector<Item> | База предметов |
|
||||
| locations | std::vector<Location> | Список локаций |
|
||||
| itemDatabase | std::vector<Item> | База предметов |
|
||||
| isRunning | bool | Флаг работы игры |
|
||||
|
||||
### Методы
|
||||
|
||||
| Метод | Описание |
|
||||
|---|---|
|
||||
| run() | Запускает игру |
|
||||
| loadLocations() | Загружает локации из файлов |
|
||||
| loadItems() | Загружает предметы |
|
||||
| processCommand() | Обрабатывает команды игрока |
|
||||
| movePlayer() | Перемещает игрока |
|
||||
| openChest() | Открывает сундук |
|
||||
| startCombat() | Запускает бой |
|
||||
| Метод | Назначение |
|
||||
| ----------------- | ---------------------------- |
|
||||
| run() | Запуск игры |
|
||||
| loadItems() | Загрузка предметов |
|
||||
| loadLocations() | Загрузка локаций |
|
||||
| render() | Отрисовка текущего состояния |
|
||||
| processCommand() | Обработка команды игрока |
|
||||
| movePlayer() | Перемещение игрока |
|
||||
| handleTile() | Обработка клетки карты |
|
||||
| solveRiddle() | Решение загадки |
|
||||
| openChest() | Открытие сундука |
|
||||
| interactWithNPC() | Взаимодействие с NPC |
|
||||
| startCombat() | Запуск боя |
|
||||
|
||||
---
|
||||
|
||||
## Player
|
||||
|
||||
Класс игрока.
|
||||
|
||||
### Поля
|
||||
|
||||
| Поле | Тип | Описание |
|
||||
| ---------------- | ----------- | ------------------------ |
|
||||
| name | std::string | Имя персонажа |
|
||||
| hp | int | Здоровье |
|
||||
| maxHp | int | Максимальное здоровье |
|
||||
| atk | int | Базовый урон |
|
||||
| gold | int | Количество золота |
|
||||
| currentLocation | int | Текущая локация |
|
||||
| position | Point | Позиция на карте |
|
||||
| inventory | Inventory | Инвентарь |
|
||||
| equippedWeaponId | int | ID экипированного оружия |
|
||||
|
||||
### Методы
|
||||
|
||||
| Метод | Назначение |
|
||||
| ------------- | ---------------------- |
|
||||
| showStats() | Вывод характеристик |
|
||||
| getDamage() | Расчёт итогового урона |
|
||||
| usePotion() | Использование зелья |
|
||||
| equipWeapon() | Экипировка оружия |
|
||||
|
||||
---
|
||||
|
||||
## Inventory
|
||||
|
||||
Инвентарь игрока.
|
||||
|
||||
### Поля
|
||||
|
||||
| Поле | Тип |
|
||||
| ----- | -------------------------- |
|
||||
| items | std::vector<InventorySlot> |
|
||||
|
||||
### Методы
|
||||
|
||||
| Метод | Назначение |
|
||||
| ------------ | ------------------------- |
|
||||
| addItem() | Добавление предмета |
|
||||
| removeItem() | Удаление предмета |
|
||||
| hasItem() | Проверка наличия предмета |
|
||||
| show() | Вывод содержимого |
|
||||
|
||||
---
|
||||
|
||||
## Location
|
||||
|
||||
Игровая локация.
|
||||
|
||||
### Поля
|
||||
|
||||
| Поле | Назначение |
|
||||
| --------------------- | ------------------------ |
|
||||
| id | Уникальный идентификатор |
|
||||
| title | Название |
|
||||
| width | Ширина карты |
|
||||
| height | Высота карты |
|
||||
| map | ASCII-карта |
|
||||
| startPosition | Стартовая позиция |
|
||||
| north/south/east/west | Связи между локациями |
|
||||
| riddle | Загадка |
|
||||
| chests | Сундуки |
|
||||
| npcs | NPC |
|
||||
| enemies | Противники |
|
||||
|
||||
### Методы
|
||||
|
||||
| Метод | Назначение |
|
||||
| -------------- | ---------------------------- |
|
||||
| loadFromFile() | Загрузка локации |
|
||||
| draw() | Отрисовка карты |
|
||||
| isWalkable() | Проверка проходимости клетки |
|
||||
| getTile() | Получение символа карты |
|
||||
|
||||
---
|
||||
|
||||
## NPC
|
||||
|
||||
Неигровой персонаж.
|
||||
|
||||
### Поля
|
||||
|
||||
| Поле | Назначение |
|
||||
| ---------- | ------------------------ |
|
||||
| id | Уникальный идентификатор |
|
||||
| name | Имя |
|
||||
| state | Состояние |
|
||||
| hp | Здоровье |
|
||||
| damage | Урон |
|
||||
| dialogText | Основной текст диалога |
|
||||
| options | Варианты ответов |
|
||||
| position | Координаты |
|
||||
| defeated | Флаг поражения |
|
||||
|
||||
### Методы
|
||||
|
||||
| Метод | Назначение |
|
||||
| ------------------- | ------------------------- |
|
||||
| loadFromFile() | Загрузка NPC |
|
||||
| parseState() | Разбор состояния |
|
||||
| parseDialogResult() | Разбор результата диалога |
|
||||
|
||||
---
|
||||
|
||||
## SaveManager
|
||||
|
||||
Система сохранения и загрузки игры.
|
||||
|
||||
### Методы
|
||||
|
||||
| Метод | Назначение |
|
||||
| ---------- | --------------- |
|
||||
| saveGame() | Сохранение игры |
|
||||
| loadGame() | Загрузка игры |
|
||||
|
||||
---
|
||||
|
||||
## Logger
|
||||
|
||||
Система журналирования событий.
|
||||
|
||||
### Методы
|
||||
|
||||
| Метод | Назначение |
|
||||
| ----- | ------------------------- |
|
||||
| log() | Запись события в лог-файл |
|
||||
|
||||
125
docs/methods.md
125
docs/methods.md
@@ -4,26 +4,125 @@
|
||||
|
||||
Перемещает игрока на указанное смещение.
|
||||
|
||||
### Входные данные
|
||||
### Параметры
|
||||
|
||||
| Параметр | Тип | Описание |
|
||||
|---|---|---|
|
||||
| dx | int | Смещение по X |
|
||||
| dy | int | Смещение по Y |
|
||||
| Имя | Тип | Описание |
|
||||
| --- | --- | ----------------- |
|
||||
| dx | int | Смещение по оси X |
|
||||
| dy | int | Смещение по оси Y |
|
||||
|
||||
### Возвращаемое значение
|
||||
|
||||
Метод ничего не возвращает.
|
||||
Отсутствует.
|
||||
|
||||
---
|
||||
|
||||
## Player::usePotion(int itemId, const vector<Item>& itemDatabase)
|
||||
## Game::solveRiddle(Location& location)
|
||||
|
||||
Использует зелье из инвентаря игрока.
|
||||
Отображает загадку игроку и проверяет введённый ответ.
|
||||
|
||||
### Входные данные
|
||||
### Параметры
|
||||
|
||||
| Параметр | Тип | Описание |
|
||||
|---|---|---|
|
||||
| itemId | int | ID предмета |
|
||||
| itemDatabase | vector<Item> | База всех предметов |
|
||||
| Имя | Тип |
|
||||
| -------- | --------- |
|
||||
| location | Location& |
|
||||
|
||||
### Возвращаемое значение
|
||||
|
||||
| Тип | Описание |
|
||||
| ---- | -------------------------- |
|
||||
| bool | true при правильном ответе |
|
||||
|
||||
---
|
||||
|
||||
## Player::usePotion(int itemId, const std::vector<Item>& itemDatabase)
|
||||
|
||||
Использует выбранное зелье из инвентаря.
|
||||
|
||||
### Параметры
|
||||
|
||||
| Имя | Тип |
|
||||
| ------------ | ----------------- |
|
||||
| itemId | int |
|
||||
| itemDatabase | std::vector<Item> |
|
||||
|
||||
---
|
||||
|
||||
## Player::equipWeapon(int itemId, const std::vector<Item>& itemDatabase)
|
||||
|
||||
Экипирует выбранное оружие.
|
||||
|
||||
### Параметры
|
||||
|
||||
| Имя | Тип |
|
||||
| ------------ | ----------------- |
|
||||
| itemId | int |
|
||||
| itemDatabase | std::vector<Item> |
|
||||
|
||||
---
|
||||
|
||||
## Inventory::addItem(int itemId, int count)
|
||||
|
||||
Добавляет предмет в инвентарь.
|
||||
|
||||
### Параметры
|
||||
|
||||
| Имя | Тип |
|
||||
| ------ | --- |
|
||||
| itemId | int |
|
||||
| count | int |
|
||||
|
||||
---
|
||||
|
||||
## Inventory::removeItem(int itemId, int count)
|
||||
|
||||
Удаляет предмет из инвентаря.
|
||||
|
||||
### Параметры
|
||||
|
||||
| Имя | Тип |
|
||||
| ------ | --- |
|
||||
| itemId | int |
|
||||
| count | int |
|
||||
|
||||
### Возвращаемое значение
|
||||
|
||||
| Тип | Описание |
|
||||
| ---- | ------------------- |
|
||||
| bool | Успешность операции |
|
||||
|
||||
---
|
||||
|
||||
## Location::loadFromFile(const std::string& path)
|
||||
|
||||
Загружает данные локации из файла.
|
||||
|
||||
### Параметры
|
||||
|
||||
| Имя | Тип |
|
||||
| ---- | ----------- |
|
||||
| path | std::string |
|
||||
|
||||
### Возвращаемое значение
|
||||
|
||||
| Тип |
|
||||
| ---- |
|
||||
| bool |
|
||||
|
||||
---
|
||||
|
||||
## NPC::loadFromFile(const std::string& path)
|
||||
|
||||
Загружает параметры NPC из текстового файла.
|
||||
|
||||
### Параметры
|
||||
|
||||
| Имя | Тип |
|
||||
| ---- | ----------- |
|
||||
| path | std::string |
|
||||
|
||||
### Возвращаемое значение
|
||||
|
||||
| Тип |
|
||||
| ---- |
|
||||
| bool |
|
||||
|
||||
@@ -3,3 +3,46 @@
|
||||
[2026-06-11 15:28:12] Player opened chest in location: Entrance Hall
|
||||
[2026-06-11 15:28:12] Player received item ID: 101
|
||||
[2026-06-11 15:28:12] Player received item ID: 101
|
||||
[2026-06-11 16:07:50] Game started
|
||||
[2026-06-11 16:08:03] Game started
|
||||
[2026-06-11 16:08:05] New game started. Player name: Zero
|
||||
[2026-06-11 16:08:20] Wrong riddle answer in location: Entrance Hall
|
||||
[2026-06-11 16:08:28] Player selected dialog option with NPC: Old Guard
|
||||
[2026-06-11 16:08:29] Player opened chest in location: Entrance Hall
|
||||
[2026-06-11 16:08:29] Player received item ID: 101
|
||||
[2026-06-11 16:08:29] Player received item ID: 101
|
||||
[2026-06-11 16:08:32] Player entered location: Old Corridor
|
||||
[2026-06-11 16:08:34] Combat started with NPC: Dungeon Bandit
|
||||
[2026-06-11 16:08:36] NPC defeated: Dungeon Bandit
|
||||
[2026-06-11 16:08:38] Player opened chest in location: Old Corridor
|
||||
[2026-06-11 16:08:38] Player received item ID: 101
|
||||
[2026-06-11 16:08:38] Player received item ID: 201
|
||||
[2026-06-11 16:08:41] Riddle solved in location: Old Corridor
|
||||
[2026-06-11 16:08:41] Player entered location: Guard Room
|
||||
[2026-06-11 16:08:46] Player selected dialog option with NPC: Archivist
|
||||
[2026-06-11 16:08:46] Combat started with NPC: Archivist
|
||||
[2026-06-11 16:08:55] NPC defeated: Archivist
|
||||
[2026-06-11 16:08:59] Riddle solved in location: Guard Room
|
||||
[2026-06-11 16:08:59] Player entered location: Library
|
||||
[2026-06-11 16:09:03] Wrong riddle answer in location: Library
|
||||
[2026-06-11 16:09:07] Riddle solved in location: Library
|
||||
[2026-06-11 16:09:07] Player entered location: Final Gate
|
||||
[2026-06-11 16:09:13] Player selected dialog option with NPC: Old Guard
|
||||
[2026-06-11 16:09:29] Wrong riddle answer in location: Final Gate
|
||||
[2026-06-11 16:09:53] Riddle solved in location: Final Gate
|
||||
[2026-06-11 16:09:53] Player entered location: Library
|
||||
[2026-06-11 16:09:57] Player selected dialog option with NPC: Old Guard
|
||||
[2026-06-11 16:10:00] Player entered location: Final Gate
|
||||
[2026-06-11 16:10:08] Player selected dialog option with NPC: Old Guard
|
||||
[2026-06-11 16:10:08] Combat started with NPC: Old Guard
|
||||
[2026-06-11 16:10:12] NPC defeated: Old Guard
|
||||
[2026-06-11 16:10:16] Player entered location: Library
|
||||
[2026-06-11 16:10:30] Player entered location: Final Gate
|
||||
[2026-06-11 16:10:36] Player opened chest in location: Final Gate
|
||||
[2026-06-11 16:10:36] Player received item ID: 101
|
||||
[2026-06-11 16:10:36] Player received item ID: 102
|
||||
[2026-06-11 16:10:36] Player received item ID: 202
|
||||
[2026-06-11 16:10:39] Player entered location: Library
|
||||
[2026-06-11 16:10:42] Player opened chest in location: Library
|
||||
[2026-06-11 16:10:42] Player received item ID: 102
|
||||
[2026-06-11 16:10:42] Player received item ID: 202
|
||||
|
||||
@@ -208,6 +208,14 @@ void Game::handleTile(char tile) {
|
||||
interactWithNPC(*location);
|
||||
}
|
||||
else if (tile == 'D') {
|
||||
|
||||
if (location->id == 5) {
|
||||
std::cout << "\nYou escaped from the labyrinth!\n";
|
||||
std::cout << "Victory!\n";
|
||||
isRunning = false;
|
||||
return;
|
||||
}
|
||||
|
||||
if (!location->riddle.isSolved) {
|
||||
bool solved = solveRiddle(*location);
|
||||
|
||||
|
||||
Reference in New Issue
Block a user