Swinga — Kiponos Game

A libGDX 2D arena of bouncing shapes (“quanters”). The hero (white ring) is keyboard-controlled and driven live by Kiponos config — fun lab game + visceral real-time demo.

Repo	kiponos-io/kiponos-game
Local	~/work/lab/Swinga
Agents	See AGENTS.md

Public samples home

This demo is public on GitHub. Showcase samples and example apps for Kiponos also live under github.com/kiponos-io (docs, golden Java, agent skills). A first-class copy of this game under the kiponos-io account is planned so all public demos share one home.

SDK

Uses Kiponos Java SDK 5.0 — Ready / Offline / Safe modes + Last Known Good:

implementation 'io.kiponos:sdk-boot-3:5.0.0.260710'

Requirements

• Java 17+
• Kiponos team credentials (KIPONOS_ID, KIPONOS_ACCESS) from the Connect screen
• Display / GPU path suitable for LWJGL3 (desktop)

Quick start

cd ~/work/lab/Swinga
./gradlew run

Gradle run loads Kiponos credentials in this order:

1. Explicit Gradle props: -PKIPONOS_ID=… -PkiponosProfile=…
2. local.properties (gitignored) — IntelliJ extract (preferred for this demo)
3. Shell env (fallback)

So a shell KIPONOS aimed at unit-tests will not override the game profile once local.properties exists.

From IntelliJ run config

IntelliJ Application config (com.avdiel.lab.Main) had:

Setting	Value
Env	KIPONOS_ID, KIPONOS_ACCESS (JWEs)
VM	-Dkiponos="['Kiponos-Game']['v1.0.single']['dev']['base']"

Refresh gitignored local file and run:

python3 scripts/extract-idea-kiponos.py
./gradlew printKiponosRunEnv   # sanity: sources + profile, no secrets
./gradlew run

Or copy local.properties.example → local.properties and paste Connect tokens.

Controls

Key	Action
← →	Turn
↑ ↓	Speed up / down
A / D	Load
Q / E	Shoot
Space	Stop
Tab	Switch hero (ring + controls + live config target)
Esc	Exit

Project layout

src/main/java/com/avdiel/lab/
  Main.java              # Kiponos + window
  KiponosGame.java       # game loop
  input/                 # keyboard → actions
  state/                 # action state machine
  quanters/              # shapes / collision
docs/
  ARCHITECTURE.md
  DEMO-NARRATIVE.md
.grok/                   # agent skill + rules
AGENTS.md

Kiponos tree (live demo)

agents/io-kiponos-game/
  announcement, paused, bg-color, title   # LIVE
  active-quanter                          # written on Tab
  quanters/
    box-color / hero-color                # LIVE hero recolor
    box-speed / hero-speed                # LIVE hero speed
    box-x, box-y, box-dir                 # startup pose

Hero = white ring = arrows = live color/speed. Tab switches hero. HUD: quiet chip + toast on apply.

Details: AGENTS.md · docs/DEMO-NARRATIVE.md · docs/ARCHITECTURE.md.

Related

• Java SDK: ~/work/kiponos-mod-sdk
• Public integrate examples: ~/work/kiponos-io

License / status

Lab / demo project (SNAPSHOT). Not a shipping game title.