1"""
  2[Title/Звание]
  3Don't mess with the Stars
  4
  5
  6[Description/Обрисовка]
  7"Don't Mess with the Stars" е 2D grid-based игра, в която играчът управлява герой, преминаващ през лабиринти, вдъхновени от астрологията.
  8Играчът събира кристали, звезден прах (star dust), зодиакални знаци и фрагменти от съзвездия, за да натрупа звездна енергия и да отключва портали към следващи нива.
  9По пътя си трябва да избягва планетарни врагове, препятствия и да се справя с временни астрологични събития, които променят поведението на играта.
 10Всяко ниво има собствена цел за събиране на звездна енергия и определен брой фрагменти от съзвездия (constellation fragments),
 11нужни за отключване на портала. С напредването на играта нужната енергия и броят на constellation fragments се увеличават,
 12враговете стават по-опасни, а събития като Full Moon и New Moon временно променят поведението им.
 13Играта приключва успешно, когато играчът премине всички нива, а неуспешно — когато загуби всичките си животи.
 14
 15
 16[Functionalities/Надарености]
 17Потребителят може да стартира нова игра от началното меню.
 18Той управлява героя чрез клавиатурата, като го движи по grid карта в четири посоки: нагоре, надолу, наляво и надясно.
 19Играта използва карта, разделена на клетки. Всяка клетка може да бъде празна, стена на лабиринта, препятствие, collectible, враг, портал или позиция на играча.
 20
 21Играчът събира collectibles:
 22- Star Crystal - основен кристал, който дава звездна енергия.
 23- Moon Crystal - по-рядък кристал, който може да дава защитен бонус.
 24- Sun Crystal - кристал, който може да дава допълнителна енергия или временен бонус.
 25- Zodiac Sign - рядък collectible, който дава повече звездна енергия или временен бонус.
 26- Star Dust - малък ресурс, който се появява по-често и носи допълнителна звездна енергия.
 27- Constellation Fragment - специален collectible, който е нужен за отключване на портала към следващо ниво.
 28
 29При сблъсък с определено препятствие или враг героят губи HP.
 30Препятствие (obstacle) - може да бъде непроходим tile (предмет или стена) или tile с предмет, върху който ако играчът премине, губи част от своето HP.
 31
 32Enemies - имат различни типове поведение, скорост и сила на атака:
 33- Mercury The Retrograde се движи хаотично или преследва играча, когато той попадне в обсега му.
 34- Jupiter The Mighty е по-бавен, но по-силен враг, който отнема повече HP.
 35- Mars The Mad One е агресивен враг, който се движи по-бързо.
 36- Venus The Charming One - може временно да забавя героя или да влияе на движението му по друг начин.
 37- Eclipse The Void е специален враг, който се появява по-рядко или при определени условия.
 38
 39Някои врагове могат да използват pathfinding, за да намират път до играча.
 40
 41Game events - активират се автоматично през определени интервали от време и за определено време:
 42(Алтернативен вариант е събитията да се активират, когато играчът премине през определен tile.)
 43- Full Moon - събитие, което променя поведението на враговете, като ги прави по-агресивни или увеличава обсега им.
 44- New Moon - събитие, което променя поведението на враговете по различен начин и може да активира по-опасни или по-непредвидими условия или врагове.
 45
 46Играта показва HUD с текущи животи, HP, активно събитие, цел на нивото, събрана звездна енергия,
 47събрани constellation fragments и колко още остават до отключване на портала.
 48След загуба потребителят вижда Game Over екран и може да започне нова игра.
 49Играта може да запазва най-добро постижение във файл и да го зарежда при следващо стартиране. (за време например)
 50
 51Нива:
 52- Всяко ниво има различна цел за събиране на звездна енергия.
 53- Всяко ниво има определен брой constellation fragments, нужни за отключване на портала.
 54- Когато играчът събере нужната звездна енергия и нужните constellation fragments, порталът към следващото ниво се отключва.
 55- Играчът преминава към следващото ниво, когато достигне отключения портал.
 56- Играта приключва успешно, когато играчът премине всички нива.
 57- Героят има HP и максимум 3 живота.
 58
 59Когато HP достигне 0, героят губи един живот, а HP се възстановява до начална стойност.
 60Играта приключва неуспешно, когато героят загуби всичките си животи.
 61
 62Resources:
 63- Star Dust - ресурс, който играчът събира за допълнителна звездна енергия.
 64- Star Energy - основният ресурс за отключване на портала към следващо ниво.
 65- Constellation Fragments - специални фрагменти, нужни за отключване на портала към следващо ниво.
 66- HP - здравето на героя.
 67- Lives - броят животи на героя.
 68
 69Bonus functionalities/Бонус надарености (Ще бъдат добавени, ако остане време):
 701. Различни герои - може играчът да има избор между различни герои с различни способности.
 712. Adaptive difficulty - може трудността да се променя според представянето на играча.
 72
 73[Milestones/Възлови точки]
 74Menu - контролира началното меню, стартирането на играта и избора на настройки.
 75Като допълнително надграждане може да включва избор на герой.
 76Maps - съхранява и управлява информацията за картите, grid позициите, свободните клетки, препятствията, началните позиции на героя, враговете,
 77collectibles и портала.
 78GameController - обработва основната логика на играта, включително стартиране на ниво, обновяване на състоянието,
 79проверка за победа или загуба и преминаване към следващо ниво.
 80UIManager - контролира визуализирането на статистиките и ресурсите в HUD-а, като животи, HP, звездна енергия,
 81constellation fragments, цел на нивото и активно астрологично събитие.
 82Enemy - контролира поведението на враговете, тяхната позиция, движение, скорост, сила на атака и реакция при сблъсък с играча.
 83Player - контролира поведението на играча, движението по grid картата, HP, животите, събирането на предмети и активните бонуси.
 84Collectible - управлява събираемите предмети като кристали, star dust, зодиакални знаци и constellation fragments,
 85както и ефектите им върху звездната енергия и бонусите.
 86Obstacles - описва препятствията по картата и проверява дали дадена клетка е проходима или не или пък нанася щета на играча.
 87Events - контролира появата и продължителността на събитията Full Moon и New Moon, както и ефектите им върху враговете и игровата среда.
 88Portal - управлява отключването на портала след събиране на достатъчно звездна енергия и нужния брой constellation fragments
 89и проверява преминаването към следващо ниво.
 90ScoreManager - изчислява събраната звездна енергия, следи constellation fragments и проверява дали целта на нивото е изпълнена.
 91AssetsManager - зарежда и управлява изображенията, sprite-овете и другите визуални ресурси на играта.
 92SaveManager - записва и зарежда постиженията на играча във файл.
 93Pathfinding - реализира намиране на път до играча за някои от враговете, когато играчът попадне в техния обсег.
 94Tests - съдържа тестове за основната логика на играта: движение по grid, събиране на предмети, събиране на звездна енергия,
 95загуба на HP, загуба на живот, отключване на портал, активиране на събития, поведение на врагове и други.
 96
 97Bonus:
 98DifficultyManager - допълнителен модул, който следи поведението на играча и променя трудността на играта според представянето му.
 99
100[Estimate in man-hours/Времеоценка в човекочасове]
101Около 50 - 60 часа. (Без генерирането/оформянето на асетите и бонус функционалностите)
102
103[Usage of technologies/Потребление на технологии]
104Стандартна Python библиотека:
105- random, json, pathlib, time, collections, unittest (ще се използва unittest или pytest) и други.
106
107Външна библиотека:
108- pygame
109
110Възможна външна библиотека:
111- pytest (ще се използва unittest или pytest)
112
113Assets:
114- AI генерирани асети - за спрайтове на герои, врагове, collectibles и други текстури в играта.
115- Лека помощ от Photoshop - за изрязване, корекции и подготовка на спрайтове и текстури
116- Допълнителни assets от интернет, ако са нужни и са свободни за употреба
117"""