1"""
  2[Title]
  3Secret of Spas
  4[Description]
  5Действието се развива по време на Средновековието в малкото село Могилово(До Стара Загора, центъра на България и света)
  6Главният герой на действието е Кънчо, който е младо момче на 20 години.
  7Както всяко друго момче на неговата възраст Къчно иска да разбере тайната на живота.
  8Той стига до заключението, че му трябва помощ от мъдреца на селото дядо Спас.
  9Дядо Спас е типичен български мъдрец, който обича да консумира алкохол и
 10съответно обича да си произвежда.
 11Но тъй като лошите грабители са откраднали неговия зързават,
 12работа на Кънчо е да го върне, за да получи мъдър съвет от дядо Спас.
 13За да се справи Къчно с тази задача, в негова помощ идват доносниците,
 14които му помагат  да намери грабителите и да вземе загубените съставки на мъдреца
 15Кънчо е силен воин и той може да си борави с лък и меч за да изпълни тази задача.
 16
 17Дядо Спас иска да си възвърне всичко откраднато , а от него са се откраднали съставки за
 18- Водка -> (Картофи, Пшеница,Царевица,Захар,Мая,Вода)
 19- Джин -> (водка, Хвойнови зърна,Корен от ангелика,Кориандър,Вода)
 20- Бира -> (Малц, Хмел, Мая за бира, Вода)
 21- Ракия(не врачанска а заралийска) -> (Грозде, Захар,Вода,Мая)
 22[Functionalities]
 23    [Functionalities/Main]
 24    - 4 Dungeona
 25        Всеки dungeon ще е създаден за откриването на съставките на конкретен алкохол.
 26        За всеки dungeon, ще бъде имплементирани:
 27         -- 2 вида грабигтели
 28            -- първите ще могат да удрят само от близко разстояние(Infantry)
 29            -- вторите ще могат да стрелят с лък(Archer)
 30            -- за всеки dungeon ще се постарая грабители да имат различен layout(но еднаква функционалност).
 31            -- при убиване на някакъв процент от грабителите ще се появяват още и ще са по трудни за убиване(повече health и attack damage).
 32
 33    - При убийство на грабител трябва да падат различни съставки.
 34    - Съставките трябва да имат различен percent rate на падане от грабител, за да е по - интересно.
 35    - Мисии които ще бъдат давани от доносниците.
 36    - Кeсия ,в която Къчно трябва да събира съставки(a.k.a инвентар, но кесия звучи по - средновековно).
 37    - Имплементация на удар и стрелба на Кънчо.
 38    - Функционалност за collision при стрелба и удар
 39    - Функционалност за collision при блоков елемент(примерно храст и река)
 40    - Имплементиране на логика, която ще дава процент шанс да падне конкретна съставка
 41    - Имплементиране на портали на картата, през които по всяко време героя ще може да се ходи на други мапове(Порталите в моя случай ще са едни табели).
 42    - Health bar
 43    - Resize на екрана
 44
 45
 46    [Functionalities/Additional]
 47        Това са функционалности, които ще направят играта по - интересна, но са само и единствено за по - добър user experiance
 48            -Звуци
 49                -- играта ще има background музика
 50                -- като Кънчо обикаля в селото, ако отиде до някоя къща, ще се чуват различни ритми в range, защото могиловци са парти хора
 51                -- при удари между Кънчо и грабителите ще се чуват ударите.
 52            -Кола
 53                чудя се дали да направя Кънчо да може да кара кола в селото, ама имам само sprite за полицейска кола, така че ще видим как изглежда и ще реша
 54                -- Кънчо ще може да се качва и слиза от колата(Примерно бутонче F мисля ,че е това в игрите)
 55                -- Кънчо ще може да си пуска музика в колата
 56            -Settings меню
 57
 58[Milestones]
 59    [Milestones/Main]
 60        Създаване на карта на селото на Кънчо от където ще получава своите мисии
 61        Създаване на 4 dungeons
 62         - Относно 5-те карти(със селото) мисля да дефинирам матрица която да оказва къде има стени и др
 63           на картата и главният герой да бъде винаги в центъра на екрана и само екрана да се мести като ще се показва
 64           някакъв partition от матрицата
 65         - трябва да има логика,  която спрямо матрицата рендерира всичко, което е в partition-a на екрана
 66
 67        за да не влизам в излизшни математически collision сметки
 68        - измисляне на алгоритъм за търсене на Кънчо от страна на грабителите(BFS стига за нашите нужди(Ако не стигне А* ще стигне))
 69        - ще измисля някакъв отпимален мащаб на карта и брой грабители, за да не падне рамта на компютъра (ако сложа BFS на 1000 грабителя на всеки frame не мисля че ще стане хубаво)
 70
 71        Мисии които ще бъдат давани от доносниците
 72           -Трябва да се направи изкачащо меню на мисията, в което ще има:
 73              -- текст който ще описва задачата на Къчно (какви съставки трябва да намери и мястото, където са грабителите)
 74              -- pixel avatar на доносника
 75              -- voice over на текста, който казва доносника(Това може да се промени, в зависимост колко е cringe)
 76        Health bar
 77            --Трябва да следи Кънчо дали е жив и ако не е да го прати в Могилово, като му махне целия прогрес, който е изкарал на текущата мисия
 78        Resize на екрана
 79            -- мапа e tile based и изглежда най- добре квадратен, затова мисля да взема най големия квадрат от dimensions на екрана
 80
 81    [Milestones/Additional]
 82        Звуци
 83            -мисля да използвам pygame.mixer като ще имам два вида музика:
 84                -- едната е background, която идва от играта или от някоя къща в Могилово(могат да се препокриват)
 85                -- другата е моментна, и се използва само и единствено при:
 86                    --- Получаване на мисия на Кънчо
 87                    --- Изпълнение на мисия на Кънчо
 88                    --- удар от страна на Кънчо или грабителите
 89                    -- при получаване на тукат от грабител, ще се чува болката на Кънчо(Чудя се дали да има voice over ама пак идва cringe проблема)
 90                    --- взимане на съставка от земята при убит грабител
 91        Кола
 92            -Ще се движи по - бързо от Кънчо
 93            -Вариантите за пускане на песни са 2:
 94                -- 1.Свалям някакви песни локално и ги въртя
 95                -- 2.Връзвам се с някое радио(Веселина) посредством python-vlc и просто пускам каквото има там.
 96        Взимане на вода
 97            - Тъй като в маповете е доста вероятно да имам вода(защото имам такива спрайтове)  е по логично да направя героя да взима водата от някоя река,
 98            отколкото да убивам грабител, за да получа съставката Вода, затова:
 99                -- мисля да вкарам логика за взимане на вода от реката с някакъв бутон,
100                -- имам spritesheet с кофа и мисля, че мога да го вържа все едно героя взима вода от реката с кофата.
101        Resize на екрана
102            -- мисля, въпреки всичко да вкарам full screen опция
103        Settings меню
104            -- ще позволява промяна на силата на звука и промяна към fullscreen
105
106[Estimate in man-hours]
107Не знам какво да кажа, затова слагам 100 часа
108
109[Usage of technologies]
110pygame
111tiledMap(Това е свързано с по - лесно създаване на game матрицата и не е обвързано с Python)
112pytmx (Това ми позволява по- лесен начин да парсна tiledMap, към pygame, вместо да пиша parser сам)
113Pillow (Тъй като съм беден студент, имам точно един sprite sheet и всички врагове имат същия външен вид спрямо Кънчо, с променени цветове на косите
114и други неща(ще видите човече със черна кожа и руса коса, не е расизъм, а просто липса на средства))
115vls (Ако реша това с радиото)
116Възможно е да използвам още доста библиотеки, за които не се сещам.
117
118[Testing]
119Тъй като pygame не предоставя някакъв конвенционален начин за тестване мисля да направя една testing директория,
120в която да mirror-на целия ми проект по пакети и python файлове и по този начин да имам някакво организирано тестване.
121
122[Disclaimer]
123Не намирам адекватни спрайтове с лъкове, така че стрелбата с лък може да изглежда малко странно, но функционалността ще е на ниво.
124Доста е вероятно да не намеря sprite за "Корен от ангелика" или някое друго, затова може да изглеждат падащите съставки странно, но имената ще ги пише с hover върху съставката)
125Доста е вероятно да добавям функционалности, но ще се постарая да се случи след изпълнението на гореспоменатите.
126"""