跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
其他技能

bevy-3d-materials

Docs-first stub for Bevy PBR materials. Godot counterpart: godot-3d-materials. Keywords: Bevy, StandardMaterial, PBR, material, ExtendedMaterial.

thedivergentai · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add thedivergentai/Game-Design-Agentic-Skills --skill bevy-3d-materials

技能说明


name: bevy-3d-materials description: "Docs-first stub for Bevy PBR materials. Godot counterpart: godot-3d-materials. Keywords: Bevy, StandardMaterial, PBR, material, ExtendedMaterial."

Bevy 3D materials (docs-first stub)

Not a full port. Docs-first stub. Godot counterpart: godot-3d-materials.

When to use

Load this when a mesh needs a PBR surface. Custom shader extension points are on bevy-shaders. Lighting is on bevy-3d-lighting.

ECS shape

  • Type named in opened text: StandardMaterial (feature blurbs and DistanceFog).
  • Extension: ExtendedMaterial on the pbr page.
  • Features that mention StandardMaterial textures: pbr_anisotropy_texture, pbr_multi_layer_material_textures, pbr_specular_textures, pbr_transmission_textures. Field names inside the struct were not opened.
  • Plugin: bevy_pbr adds PBR rendering. It is part of the 3d render collection.

Godot idea to Bevy idiom

IdeaBevy idiom (idea only)
PBR surfaceStandardMaterial. Albedo and roughness fields were not opened.
Shader overrideExtendedMaterial. Type parameters were not opened.
TransparencyUnverified at field level.

Gaps

  • The StandardMaterial struct page was not opened. Do not invent albedo, metallic, or roughness field names.
  • Mesh attachment component names (material handles on meshes) were not opened.

Expert Knowledge Delta

Library target in prose: Bevy 0.20.0. Lattice URLs stay unversioned.

Opened canon only: Component, Resource, Query, Commands, Startup, Update, Fixed / FixedMain (bevy::time), .chain(), Plugin, DefaultPlugins, MinimalPlugins. Messages and observers are an ownership slot. This file does not invent their struct APIs. Systems run in parallel unless .chain() orders the ones that conflict.

Who owns state

PieceOwnerWho may mutateSchedule
Data on one entityComponentOne system via QueryUpdate or FixedMain
One value for the whole appResourceOne systemStartup to insert, then the schedule that reads it
SpawnCommandsThe spawning systemStartup for the initial world; later schedules for runtime spawn
Order that must not race.chain()The chained systems onlySame schedule
Plugin boundaryPluginbuild registers systems and resourcesBefore the app runs

Borrow rule: two systems that both mutably query the same component must be ordered (.chain()) or split so only one writes. Unrelated systems stay parallel. That is the ECS page rule, not a guess at a system-set API.

Decision

If you needDo thisDo not
Per-entity dataComponent + QueryA Godot node script
App-wide config or clockResourceCopy the value onto every entity
Stable simulation stepFixedMain and the Fixed clockTie simulation to raw frame Update
Startup spawnCommands in StartupSpawn from a render system
Cross-system notice that is not shared stateMessage or observer slot in bevy-events-messagingA new event type invented in this file
An API this skill did not openA Gaps rowA fabricated crate (solver, navmesh module, net, XR)

Load references/a-gate-notes.md for the same table plus the gap rule.

NEVER

  • Do not put /0.20.0/ in lattice URLs. WHY: permalinks stay on latest. The 0.20.0 pin belongs in prose once.

  • Do not mutably query the same component from two unordered systems. WHY: the schedule runs systems in parallel unless .chain() orders them.

  • Do not invent a physics, navigation, networking, or XR crate here. WHY: those rows are gaps, blocked, or revisit.

  • No Godot StandardMaterial or shader-material types. WHY: a Godot port, an unopened API, or a public lie fails the docs-first bar.

  • No Godot types in Bevy code. WHY: a Godot port, an unopened API, or a public lie fails the docs-first bar.

  • No invented APIs or unnamed third-party crates as the chosen solver. WHY: a Godot port, an unopened API, or a public lie fails the docs-first bar.

  • No Creation Station content. WHY: a Godot port, an unopened API, or a public lie fails the docs-first bar.

  • No umbrella skill over Godot and Bevy. WHY: a Godot port, an unopened API, or a public lie fails the docs-first bar.

  • Do not mark this row ported. It is docs_mapped. WHY: a Godot port, an unopened API, or a public lie fails the docs-first bar.

Reference

docs.rs links use the unversioned latest permalink. The library pin on bevy-master stays 0.20.0.

Official Documentation

  • Migration guides - Unversioned hop index.
  • bevy crate - Unversioned API index. Feature list opened for 0.20.0.
  • Assets - Official asset catalog. No third-party crate was selected.
  • Examples - Example tree on the latest branch.
  • ECS - Component, systems, Query, Startup, Update, and .chain().
  • Plugins - Plugin, DefaultPlugins, MinimalPlugins, and add_plugins.
  • bevy::pbr - StandardMaterial mentioned, ExtendedMaterial listed.

Related Skills

Prerequisites

阅读完整来源 ↗