-
-
- JS -
- -
- -
- -
- -
- -
an open source voxel game building toolkit for modern web browsers
- --
-
- About -
- Examples -
- Modules -
- How -
- - Follow @voxeljs - -
- - #voxel.js on freenode - -
diff --git a/index.html b/index.html index e66c930..cdeb927 100644 --- a/index.html +++ b/index.html @@ -2,199 +2,204 @@ - + + + +
- - -voxel.js is a collection of projects that make it easier than ever to - create 3D voxel games like Minecraft all in the browser.
-It was written by @maxogden and @substack, two non-game developers that want to make voxel games easy, fun and modular, but is now collectively maintained by nearly 100 contributors.
- -Here is a presentation from May 2013 that covers all the exciting stuff that happened in voxel.js land up to that point.
-Also definitely read this great blog post about Voxel.js in 2014 by @deathcap
-All of the code is open source! If you find bugs or have ideas for improvements please open issues for them on the related github project, or better yet send code or write new modules. - -
voxel.js games require a computer that can run WebGL, the HTML5 3D graphics - engine. Visit get.webgl.org to see if your - current browser supports it. Chrome version 23 or above or Firefox version - 17 or above are recommended.
- -Click on the screenshots below to run the demos in your browser:
- -Instead of making a giant game framework we instead decided to split voxel.js - up into a bunch of small building blocks (modules). Modules can be installed - with npm, the package manager from node.js. - Here are some modules that we have already started working on:
- -There are around 200 addons for voxel.js published on NPM, here are live search results for all the modules on NPM with word 'voxel' in the title/description:
- -Here is a handy video screencast from @shamakry that will teach you how to get started in under 10 minutes:
- -If you don't wanna watch a video you can follow these instructions instead:
-To use the voxel.js modules you will need to install node.js (which - will also install npm) and be able to use your computer's command line.
-Once node.js is installed, you can install the basic voxel.js npm package in your project directory, and then install a basic texture pack. Make a file called package.json
in your project directory and give it these contents:
+ ++- + ++ + ++ +voxel.js++++
+- JS +
- +
- +
- +
- +
- +
an open source voxel game building toolkit for modern web browsers
+ ++
+ + +- About
+- Examples
+- Modules
+- How
+- + Follow @voxeljs +
+- + #voxel.js on freenode +
++ + ++
About
+voxel.js is a collection of projects that make it easier than ever to + create 3D voxel games like Minecraft all in the browser.
+It was written by @maxogden and @substack, two non-game developers that want to make voxel games easy, fun and modular, but is now collectively maintained by nearly 100 contributors.
+ +Watch
+Here is a presentation from May 2013 that covers all the exciting stuff that happened in voxel.js land up to that point.
+Also definitely read this great blog post about Voxel.js in 2014 by @deathcap
+Contribute
+All of the code is open source! If you find bugs or have ideas for improvements please open issues for them on the related github project, or better yet send code or write new modules. + +
+ + +Examples
+voxel.js games require a computer that can run WebGL, the HTML5 3D graphics + engine. Visit get.webgl.org to see if your + current browser supports it. Chrome version 23 or above or Firefox version + 17 or above are recommended.
+ +Click on the screenshots below to run the demos in your browser:
+ ++++++ view source on github +
+++ view source on github +
+++ view source on github +
+++ view source on github +
+++ view source on github +
+++ view source on github +
+++ view source on github +
+++ view source on github +
+++ view source on github +
+++ view source on github +
+++ view source on github +
+++ view source on github +
+++ + view source on github + +
+++ view source on github +
++ ++ view source on github +
+++ view source on github +
+++ view source on github +
+++ view source on github +
+ + +Components
+Instead of making a giant game framework we instead decided to split voxel.js + up into a bunch of small building blocks (modules). Modules can be installed + with npm, the package manager from node.js. + Here are some modules that we have already started working on:
+ +The Core
++
+- voxel-engine +
- this is the main module for building voxel games - you can plug any voxel module into the engine. read the readme for a great overview of what is possible with voxel.js
+ +Add-ons
+++ +There are around 200 addons for voxel.js published on NPM, here are live search results for all the modules on NPM with word 'voxel' in the title/description:
+ ++ + +Tools & Utilities
+ ++ Voxel Builder ++voxel object/creature editor that runs in your browser and lets you save/export/share your creation++ -Making your first game
+Making a game from the command line
+Here is a handy video screencast from @shamakry that will teach you how to get started in under 10 minutes:
+ +If you don't wanna watch a video you can follow these instructions instead:
+To use the voxel.js modules you will need to install node.js (which + will also install npm) and be able to use your computer's command line.
+Once node.js is installed, you can install the basic voxel.js npm package in your project directory, and then install a basic texture pack. Make a file called
+package.json
in your project directory and give it these contents:-{ "name": "mygamename", @@ -204,241 +209,240 @@
Making a game from the command line
} }Now you can tell node to install your dependencies:
-+Now you can tell node to install your dependencies:
+-$ npm install
Next, create mygame.js and put the following code in it:
-+Next, create mygame.js and put the following code in it:
+-var createGame = require('voxel-hello-world') var game = createGame()
Then to build your game you use browserify:
-+Then to build your game you use browserify:
+-$ npm install browserify -g $ browserify mygame.js -o builtgame.js
Load builtgame.js into a web page:
-<!doctype html> +
Load builtgame.js into a web page:
+-<!doctype html> <html> <body> <script src="builtgame.js"></script> </body> </html>
Now you should be able to play your game by opening up index.html in your browser.
-There are API docs in the voxel-engine readme
-- +Get Involved
-Here are some ways to learn and/or get involved with voxel.js:
-- Resources
--
- Voxel.js website: http://voxeljs.com +
Now you should be able to play your game by opening up index.html in your browser.
+There are API docs in the voxel-engine readme
++ -Get Involved
+Here are some ways to learn and/or get involved with voxel.js:
++ Resources
++
-- Voxel.js website: http://voxeljs.com -
-- Write voxel.js apps in your browser: http://creator.voxeljs.com +
+- Write voxel.js apps in your browser: http://creator.voxeljs.com -
-- Find voxel modules: https://npmjs.org/search?q=voxel +
+- Find voxel modules: https://npmjs.org/search?q=voxel -
-- Design a voxel creature: http://voxelbuilder.com/ +
+- Design a voxel creature: http://voxelbuilder.com/ -
-- Voxel.js development how-to screencast (OS X): http://www.youtube.com/watch?v=khWOLOL2SzA +
+- Voxel.js development how-to screencast (OS X): http://www.youtube.com/watch?v=khWOLOL2SzA -
-- Voxel.js development how-to (article): https://gist.github.com/maxogden/5147486 +
+- Voxel.js development how-to (article): https://gist.github.com/maxogden/5147486 -
-- Voxel.js logos: http://voxeljs.com/voxeljs-logos.png +
+- Voxel.js logos: http://voxeljs.com/voxeljs-logos.png -
-- Basics of Three.js: http://fhtr.org/BasicsOfThreeJS/ +
+- Basics of Three.js: http://fhtr.org/BasicsOfThreeJS/ -
-- Great book on artistic/algorithmic coding: http://natureofcode.com/ +
+- Great book on artistic/algorithmic coding: http://natureofcode.com/ -
-- Have an idea? Ask a question or discuss things at https://github.com/voxel/issues +
+- Have an idea? Ask a question or discuss things at https://github.com/voxel/issues -
-- BlockPlot: Voxel.js hosting service (still in beta): http://blockplot.com +
+- BlockPlot: Voxel.js hosting service (still in beta): http://blockplot.com -
-- How our voxel rendering works: http://0fps.wordpress.com/2012/06/30/meshing-in-a-minecraft-game/ +
+- How our voxel rendering works: http://0fps.wordpress.com/2012/06/30/meshing-in-a-minecraft-game/ -
-- Learn about shaders: http://www.html5rocks.com/en/tutorials/webgl/shaders/ and - examples at: https://www.shadertoy.com/ +
+- Learn about shaders: http://www.html5rocks.com/en/tutorials/webgl/shaders/ and + examples at: https://www.shadertoy.com/ -
-- Repositories you can hack on
+ + ++ Repositories you can hack on
--
- P2P 2 player multiplayer: https://github.com/maxogden/ludum-dare-26 +
+
-- P2P 2 player multiplayer: https://github.com/maxogden/ludum-dare-26 -
-- Node.js multiplayer server: https://github.com/maxogden/voxel-server and - client: https://github.com/maxogden/voxel-client - -
-- Voxel walk animation: https://github.com/flyswatter/voxel-walk +
+- Node.js multiplayer server: https://github.com/maxogden/voxel-server and + client: https://github.com/maxogden/voxel-client -
-- Load a minecraft world: https://github.com/maxogden/mca2js - -
-- Minecraft items: https://github.com/maxogden/minecraft-blockinfo - -
-- Store voxel worlds in IndexedDB: https://github.com/maxogden/voxel-level - -
-- Voxel virus (with a minimal voxel water demo): https://github.com/shama/voxel-virus - -
-- Voxel 3D bulk selections: https://github.com/maxogden/voxel-select - -
-- https://github.com/maxogden/gifblocks -
-- Voxel GIF animation studio: https://github.com/maxogden/gifblocks - -
-- Implement a voxel monster loader for: https://github.com/maxogden/voxel-mobs - -
-- 3D City Loader: https://github.com/maxogden/voxel-city - -
-- Player physics and movement (needs some tweaking): https://github.com/maxogden/voxel-physical, - https://github.com/maxogden/kb-controls, https://github.com/maxogden/voxel-player and - https://github.com/chrisdickinson/voxel-control/blob/master/index.js -
-- Voxel drone: https://github.com/shama/voxel-drone - -
-- Voxel script gun: https://github.com/maxogden/voxel-script-gun - -
-- Mobile/touch controls: https://github.com/voxel/issues/issues/2 - -
-- Voxel world function: https://github.com/maxogden/voxel-world-function - -
-- Real Voxel Physics: https://github.com/timoxley/voxel-real-physics - -
-- Minecraft Multiplayer Bot Visualizer: https://github.com/vogonistic/mineflayer-voxel - -
-- Voxel color post processors: http://hughsk.github.io/voxel-colorist/demo/ - -
-- Day/Night/Moon cycles: https://github.com/shama/voxel-sky - -
-- Portal Gun: https://github.com/shama/voxel-portal-gun - -
-- New Project Ideas
- --
-- Documenting the core API - -
-- Transparent textures (water, glass) - drawing the blocks behind them
-- Water - flow, swimming/buoyancy
-- IRC integration
-- UI-based block-type/material manager, upload + manage textures, add new - block types
-- Inventory + toolbelt customizer
-- voxeljs as a data visualizer (like http://archiveroom.net/) - or file-browser (http://www.youtube.com/watch?v=dFUlAQZB9Ng)
-- in-browser Package Management for voxel-creator using - NPM. See https://github.com/grncdr/browserify-as-a-service/issues - -
-- Critter builder + AI builder + voxel-critter + - voxel-painter -
-- Biome-based Terrain generation
-- Castle defense multiplayer game!
-- Music visualization/VJ software e.g. https://twitter.com/voxeljs/status/304420023550738432 - -
-- Get Voxel.js running on the Raspberry Pi via Firefox OS http://www.philipp-wagner.com/blog/2013/04/firefox-os-for-raspberry-pi-now-available/ - -
-- Bones, IK solver. Apply animations to meshes preferably BVH
-- Voxel base strategy games or chess
-- Leveling, experience or points system
-- Player/item stats (hp, str, stam, dex... think DnD, MTG, etc)
-- For more modules check out these voxel.js contributors on NPM
- --
-- https://npmjs.org/~mikolalysenko -
-- https://npmjs.org/~maxogden -
-- https://npmjs.org/~shama -
-- https://npmjs.org/~substack -
-- https://npmjs.org/~hughsk -
-- https://npmjs.org/~chrisdickinson -
-More!
-The 0fps blog posts on voxel meshing by @mikolalysenko are the reason voxel.js exists. Highly recommended reading! Definitely check out the meshing toolbox.
-mr. doob and three.js are what voxel.js is built on top of.
-webgl-meincraft is a great tech demo that showed a lot of this can be done in a browser
-Jonas Wagner made a killer demo and gave a great talk about Voxel Worlds on the web that helped to inspire this project.
- -- - -Fan Art
-Here are some of the wonderful things users have made with their voxel worlds. Tweet @voxeljs or email max@maxogden.com your photo to submit your art!
--- -- by @jllord -
--- voxeljs logos, BSD licensed by @jllord -
The 0fps blog posts on voxel meshing by @mikolalysenko are the reason voxel.js exists. Highly recommended reading! Definitely check out the meshing toolbox.
+mr. doob and three.js are what voxel.js is built on top of.
+webgl-meincraft is a great tech demo that showed a lot of this can be done in a browser
+Jonas Wagner made a killer demo and gave a great talk about Voxel Worlds on the web that helped to inspire this project.
+ +Here are some of the wonderful things users have made with their voxel worlds. Tweet @voxeljs or email max@maxogden.com your photo to submit your art!
+