nonsensical-dev/zenyx-engine
nonsensical-dev/zenyx-engine
3
0
Fork 2
Code Issues 6 Pull requests 1 Projects 1 Releases Activity Actions

update main readme and add readme for Zephyr

Browse source
This commit is contained in:
Chance 2024-12-03 14:22:27 -05:00 • committed by BitSyndicate
parent a8c8a8c468
commit 921c925fcf
Signed by: bitsyndicate
GPG key ID: 443E4198D6BBA6DE
2 changed files with 69 additions and 45 deletions
Download patch file Download diff file Expand all files Collapse all files

92
README.md
View file

@ -12,39 +12,49 @@
--- ---
## What is zenyx? # What is zenyx?
Zenyx is a game engine built on top of [wgpu](https://github.com/gfx-rs/wgpu) Zenyx is a game engine built on top of [wgpu](https://github.com/gfx-rs/wgpu)
and [winit](https://github.com/rust-windowing/winit). It is designed to be an and [winit](https://github.com/rust-windowing/winit). It is designed to be an
intuitive and innovative game engine that can both adapt to your workflow and intuitive and innovative game engine that can both adapt to your workflow and
bring new ideas to the table. bring new ideas to the table.
### Features ## Features
> 💡 Note: The following features are goals and are not currently implemented: > 🚀 Note: The following features are goals and are not currently implemented:
> Zenyx > Zenyx
_**Zenyx aims to provide:**_ ### **Zenyx aims to provide:**
- **Cross platform support** - Windows, Linux and macOS support - ✨ **Cross platform support** - Windows, Linux and macOS support
- **Support for multiple renderers** - Zenyx can use Vulkan. OpenGL, and - 🎮 **Support for multiple renderers** - Zenyx can use Vulkan. OpenGL, and
DirectX. In both 2D and 3D DirectX. In both 2D and 3D
- **Safe Performance** - Written in Rust for speed and safety - ⚡ **Safe Performance** - Written in Rust for speed and safety
- **Intuitive Design** - User-friendly workflows and highly extensible tools - 🎯 **Intuitive Design** - User-friendly workflows and highly extensible tools
- **Flexible Scripting** - Easy to use scripting language without sacrificing - 📝 **Flexible Scripting** - Easy to use scripting language without sacrificing
performance performance
- **Extensible Architecture** - Modular design for easy customization - 🔧 **Extensible Architecture** - Modular design for easy customization
- **Fully Featured Toolset** - Built in tools for playing spatial audio and - 🛠️ **Fully Featured Toolset** - Built in tools for playing spatial audio and
level editing level editing
- **Real-time Editor** - Live preview and Incredible User experience - 🖥️ **Real-time Editor** - Live preview and Incredible User experience
- **Asset Management** - Efficient resource handling system - 📦 **Asset Management** - Efficient resource handling system
- **Physics Integration** - Built-in physics simulation - 🎲 **Physics Integration** - Built-in physics simulation
- **Improved Scene Management** - Flexible scene organization tools - 🗂️ **Improved Scene Management** - Flexible scene organization tools
## Star history ⭐
<a href="https://star-history.com/#Caznix/Zenyx&Date">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=Caznix/Zenyx&type=Date&theme=dark" />
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=Caznix/Zenyx&type=Date" />
<img alt="Star History Chart" src="https://api.star-history.com/svg?repos=Caznix/Zenyx&type=Date" />
</picture>
</a>
## FAQ ## FAQ
<details> <details>
<summary>What platforms does Zenyx support?</summary> <summary><b>What platforms does Zenyx support?</b></summary>
Zenyx primarily supports Windows and Linux, with secondary support for macOS Zenyx primarily supports Windows and Linux, with secondary support for macOS
(requires MoltenVK). See the (requires MoltenVK). See the
@ -54,7 +64,7 @@ information.
</details> </details>
<details> <details>
<summary>Is Zenyx ready for production use?</summary> <summary><b>Is Zenyx ready for production use?</b></summary>
Zenyx is currently in early development and is not yet ready for any simple use Zenyx is currently in early development and is not yet ready for any simple use
cases, but we're working hard to make it the best it can be before we release cases, but we're working hard to make it the best it can be before we release
@ -64,7 +74,7 @@ the [contribution section](CONTRIBUTING.md) for the ways you can help.
</details> </details>
<details> <details>
<summary>How can I contribute to Zenyx?</summary> <summary><b>How can I contribute to Zenyx?</b></summary>
We welcome contributions! Please check our contribution guidelines and open a We welcome contributions! Please check our contribution guidelines and open a
pull request on GitHub, if you arent a developer, you can also report bugs or pull request on GitHub, if you arent a developer, you can also report bugs or
@ -74,7 +84,7 @@ For more information, please see the [Contributing section](#contributing).
</details> </details>
<details> <details>
<summary>What are the system requirements?</summary> <summary><b>What are the system requirements?</b></summary>
Detailed system requirements will be provided as the engine matures. Currently, Detailed system requirements will be provided as the engine matures. Currently,
the only requirement is a modern OS and a system with atleast a semi-recent GPU. the only requirement is a modern OS and a system with atleast a semi-recent GPU.
@ -82,28 +92,32 @@ the only requirement is a modern OS and a system with atleast a semi-recent GPU.
</details> </details>
<details> <details>
<summary>Is Zenyx free to use?</summary> <summary><b>Is Zenyx free to use?</b></summary>
Yes, Zenyx is open-source software licensed under MIT. You can Modify, Yes, Zenyx is open-source software licensed under MIT. You can Modify,
Distribute, and use Zenyx for any purpose you wish. Distribute, and use Zenyx for any purpose you wish.
</details> </details>
### What platforms will be supported? ## What platforms will be supported in the future?
| Platform | Support Priority | Status | Notes | | Platform | Support Priority | Status | Notes |
| ---------- | ---------------- | ------ | -------------------------------------------------------------------------------------------- | | :--------: | :--------------: | :----: | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Windows | Primary | ✅ | | | Windows | Primary | ✅ | |
| Linux/*BSD | Primary | ✅ | | | Linux/*BSD | Primary | ✅ | |
| macOS | Secondary | 🌋 | Requires MoltenVK for both editor and exported games due to Wgpu's lack of support for Metal | | macOS | Secondary | 🌋 | Requires MoltenVK for both editor and exported games due to Wgpu's lack of support for Metal |
| Android | TBD | ❓ | |
| iOS | TBD | ❓+🌋 | |
| Web | TBD | ❓ | |
| Consoles | Not planned | ⛔ | Consoles require specific dev kits,proprietary licenses, and substantial fees that we (Caznix & the open source contributors) currently do not have the capacity for. This may change in the future but most likely will not be soon. |
## Documentation # Documentation
### Getting Started ## Getting Started
Zenyx is not yet ready to be used but this may change in the near future. Zenyx is not yet ready to be used but this may change in the near future.
## Contributing # Contributing
We welcome contributions of any kind! If you're interested in contributing, We welcome contributions of any kind! If you're interested in contributing,
please check out our CONTRIBUTING.md file for coding standards and guidelines. please check out our CONTRIBUTING.md file for coding standards and guidelines.
@ -115,39 +129,39 @@ documentation.
If you would like to contribute code to Zenyx, follow the instructions below for If you would like to contribute code to Zenyx, follow the instructions below for
your platform: your platform:
### Prerequisites (all platforms) ## Prerequisites (all platforms)
0. Install [Rust](https://www.rust-lang.org/tools/install) 0. Install [Rust](https://www.rust-lang.org/tools/install)
1. Install [git](https://git-scm.com/downloads) 1. Install [git](https://git-scm.com/downloads)
### Building ## Building
**1**. Clone the repository: **1**. Clone the repository:
```bash git clone https://github.com/Caznix/Zenyx.git
git clone https://github.com/Caznix/Zenyx.git
```
**2**. cd into the project directory **2**. cd into the project directory
```bash cd ./Zenyx
cd ./Zenyx
```
**3**. Build the project **3**. Build the project
```bash cargo run
cargo run
```
### macOS ## macOS
⚠️ as of this current time, we do not have any macOS contributors to write this ⚠️ as of this current time, we do not have any macOS contributors to write this
guide, so follow the [General](#building) instructions and try to fill in the guide, so follow the [General](#building) instructions and try to fill in the
gaps, you can also ask questions on the [Discord]() gaps, you can also ask questions on the [Discord]()
## Press kit ## Subcrates
Zenyx is split into multiple crates to make it easier to maintain and update, you can find the crates in the `subcrates` directory, each crate has its own README file so you can find more information for each crate there. Here is a list of the crates:
* [Zephyr (ECS)](subcrates/zephyr/README.md)
* Aims to provides a lightweight and boilerplate-free ECS framework for modular game development.
# Press kit
## Typefaces ## Typefaces
Main typeface Main typeface
@ -157,3 +171,5 @@ Main typeface
## Colored badges ## Colored badges
<img src="assets/Badge.png" width="100" alt="Zenyx Logo"> <img src="assets/Badge.png" width="100" alt="Zenyx Logo">

8
subcrates/zephyr/README.md Normal file
View file

@ -0,0 +1,8 @@
# Zephyr ECS<div align="center">
🚧 **Work In Progress** 🚧
This README is currently under construction. Please check back later for more detailed information about the project.
</div>