skrabanek
2 days ago
6 changed files with 126 additions and 248 deletions
@ -0,0 +1,104 @@ |
|||
# 🎮 Návod pro studenty: Jak připravit hru pro GameGlass Portál |
|||
|
|||
Ahoj! Abys mohl/a svou hru nahrát na náš školní GameGlass portál a ukázat ji všem ostatním přímo ve webovém prohlížeči, stačí dodržet několik jednoduchých pravidel. |
|||
|
|||
--- |
|||
|
|||
## 1. Pravidla pro Pygame (Grafické hry) |
|||
|
|||
Aby tvoje Pygame hra mohla běžet uvnitř internetového prohlížeče, musí být strukturována tzv. "asynchronně" (aby nezamrzla prohlížeč). |
|||
|
|||
**Musíš udělat přesně tyto 3 kroky ve svém kódu:** |
|||
|
|||
1. **Importuj `asyncio`:** |
|||
Na úplný začátek souboru, hned k `import pygame`, přidej: |
|||
```python |
|||
import pygame |
|||
import asyncio |
|||
``` |
|||
|
|||
2. **Zabal hru do asynchronní funkce:** |
|||
Celý kód tvé hry (nebo alespoň tvoji hlavní herní smyčku) musíš zabalit do asynchronní funkce (např. `async def main():`). |
|||
A na úplný konec souboru pak hru spustit pomocí `asyncio.run(main())`. |
|||
|
|||
3. **Přidej odpočinkovou pauzu do smyčky:** |
|||
Do tvé hlavní smyčky `while True:` musíš (ideálně nakonec smyčky) přidat magické zaříkávadlo: |
|||
```python |
|||
await asyncio.sleep(0) |
|||
``` |
|||
*Tento příkaz řekne prohlížeči: "Teď si můžeš na milisekundu odpočinout a vykreslit obrazovku". Bez tohoto příkazu hra okamžitě zamrzne a spadne!* |
|||
|
|||
**Ukázková kostra správné Pygame hry:** |
|||
```python |
|||
import pygame |
|||
import asyncio |
|||
|
|||
# --- Zde dej své funkce a nastavení --- |
|||
|
|||
async def main(): |
|||
pygame.init() |
|||
screen = pygame.display.set_mode((800, 600)) |
|||
clock = pygame.time.Clock() |
|||
running = True |
|||
|
|||
while running: |
|||
for event in pygame.event.get(): |
|||
if event.type == pygame.QUIT: |
|||
running = False |
|||
|
|||
# Zde se děje logika hry a vykreslování... |
|||
screen.fill((0, 0, 0)) |
|||
pygame.display.flip() |
|||
|
|||
# Omezení FPS |
|||
clock.tick(60) |
|||
|
|||
# MAGICKÝ PŘÍKAZ (NUTNÉ PRO WEB!) |
|||
await asyncio.sleep(0) |
|||
|
|||
pygame.quit() |
|||
|
|||
# Spuštění asynchronní hry |
|||
if __name__ == "__main__": |
|||
asyncio.run(main()) |
|||
``` |
|||
|
|||
--- |
|||
|
|||
## 2. Pravidla pro terminálové hry (Čistý Python textovky) |
|||
|
|||
Pokud děláš obyčejnou textovou hru (pouze příkazy `print` a `input`), je to velmi jednoduché: |
|||
|
|||
- Nemusíš používat `asyncio` vůbec. |
|||
- Můžeš normálně používat `input("Zadej volbu: ")`. Portál sám vytvoří interaktivní textové pole. |
|||
- Pokud chceš "vyčistit obrazovku" terminálu, můžeš použít klasický příkaz: |
|||
```python |
|||
import os |
|||
os.system('cls') # nebo os.system('clear') |
|||
``` |
|||
|
|||
--- |
|||
|
|||
## 3. Pravidla pro Ren'Py (Vizuální Novely) |
|||
|
|||
- Tvoje hra bude spuštěna přes Web Assembly engine Ren'Py. |
|||
- **Krok navíc:** Před zabalením do ZIPu jdi do složky své hry a zazipuj POUZE obsah složky `game/` (tedy soubory `.rpy` a složku s obrázky `images/`). Portál nepotřebuje zbytek enginu (soubory `.exe`, `.sh`), engine už v portálu je. |
|||
|
|||
--- |
|||
|
|||
## ⚠️ DŮLEŽITÉ UPOZORNĚNÍ K CESTÁM V KÓDU (Pro všechny hry) |
|||
**NIKDY** ve svém kódu nepoužívejte tzv. "natvrdo zadrátované cesty" k obrázkům nebo k vašemu disku! (Tzv. Absolutní cesty). |
|||
|
|||
❌ **ŠPATNĚ (Na webu to spadne):** |
|||
```python |
|||
os.chdir(r"C:\Users\Student\Plocha\MojeHra") # NIKDY! |
|||
image = pygame.image.load(r"C:\Users\Student\Plocha\MojeHra\assets\hrdina.png") |
|||
``` |
|||
|
|||
✅ **SPRÁVNĚ (Relativní cesty):** |
|||
Aplikace běží v paměti na internetu (kde disk C:\ vůbec neexistuje). Používejte relativní cesty: |
|||
```python |
|||
image = pygame.image.load("assets/hrdina.png") |
|||
``` |
|||
|
|||
Až budeš mít hotovo, všechny své soubory a složky označ a zabal přímo do archivu **.ZIP** a nahraj do formuláře na portálu! |
|||
@ -1,182 +0,0 @@ |
|||
import pygame |
|||
import asyncio # PŘIDÁNO PRO WEB: importujeme asyncio pro neblokující smyčku |
|||
import random |
|||
import sys |
|||
|
|||
# Povinná příprava knihovny Pygame |
|||
async def main(): # PŘIDÁNO PRO WEB: Zabalíme celou hru do asynchronní funkce |
|||
pygame.init() |
|||
|
|||
# --- NASTAVENÍ OKNA A MŘÍŽKY --- |
|||
# Hra SNAKE (Had) většinou nefunguje na pixely jako ostatní hry, ale funguje na jakési neviditelné "Mřížce". |
|||
SIRKA_OKNA = 800 |
|||
VYSKA_OKNA = 600 |
|||
VELIKOST_DILKU = 20 # Velikost jednoho čtverečku na mřížce (dílku hada i jídla) |
|||
FPS = 15 # Rychlost hada. Zde je nižší 15, protože pohyb po skocích na mřížce nevyžaduje 60 FPS. |
|||
|
|||
# Definice Palety Barev (Red, Green, Blue) |
|||
CERNA = (0, 0, 0) |
|||
BILA = (255, 255, 255) |
|||
ZELENA = (0, 255, 0) |
|||
CERVENA = (255, 0, 0) |
|||
|
|||
okno = pygame.display.set_mode((SIRKA_OKNA, VYSKA_OKNA)) |
|||
pygame.display.set_caption("Klasický Had (Snake)") |
|||
|
|||
hodiny = pygame.time.Clock() |
|||
font = pygame.font.SysFont("arial", 36) |
|||
|
|||
# Pomocná funkce pro rychlé vykreslení textu na daných x, y. |
|||
# Zkracuje to kód, abychom pořád neopakovali metody render() a blit(). |
|||
def zobraz_text(text, barva, x, y): |
|||
text_plocha = font.render(text, True, barva) |
|||
okno.blit(text_plocha, (x, y)) |
|||
|
|||
# Veškerou logiku hry teď poprvé schováme do tzv. Hlavní Funkce. |
|||
# Proč? Jakmile funkce skončí (kvůli výhře/prohře), velmi jednoduše se tímto trikem dá celá hra resetovat, |
|||
# jelikož stačí funkci zavolat odznova. |
|||
async def hlavni_smycka(): |
|||
|
|||
# --- POČÁTEČNÍ STAV HRY --- |
|||
# Nejdůležitější princip této hry! Tělo hada není jeden objekt, je to SEZNAM SOUŘADNIC (pole v poli). |
|||
# Každý článek jeho těla má své [x, y]. Ten ÚPLNĚ PRVNÍ prvek na pozici 0 je HLAVA HADA. |
|||
had_telo = [ |
|||
[SIRKA_OKNA // 2, VYSKA_OKNA // 2], # Hlava |
|||
[SIRKA_OKNA // 2 - VELIKOST_DILKU, VYSKA_OKNA // 2], # Druhý článek břicha |
|||
[SIRKA_OKNA // 2 - 2 * VELIKOST_DILKU, VYSKA_OKNA // 2] # Ocas |
|||
] |
|||
|
|||
# Směr pohybu! Tohle číslo přidáme při každém snímku k souřadnicím HLAVY. |
|||
# Tím ji virtuálně posuneme vpřed. |
|||
smer_x = VELIKOST_DILKU # Z počátku letí had doprava, protože z osy X roste pozitivně |
|||
smer_y = 0 # Do vertikály Y mu zpočátku nepřidáváme nic, letí rovně |
|||
|
|||
# --- POZICE JÍDLA (ČERVENÝ ČTVEREČEK) --- |
|||
# Jídlo musíme nasměrovat přesně do nějaké buňky mřížky! |
|||
# Trik: random.randrange(od, do, krok) ... Jídlo padne například na X=20, 40, 60... ale NIKDY na 17, 33 atd. |
|||
# Kdyby nebylo zarovnané na mřížku, tak ho had miné! |
|||
jidlo_x = random.randrange(0, SIRKA_OKNA, VELIKOST_DILKU) |
|||
jidlo_y = random.randrange(0, VYSKA_OKNA, VELIKOST_DILKU) |
|||
|
|||
skore = 0 |
|||
konec_hry = False # Boolean kontrolka pro Game Over |
|||
|
|||
# Nekonečná smyčka tohoto jednoho konkrétního zápasu |
|||
while True: |
|||
|
|||
# 1. ZPRACOVÁNÍ UDÁLOSTÍ |
|||
for udalost in pygame.event.get(): |
|||
if udalost.type == pygame.QUIT: |
|||
pygame.quit() |
|||
sys.exit() |
|||
|
|||
# Detekce šipek pro změnu SMĚRU pohybu HADA |
|||
if udalost.type == pygame.KEYDOWN: |
|||
|
|||
# OCHRANA: Had nemůže provést fyzicky nemožný obrat o 180 stupňů a zajet si rovnou do těla! |
|||
# Tzn. pokud zmáčknul šipku DOLEVA, a had letí rovně/doprava (smer_x == 0), |
|||
# teprve pak si smí dovolit nastavit změnu směru. |
|||
if udalost.key == pygame.K_LEFT and smer_x == 0: |
|||
smer_x = -VELIKOST_DILKU # Záporná hodnota pro směr vlevo |
|||
smer_y = 0 # Vertikální se ruší |
|||
elif udalost.key == pygame.K_RIGHT and smer_x == 0: |
|||
smer_x = VELIKOST_DILKU # Kladná hodnota pro směr vpravo |
|||
smer_y = 0 |
|||
elif udalost.key == pygame.K_UP and smer_y == 0: |
|||
smer_x = 0 |
|||
smer_y = -VELIKOST_DILKU # Záporná hodnota směrem vzhůru k Y=0 |
|||
elif udalost.key == pygame.K_DOWN and smer_y == 0: |
|||
smer_x = 0 |
|||
smer_y = VELIKOST_DILKU |
|||
|
|||
# Pokud zemřel a bliká varování, čekáme na Mezerník |
|||
if udalost.key == pygame.K_SPACE and konec_hry: |
|||
# Pokud nastane RETURN, znamená to, že se celá tato 'hlavni_smycka()' okamžitě ukončí, |
|||
# její paměť (proměnné had_telo atd) se nenávratně vymaže. |
|||
# Následně ji však náš spouštěč úplně dole v souboru spustí naprosto na čisto znova. (RESTART) |
|||
return |
|||
|
|||
# LOGIKA HRY: Provede se jenom pokud žijeme |
|||
if not konec_hry: |
|||
|
|||
# --- ZÁKLADNÍ PRINCIP POHYBU HADA --- |
|||
# Jak hada posunout? |
|||
# 1. Spočítáme, kde se bude nacházet hadova hlava v PŘÍŠTÍM Snímku |
|||
# Vezmeme si pozici staré hlavy, neboli had_telo na nultém indexu |
|||
nova_hlava_x = had_telo[0][0] + smer_x |
|||
nova_hlava_y = had_telo[0][1] + smer_y |
|||
|
|||
# 2. Tuto ZCELA NOVOU POZICI vsuneme pomocí "insert" na ÚPLNÝ ZAČÁTEK (index 0) našeho Seznamu |
|||
# Náš had je najednou o kousek delší! (Natáhl hlavu tam, kam letí) |
|||
had_telo.insert(0, [nova_hlava_x, nova_hlava_y]) |
|||
|
|||
# --- SEŽRÁNÍ JÍDLA (Růst hada) --- |
|||
# Zjišťujeme, zda se souřadnice nové hlavy náhodou rovnou nerovnají pozici Jídla na mřížce. |
|||
# Nepoužíváme obdélníkové kolize, protože pracujeme s přesnou mřížkou! |
|||
if nova_hlava_x == jidlo_x and nova_hlava_y == jidlo_y: |
|||
skore += 1 # Bod do tabulky! |
|||
|
|||
# Zrušíme staré jídlo a najdeme mu na hracím plánu nové náhodné místo (zarovnané na mřížku) |
|||
jidlo_x = random.randrange(0, SIRKA_OKNA, VELIKOST_DILKU) |
|||
jidlo_y = random.randrange(0, VYSKA_OKNA, VELIKOST_DILKU) |
|||
|
|||
# TOHLE JE DŮLEŽITÉ: Náš hadí Seznam byl momentálně obohacen o přední novou "hlavu", tzn vyrostl, a |
|||
# a my mu ten starý OCAS NEZKRÁTÍME. Takže je opravdu objektivně o jedno políčko natrvalo větší! |
|||
else: |
|||
# Pokud jídlo na této pozici NEBYLO, my musíme zachovat hada stále stejně dlouhého. |
|||
# Nahoře jsme mu před chvílí přidali hlavičku. Tady dole mu z konce seznamu (ocásku) |
|||
# jeden prvek odebereme (pomocí .pop()), takže vlastně provedl POHYB A JE STÁLE STEJNĚ DLOUHÝ. |
|||
had_telo.pop() |
|||
|
|||
# --- SMRTELNÉ NÁRAZY (Stěna a Sebevražda) --- |
|||
|
|||
# Pokud vylétla nová hlava mimo rozměry Okna... |
|||
if (nova_hlava_x < 0 or nova_hlava_x >= SIRKA_OKNA or |
|||
nova_hlava_y < 0 or nova_hlava_y >= VYSKA_OKNA): |
|||
konec_hry = True # GAME OVER |
|||
|
|||
# Nebo pokud had sežral vlastního ocas! |
|||
# for-cyklus "for dilek in had_telo[1:]" prohlédne VŠE kromě samotné hlavy (začíná od indexu 1, čili tělo) |
|||
# A pokud se na jedné jediné z těchto pozic těla nachází nově nakreslená hlava, tak had do sebe kousl. |
|||
for dilek in had_telo[1:]: |
|||
if nova_hlava_x == dilek[0] and nova_hlava_y == dilek[1]: |
|||
konec_hry = True |
|||
|
|||
# --- VYKRESLOVÁNÍ (Obarvování monitoru) --- |
|||
okno.fill(CERNA) # Umytí tabule na černo |
|||
|
|||
# 1. Jídlo (Čtverec o rozměrech jedné buňky na mřížce) |
|||
pygame.draw.rect(okno, CERVENA, (jidlo_x, jidlo_y, VELIKOST_DILKU, VELIKOST_DILKU)) |
|||
|
|||
# 2. Celý samotný dlouhý had |
|||
# Projdeme seznam všech buněk a pro každičkou z nich na daném [X, Y] nakreslíme jeden zelený kvádr |
|||
for dilek in had_telo: |
|||
pygame.draw.rect(okno, ZELENA, (dilek[0], dilek[1], VELIKOST_DILKU, VELIKOST_DILKU)) |
|||
|
|||
zobraz_text(f"Skóre: {skore}", BILA, 10, 10) |
|||
|
|||
if konec_hry: |
|||
# Zásadní hláška uprostřed pole o tom, ať to zkusí hráč znovu. |
|||
zobraz_text("Konec hry! Stiskni MEZERNÍK pro novou hru.", CERVENA, 100, VYSKA_OKNA // 2) |
|||
|
|||
# Hotový frame se prohazuje s tím na monitoru |
|||
pygame.display.flip() |
|||
|
|||
# Omezení rychlosti |
|||
hodiny.tick(FPS) |
|||
# PRIDANO PRO WEB |
|||
await asyncio.sleep(0) |
|||
|
|||
# Úplný spodek skriptu Pythonu |
|||
# Tento 'if' ověřuje, jestli Python zapnul tento soubor napřímo jako první. |
|||
if __name__ == "__main__": |
|||
|
|||
# NEKONEČNÁ SLUČKA ŽIVOTA. |
|||
# Jakmile uvnitř `hlavni_smycka` zavoláme 'return' kvůli Game Over + stisku Mezerníku, |
|||
# funkce se zničí, a tento while True ji opět vzkřísí z prachu k novému životu s čistým listem skóre. |
|||
while True: |
|||
await hlavni_smycka() |
|||
|
|||
|
|||
# PŘIDÁNO PRO WEB: Spuštění asynchronní hry |
|||
asyncio.run(main()) |
|||
@ -1,11 +0,0 @@ |
|||
import os |
|||
import glob |
|||
|
|||
os.chdir(r'C:\gitprojekty_skola\python_gamejam_examples\pygame') |
|||
for f in glob.glob('*.py'): |
|||
if f.startswith('patch'): continue |
|||
with open(f, 'r', encoding='utf-8') as file: |
|||
content = file.read() |
|||
content = content.replace('async def hlavni_smycka():', 'async def hlavni_smycka():') |
|||
with open(f, 'w', encoding='utf-8') as file: |
|||
file.write(content) |
|||
@ -1,25 +0,0 @@ |
|||
import os |
|||
import glob |
|||
import re |
|||
|
|||
os.chdir(r'C:\gitprojekty_skola\python_gamejam_examples\pygame') |
|||
for f in glob.glob('*.py'): |
|||
with open(f, 'r', encoding='utf-8') as file: |
|||
content = file.read() |
|||
|
|||
# 1. async def |
|||
content = re.sub(r'(\s*)def hlavni_smycka\(\):', r'\1async def hlavni_smycka():', content) |
|||
|
|||
# 2. Add await to hlavni_smycka() calls |
|||
content = re.sub(r'(\s+)hlavni_smycka\(\)', r'\1await hlavni_smycka()', content) |
|||
|
|||
# 3. Fix asyncio.sleep(0) |
|||
# Odstranime stary await asyncio.sleep(0) a jeho komentar |
|||
content = re.sub(r'[ \t]*# PØIDÁNO PRO WEB: Dáme prohlížeèi šanci pøekreslit obrazovku\s+await asyncio\.sleep\(0\)\s*', '\n', content) |
|||
|
|||
# Pridame ho tesne za hodiny.tick(...) se stejnym odsazenim |
|||
content = re.sub(r'([ \t]*)(.*hodiny\.tick.*)', r'\1\2\n\1# PØIDÁNO PRO WEB: Dáme prohlížeèi šanci pøekreslit obrazovku\n\1await asyncio.sleep(0)', content) |
|||
|
|||
with open(f, 'w', encoding='utf-8') as file: |
|||
file.write(content) |
|||
print(f'Opraveno: {f}') |
|||
@ -1,29 +0,0 @@ |
|||
import os |
|||
import glob |
|||
import re |
|||
|
|||
os.chdir(r'C:\gitprojekty_skola\python_gamejam_examples\pygame') |
|||
for f in glob.glob('*.py'): |
|||
if f == 'patch.py': |
|||
continue |
|||
with open(f, 'r', encoding='utf-8') as file: |
|||
content = file.read() |
|||
|
|||
# 1. async def |
|||
content = re.sub(r'(\s*)def hlavni_smycka\(\):', r'\1async async def await hlavni_smycka():', content) |
|||
|
|||
# 2. Add await to await hlavni_smycka() calls |
|||
content = re.sub(r'(\s+)hlavni_smycka\(\)', r'\1await await hlavni_smycka()', content) |
|||
|
|||
# 3. Fix asyncio.sleep(0) |
|||
# Match the old comment containing WEB without needing special chars |
|||
content = re.sub(r'[ \t]*#.*WEB.*\s+await asyncio\.sleep\(0\)\s*', '\n', content) |
|||
|
|||
# Pridame ho tesne za hodiny.tick(...) se stejnym odsazenim |
|||
# PRIDANO PRO WEB |
|||
await asyncio.sleep(0) |
|||
content = re.sub(r'([ \t]*)(.*hodiny\.tick.*)', r'\1\2\n\1# PRIDANO PRO WEB\n\1await asyncio.sleep(0)', content) |
|||
|
|||
with open(f, 'w', encoding='utf-8') as file: |
|||
file.write(content) |
|||
print(f'Opraveno: {f}') |
|||
Loading…
Reference in new issue