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

improve formatting

Browse source
This commit is contained in:
Chance 2024-12-02 15:10:17 -05:00 • committed by BitSyndicate
parent 165ec8c9c7
commit 004da12855
Signed by: bitsyndicate
GPG key ID: 443E4198D6BBA6DE
1 changed files with 69 additions and 40 deletions
Download patch file Download diff file Expand all files Collapse all files

109
README.md
View file

@ -2,118 +2,147 @@
<img src="assets/Logo.svg" alt="Zenyx engine" width="250"/>
![Version](https://img.shields.io/badge/version-0.1.0-blue)![License](https://img.shields.io/github/license/Caznix/Zenyx)
![Version](https://img.shields.io/badge/version-0.1.0-blue)
![License](https://img.shields.io/github/license/Caznix/Zenyx)
![Build](https://img.shields.io/github/actions/workflow/status/Caznix/Zenyx/rust.yml?branch=main)
![platform](https://img.shields.io/badge/platform-windows%20%7C%20linux%20%7C%20macos-informational)
</div>
---
## What is zenyx?
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 intuitive and innovative game engine that can both adapt to your workflow and bring new ideas to the table.
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
intuitive and innovative game engine that can both adapt to your workflow and
bring new ideas to the table.
### Features
> 💡 Note: The following features are goals and are not currently implemented:
Zenyx
> Zenyx
***Zenyx aims to provide:***
* **Cross platform support** - Windows, Linux and macOS support
* **Support for multiple renderers** - Zenyx can use Vulkan. OpenGL, and DirectX. In both 2D and 3D
* **Safe Performance** - Written in Rust for speed and safety
* **Intuitive Design** - User-friendly workflows and highly extensible tools
* **Flexible Scripting** - Easy to use scripting language without sacrificing performance
* **Extensible Architecture** - Modular design for easy customization
* **Fully Featured Toolset** - Built in tools for playing spatial audio and level editing
* **Real-time Editor** - Live preview and Incredible User experience
* **Asset Management** - Efficient resource handling system
* **Physics Integration** - Built-in physics simulation
* **Improved Scene Management** - Flexible scene organization tools
_**Zenyx aims to provide:**_
- **Cross platform support** - Windows, Linux and macOS support
- **Support for multiple renderers** - Zenyx can use Vulkan. OpenGL, and
DirectX. In both 2D and 3D
- **Safe Performance** - Written in Rust for speed and safety
- **Intuitive Design** - User-friendly workflows and highly extensible tools
- **Flexible Scripting** - Easy to use scripting language without sacrificing
performance
- **Extensible Architecture** - Modular design for easy customization
- **Fully Featured Toolset** - Built in tools for playing spatial audio and
level editing
- **Real-time Editor** - Live preview and Incredible User experience
- **Asset Management** - Efficient resource handling system
- **Physics Integration** - Built-in physics simulation
- **Improved Scene Management** - Flexible scene organization tools
## FAQ
<details>
<summary>What platforms does Zenyx support?</summary>
Zenyx primarily supports Windows and Linux, with secondary support for macOS (requires MoltenVK). See the [Platform support table](#what-platforms-will-be-supported) for more information.
Zenyx primarily supports Windows and Linux, with secondary support for macOS
(requires MoltenVK). See the
[Platform support table](#what-platforms-will-be-supported) for more
information.
</details>
<details>
<summary>Is Zenyx ready for production use?</summary>
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 1.0. If this interests you and you're interested in helping, please check out the [contribution section](CONTRIBUTING.md) for the ways you can help.
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
1.0. If this interests you and you're interested in helping, please check out
the [contribution section](CONTRIBUTING.md) for the ways you can help.
</details>
<details>
<summary>How can I contribute to Zenyx?</summary>
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 feature requests on our [issue tracker](https://github.com/Caznix/Zenyx/issues). For more information, please see the [Contributing section](#contributing).
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
feature requests on our [issue tracker](https://github.com/Caznix/Zenyx/issues).
For more information, please see the [Contributing section](#contributing).
</details>
<details>
<summary>What are the system requirements?</summary>
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.
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.
</details>
<details>
<summary>Is Zenyx free to use?</summary>
Yes, Zenyx is open-source software licensed under MIT. You can Modify, Distribute, and use Zenyx for any purpose you wish.
Yes, Zenyx is open-source software licensed under MIT. You can Modify,
Distribute, and use Zenyx for any purpose you wish.
</details>
### What platforms will be supported?
| Platform | Support Priority | Status | Notes |
|----------|-----------------|--------|--------|
| Windows | Primary | ✅ | |
| Linux/*BSD | Primary | ✅ | |
| macOS | Secondary | 🌋 | Requires MoltenVK for both editor and exported games due to Wgpu's lack of support for Metal |
| Platform | Support Priority | Status | Notes |
| ---------- | ---------------- | ------ | -------------------------------------------------------------------------------------------- |
| Windows | Primary | ✅ | |
| Linux/*BSD | Primary | ✅ | |
| macOS | Secondary | 🌋 | Requires MoltenVK for both editor and exported games due to Wgpu's lack of support for Metal |
## Documentation
### Getting Started
Zenyx is not yet ready to be used but this may change in the near future.
## 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.
We welcome contributions of any kind! If you're interested in contributing,
please check out our CONTRIBUTING.md file for coding standards and guidelines.
Even if you're not a developer, you can still help tremendously by spreading the word about Zenyx, reporting bugs, suggesting features, or helping improve our documentation.
Even if you're not a developer, you can still help tremendously by spreading the
word about Zenyx, reporting bugs, suggesting features, or helping improve our
documentation.
If you would like to contribute code to Zenyx, follow the instructions below for your platform:
If you would like to contribute code to Zenyx, follow the instructions below for
your platform:
### Prerequisites (all platforms)
0. Install [Rust](https://www.rust-lang.org/tools/install)
1. Install [git](https://git-scm.com/downloads)
### Building
**1**. Clone the repository:
```ps1
git clone https://github.com/Caznix/Zenyx.git
```
**2**.
cd into the project directory
**2**. cd into the project directory
```PS1
cd ./Zenyx
```
**3**. Build the project using the xtask:
```ps1
cargo xtask run core # also use editor for editor, or engine for both
cargo xtask run core # also use editor for editor, or engine for both
```
### macOS
⚠️ 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 gaps, you can also ask questions on the [Discord]()
⚠️ 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
gaps, you can also ask questions on the [Discord]()