Static game assets for the HyperScape 3D RPG. This repo is cloned into the main project and served via CDN.
assets/
├── audio/ # Game audio
│ ├── music/ # Background music tracks
│ │ ├── intro/ # Intro themes
│ │ ├── normal/ # Exploration tracks
│ │ ├── combat/ # Battle themes
│ │ └── draft/ # WIP tracks
│ ├── soundeffects/ # SFX library
│ └── voice/ # NPC dialogue audio + voice profiles
│
├── avatars/ # Player avatar models (4 VRM files)
│
├── emotes/ # Character animations (27 GLB clips)
│ # idle, walk, run, jump, combat, dances, etc.
│
├── models/ # Game object models (42 directories)
│ # Flat structure - see Models section below
│
├── vegetation/ # World vegetation
│ ├── garden-trees/ # Garden tree variants
│ ├── jungle-trees/ # Jungle/palm trees
│ ├── bushes/ # Bush models
│ ├── flowers/ # Flower models
│ ├── ferns/ # Fern models
│ ├── ivy/ # Ivy models
│ └── fallen_trees/ # Dead/fallen trees
│
├── rocks/ # Rock formations
│ ├── pathway_rocks/ # Pathway rock variants
│ ├── round_rocks/ # Round rock variants
│ ├── tall_rocks/ # Tall rock formations
│ └── *.glb # Individual large rocks
│
├── grass/ # Grass/foliage models for terrain
│
├── trees/ # Standalone tree models
│
├── terrain/ # Terrain assets
│ └── textures/ # PBR texture atlases
│ ├── dirt/
│ ├── dirt_ground/
│ ├── grass/
│ ├── rock/
│ ├── leafy_texture/
│ ├── stylized_grass/
│ ├── stylized_snow/
│ └── stylized_stone/
│
├── textures/ # Additional textures
│ ├── noise/ # Noise maps
│ └── terrain/ # Terrain textures
│
├── water/ # Water effects
│ ├── water-shader/ # Shader textures + cubemaps
│ └── water-particle/ # Particle effects
│
├── world/ # Base environment
│ # Skybox HDR, base terrain mesh
│
├── manifests/ # Game configuration (10 JSON files)
│ # See Manifests section below
│
├── web/ # Runtime dependencies
│ # PhysX WASM, TypeScript defs, fonts
│
├── luts/ # Color grading look-up tables
│
├── noise/ # Simplex noise textures
│
├── cache/ # Cached manifest data
│
└── *.wasm, *.js # PhysX runtime (root copies)
The models/ directory uses a flat structure with 42 individual model directories (not nested by category).
Weapons:
sword-base,sword-bronze,sword-steel,sword-mithrilbow-base,bow-oak,bow-willow,bow-woodarrows-base,arrows-bronzeshield-base,shield-bronze,shield-steel,shield-mithrilmace,mace-dragon
Armor:
chainbody,chainbody-dragonspiked-helmet
Tools:
pickaxe,pickaxe-bronze,pickaxe-steel,pickaxe-mithrilhatchet-base,hatchet-bronzefishing-rod-base,fishing-rod-standard
Resources:
logs-base,logs-woodore-copper,ore-tintree,basic-reg-tree,basic-reg-tree-stump
NPCs:
human,goblin,imp,troll,thug
Environment:
grass,vegetation,rocks
Each model directory contains:
model-name/
├── {model-name}.glb # 3D model (GLTF binary)
├── metadata.json # Generation/variant metadata
└── concept-art.png # Reference artwork
NPCs additionally have:
├── {model-name}.vrm # VRM humanoid model
├── {model-name}_rigged.glb # Rigged GLB variant
└── animations/ # Walking, running animations
Dragon armor has:
├── sprites/ # 8-angle sprite sheets (0deg-315deg)
└── sprite-metadata.json # Sprite configuration
The manifests/ directory contains 10 JSON configuration files:
| File | Purpose |
|---|---|
items.json |
Item database - weapons, armor, tools, consumables, resources |
npcs.json |
NPC definitions - stats, dialogue, loot tables, spawns |
resources.json |
Harvestable resources - trees, ore deposits, fishing spots |
tools.json |
Tool definitions - pickaxes, hatchets, fishing rods |
biomes.json |
Terrain biome parameters - vegetation, colors, heights |
world-areas.json |
Named zones - boundaries, NPC placements, spawn points |
stores.json |
Shop inventories - items, pricing, buyback rates |
music.json |
Audio track metadata - paths, durations, categories |
vegetation.json |
Vegetation asset catalog - weights, scales, distributions |
buildings.json |
Building definitions (reserved for future use) |
See manifests/README.md for detailed schema documentation.
| Type | Format | Notes |
|---|---|---|
| 3D Models | .glb |
GLTF binary |
| Avatars/NPCs | .vrm |
VRM humanoid format |
| Audio | .mp3 |
Compressed audio |
| Textures | .png, .jpg |
Standard images |
| HDR | .hdr, .ktx2 |
Skybox/environment maps |
| LUTs | .ktx2, .CUBE, .3dl |
Color grading |
| Config | .json |
Game data |
| Runtime | .wasm, .js, .d.ts |
PhysX physics engine |
| Fonts | .woff2 |
Web fonts |
Large binary files (.glb, .png, .mp3, .vrm, .wasm) are tracked with Git LFS. Ensure LFS is installed before cloning:
git lfs install
git clone <repo-url>| Category | Count |
|---|---|
| Model directories | 42 |
| Emote animations | 27 |
| Avatar models | 4 |
| Manifest configs | 10 |
| Vegetation subdirs | 7 |
| Terrain texture types | 8 |