character-terrain

Detect terrain under a character and resolve matching footstep audio in Unity.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/Silac1995/My-World-Isekai-Unity --skill character-terrain
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: character-terrain
Source: https://github.com/Silac1995/My-World-Isekai-Unity/tree/main/.agent/skills/character-terrain
Command: npx skills add https://github.com/Silac1995/My-World-Isekai-Unity --skill character-terrain

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Character terrain detection and the corresponding footstep audio are not consistently synchronized across server and client, leading to mismatched sounds and reduced immersion.

Core Features & Use Cases

  • Detects the terrain under a character each frame via CharacterTerrainEffects and exposes CurrentTerrainType.
  • Resolves correct footstep audio using FootstepAudioResolver by cross-referencing terrain, boot material, and foot surface.
  • Enables future gameplay extensions for terrain-driven movement, weather interactions, and VFX.

Quick Start

Attach CharacterTerrainEffects to the character and ensure FootstepAudioResolver subscribes to the OnAnimationEvent to play terrain-specific footsteps.

Frequently Asked Questions about character-terrain

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I sync footstep audio with terrain detection in Unity multiplayer?

To sync footstep audio in Unity, you need CharacterTerrainEffects on both server and client to detect CurrentTerrainType, then FootstepAudioResolver cross-references terrain, boot material, and foot surface to play the correct audio clip.

What's the best way to play terrain-specific footsteps in Unity real-time gameplay?

The best way to play terrain-specific footsteps is using FootstepAudioResolver paired with a FootstepAudioProfile, which maps terrain and weather profiling data to the correct audio clip triggered by OnAnimationEvent.

How does CharacterTerrainEffects detect terrain types for footstep audio?

CharacterTerrainEffects detects terrain types each frame by sampling the terrain under the character via a TerrainCellGrid and BiomeRegion defaults, exposing the result as CurrentTerrainType for audio resolution.

Can I use terrain-aware footsteps to trigger movement and weather VFX in Unity?

Yes, terrain-aware footsteps enable future gameplay extensions for terrain-driven movement, weather interactions, and VFX by exposing CurrentTerrainType and terrain profiling data for additional systems to consume.

Why are my Unity footstep sounds mismatched between server and client?

Footstep sounds mismatch when CharacterTerrainEffects is not synchronized across server and client, requiring both sides to run terrain detection and FootstepAudioResolver to ensure consistent audio playback.

Do I need a FootstepAudioProfile to resolve boot material footstep sounds in Unity?

Yes, you need a FootstepAudioProfile paired with FootstepAudioResolver to cross-reference terrain, boot material, and foot surface mappings for resolving the correct footstep audio clip.