# jouneri/skatescape architecture

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

- Interactive diagram: https://gitdiagram.com/jouneri/skatescape
- Repository: https://github.com/jouneri/skatescape

## Overview

SkateScape is a cosmetic RuneLite plugin: the player queues tricks with configured hotkeys, the plugin coordinates skating and trick playback, and client-side animation and board rendering produce the visible result. The graph preserves movement, trick definition/timing/runtime, and board geometry as distinct stages, plus the developer authoring and inspection branch. Edges follow excerpts, SOURCE INDEX references, or README statements; several internals are represented by their exact source paths without asserting unsampled call details.

Main entry points: [`src/main/java/com/skatescape/SkateScapePlugin.java`](https://github.com/jouneri/skatescape/blob/master/src/main/java/com/skatescape/SkateScapePlugin.java) (Plugin Coordinator), [`src/main/java/com/skatescape/TrickRuntimeController.java`](https://github.com/jouneri/skatescape/blob/master/src/main/java/com/skatescape/TrickRuntimeController.java) (Trick Runtime), [`src/main/java/com/skatescape/SkateboardSceneController.java`](https://github.com/jouneri/skatescape/blob/master/src/main/java/com/skatescape/SkateboardSceneController.java) (Board Scene), [`src/main/java/com/skatescape/SkateboardTrickTransformController.java`](https://github.com/jouneri/skatescape/blob/master/src/main/java/com/skatescape/SkateboardTrickTransformController.java) (Trick Transforms)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Plugin and Controls"]
  node_config["Plugin Settings"]
  node_plugin["Plugin Coordinator"]
  node_input["Hotkey Input"]
end

subgraph group_tricks["Trick Playback"]
  node_definition["Trick Definitions"]
  node_registry["Trick Registry<br/>[TrickRegistry.java]"]
  node_timeline["Timeline Builder"]
  node_runtime["Trick Runtime"]
  node_animation["Player Animation"]
end

subgraph group_board["Board and Movement"]
  node_movement["Skating Movement"]
  node_scene["Board Scene"]
  node_transform["Trick Transforms"]
  node_factory["Model Factory"]
  node_geometry["Model Geometry"]
end

subgraph group_authoring["Developer Tools"]
  node_pertrick["Trick Tuning Config"]
  node_panel["Config Panel"]
  node_inspector["Trick Inspector"]
  node_overlay["Inspector Overlay"]
  node_animinspector["Animation Inspector"]
  node_choreography["Trick 5 Choreography"]
  node_devmode["Developer Mode"]
end

node_player(("Player"))
node_runelite["RuneLite Client"]

node_player -->|"presses hotkey"| node_input
node_config -->|"sets hotkeys"| node_input
node_input -->|"queues trick"| node_plugin
node_plugin -->|"reads settings"| node_config
node_plugin -->|"coordinates movement"| node_movement
node_plugin -->|"coordinates playback"| node_runtime
node_plugin -->|"prepares timelines"| node_timeline
node_plugin -->|"coordinates animation"| node_animation
node_plugin -->|"coordinates board"| node_scene
node_runtime -->|"selects tricks"| node_registry
node_registry -->|"provides definitions"| node_definition
node_timeline -->|"uses parameters"| node_definition
node_runtime -->|"reads active trick"| node_definition
node_plugin -->|"coordinates transforms"| node_transform
node_transform -->|"updates scene"| node_scene
node_scene -->|"creates model"| node_factory
node_factory -->|"uses geometry"| node_geometry
node_transform -->|"transforms model"| node_geometry
node_plugin -->|"coordinates inspection"| node_inspector
node_inspector -->|"selects definition"| node_registry
node_inspector -->|"controls timeline"| node_plugin
node_plugin -->|"coordinates inspection"| node_animinspector
node_plugin -->|"initializes tuning"| node_pertrick
node_plugin -->|"creates developer panel"| node_panel
node_plugin -->|"initializes choreography"| node_choreography
node_plugin -->|"uses overlay"| node_overlay
node_devmode -->|"gates tools"| node_plugin
node_runelite -->|"hosts plugin"| node_plugin
node_player -->|"moves in game"| node_movement
node_player -->|"queues combos"| node_runtime
node_scene -->|"renders client-side"| node_runelite

click node_config "https://github.com/jouneri/skatescape/blob/master/src/main/java/com/skatescape/SkateScapeConfig.java"
click node_plugin "https://github.com/jouneri/skatescape/blob/master/src/main/java/com/skatescape/SkateScapePlugin.java"
click node_input "https://github.com/jouneri/skatescape/blob/master/src/main/java/com/skatescape/SkateScapeInputController.java"
click node_movement "https://github.com/jouneri/skatescape/blob/master/src/main/java/com/skatescape/SkatingMovementController.java"
click node_definition "https://github.com/jouneri/skatescape/blob/master/src/main/java/com/skatescape/TrickDefinition.java"
click node_registry "https://github.com/jouneri/skatescape/blob/master/src/main/java/com/skatescape/TrickRegistry.java"
click node_timeline "https://github.com/jouneri/skatescape/blob/master/src/main/java/com/skatescape/TrickTimelineBuilder.java"
click node_runtime "https://github.com/jouneri/skatescape/blob/master/src/main/java/com/skatescape/TrickRuntimeController.java"
click node_animation "https://github.com/jouneri/skatescape/blob/master/src/main/java/com/skatescape/PlayerTrickAnimationController.java"
click node_scene "https://github.com/jouneri/skatescape/blob/master/src/main/java/com/skatescape/SkateboardSceneController.java"
click node_transform "https://github.com/jouneri/skatescape/blob/master/src/main/java/com/skatescape/SkateboardTrickTransformController.java"
click node_factory "https://github.com/jouneri/skatescape/blob/master/src/main/java/com/skatescape/SkateboardModelFactory.java"
click node_geometry "https://github.com/jouneri/skatescape/blob/master/src/main/java/com/skatescape/SkateboardModelGeometry.java"
click node_pertrick "https://github.com/jouneri/skatescape/blob/master/src/main/java/com/skatescape/PerTrickConfigController.java"
click node_panel "https://github.com/jouneri/skatescape/blob/master/src/main/java/com/skatescape/SkateScapeConfigPanelController.java"
click node_inspector "https://github.com/jouneri/skatescape/blob/master/src/main/java/com/skatescape/TrickInspector.java"
click node_overlay "https://github.com/jouneri/skatescape/blob/master/src/main/java/com/skatescape/TrickInspectorOverlay.java"
click node_animinspector "https://github.com/jouneri/skatescape/blob/master/src/main/java/com/skatescape/AnimationInspector.java"
click node_choreography "https://github.com/jouneri/skatescape/blob/master/src/main/java/com/skatescape/Trick5BoardChoreographyController.java"
click node_devmode "https://github.com/jouneri/skatescape/blob/master/src/main/java/com/skatescape/SkateScapeDeveloperMode.java"

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_config,node_plugin,node_input,node_runelite toneBlue
class node_definition,node_registry,node_timeline,node_runtime,node_animation toneAmber
class node_movement,node_scene,node_transform,node_factory,node_geometry toneMint
class node_pertrick,node_panel,node_inspector,node_overlay,node_animinspector,node_choreography,node_devmode toneRose
class node_player toneIndigo
```

## Components

### Plugin and Controls

- [Plugin Settings](https://github.com/jouneri/skatescape/blob/master/src/main/java/com/skatescape/SkateScapeConfig.java): `src/main/java/com/skatescape/SkateScapeConfig.java`
- [Plugin Coordinator](https://github.com/jouneri/skatescape/blob/master/src/main/java/com/skatescape/SkateScapePlugin.java): `src/main/java/com/skatescape/SkateScapePlugin.java`
- [Hotkey Input](https://github.com/jouneri/skatescape/blob/master/src/main/java/com/skatescape/SkateScapeInputController.java): `src/main/java/com/skatescape/SkateScapeInputController.java`

### Trick Playback

- [Trick Definitions](https://github.com/jouneri/skatescape/blob/master/src/main/java/com/skatescape/TrickDefinition.java): `src/main/java/com/skatescape/TrickDefinition.java`
- [Trick Registry](https://github.com/jouneri/skatescape/blob/master/src/main/java/com/skatescape/TrickRegistry.java): `src/main/java/com/skatescape/TrickRegistry.java`
- [Timeline Builder](https://github.com/jouneri/skatescape/blob/master/src/main/java/com/skatescape/TrickTimelineBuilder.java): `src/main/java/com/skatescape/TrickTimelineBuilder.java`
- [Trick Runtime](https://github.com/jouneri/skatescape/blob/master/src/main/java/com/skatescape/TrickRuntimeController.java): `src/main/java/com/skatescape/TrickRuntimeController.java`
- [Player Animation](https://github.com/jouneri/skatescape/blob/master/src/main/java/com/skatescape/PlayerTrickAnimationController.java): `src/main/java/com/skatescape/PlayerTrickAnimationController.java`

### Board and Movement

- [Skating Movement](https://github.com/jouneri/skatescape/blob/master/src/main/java/com/skatescape/SkatingMovementController.java): `src/main/java/com/skatescape/SkatingMovementController.java`
- [Board Scene](https://github.com/jouneri/skatescape/blob/master/src/main/java/com/skatescape/SkateboardSceneController.java): `src/main/java/com/skatescape/SkateboardSceneController.java`
- [Trick Transforms](https://github.com/jouneri/skatescape/blob/master/src/main/java/com/skatescape/SkateboardTrickTransformController.java): `src/main/java/com/skatescape/SkateboardTrickTransformController.java`
- [Model Factory](https://github.com/jouneri/skatescape/blob/master/src/main/java/com/skatescape/SkateboardModelFactory.java): `src/main/java/com/skatescape/SkateboardModelFactory.java`
- [Model Geometry](https://github.com/jouneri/skatescape/blob/master/src/main/java/com/skatescape/SkateboardModelGeometry.java): `src/main/java/com/skatescape/SkateboardModelGeometry.java`

### Developer Tools

- [Trick Tuning Config](https://github.com/jouneri/skatescape/blob/master/src/main/java/com/skatescape/PerTrickConfigController.java): `src/main/java/com/skatescape/PerTrickConfigController.java`
- [Config Panel](https://github.com/jouneri/skatescape/blob/master/src/main/java/com/skatescape/SkateScapeConfigPanelController.java): `src/main/java/com/skatescape/SkateScapeConfigPanelController.java`
- [Trick Inspector](https://github.com/jouneri/skatescape/blob/master/src/main/java/com/skatescape/TrickInspector.java): `src/main/java/com/skatescape/TrickInspector.java`
- [Inspector Overlay](https://github.com/jouneri/skatescape/blob/master/src/main/java/com/skatescape/TrickInspectorOverlay.java): `src/main/java/com/skatescape/TrickInspectorOverlay.java`
- [Animation Inspector](https://github.com/jouneri/skatescape/blob/master/src/main/java/com/skatescape/AnimationInspector.java): `src/main/java/com/skatescape/AnimationInspector.java`
- [Trick 5 Choreography](https://github.com/jouneri/skatescape/blob/master/src/main/java/com/skatescape/Trick5BoardChoreographyController.java): `src/main/java/com/skatescape/Trick5BoardChoreographyController.java`
- [Developer Mode](https://github.com/jouneri/skatescape/blob/master/src/main/java/com/skatescape/SkateScapeDeveloperMode.java): `src/main/java/com/skatescape/SkateScapeDeveloperMode.java`

### Other components

- **Player**
- **RuneLite Client**

## Connections

- Player → Hotkey Input: presses hotkey (evidence: `README.md`)
- Plugin Settings → Hotkey Input: sets hotkeys (evidence: `src/main/java/com/skatescape/SkateScapeInputController.java`)
- Hotkey Input → Plugin Coordinator: queues trick (evidence: `src/main/java/com/skatescape/SkateScapeInputController.java`)
- Plugin Coordinator → Plugin Settings: reads settings (evidence: `src/main/java/com/skatescape/SkateScapePlugin.java`)
- Plugin Coordinator → Skating Movement: coordinates movement (evidence: `src/main/java/com/skatescape/SkateScapePlugin.java`)
- Plugin Coordinator → Trick Runtime: coordinates playback (evidence: `src/main/java/com/skatescape/SkateScapePlugin.java`)
- Plugin Coordinator → Timeline Builder: prepares timelines (evidence: `src/main/java/com/skatescape/SkateScapePlugin.java`)
- Plugin Coordinator → Player Animation: coordinates animation (evidence: `src/main/java/com/skatescape/SkateScapePlugin.java`)
- Plugin Coordinator → Board Scene: coordinates board (evidence: `src/main/java/com/skatescape/SkateScapePlugin.java`)
- Trick Runtime → Trick Registry: selects tricks (evidence: `src/main/java/com/skatescape/TrickRuntimeController.java`)
- Trick Registry → Trick Definitions: provides definitions (evidence: `src/main/java/com/skatescape/TrickRegistry.java`)
- Timeline Builder → Trick Definitions: uses parameters (evidence: `src/main/java/com/skatescape/TrickTimelineBuilder.java`)
- Trick Runtime → Trick Definitions: reads active trick (evidence: `src/main/java/com/skatescape/TrickRuntimeController.java`)
- Plugin Coordinator → Trick Transforms: coordinates transforms (evidence: `src/main/java/com/skatescape/SkateScapePlugin.java`)
- Trick Transforms → Board Scene: updates scene (evidence: `src/main/java/com/skatescape/SkateboardTrickTransformController.java`)
- Board Scene → Model Factory: creates model (evidence: `src/main/java/com/skatescape/SkateboardSceneController.java`)
- Model Factory → Model Geometry: uses geometry (evidence: `src/main/java/com/skatescape/SkateboardModelFactory.java`)
- Trick Transforms → Model Geometry: transforms model (evidence: `src/main/java/com/skatescape/SkateboardTrickTransformController.java`)
- Plugin Coordinator → Trick Inspector: coordinates inspection (evidence: `src/main/java/com/skatescape/SkateScapePlugin.java`)
- Trick Inspector → Trick Registry: selects definition (evidence: `src/main/java/com/skatescape/TrickInspector.java`)
- Trick Inspector → Plugin Coordinator: controls timeline (evidence: `src/main/java/com/skatescape/TrickInspector.java`)
- Plugin Coordinator → Animation Inspector: coordinates inspection (evidence: `src/main/java/com/skatescape/SkateScapePlugin.java`)
- Plugin Coordinator → Trick Tuning Config: initializes tuning (evidence: `src/main/java/com/skatescape/SkateScapePlugin.java`)
- Plugin Coordinator → Config Panel: creates developer panel (evidence: `src/main/java/com/skatescape/SkateScapePlugin.java`)
- Plugin Coordinator → Trick 5 Choreography: initializes choreography (evidence: `src/main/java/com/skatescape/SkateScapePlugin.java`)
- Plugin Coordinator → Inspector Overlay: uses overlay (evidence: `src/main/java/com/skatescape/SkateScapePlugin.java`)
- Developer Mode → Plugin Coordinator: gates tools (evidence: `README.md`)
- RuneLite Client → Plugin Coordinator: hosts plugin (evidence: `README.md`)
- Player → Skating Movement: moves in game (evidence: `README.md`)
- Player → Trick Runtime: queues combos (evidence: `README.md`)
- Board Scene → RuneLite Client: renders client-side (evidence: `README.md`)
