LogoLogo
  • Get Started
  • Getting Started
    • Initial Setup
    • Create Your First Game
    • API Reference
    • Build Your First World Map
    • Multiplayer Testing
    • Use Templates & Examples
    • Styling & Assets
      • Modeling Guidelines
      • Texturing Guidelines
      • Default Assets
  • Build Faster With AI Tools
  • SDK Guides
    • Assets
    • Audio & SFX
      • Audio Manager
    • Blocks & Chunks
      • Block Types
      • Block Type Registry
      • Chunks
      • Chunk Lattice
    • Camera
    • Chat & Commands
    • Debugging
    • Entities
      • Animations
      • Block Entities
      • Colliders & Hitbox
      • Child Entities
      • Entity Controllers
        • Base Entity Controller
        • Pathfinding Entity Controller
        • DefaultPlayer Entity Controller
        • Simple Entity Controller
      • Entity Manager
      • Model Entities
      • Movement & Pathfinding
      • Player Controlled Entities
    • Events
    • Input & Controls
    • Lighting
      • Ambient Light
      • Light Manager
      • Point Lights
      • Spot Lights
      • Sun Light (Directional)
    • Mobile
    • Persisted Data
    • Players
      • Player Manager
      • Persisted Player Data
    • Plugins
    • Physics
      • Colliders
      • Collision Groups
      • Debugging
      • Gravity
      • Raycasts
      • Rigid Bodies
    • User Interface
      • Overlay UI
      • Scene UIs
      • Scene UI Manager
    • Worlds
      • Map Data Format
  • Helpful Resources
    • HYTOPIA Architecture & Platform Overview
    • Useful Third-Party Tools
Powered by GitBook
On this page
  • Assets Directory
  • Asset Usage & URIs
  • Asset Subfolders
Export as PDF
  1. SDK Guides

Assets

PreviousBuild Faster With AI ToolsNextAudio & SFX

Last updated 4 months ago

All of the different types of content that make up your game are called "Assets". Assets can be music, sound effects, block textures, cubemaps, GLTF models, images, videos, and more.

Assets Directory

All of your assets must be placed in the assets folder at the root of your project project structure. If you created your project using the HYTOPIA boilerplate or a template, your asset folder will look something like this.

Asset Usage & URIs

Throughout the HYTOPIA SDK, you'll be required to provide a URI to some type of asset. Whether this be a URI for a model, an audio file, a texture, or something else.

All asset URI's are provided relative to the assets folder.

For example, if we created a new block type that used a texture called dirt.png and we specified the URI to find that texture as blocks/dirt.png, then the fully resolved path would be assets/blocks/dirt.png

Asset Subfolders

It's common to want to organize your assets into subfolders, you can do this in any way you'd like. Again, the only important thing is all your assets must exist as a child of your root assets folder.

For example, we could create a audio folder in our assets folder to hold our .mp3 and .wav sound files for out game. Maybe we want to organize it a bit better and make multiple subfolders for organization so our structure looks like assets/audio/songs and within the songs folder we put ambient music. When needing to provide an audio URI for say the Audio class, we'd then use something like audio/songs/my-song.mp3 .