Merge pull request #256 from stride3d/staging

fix: Merging Aggror's updates to master
stride3d · Feb 18, 2024 · 9c50d26 · 9c50d26
2 parents 0038998 + 320c9ba
commit 9c50d26
Show file tree

Hide file tree

Showing 22 changed files with 508 additions and 2 deletions.
diff --git a/Stride.Docs.csproj b/Stride.Docs.csproj
@@ -6,4 +6,8 @@
         <ImplicitUsings>enable</ImplicitUsings>
     </PropertyGroup>
 
+    <ItemGroup>
+      <Folder Include="en\community-resources\media\" />
+    </ItemGroup>
+
 </Project>
diff --git a/en/community-resources/coding.md b/en/community-resources/coding.md
@@ -0,0 +1,37 @@
+#Coding
+
+## Code Only
+- [CodeOnlySample](https://github.com/xen2/Xenko.CodeOnlySample) - Sample project with code only
+- [XenkoWindowFromCode](https://github.com/microdee/xenko-window-from-code) - Launch a game window from code only
+
+## Networking
+- [ClientServerSample](https://github.com/Ethereal77/Stride.ClientServerSample) - Headless server (Physics only, no game tick loop)
+- [Stride.Networking.Simple](https://github.com/manio143/Stride.Networking.Simple) - Asynchronous NetworkScript example for client-server communication
+- [ET-Stride: A networking framework based on Stride and ET](https://github.com/ly3027929699/ET-Stride)
+- [GalaxyCore: Network Solution for Unity, Stride, Xenko, Unigine](https://github.com/defraswiew/GalaxyCore)
+- [Regulus.Remote: A simple C# network library.](https://github.com/jiowchern/Regulus.Remote)
+- [Lite Entity System](https://github.com/RevenantX/LiteEntitySystem)
+- [MUD framework for Stride](https://github.com/JoseJohnen/MUD_SKELETON/tree/main)
+- [Running Stride headless client/server](https://github.com/Ethereal77/Stride.ClientServerSample)
+
+## Entiy Component System
+- [Entity Processor Example](https://github.com/Basewq/XenkoProofOfConcepts/tree/master/EntityProcessorExample) - Custom Entity Component + Processor
+- Libraries
+    - [Doprez.Stride.AI: FSM and GOAP library for Stride](https://github.com/Doprez/Doprez.Stride.AI)
+    - [Bepu Navigation](https://github.com/Nicogo1705/Stride.BepuPhysics/tree/master/Stride.BepuPhysics.Navigation) using [DotRecast](https://github.com/ikpil/DotRecast)
+- Articles
+  - [Svelto Abstraction from OOP](https://www.sebaslab.com/ecs-abstraction-layers-and-modules-encapsulation/)
+  - [Svelto Doofuses example](https://www.sebaslab.com/svelto-ecs-3-3-and-the-new-filters-api/#:~:text=shiny%20new%20Doofuses%20Stride%20example.)
+  - [Svelto Turret example](https://www.sebaslab.com/svelto-miniexample-7-stride-engine-demo/)
+- Repositories
+  - [Stride-npc: A basic example of a Finite State Machine](https://github.com/Doprez/stride-npc)
+  - [Stride-goap: a very simple implementation of GOAP using MountainGoap](https://github.com/Doprez/stride-goap)
+  - [Svelto ECS mini examples](https://github.com/sebas77/Svelto.MiniExamples)
+    - [Using Entity Processors for Scene Editor Plugins](https://github.com/Doprez/lod-example)
+    - [Pathfinding With Entity Processors](https://github.com/Doprez/stride-pathfinding-demo)
+    - [Arch ECS integrated into Stride](https://github.com/Doprez/stride-arch-ecs#add-arch-components-in-strides-editor)
+
+
+
+
+      
diff --git a/en/community-resources/embedded-stride.md b/en/community-resources/embedded-stride.md
@@ -0,0 +1,11 @@
+#Embedded Stride
+
+* project examples
+	* [Stride in Ultralight Blazor](https://github.com/lionfire/LionFire.Stride.Ultralight)
+	* [Stride in Winforms](https://github.com/windperson/-StrideGameNet5WinFormsDemo)
+* code blobs
+	* [Stride in WPF Control](https://gist.github.com/EricEzaM/5797be1f4b28f15e9be53287a02d3d67)
+	* [Stride in avalonia Control](https://gist.github.com/westonsoftware/a3fa982397fe1817ece4a27d3cbc5a89)
+* VVVV integration
+  	* [3D rendering documentation](https://thegraybook.vvvv.org/reference/libraries/graphics-3d.html)
+  	* [Stride integration source code on GitHub](https://github.com/vvvv/VL.StandardLibs)
diff --git a/en/community-resources/engine.md b/en/community-resources/engine.md
@@ -0,0 +1,9 @@
+  # Engine Documentation
+
+* [Custom Root Renderer](https://github.com/tebjan/Stride.CustomRootRenderFeature)
+* [Compiling Stride for Linux](https://www.youtube.com/watch?v=BoHEASoQvu8)
+* [Experimental mini Stride.Editor in Avalonia](https://github.com/manio143/StrideComponentsEditorAvalonia)
+* [Stride Editor current design document](https://gist.github.com/manio143/b6666eedb1403deb5525961697d0c25d)
+* [Stride docs shader stages](https://github.com/stride3d/stride*docs/blob/master/en/manual/graphics/effects*and*shaders/shading*language/shader*stages.md/)
+* [Strideui discussion](https://gist.github.com/manio143/8706b4bad5f7db5402d3b81acbb6276e)
+* [Stride Game Engine Extension for code only approach](https://github.com/VaclavElias/stride*code*only)
diff --git a/en/community-resources/example-projects.md b/en/community-resources/example-projects.md
@@ -0,0 +1,55 @@
+# Example projects
+
+## Input
+* [Control * Input Manager](https://github.com/rsptim1/Ctrl)
+* [Easier input binding configuration](https://github.com/lparkermg/LPSoft.Stride.InputExtensions)
+* [Demos with a focus on Code*Only approach](https://github.com/najak3d/Stride3D_Demos)
+
+## Editor
+* [Custom Editor Gizmos](https://github.com/gearsin/Stride.Demo.Gizmo/tree/master)
+
+## Scene
+* [Load Scenes in parallel](https://github.com/julyfortoday/StrideParallelScenes)
+* [Export/save a scene or a group of entities within a running stride game](https://gist.github.com/Eideren/0aa59644eb7c5b029d04b7fa5a285e62)
+
+## Code blobs
+* [Stride C# gists search](https://gist.github.com/search?l=c%23&q=stride)
+* [Look at script](https://gist.github.com/ykafia/9579569c26e2724f1a35afab0449b72a)
+* [Smooth follow](https://gist.github.com/Doprez/e146f8d30b7e9cea05de138d4e3a30f0)
+* [Smooth Rotation](https://gist.github.com/Doprez/5bd571341b075c5cf257d7265c374807)
+* [Stride 3rd person controller](https://pastebin.com/4nFbabkZ)
+* [Quake 3 movement for Stride3D](https://github.com/Redhacker1/Q3MovementStride)
+
+
+## Other
+* [Proof of Concepts](https://github.com/Basewq/XenkoProofOfConcepts)
+    * [Cutscene Timeline](https://github.com/Basewq/XenkoProofOfConcepts/tree/master/CutsceneTimelineExample)
+    * [Text Control](https://github.com/Basewq/XenkoProofOfConcepts/tree/master/DialogueTextControlExample)
+    * [Entity Processor](https://github.com/Basewq/XenkoProofOfConcepts/tree/master/EntityProcessorExample)
+    * [Game Screen Manager](https://github.com/Basewq/XenkoProofOfConcepts/tree/master/GameScreenManagerExample)
+    * [Level Editor Extensions](https://github.com/Basewq/XenkoProofOfConcepts/tree/master/LevelEditorExtensionExample)
+    * [Multiplayer](https://github.com/Basewq/XenkoProofOfConcepts/tree/master/MultiplayerExample)
+    * [Object Info Renderer](https://github.com/Basewq/XenkoProofOfConcepts/tree/master/ObjectInfoRenderTargetExample)
+    * [Screen Space Decals](https://github.com/Basewq/XenkoProofOfConcepts/tree/master/ScreenSpaceDecalExample)
+    * [Screen Space Decals With Root Renderer](https://github.com/Basewq/XenkoProofOfConcepts/tree/master/ScreenSpaceDecalRootRendererExample)
+* [Source generation](https://github.com/johang88/StrideSourceGeneratorTest)
+* [Stride config example](https://github.com/johang88/StrideConfigurationReference)
+* [Sound detection in Stride](https://github.com/manio143/BeatDetection)
+* [StrideVoxelScape](https://github.com/Jarb2104/StrideVoxelScape_v0.1)
+* [Stride3D examples in .NET 5 using C# 9.0 or .NET 6 using C# 10](https://github.com/VaclavElias/Stride3DTutorials)
+* [Tweening library](https://github.com/JoshFlash/ZenTween)
+* [Tessellation](https://github.com/johang88/Stride*Tessellation)
+* [Workshop creating a game with Stride](https://github.com/manio143/StrideIntroWorkshopNode20/tree/main)
+* [Xenko/Stride byte*sized project examples](https://github.com/profan/XenkoByteSized)
+
+
+### Old projects
+These are projects that definitely will not work with Stride 4.x without massive rewrites but were made with the old versions of Stride FKA Xenko or Paradox game engine.
+
+* [A Minecraft*style game](https://github.com/NckHmml/ParadoxCraft)
+* [Xenko Voxel Scape](https://github.com/Doprez/stride-voxelscape)
+* [Stride Voxel Scape](https://github.com/Jarb2104/StrideVoxelScape_v0.1)
+    * [Video demo](https://www.youtube.com/watch?v=whJOtux2DrQ)
+* [Xenko Live Editor](https://github.com/treplogle/XenkoLiveEditor)
+    * [New Stride version](https://github.com/tebjan/StrideLiveEditor)
+* [Voxel GI example](https://github.com/WhyPenguins/XenkoVoxelGI)
diff --git a/en/community-resources/games-and-demos.md b/en/community-resources/games-and-demos.md
@@ -0,0 +1,45 @@
+# Games and demos
+
+## Games
+* [Distant Worlds 2](https://store.steampowered.com/app/1531540/Distant_Worlds_2) - Vast, pausable real*time 4X space strategy game
+* [Starbreach](https://github.com/xenko3d/Starbreach) - First/Third Person Shooter
+* [Rollerghoaster](https://aggror.com/blog/video*rollerghoaster*0.0.2*demo) - Race against online and local ghosts on procedural tracks
+* [FPS Infinite](https://store.steampowered.com/app/1256380/FPS_Infinite/) - Procedural FPS with VR support
+* [Once Upon A Lan](https://jarmo.itch.io/once*upon*a*lan) - Multiplayer isometric arena brawler over LAN
+* [BallsOfSteel](https://github.com/Kryptos*FR/BallsOfSteel)
+* [XenkoSpaceShooter](https://github.com/jayrulez/XenkoSpaceShooter)
+* [XenkoAsteroids](https://github.com/LanceJZ/Xenko_Asteroids)
+* [TurnBasedBattleSim](https://github.com/jayrulez/TurnBasedBattleSim)
+* [Harrowing Flight](https://forums.xenko.com/t/harrowing*flight*student*game*project/1823) - Student Game Project
+* [Glasses](https://globalgamejam.org/2019/games/glasses) - Global Game Jam Entry
+* [vvvv Showcase](https://visualprogramming.net/#Showcase) - Many large*scale interactive media projects made with vvvv
+* [Astroids](https://github.com/LanceJZ/Stride-Asteroids)
+* [Basic Platformer WIP](https://github.com/Doprez/stride-platformer)
+* [Rise of the Undeaf](https://github.com/manio143/RiseOfTheUndeaf)
+* [Xenko TPS example](https://github.com/stride3d/Starbreach)
+* [Zerobot](https://github.com/joaovsq/Zerobot)
+* Youtube
+   * [Rescue Drone * August 2015](https://www.youtube.com/watch?v=wOZ*s7Q4qWY)
+   * [Xenko Game Engine: How The Makers Of Bravely Default Want To Help Develop Better VR Games](https://www.youtube.com/watch?v=1hgh7R38yK8)
+   * [Xenko Procedural Terrain Generation &amp; Water tests](https://www.youtube.com/watch?v=ba_Tpz4ojHk)
+   * [Xenko 1.8 * Cel Shading](https://www.youtube.com/watch?v=RJDrG1QR3Uo)
+   * [demo of vxgi implementation in Xenko game engine](https://www.youtube.com/watch?v=AZytf15FRks&t=2s)
+* Twitter
+    * [Networking from Scythe of Luna](https://twitter.com/scythe_of_luna/status/1616773130495885325)
+* Vimeo
+    * [Data Sculpture for Herrenknecht rendered with Stride](https://vimeo.com/797315059)
+* Releases
+  * [Children of the galaxy](https://www.emptykeys.com/games/children*of*the*galaxy/)
+  * [Distant Worlds 2](https://store.steampowered.com/app/1531540/Distant_Worlds_2/)
+  * [Snaaker Friends](https://store.steampowered.com/app/1443760/Snaaker__Friends/)
+  * [VVVVarkle with vvvv rendered using Stride](https://github.com/BenTec3d/VVVVarkle/releases/tag/v1.0)
+  * [Virtual Desktop](https://www.vrdesktop.net/)
+    * [Flappy Bird With Source Code](https://nedreid.itch.io/flappy*bird*stride)
+  * [Large*scale interactive projects made with VVVV](https://visualprogramming.net/#Showcase)
+* Game Jams
+  * [Step up Made by Marian Dziubiak and Youness Kafia](https://manio143.itch.io/project*step*up)
+  * [Stopping the Rogue by manio](https://manio143.itch.io/stopping*the*rogue)
+  * [Once Upon a LAN by Jarmo](https://jarmo.itch.io/once*upon*a*lan)
+  * [Dozer Dash](https://ldjam.com/events/ludum*dare/54/$374737) * made with a code only approach [plus repo](https://github.com/Schossi/LD54/tree/main)
+* Projects
+  * [Astroids](https://github.com/mmujic2/StrideAsteroids)  
diff --git a/en/community-resources/index.md b/en/community-resources/index.md
@@ -0,0 +1,110 @@
+# Community Resources
+
+Stride's community has made and shared all kinds of awesome stuff over the years. Have a look around for inspiration or
+perhaps for something that you can reuse for your project.
+
+<div class="row g-4 mb-4">
+<div class="col-md-6">
+    <div class="card h-100">
+        <div class="card-body">
+            <h2 class="card-title h5">👾 Games and demos</h2>
+            <p class="card-text">Games, demo's and prototypes that people made.</p>
+        </div>
+        <p class="px-3 mb-4"><a class="stretched-link" href="games-and-demos.md">Explore games and demos</a></p>
+    </div>
+</div>
+<div class="col-md-6">
+    <div class="card h-100">
+        <div class="card-body">
+            <h2 class="card-title h5">⚙️ Example projects</h2>
+            <p class="card-text">Examples for you to try and dig into.</p>
+        </div>
+        <p class="px-3 mb-4"><a class="stretched-link" href="example-projects.md">Try it out yourself</a></p>
+    </div>
+</div>
+<div class="col-md-6">
+    <div class="card h-100">
+        <div class="card-body">
+            <h2 class="card-title h5">🎓 Tutorials and Articles</h2>
+            <p class="card-text">Tutorials and articles</p>
+        </div>
+        <p class="px-3 mb-4"><a class="stretched-link" href="tutorials-and-articles.md">Explore tutorials and articles</a></p>
+    </div>
+</div>
+<div class="col-md-6">
+    <div class="card h-100">
+        <div class="card-body">
+            <h2 class="card-title h5">⨺ Models and Animations</h2>
+            <p class="card-text">From procedural mesh to animation controllers</p>
+        </div>
+        <p class="px-3 mb-4"><a class="stretched-link" href="models-and-animations.md">Have a look</a></p>
+    </div>
+</div>
+<div class="col-md-6">
+    <div class="card h-100">
+        <div class="card-body">
+            <h2 class="card-title h5">🌈 Shaders</h2>
+            <p class="card-text">Enter the magical world of shaders.</p>
+        </div>
+        <p class="px-3 mb-4"><a class="stretched-link" href="shaders.md">No shady stuff here, we promise</a></p>
+    </div>
+</div>
+
+<div class="col-md-6">
+    <div class="card h-100">
+        <div class="card-body">
+            <h2 class="card-title h5">⛰️ Terrain and Water</h2>
+            <p class="card-text">Groundbreaking stuff and H2O related topics</p>
+        </div>
+        <p class="px-3 mb-4"><a class="stretched-link" href="terrain-and-water.md">Get your feet wet</a></p>
+    </div>
+</div>
+<div class="col-md-6">
+    <div class="card h-100">
+        <div class="card-body">
+            <h2 class="card-title h5">🎥 Rendering and camera</h2>
+            <p class="card-text">Rendering, Camera's, render groups and more</p>
+        </div>
+        <p class="px-3 mb-4"><a class="stretched-link" href="rendering-and-camera.md">Lights, camera, Action!</a></p>
+    </div>
+</div>
+<div class="col-md-6">
+    <div class="card h-100">
+        <div class="card-body">
+            <h2 class="card-title h5">🍎 Physics</h2>
+            <p class="card-text">Physics, colliders, triggers</p>
+        </div>
+        <p class="px-3 mb-4"><a class="stretched-link" href="physics.md">Bump in to some useful code</a></p>
+    </div>
+</div>
+<div class="col-md-6">
+    <div class="card h-100">
+        <div class="card-body">
+            <h2 class="card-title h5">🪟 UI</h2>
+            <p class="card-text">Interfaces, interactions and 3rd party tools</p>
+        </div>
+        <p class="px-3 mb-4"><a class="stretched-link" href="ui.md">We will tell you why</a></p>
+    </div>
+</div>
+
+<div class="col-md-6">
+    <div class="card h-100">
+        <div class="card-body">
+            <h2 class="card-title h5">🎓 Visual programming</h2>
+            <p class="card-text">Visual programming, VVVV</p>
+        </div>
+        <p class="px-3 mb-4"><a class="stretched-link" href="visual-programming.md">Start connecting the dots</a></p>
+    </div>
+</div>
+
+<div class="col-md-6">
+    <div class="card h-100">
+        <div class="card-body">
+            <h2 class="card-title h5">🎓 Tools and importers</h2>
+            <p class="card-text">General tools, Asset handling and importer tools</p>
+        </div>
+        <p class="px-3 mb-4"><a class="stretched-link" href="tools-and-importers.md">Import some knowledge</a></p>
+    </div>
+</div>
+
+</div>
diff --git a/en/community-resources/models-and-animations.md b/en/community-resources/models-and-animations.md
@@ -0,0 +1,16 @@
+# Models and Animations
+
+
+## Meshes and Models
+* [Creating a procedural model](https://github.com/tebjan/StrideProceduralModel)
+* [Get Vertices and Indices from a mesh](https://gist.github.com/Doprez/3974122afee1cbddae289e16057026f3)
+* [Procedural Meshes](https://github.com/profan/XenkoByteSized/blob/master/XenkoByteSized/ProceduralMesh/TetrahedronMesh.cs)
+* [LOD implementation](https://github.com/Xisrith/StrideLOD)
+* [Basic Stride LOD system](https://gist.github.com/Doprez/5327fbd7d8c371938088db81d82d153b)
+* [Stride IK implementation](https://github.com/flipdp/Stride.IK/tree/master)
+* [Stride Instancing Example](https://github.com/tebjan/StrideTransformationInstancing)
+* [Super Character Controller](https://github.com/corthax/SuperCharacterController)
+* [Multi*Mesh Shader](https://github.com/profan/XenkoByteSized/blob/master/XenkoByteSized/ProceduralMesh/CombinedMeshes.cs)
+
+## Animation
+* [Animation Trigger script](https://gist.github.com/Doprez/3ff7463fc48bd8e69178fde388dd1df4)
diff --git a/en/community-resources/physics.md b/en/community-resources/physics.md
@@ -0,0 +1,6 @@
+# Physics
+* [Physics constraints demo](https://github.com/manio143/StrideConstraintsDemo)
+* [Bepu physics integration](https://github.com/Nicogo1705/BepuPhysicIntegrationTest/tree/master)
+* [Trigger Example](https://github.com/profan/XenkoByteSized#xenkobytesizedtriggerscene***doorscript)
+* [Vehicle Script](https://github.com/profan/XenkoByteSized#xenkobytesizedvehiclescene***vehiclescript)
+* [XenkoRotatingSun](https://github.com/SuavePirate/Xenko.RotatingSun) * Rotating Sun
diff --git a/en/community-resources/rendering-and-camera.md b/en/community-resources/rendering-and-camera.md
@@ -0,0 +1,34 @@
+# Rendering and Camera
+
+## Rendering
+* [Debug shape render](https://github.com/Doprez/Stride.DebugShapes)
+  * [Old: Debug shape render](https://github.com/profan/XenkoDebugRendering/tree/master/DebugRendering)
+* [Fog Of War](https://github.com/herocrab/StrideFogOfWarPlus)
+* [Stride Outline Renderer](https://github.com/SoulRider/StrideOutlineRenderer)
+* [XenkoByteSized](https://github.com/profan/XenkoByteSized) * Various Procedural Renderings
+* [ShaderExplorerForStride](https://github.com/tebjan/Stride.ShaderExplorer/releases) * Explore Stride source shader implementations
+* [FlowingWater](https://github.com/TomGroner/XenkoFlowingWater) * Flowing water shader implementation
+* [VoxelGIPrototype](https://github.com/WhyPenguins/XenkoVoxelGI) * VXGI inspired Global Illumination shaders (merged as of Stride v4beta2)
+* [XenkoVoxelExample](https://github.com/jason*wilmans/XenkoVoxelExample) * minecraft like voxel brick world
+* [CustomRootRenderer](https://github.com/tebjan/Xenko.CustomRootRenderFeature) * Render custom shaders correctly into a scene
+* [StrideFogOfWarPlus](https://github.com/herocrab/StrideFogOfWarPlus) * Moba/Platformer/RTS FogOfWar System (no LoS)
+* [StrideTriplanarShader](https://github.com/herocrab/StrideTriplanarShader) * Triplanar Shader for Stride
+* [StrideMeshOutlineRenderFeature](https://github.com/herocrab/StrideMeshOutlineRenderFeature) * Mesh Outline Render Feature
+* [Object Info Render Target Example](https://github.com/Basewq/XenkoProofOfConcepts/tree/master/ObjectInfoRenderTargetExample) * Renders object information onto a render target
+* [Screen Space Decal Example](https://github.com/Basewq/XenkoProofOfConcepts/tree/master/ScreenSpaceDecalExample) * Screen space projected decal system
+* [Screen Space Decal Root Renderer Example](https://github.com/Basewq/XenkoProofOfConcepts/tree/master/ScreenSpaceDecalRootRendererExample) * Screen space projected decal system using RootRenderFeature
+* [TR.Stride](https://github.com/johang88/TR.Stride)
+    * TR.Stride.Atmosphere * Implementation of UE4 atmosphere rendering
+    * TR.Stride.Ocean * Ocean Water rendering
+    * TR.Stride.Terrain* Height Map Terrain
+    * TR.Stride.Gameplay * Manage savegames
+* [UnrealMotion](https://github.com/ykafia/UnrealMotion) * Unreal engine motion blur for Stride
+
+## Camera
+* [Camera controller](https://github.com/herocrab/StrideCameraController)
+* [XenkoByteSized](https://github.com/profan/XenkoByteSized) * Split Screen
+* [Stride3dSplitScreen](https://github.com/spasarto/Stride3dSplitScreen) * Another Split Screen
+* [StrideCameraController](https://github.com/herocrab/StrideCameraController) * Swapping Cameras/Resident Evil Style
+* [CameraFollow.cs](https://gist.github.com/ykafia/371b310de1ba7bb8ab3d2feffce2a190)
+* [SplitScreen](https://github.com/profan/XenkoByteSized#xenkobytesizedsplitscreen)
+