Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/shaoruu/mine.js
:mount_fuji: A voxel world built with JS/TS/RS. (formerly mc.js) (maybe mine.ts? or even mine.rs?)
https://github.com/shaoruu/mine.js
actix ecs engine freshkoala game gamedev javascript mcjs minecraft multiplayer nodejs protobuf rust shaoru shaoruu specs threejs voxel websocket
Last synced: about 2 months ago
JSON representation
:mount_fuji: A voxel world built with JS/TS/RS. (formerly mc.js) (maybe mine.ts? or even mine.rs?)
- Host: GitHub
- URL: https://github.com/shaoruu/mine.js
- Owner: shaoruu
- License: mit
- Created: 2019-08-25T03:08:07.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2024-03-23T03:33:38.000Z (6 months ago)
- Last Synced: 2024-05-23T07:06:26.953Z (4 months ago)
- Topics: actix, ecs, engine, freshkoala, game, gamedev, javascript, mcjs, minecraft, multiplayer, nodejs, protobuf, rust, shaoru, shaoruu, specs, threejs, voxel, websocket
- Language: Rust
- Homepage: https://github.com/voxelize/voxelize
- Size: 86.4 MB
- Stars: 303
- Watchers: 8
- Forks: 31
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## [A BETTER MINEJS](https://github.com/voxelize/voxelize)
MineJS has been rewritten into a customizable fullstack library called [voxelize](https://github.com/voxelize/voxelize)
# [MineJS](http://mine.shaoruu.io/)
MineJS is a multiplayer voxel engine that runs in your browser! (Probably should change the name to MineRS/MineTS)
**Any PRs are welcomed!**
Here's the quick TODO list that we're following: [Link](https://www.notion.so/f61d8c4ce1e245b6aba980adf0f1ea7c?v=77f64c4f1ed342a1b25d8af524cb9da0)
## :dart: Disclaimers
This is purely a passionate project. Although inspired, I have no intention for this game to be affiliated with Minecraft, or any licensed voxel engines. Further, textures and assets used in the game are all licensed for free use. More information can be found in the last section.
## :crown: Motivation
We thought it would be interesting to design a game that is inspired by popular voxel engines such as "Minetest" and "Veloren". With the combination of Rust and TypeScript, we hope to deliver quality graphics and performance, as well as interactive multiplayer game play within a 3D voxel-based environment.
## :camera: Gallery
## :construction_worker: WIP (all help welcomed!)
##### Terrain Generation
##### [Entities (Robot ATM)](https://www.youtube.com/watch?v=zZYVJUPB0xc&t=9s&ab_channel=iantheearl)
## :video_game: Controls
- V: Toggle zoom
- R: Toggle sprint
- T: Toggle chat
- J: Toggle debug
- F: Toggle physics
- C: Toggle perspective
- K: Toggle fullscreen
- Z: Bulk placement
- X: Bulk destruction
- 0-n: Change block placement
- Space: Jump / fly up
- W/A/S/D: Movements
- L-Shift: Fly down
- L-Mouse: Break block
- M-Mouse: Get block of looking
- R-Mouse: Place block
- Tab: Player list
## :ram: Installation
```bash
# go to the folder you save ur projects
cd path/to/folder
# clone the repository
git clone https://github.com/ian13456/mine.js
# cd into mine.js
cd mine.js
# you need yarn for this project
# somewhere here https://classic.yarnpkg.com/en/docs/install/#debian-stable
# after you install yarn, install the dependencies needed
yarn
# next you need cargo watch
cargo install cargo-watch
# next compile protobuf
yarn compile
# next run server
yarn server
# next listen on client changes (separate terminal)
yarn client
# OPEN ANOTHER TERMINAL
yarn watch
# visit localhost:3000
```
### :notebook: Citations
- [Ponderosa Font](https://www.1001fonts.com/ponderosa-font.html) - [Licensed](http://www.fontframe.com/tepidmonkey) for non-commercial and commercial use.
- [Open Source Voxel Textures](https://opengameart.org/content/voxel-pack) - Licensed under OpenGameArt for free use.
- [Flourish Resource Pack](https://www.minecraftforum.net/forums/mapping-and-modding-java-edition/resource-packs/1245961-16x-1-7-4-wip-flourish) - Licensed for free use.
- [Alvoria's Sanity](https://www.minecraftforum.net/forums/mapping-and-modding-java-edition/resource-packs/1243771-alvorias-sanity-1-12-2-no-longer-updating-sorry) - Licensed for free use under the [Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International Public License.](https://www.minecraftforum.net/linkout?remoteUrl=http%253a%252f%252fcreativecommons.org%252flicenses%252fby-nc-sa%252f4.0%252f)
- [Pixel Perfection](https://www.minecraftforum.net/forums/mapping-and-modding-java-edition/resource-packs/1242533-pixel-perfection-now-with-polar-bears-1-11) - Licensed for free use under the [Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International Public License.](https://www.minecraftforum.net/linkout?remoteUrl=http%253a%252f%252fcreativecommons.org%252flicenses%252fby-nc-sa%252f4.0%252f)