Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/dimkauzh/webzen
A Go Game Engine that targets WebAssembly! It's easy and fast!
https://github.com/dimkauzh/webzen
draw drawing engine game game-engine go go-game go-game-engine golang rendering web web-api web-app web-render web-ui webassemby
Last synced: about 12 hours ago
JSON representation
A Go Game Engine that targets WebAssembly! It's easy and fast!
- Host: GitHub
- URL: https://github.com/dimkauzh/webzen
- Owner: dimkauzh
- License: gpl-3.0
- Created: 2023-10-01T20:06:26.000Z (over 1 year ago)
- Default Branch: dev
- Last Pushed: 2023-10-21T17:46:18.000Z (about 1 year ago)
- Last Synced: 2023-10-21T22:29:46.571Z (about 1 year ago)
- Topics: draw, drawing, engine, game, game-engine, go, go-game, go-game-engine, golang, rendering, web, web-api, web-app, web-render, web-ui, webassemby
- Language: Go
- Homepage:
- Size: 88.9 KB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
Webzen
A Go Game Engine that targets WebAssembly!
Webzen is a Go Game Engine that targets WebAssembly, enabling you to build web applications with Go. It helps you build your games easy and fast. This project leverages `syscall/js` to interact with the JavaScript runtime in the browser.
> **Please note that Webzen is currently under high maintenance and is not production-ready.** The project is actively being developed and improved, which is why there is only a `dev` branch available. Its currently in Beta status
## Building
### Prerequisites
Webzen doesnt need anything except Go version that is higher that 1.18. There is no C compiler or anything needed, but we recommend wasmserve to quickly run your code.
### Getting the Go package
Webzen is an ordinary go package, so you can get it using this command:
```bash
go get github.com/dimkauzh/webzen@latest
```
The package is also [available on pkg.go.dev](https://pkg.go.dev/github.com/dimkauzh/webzen).
### How to Run the Example
To run the example provided in this repository, follow these steps:
1. Clone this repository to your local machine:
```shell
git clone github.com/dimkauzh/webzen.git
```
2. Navigate to the project folder:
```shell
cd webzen
```
3. Install needed dependencies:
First, make sure you have Go installed, secondly, run make install to install everything needed:
```shell
make setup
```
4. Build and run the example using make and wasmserve. This will start a local development server at localhost:8080:
```shell
make example
```
Open your web browser and go to http://localhost:8080 to see the example in action.
### Building a Ready Application
To build a production-ready WebAssembly application with Webzen, follow these steps:
Compile your Go code to WebAssembly using the GOOS=js and GOARCH=wasm flags. Replace build_path/file_name.wasm and file_path/file_name.go with your desired output file path and source file, respectively:
```shell
GOOS=js GOARCH=wasm go build -o build_path/file_name.wasm file_path/file_name.go
```
You can then include the generated .wasm file in your web application and load it using JavaScript.
Feel free to explore the example provided in this repository to better understand how Webzen works and how you can create your own Go-powered web applications.
## Documentation
The documentation for Webzen is available at https://github.com/dimkauzh/webzen/wiki
## License
This project is licensed under the GPLv3 License - see the LICENSE file for details.