# m1kraz1/touchgrass architecture

> Architecture diagram of the GitHub repository m1kraz1/touchgrass, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/m1kraz1/touchgrass
- Repository: https://github.com/m1kraz1/touchgrass

## Overview

Touch Grass is an Android 3D multiplayer game: a player starts a session, moves and looks with on-screen joysticks, and sees their own and nearby players in a grass field. MainActivity owns the game loop, input, HUD, and network synchronization; the renderer draws the scene and interpolates remote-player positions. NetworkManager discovers peers and exchanges positions over local sockets. The sampled sources support these main links; no README was provided, so unsampled capabilities cannot be verified.

Main entry points: [`app/src/main/java/ch/luca/touchgrass/MyGLRenderer.kt`](https://github.com/m1kraz1/touchgrass/blob/master/app/src/main/java/ch/luca/touchgrass/MyGLRenderer.kt) (Scene Renderer), [`app/src/main/java/ch/luca/touchgrass/MainActivity.kt`](https://github.com/m1kraz1/touchgrass/blob/master/app/src/main/java/ch/luca/touchgrass/MainActivity.kt) (Game Activity), [`app/src/main/java/ch/luca/touchgrass/NetworkManager.kt`](https://github.com/m1kraz1/touchgrass/blob/master/app/src/main/java/ch/luca/touchgrass/NetworkManager.kt) (Peer Manager), [`app/src/main/java/ch/luca/touchgrass/MyGLSurfaceView.kt`](https://github.com/m1kraz1/touchgrass/blob/master/app/src/main/java/ch/luca/touchgrass/MyGLSurfaceView.kt) (GL Surface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_game["Game and UI"]
  node_activity["Game Activity<br/>[MainActivity.kt]"]
end

subgraph group_network["Multiplayer Networking"]
  node_network_manager["Peer Manager<br/>[NetworkManager.kt]"]
end

subgraph group_graphics["3D Rendering"]
  node_surface["GL Surface<br/>[MyGLSurfaceView.kt]"]
  node_renderer["Scene Renderer<br/>[MyGLRenderer.kt]"]
  node_grass["Grass Field<br/>[Grass.kt]"]
  node_sun["Sun Shape<br/>[Sun.kt]"]
  node_remote_shape["Player Shape"]
end

node_player(("Player"))
node_android_nsd["Android NSD"]
node_peers(("Nearby Peers"))

node_player -->|"plays through"| node_activity
node_activity -->|"creates"| node_surface
node_surface -->|"sets renderer"| node_renderer
node_activity -->|"updates state"| node_renderer
node_activity -->|"starts and syncs"| node_network_manager
node_renderer -->|"draws"| node_grass
node_renderer -->|"draws"| node_sun
node_renderer -->|"draws players"| node_remote_shape
node_network_manager -->|"discovers services"| node_android_nsd
node_network_manager -->|"exchanges positions"| node_peers

click node_activity "https://github.com/m1kraz1/touchgrass/blob/master/app/src/main/java/ch/luca/touchgrass/MainActivity.kt"
click node_surface "https://github.com/m1kraz1/touchgrass/blob/master/app/src/main/java/ch/luca/touchgrass/MyGLSurfaceView.kt"
click node_renderer "https://github.com/m1kraz1/touchgrass/blob/master/app/src/main/java/ch/luca/touchgrass/MyGLRenderer.kt"
click node_grass "https://github.com/m1kraz1/touchgrass/blob/master/app/src/main/java/ch/luca/touchgrass/Grass.kt"
click node_sun "https://github.com/m1kraz1/touchgrass/blob/master/app/src/main/java/ch/luca/touchgrass/Sun.kt"
click node_remote_shape "https://github.com/m1kraz1/touchgrass/blob/master/app/src/main/java/ch/luca/touchgrass/RemotePlayerShape.kt"
click node_network_manager "https://github.com/m1kraz1/touchgrass/blob/master/app/src/main/java/ch/luca/touchgrass/NetworkManager.kt"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_activity toneBlue
class node_network_manager toneAmber
class node_surface,node_renderer,node_grass,node_sun,node_remote_shape toneMint
class node_player,node_android_nsd,node_peers toneIndigo
```

## Components

### Game and UI

- [Game Activity](https://github.com/m1kraz1/touchgrass/blob/master/app/src/main/java/ch/luca/touchgrass/MainActivity.kt): `app/src/main/java/ch/luca/touchgrass/MainActivity.kt`

### Multiplayer Networking

- [Peer Manager](https://github.com/m1kraz1/touchgrass/blob/master/app/src/main/java/ch/luca/touchgrass/NetworkManager.kt): `app/src/main/java/ch/luca/touchgrass/NetworkManager.kt`

### 3D Rendering

- [GL Surface](https://github.com/m1kraz1/touchgrass/blob/master/app/src/main/java/ch/luca/touchgrass/MyGLSurfaceView.kt): `app/src/main/java/ch/luca/touchgrass/MyGLSurfaceView.kt`
- [Scene Renderer](https://github.com/m1kraz1/touchgrass/blob/master/app/src/main/java/ch/luca/touchgrass/MyGLRenderer.kt): `app/src/main/java/ch/luca/touchgrass/MyGLRenderer.kt`
- [Grass Field](https://github.com/m1kraz1/touchgrass/blob/master/app/src/main/java/ch/luca/touchgrass/Grass.kt): `app/src/main/java/ch/luca/touchgrass/Grass.kt`
- [Sun Shape](https://github.com/m1kraz1/touchgrass/blob/master/app/src/main/java/ch/luca/touchgrass/Sun.kt): `app/src/main/java/ch/luca/touchgrass/Sun.kt`
- [Player Shape](https://github.com/m1kraz1/touchgrass/blob/master/app/src/main/java/ch/luca/touchgrass/RemotePlayerShape.kt): `app/src/main/java/ch/luca/touchgrass/RemotePlayerShape.kt`

### Other components

- **Player**
- **Android NSD**
- **Nearby Peers**

## Connections

- Player → Game Activity: plays through (evidence: `app/src/main/java/ch/luca/touchgrass/MainActivity.kt`)
- Game Activity → GL Surface: creates (evidence: `app/src/main/java/ch/luca/touchgrass/MainActivity.kt`)
- GL Surface → Scene Renderer: sets renderer (evidence: `app/src/main/java/ch/luca/touchgrass/MyGLSurfaceView.kt`)
- Game Activity → Scene Renderer: updates state (evidence: `app/src/main/java/ch/luca/touchgrass/MainActivity.kt`)
- Game Activity → Peer Manager: starts and syncs (evidence: `app/src/main/java/ch/luca/touchgrass/MainActivity.kt`)
- Scene Renderer → Grass Field: draws (evidence: `app/src/main/java/ch/luca/touchgrass/MyGLRenderer.kt`)
- Scene Renderer → Sun Shape: draws (evidence: `app/src/main/java/ch/luca/touchgrass/MyGLRenderer.kt`)
- Scene Renderer → Player Shape: draws players (evidence: `app/src/main/java/ch/luca/touchgrass/MyGLRenderer.kt`)
- Peer Manager → Android NSD: discovers services (evidence: `app/src/main/java/ch/luca/touchgrass/NetworkManager.kt`)
- Peer Manager → Nearby Peers: exchanges positions (evidence: `app/src/main/java/ch/luca/touchgrass/NetworkManager.kt`)
