Skip to content

L3P3/minicraft

Repository files navigation

Minicraft

Screenshot

Minecraft, but based on ray tracing and written in JavaScript, following my own rules.

>>> START MINICRAFT <<<

User manual

Heavily inspired by and somewhat based on the work of @xNotch.

TODOs

  • study computer science and math
  • steal idea from @xNotch
  • proof of concept
  • tell everybody about this project
  • get rich
  • annoy everybody with this project
  • new file structure
  • basic component tree
  • basic models
  • basic rasterization
  • key handling
  • settings menu
  • comprehensive readme
  • solve wrong-fps issue
  • world/chunk/player model
  • actual raytracing
  • correct raytracing
  • production build
  • build/destroy
  • persistent user configuration
  • texturing
  • multiple chunks
  • load/save chunks
  • basic mobile view
  • chat/terminal
  • more blocks
  • higher world
  • inventory
  • gamemode
  • multiple worlds
  • download/upload worlds
  • world edit
  • multiplayer
  • sound
  • entity models
  • collision
  • good styled ui
  • good mobile view
  • migrate to typescript?
  • support older browsers
  • time of day
  • sky elements
  • non-cubic blocks
  • visible entities
  • particles
  • multi-threading?
  • use gpu?
  • get a lawyer?

How to use while developing

I highly recommend using Visual Studio Code and the extension "Live Server". Start it via "Go Live" and open "http://localhost:5500/app-dev.html" to see the result.

Build instructions

After cloning, you need to run npm install once to install the build tools.

To bundle the app, run npm run build. The result will be put into the /dist directory and can be tested at "http://localhost:5500/app-prod.html".

My tools

Contribution

I am really happy to answer any questions or getting any kind of feedback. Feel free to open issues or suggest changes by opening a pull request!

License

Just ZLib license, I do not care too much about it.

This game includes slightly modified textures from Minecraft, which is of course owned by Microsoft. Since this is a purely educational project, I deem this fair use.