From 48bf3a034204b34cff903319b67ab06cf6709486 Mon Sep 17 00:00:00 2001 From: Thierry Berger Date: Thu, 12 Sep 2024 15:40:18 +0200 Subject: [PATCH 1/2] fix tree links from blenvy to main --- README.md | 32 ++++++++++++++++---------------- 1 file changed, 16 insertions(+), 16 deletions(-) diff --git a/README.md b/README.md index f6933012..5e5af4af 100644 --- a/README.md +++ b/README.md @@ -29,8 +29,8 @@ Want to jump right in? See the [quickstart guide](https://github.com/kaosat-dev/ ## Features * Useful if you want to use Blender as your Editor -* define Bevy components as custom properties in Blender with an UI tool to add & edit Bevy components, automatically export gltf blueprints & more in [Blender](https://github.com/kaosat-dev/Blenvy/tree/blenvy/tools/blenvy) -* blueprints & levels system : turn your Blender collections into [gltf Blueprints](https://github.com/kaosat-dev/Blenvy/tree/blenvy/crates/blenvy) for reuse inside levels that are just Blender scenes +* define Bevy components as custom properties in Blender with an UI tool to add & edit Bevy components, automatically export gltf blueprints & more in [Blender](https://github.com/kaosat-dev/Blenvy/tree/main/tools/blenvy) +* blueprints & levels system : turn your Blender collections into [gltf Blueprints](https://github.com/kaosat-dev/Blenvy/tree/main/crates/blenvy) for reuse inside levels that are just Blender scenes * setup & tweak components in Blender Collections & override any of them in your collection instances if you want * setup & tweak components for objects, meshes and materials as well ! * automatically load all assets for each blueprint (gltf files, manually added assets), with no setup required @@ -39,15 +39,15 @@ Want to jump right in? See the [quickstart guide](https://github.com/kaosat-dev/ * minimal dependencies: Bevy, Serde & RON only! * opensource -> If you were previously using the individual bevy_gltf_xxx crates & Blender add-ons please see the [migration guide](https://github.com/kaosat-dev/Blenvy/blob/blenvy/Migration_guide.md) +> If you were previously using the individual bevy_gltf_xxx crates & Blender add-ons please see the [migration guide](https://github.com/kaosat-dev/Blenvy/blob/main/Migration_guide.md) ## Crates One crate to rule them all ! -* [blenvy](https://github.com/kaosat-dev/Blenvy/tree/blenvy/crates/blenvy) This crate allows you to +* [blenvy](https://github.com/kaosat-dev/Blenvy/tree/main/crates/blenvy) This crate allows you to * define components direclty inside gltf files and instanciate/inject the components on the Bevy side. - * export your project's Bevy registry to json, in order to be able to generate custom component UIs on the Blender side in the Blender [blenvy](https://github.com/kaosat-dev/Blenvy/tree/blenvy/tools/blenvy) add-on + * export your project's Bevy registry to json, in order to be able to generate custom component UIs on the Blender side in the Blender [blenvy](https://github.com/kaosat-dev/Blenvy/tree/main/tools/blenvy) add-on * define Blueprints/Prefabs for Bevy inside gltf files and spawn them in Bevy. With the ability to override and add components when spawning, efficient "level" loading etc * the ability to save & load your game state in a relatively simple way, by leveraging the blueprint functionality to only save a minimal subset of dynamic data, seperating dynamic & static parts of levels etc. @@ -55,26 +55,26 @@ One crate to rule them all ! There is a [video tutorial/explanation](https://youtu.be/-lcScjQCA3c) if you want, or you can read the crate docs. There is a [video tutorial/explanation](https://youtu.be/CgyNtwgYwdM) for this one too, or you can read the crate docs - The examples for the crate are [here](https://github.com/kaosat-dev/Blenvy/tree/blenvy/examples) + The examples for the crate are [here](https://github.com/kaosat-dev/Blenvy/tree/main/examples) ## Tools ### Blender: blenvy -* an all in one [Blender addon](https://github.com/kaosat-dev/Blenvy/tree/blenvy/tools/blenvy) for the Blender side of the workflow: +* an all in one [Blender addon](https://github.com/kaosat-dev/Blenvy/tree/main/tools/blenvy) for the Blender side of the workflow: * allow easilly adding & editing Bevy components , using automatically generated UIs for each component * automatically exports your level/world from Blender to gltf whenever you save your Blend file - * automatically export your [Gltf blueprints](https://github.com/kaosat-dev/Blenvy/tree/blenvy/crates/blenvy) & assets + * automatically export your [Gltf blueprints](https://github.com/kaosat-dev/Blenvy/tree/main/crates/blenvy) & assets ## Examples -you can find all examples, [here](https://github.com/kaosat-dev/Blenvy/tree/blenvy/examples) +you can find all examples, [here](https://github.com/kaosat-dev/Blenvy/tree/main/examples) -* [`components`](https://github.com/kaosat-dev/Blenvy/tree/blenvy/examples/components/) use of ```components``` only, to spawn entities with components defined inside gltf files -* [`blueprints`](https://github.com/kaosat-dev/Blenvy/tree/blenvy/examples/blueprints/) use of ```blueprints``` and ```levels``` to spawn a level and then populate it with entities coming from different gltf files, live (at runtime) spawning of entities etc -* [`animation`](https://github.com/kaosat-dev/Blenvy/tree/blenvy/examples/animation/) how to use and trigger animations from gltf files -* [`save_load`](https://github.com/kaosat-dev/Blenvy/tree/blenvy/examples/save_load/) how to save & load levels -* [`demo`](https://github.com/kaosat-dev/Blenvy/tree/blenvy/examples/demo/) a full demo showcasing all features , including physics, animation +* [`components`](https://github.com/kaosat-dev/Blenvy/tree/main/examples/components/) use of ```components``` only, to spawn entities with components defined inside gltf files +* [`blueprints`](https://github.com/kaosat-dev/Blenvy/tree/main/examples/blueprints/) use of ```blueprints``` and ```levels``` to spawn a level and then populate it with entities coming from different gltf files, live (at runtime) spawning of entities etc +* [`animation`](https://github.com/kaosat-dev/Blenvy/tree/main/examples/animation/) how to use and trigger animations from gltf files +* [`save_load`](https://github.com/kaosat-dev/Blenvy/tree/main/examples/save_load/) how to save & load levels +* [`demo`](https://github.com/kaosat-dev/Blenvy/tree/main/examples/demo/) a full demo showcasing all features , including physics, animation ## Workflow @@ -84,8 +84,8 @@ The workflow goes as follows (once you got your Bevy code setup) ![component registration](https://github.com/kaosat-dev/Blenvy/blob/main/docs/component_registration.png) -* setup & then use the Blenvy [Bevy crate](https://github.com/kaosat-dev/Blenvy/tree/blenvy/crates/blenvy) -* setup & then use the Blenvy [Blender add-on](https://github.com/kaosat-dev/Blenvy/tree/blenvy/tools/blenvy) +* setup & then use the Blenvy [Bevy crate](https://github.com/kaosat-dev/Blenvy/tree/main/crates/blenvy) +* setup & then use the Blenvy [Blender add-on](https://github.com/kaosat-dev/Blenvy/tree/main/tools/blenvy) * iterate * have fun ! From 94f82b4682f8c9f9422918119a91a01a0efe01a5 Mon Sep 17 00:00:00 2001 From: Thierry Berger Date: Thu, 12 Sep 2024 15:51:12 +0200 Subject: [PATCH 2/2] clarify where to get the release zip --- tools/blenvy/README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/tools/blenvy/README.md b/tools/blenvy/README.md index cdcf29f1..d71f756a 100644 --- a/tools/blenvy/README.md +++ b/tools/blenvy/README.md @@ -20,9 +20,9 @@ If you can I would generally recommend starting fresh, but a lot of effort has b ## Installation: -* grab the latest release zip file +* grab the latest release zip file from the [release page](https://github.com/kaosat-dev/Blenvy/releases/) -![blender addon install](./docs/blender_addon_install_zip.png) + ![blender addon install](./docs/blender_addon_install_zip.png) * up to Blender 4.1 go to edit => preferences => add-ons, click on install and choose the path where ```blenvy.zip``` is stored