1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
|
The BananaBread Engine
======================
A port of the Cube 2/Sauerbraten 3D game engine/first person shooter to the
web, compiling C++ and OpenGL to JavaScript and WebGL using Emscripten.
See the **[FAQ](https://github.com/kripken/BananaBread/wiki/FAQ)**.
Demos
-----
A live demo is available here: **[Stable Demo](https://developer.mozilla.org/demos/detail/bananabread)**
There is a non-stable testing version here: http://dl.dropbox.com/u/80664946/index.html
We also have a silly non-game example, http://www.syntensity.com/static/night14/fireworks.html
Overview
--------
Cube 2 is a compact and efficient 3D game engine. By compiling it
to JavaScript and WebGL you can run a complete first person
shooter in your web browser, using only standard web APIs and
without any plugins.
Features:
* A multitude of visual effects including water reflection/refraction,
parallax mapping, glare, particle effects,
lightmaps, skeletal animation (on gpu), etc. etc.
* Streamlined and quick physics system
* Ragdoll physics
* Bot AI with adjustable skill level
* Integrated in-game editor
* Fast performance both running on the web or natively
* zlib license
The original engine also has a lot of other features not yet
enabled (but will be):
* Multiplayer
* Multiplayer editing
* Shadowmapping
Building
--------
Get emscripten and its dependencies,
http://emscripten.org/
It's recommended to go through the emscripten tutorial to see that it is set
up properly.
You will also need crunch if you want smaller downloads,
http://code.google.com/p/crunch/
Build in crnlib using the Makefile (if it isn't in the release yet, see the
issue filed on their site where we submitted it,
http://code.google.com/p/crunch/issues/detail?id=1 ). You can disable
crunch if you don't want it, remove all mentions of crunch in
`cube2/src/web/Makefile`.
Then do `make` in `cube2/src/web` for a web build. You can also do `make` in
`cube2/src/native` for a native linux build.
If you have any problems building, feel free to file an issue here or to
find us on emscripten IRC (see emscripten site).
See needed.txt for some possibly useful scripts to package the output.
Running
-------
0. Run
python -m SimpleHTTPServer 8888
in cube2/
1. Load localhost:8888 in your browser
Modding
-------
To use maps of your own or make other kinds of changes or additions to the
artwork, see the
**[Modding](https://github.com/kripken/BananaBread/wiki/Modding)**
page.
Debugging
---------
If you append `,debug` to the URL of one of the levels, it will use
`bb.debug.js` instead of `bb.js`. The debug build has not been run
through closure compiler and is much more readable for stack traces
and profiling and so forth.
License
-------
### Code
Code is zlib licensed (just like Sauerbraten):
Copyright (C) 2001-2012 Sauerbraten authors (see cube2/src/readme_source.txt)
and BananaBread authors (see below)
This software is provided 'as-is', without any express or implied
warranty. In no event will the authors be held liable for any damages
arising from the use of this software.
Permission is granted to anyone to use this software for any purpose,
including commercial applications, and to alter it and redistribute it
freely, subject to the following restrictions:
1. The origin of this software must not be misrepresented; you must not
claim that you wrote the original software. If you use this software
in a product, an acknowledgment in the product documentation would be
appreciated but is not required.
2. Altered source versions must be plainly marked as such, and must not be
misrepresented as being the original software.
3. This notice may not be removed or altered from any source distribution.
BananaBread authors:
* Alon Zakai
* Gregor Koch
* Bobby Richter
### Art
All art content in this project (levels/maps, character model, etc.
etc.) is either CC-BY or CC-BY-SA, which means you can use it in
your projects, including commercial ones. If a directory does not
contain a specific license file, then it is new artwork created for
this project, which has the CC-BY license,
http://creativecommons.org/licenses/by/3.0/
and copyright is held by the Mozilla Foundation.
Previously-existing content can also be CC-BY-SA, see license files in
specific directories.
|
