skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
chrisgliddon/bevy-skills118 installs

bevy-voxel-data

Use when defining voxel blocks in RON (`name`, `textures`, `flags`), building a runtime palette mapping `BlockId -> BlockDef`, baking per-block textures into a KTX2 atlas (`ktx2` + `zstd_rust` features), or binding the atlas as `StandardMaterial.base_color_texture` with an `ImageSampler` so meshed quads sample by face index. Generic Bevy 0.20 voxel-data patterns — no game-specific data baked in.

How do I install this agent skill?

npx skills add https://github.com/chrisgliddon/bevy-skills --skill bevy-voxel-data
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    The skill provides comprehensive documentation and patterns for managing voxel data in Bevy 0.20, including palette systems, texture atlasing, and storage optimizations. No security issues were detected.

  • Socketpass

    No alerts

  • Snykpass

    Risk: LOW · No issues

What does this agent skill do?

Bevy 0.20 — Voxel data (RON, palette, KTX2 atlas)

When to use this skill

  • Defining a moddable block catalog in a text format authors can edit.
  • Building a runtime palette keyed by BlockId (u16/u32) for fast lookup during meshing.
  • Packing per-block textures into a single atlas so all chunks can share one material.
  • Switching the atlas to KTX2 for GPU-friendly compressed delivery.
  • Choosing a runtime chunk storage format (flat array, RLE, palette compression, hybrid).
  • Optimising procedural world generation: extremity bound checking, noise upsampling, noise caching, cross-biome noise sharing.
  • Surveying the Rust/Bevy voxel-crate ecosystem and its current gaps before reaching for a dependency.

Canonical end-to-end flow

1. Define blocks in RON (assets/blocks.ron):

(
    blocks: [
        ( name: "air",   visibility: Empty ),
        ( name: "grass", visibility: Opaque,
          faces: ( top: "textures/grass_top.png",
                   bottom: "textures/dirt.png",
                   side: "textures/grass_side.png" ) ),
        ( name: "stone", visibility: Opaque,
          faces: ( all: "textures/stone.png" ) ),
    ],
)

2. Core Rust types — BlockCatalog is a Bevy Asset; Palette is a Resource:

#[derive(Debug, Deserialize, Asset, TypePath)]
pub struct BlockCatalog { pub blocks: Vec<BlockDef> }

#[derive(Resource, Default)]
pub struct Palette {
    pub by_id:   Vec<PaletteEntry>,   // index == BlockId
    pub by_name: HashMap<String, u16>,
}

#[derive(Default, Clone)]
pub struct PaletteEntry {
    pub name:       String,
    pub visibility: BlockVisibility,
    /// Atlas tile per face: [−X, −Y, −Z, +X, +Y, +Z] (block-mesh order).
    pub face_tiles: [u16; 6],
}

3. Build the palette — walk the catalog, look up each face path in the AtlasIndex (JSON sidecar loaded alongside the KTX2 file), emit one PaletteEntry per block in catalog order (that order is the BlockId space).

4. Bind the atlas to StandardMaterial.base_color_texture; compute per-vertex UVs as tile_x = tile_index % atlas_cols during the meshing pass.

Topics

TopicReference
Full RON schema, all fields, serde defaults, parser notesreferences/ron-schema.md
BlockDef / BlockFaces / BlockVisibility types, build_palette in full, face_tiles slot conventionreferences/palette.md
KTX2 packing, tile-size budgets, padding for mip safety, BC7/ETC2/ASTC per platformreferences/ktx2-atlas.md
StandardMaterial binding, UV formula, per-vertex emission, sampler config, alpha modesreferences/atlas-binding.md
Runtime chunk storage formats — flat array, RLE, palette compression, hybrid — with RAM estimatesreferences/storage-formats.md
Procedural generation patterns — noise upsampling, biome sharing, extremity bounds, cachingreferences/generation.md
Rust/Bevy voxel-crate ecosystem survey (block-mesh, bevy_voxel_world, bevy-vox-scene, …)references/ecosystem.md

Gotchas

  • KTX2 is opt-in, and the feature is zstd_rust, not zstd. ktx2 and zstd_rust are both pulled in by 3d_api (so by 3d and the defaults). For trimmed WASM builds add ktx2 plus zstd_rust (or zstd_c) explicitly. Use BC7 (desktop) or ETC2/ASTC (mobile) — see references/ktx2-atlas.md.
  • compressed_image_saver changed meaning (0.20). It now emits BCn/ASTC via ctt; the old Basis Universal UASTC behaviour is compressed_image_saver_universal. Pick one when you let the asset processor bake the atlas instead of an offline script.
  • Sampler types live in bevy::image. ImageSampler, ImageSamplerDescriptor, ImageAddressMode are bevy::image::*; bevy::render::texture::* is stale pre-0.16 output and no longer resolves.
  • Image::pixel_bytes returns Result (0.19). Atlas-inspection code that did if let Some(px) = image.pixel_bytes(..) must match on Ok/Err.
  • Name your enum BlockVisibility. bevy::prelude::* already exports Visibility; a local Visibility shadows it silently and the next Visibility::Hidden on a chunk entity hits the wrong type.
  • Resource implies Component (0.19). #[derive(Resource)] on Palette is enough; #[derive(Component, Resource)] is now an error.
  • Palette ordering is the BlockId space. Reordering the catalog after a save file ships will corrupt saves. Always append; never reorder.
  • Texture bleeding at mip levels ≥ 1. Add 2-pixel padding around each tile, or switch to a texture array with clamp_to_edge per slice. Details in references/ktx2-atlas.md and references/atlas-binding.md.
  • Translucent blocks need a separate draw call. Use AlphaMode::Blend on a second material and a separate mesh batch per chunk — translucent quads cannot be merged with opaque ones. AlphaMode moved to bevy_material in 0.19 but stays in the prelude.
  • Don't bake the atlas at runtime in shipped builds. Run the bake script at content-build time; commit the .ktx2 + JSON index; load both at startup.

See also

  • bevy-voxel-pipeline — the meshing step that consumes face_tiles.
  • bevy-voxel-runtime — remesh scheduling once blocks change.
  • bevy-custom-assets — implementing the RON catalog loader.
  • bevy-pbr-materials — wiring the atlas into StandardMaterial.
  • bevy-migration-0-19-to-0-20 — compressed_image_saver and image-feature renames.

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/chrisgliddon/bevy-skills/bevy-voxel-data">View bevy-voxel-data on skillZs</a>