TMCandClaude Opus 5.5 90acbcb4e6 Bela v0: local game against bots, counting training, settings with self-update
- engine: Croatian Bela rules (deal, trump call, declarations, play rules, scoring),
  heuristic bot, counting drill; unit tests and a 1000-game simulation
- app: Jetpack Compose table with partner and two bot opponents, Hungarian deck,
  card-counting training, settings with in-app update and a QR code for sharing
- tools: card import/render/upscale scripts and the launcher icon generator

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-15 20:40:57 +01:00

Bela

Android aplikacija za Belu: ti i bot partner protiv dva bota, do 1001 boda. Ovo je verzija 0: lokalna igra, bez mreže i računa.

Struktura

Modul Što je u njemu
engine/ Čisti Kotlin, bez Androida: karte, pravila, zvanja, bodovanje, bot. Kasnije se može prebaciti u Kotlin Multiplatform za server ili iOS.
app/ Android aplikacija (Jetpack Compose): početni ekran, stol, dijalozi.

Važne datoteke:

  • engine/.../Game.kt: tijek partije (dijeljenje, zvanje aduta, štihovi, obračun).
  • engine/.../Trick.kt: dozvoljeni potezi (praćenje boje, iber, sječenje).
  • engine/.../Declarations.kt: zvanja.
  • engine/.../RuleSet.kt: kućna pravila (do koliko se igra, štiglja, iber, belot, "visi").
  • engine/.../Bot.kt: heuristički bot.
  • app/.../ui/CardArt.kt: sve što crta kartu, vidi niže.

Build i pokretanje

gradlew :engine:test          # testovi pravila + simulacija 1000 partija
gradlew :app:assembleDebug    # APK u app/build/outputs/apk/debug/
gradlew :app:installDebug     # instalacija na spojeni uređaj ili emulator

Projekt koristi AGP 9.4.1, Kotlin 2.4.21, Gradle 9.8.2 i compileSdk 36, iste verzije kao AndroidTV projekt.

Karte

Aplikacija koristi slike iz app/src/main/res/drawable-nodpi/ (card_<boja>_<vrijednost>.webp, suit_<boja>.webp). Postoje dva izvora, a skripta odabranog izvora prepisuje te slike:

Izvor Naredba Napomena
PNG špil (trenutno u upotrebi): tomasdrus/hungarian-playing-cards, kopiran u card_assets/hungarian-playing-cards/ python tools/import_png_cards.py 363×585 px, WebP bez gubitaka. Repozitorij nema licencu, vidi NOTICE.md u toj mapi. Prije objave aplikacije treba dopuštenje autora.
Naši SVG-ovi u card_assets/*.svg python tools/render_cards.py Treba Inkscape 1.x. Renderira 720 px.

Poleđina je naša i crta se vektorski u kodu (CardBack).

Pravilo oštrine: karta se nikad ne crta šire od svoje slike. Svaka veličina karte ograničava se s maxCardWidth() (za PNG špil to je 363 px, na ovom emulatoru ~138dp). Slike se dekodiraju u rezoluciji u kojoj se crtaju, s mipmapama. U debug buildu svako povećanje slike zapisuje se u logcat pod oznakom BelaCards, pa se provjerava s adb logcat -s BelaCards.

Sve što crta kartu nalazi se u app/src/main/kotlin/hr/bela/app/ui/CardArt.kt (CardFace, CardBack, SuitIcon, maxCardWidth).

U kodu se boje zovu HERC, KARO, PIK i TREF (= srce, zvono, list, žir), a vrijednosti SEDAM … AS.

Trening brojanja

S početnog ekrana ("Trening brojanja"). Svaka runda je hrpa osvojenih štihova (po 4 karte) s izmišljenim adutom i ponekad zadnjim štihom (+10). Karte se pokazuju jedna po jedna, a zatim igrač bira jedan od četiri zbroja. Netočni odgovori nastaju iz tipičnih grešaka (dečko ili devetka u adutu, zaboravljen zadnji štih, propuštena desetka ili as…). Nakon odgovora vidi se svaka karta s bodovima i objašnjenje greške.

  • Logika runde: engine/.../CountingDrill.kt (s testovima).
  • Razine (Lako 8 karata, Srednje 12–16, Teško 20–28) i stanje: app/.../TrainingViewModel.kt.
  • Ekran: app/.../ui/TrainingScreen.kt.

Izgled

  • Fontovi: Cinzel (naslovi, rezultat, oznake) i Inter (tekst), u app/src/main/res/font/. Oba su pod licencom SIL Open Font License, tekst licence je u licenses/.
  • Boje, prijelazi i filc stola su u ui/Theme.kt, zajednički gumbi i ukrasi u ui/Components.kt.

Spremanje partije

Partija se sprema nakon svakog poteza kao seed i popis poteza (GameRecord), pa se nakon zatvaranja aplikacije vraća točno gdje je stala.

S
Description
No description provided
Readme
52 MiB
0 Stars 1 Watchers 0 Forks
Languages
Kotlin 91.5%
Python 5.4%
PowerShell 1.7%
Dockerfile 0.7%
HTML 0.6%
Other 0.1%