Home - Forums - Documentation - Gallery - Bugs
(Python Based Example Demos/Games)
Current revision (16:06, 13 September 2010) (edit) (undo)
m (Updated links to blender2crystal)
 
(17 intermediate revisions not shown.)
Line 4: Line 4:
CELstart is an environment for making games using scripting alone (CEL's [[XML script]] or Python). Games are distributed in self-contained packages (so-called ''celzips'') and can be played by the user by simply opening them - whether the user is on Windows, Linux or MacOS/X.
CELstart is an environment for making games using scripting alone (CEL's [[XML script]] or Python). Games are distributed in self-contained packages (so-called ''celzips'') and can be played by the user by simply opening them - whether the user is on Windows, Linux or MacOS/X.
-
While CELstart is included with CEL you can download standalone binaries, so you need neither Crystal Space or CEL (which are included in the binary). You don't even need a C++ compiler to make games for CELstart.
+
While '''CELstart is included with CEL''' you can download standalone binaries, so you need neither Crystal Space or CEL (which are included in the binary). You don't even need a C++ compiler to make games for CELstart.
-
One popular way to make CELstart applications is with [http://www.blender.org Blender] through the [http://b2cs.delcorp.org/ blender2crystal script]. It is possible to make full CELstart games from within Blender.
+
One popular way to make CELstart applications is with [http://www.blender.org Blender] through the [http://leapingcat.org/blender2crystal/index.php/Main_Page blender2crystal script]. It is possible to make full CELstart games from within Blender.
=Documentation=
=Documentation=
-
You can find more information about '''CELStart''' and tools to utilize it on the [http://b2cs.delcorp.org/index.php/Main_Page blender2crystal home page] and in the [http://cel.crystalspace3d.org/cel/docs/online/manual/AppCelstart.html#0 CEL manual]. Start by downloading blender2crystal and don't forget to have a look at the [http://b2cs.delcorp.org/index.php/Documentation#Tutorials tutorials] on this page.
+
You can find more information about '''CELStart''' and tools to utilize it on the [http://leapingcat.org/blender2crystal/index.php/Main_Page blender2crystal home page] and in the [http://cel.crystalspace3d.org/cel/docs/online/manual/AppCelstart.html#0 CEL manual]. Start by downloading blender2crystal and don't forget to have a look at the [http://leapingcat.org/blender2crystal/index.php/Documentation#Tutorials documentation and tutorials] on this page.
=Downloads=
=Downloads=
-
==Latest Release (1.0.1)==
+
== Current Release (1.4.0)==
 +
These are contributed (unofficial, unsupported) builds for CELStart from 1.4.0 release.<br/>
 +
Also include cslight, lighter2, walktest, basemapgen, docconv and bootstrap utilities (viewmesh &amp; python CEGUI support included only in Linux build).
 +
 +
{|border="1" cellspacing="0" cellpadding="2"
 +
! OS
 +
! Arch
 +
! Version
 +
! Link
 +
! MD5 sum
 +
|-
 +
|Linux
 +
|x86
 +
|1.4.0
 +
|Not available yet
 +
|
 +
|-
 +
|Linux
 +
|x86_64
 +
|1.4.0
 +
|[http://{{CSSITE}}/downloads/contrib/celstart-1.4.0-Linux-x86_64.tar.bz2 celstart-1.4.0-Linux-x86_64.tar.bz2] (40Mb)
 +
|[http://{{CSSITE}}/downloads/contrib/celstart-1.4.0-Linux-x86_64.MD5SUM celstart-1.4.0-Linux-x86_64.MD5SUM]
 +
|-
 +
| Windows
 +
| x86
 +
| 1.4.0
 +
| [http://{{CSSITE}}/downloads/contrib/celstart-1.4.0-Windows-x86.zip celstart-1.4.0-Windows.zip] (40Mb)
 +
|[http://{{CSSITE}}/downloads/contrib/celstart-1.4.0-Windows-x86.MD5SUM celstart-1.4.0-Windows-x86.MD5SUM]
 +
|}
 +
 +
==Preview for next release (1.9dev)==
 +
 +
These are contributed (unofficial, unsupported) builds for CELStart from trunk/1.9 SVN branch.<br/>
 +
Also include lighter2, walktest, basemapgen, docconv and bootstrap utilities (viewmesh &amp; python CEGUI support included only in Linux build).
 +
 +
{|border="1" cellspacing="0" cellpadding="2"
 +
! OS
 +
! Arch
 +
! Version
 +
! Revisions
 +
! Link
 +
! MD5 sum
 +
|-
 +
|Linux
 +
|x86
 +
|1.9.0dev
 +
|CS r32172, CEL r3839
 +
|[http://www.crystalspace3d.org/downloads/contrib/celstart-1.9.0-CSr32172-CELr3839-Linux-x86.tar.bz2 celstart-1.9.0-CSr32172-CELr3839-Linux-x86.tar.bz2] (32Mb)
 +
|[http://www.crystalspace3d.org/downloads/contrib/MD5SUMS-32172.3839 MD5SUMS-32172.3839]
 +
|-
 +
|Linux
 +
|x86_64
 +
|1.9.0dev
 +
|CS r32172, CEL r3839
 +
|[http://www.crystalspace3d.org/downloads/contrib/celstart-1.9.0-CSr32172-CELr3839-Linux-x86_64.tar.bz2 celstart-1.9.0-CSr32172-CELr3839-Linux-x86_64.tar.bz2] (41Mb)
 +
|[http://www.crystalspace3d.org/downloads/contrib/MD5SUMS-32172.3839 MD5SUMS-32172.3839]
 +
|}
 +
 +
* [http://crystalspace3d.org/0install/celstart-launcher-1.4.xml Linux (through 0install)]. See below.
 +
 +
Usage:
 +
 +
* See the README file included in the archives.
 +
 +
0install version:
 +
* [http://0install.net/ 0install] is a system to automatically download and update software to your computer. [http://0install.net/injector.html Follow the instructions on the 0install homepage] to set it up. (Note x86_64 users: you need a very recent version of 0install, 0.35 or newer, to run the package. That means you may have to install from source on some distros.) Once this is done follow the instructions from the [http://crystalspace3d.org/0install/celstart-launcher-1.4.xml CELstart link above] to run it.
 +
 +
==Previous Release (1.2.1)==
To get started using CELstart download one of the following binaries:
To get started using CELstart download one of the following binaries:
-
* [http://{{CSSITE}}/downloads/celstart/celstart-v7-win32.zip CELstart Binary for Windows V7 (20 megs)]: download and extract to some directory. No other installation required.
 
-
* [http://{{CSSITE}}/downloads/celstart/1.0.1/CELstart%201.0.1.package CELstart Binary for 32-bit Linux 1.0.1 (15 megs)]: download this and execute to install. See the [http://autopackage.org/docs/howto-install/ autopackage install howto] for more detailed installation instructions.
 
-
'''Important Note:''' Version 3 of CELstart is the first one that works for python scripts. However there is still a limitation. You have to manually set the PYTHONPATH environment variable to point to the zip file (i.e. not the extracted zip file, just the zip file itself) that you want to run. We will try to fix this limitation in the future.
+
* [http://{{CSSITE}}/downloads/contrib/celstart-1.2.1-windows.zip CELStart 1.2.1 binary for Windows (22 Mb)].
 +
* [http://{{CSSITE}}/downloads/contrib/celstart-1.2.1-linux-x86.tar.bz2 CELStart 1.2.1 binary for Linux x86-32bits (21 Mb)].
 +
* [http://{{CSSITE}}/downloads/contrib/celstart-1.2.1-linux-x86_64.tar.bz2 CELStart 1.2.1 binary for Linux x86-64bits (20 Mb)].
 +
* [http://{{CSSITE}}/downloads/contrib/celstart-1.2.1-freebsd6.tar.bz2 CELStart 1.2.1 binary for FreeBSD 6 (24 Mb)].
 +
 
 +
Download and extract to some directory. No other installation required.<br/>
 +
Those binaries have support for Cal3D, ODE, and Python 2.5, but have no support for CEGUI nor Bullet.
 +
 
 +
==Older Releases==
 +
 
 +
=== 1.2 ===
 +
 
 +
* [http://{{CSSITE}}/downloads/celstart/1.2/celstart-v1.2-win32.zip CELstart Binary for Windows 1.2 (21 megs)]: download and extract to some directory. No other installation required.
 +
* [http://{{CSSITE}}/downloads/celstart/1.2/CELstart%201.2.package CELstart Binary for 32-bit Linux 1.2 (15 megs)]: download this and execute to install. See the [http://autopackage.org/docs/howto-install/ autopackage install howto] for more detailed installation instructions.
 +
 
 +
'''Important Note:''' To run celstart with python support you have to manually set the PYTHONPATH environment variable to point to the zip file (i.e. not the extracted zip file, just the zip file itself) that you want to run. We will try to fix this limitation in the future.
 +
 
 +
===1.0.1===
 +
 
 +
The old stable CELstart release can be found here:
 +
* [http://{{CSSITE}}/downloads/celstart/celstart-v7-win32.zip CELstart Binary for Windows V7 (20 megs)].
 +
* [http://{{CSSITE}}/downloads/celstart/1.0.1/CELstart%201.0.1.package CELstart Binary for 32-bit Linux 1.0.1 (15 megs)].
==Xml Based Example Demos/Games==
==Xml Based Example Demos/Games==
Line 27: Line 113:
===ShaderTest===
===ShaderTest===
-
{{ImageTextRight|image=shadertest.jpg|url=[http://{{CSSITE}}/downloads/celstart/shadertest.celzip Download ShaderTest (2.5 megs)]|text=This is a small demo level showing several shaders in action (parallax, specular, bumpmap, glow, ...). Just run it and move around (use the arrow-keys or mousemove). Note that to actually see the shaders in full glory, you need a 3D card that can handle shader fragment programs (most modern 3D cards can do this). If your card cannot handle it, then the shaders will automatically fallback to regular bumpmapping, which is not as nice to look at.}}
+
{{ImageTextRight|image=shadertest.jpg|url=[http://{{CSSITE}}/downloads/celstart/shadertest.celzip Download ShaderTest] (2.5 megs) - [http://www.dailymotion.com/Elalyse/video/x2ic1q_shadertest Video]|text=This is a small demo level showing several shaders in action (parallax, specular, bumpmap, glow, ...). Just run it and move around (use the arrow-keys or mousemove). Note that to actually see the shaders in full glory, you need a 3D card that can handle shader fragment programs (most modern 3D cards can do this). If your card cannot handle it, then the shaders will automatically fallback to regular bumpmapping, which is not as nice to look at.}}
===ParticleTest===
===ParticleTest===
-
{{ImageTextRight|image=xmlparticles.jpg|url=[http://{{CSSITE}}/downloads/celstart/xmlparticles.celzip Download XMLParticles (0.12 megs)]|text=This is a small demo level showing several particle systems in action. Just run it and move around. A lot more effects are possible with particles. These are just examples, to show off what Crystal Space is capable of. Warning: this demo requires at least celstart version 4.}}
+
{{ImageTextRight|image=xmlparticles.jpg|url=[http://{{CSSITE}}/downloads/celstart/xmlparticles.celzip Download XMLParticles] (0.12 megs) - [http://www.dailymotion.com/Elalyse/video/x2ic5z_particletest Video]|text=This is a small demo level showing several particle systems in action. Just run it and move around. A lot more effects are possible with particles. These are just examples, to show off what Crystal Space is capable of. Warning: this demo requires at least celstart version 4.}}
===Castle===
===Castle===
-
{{ImageTextRight|image=castle.jpg|url=[http://{{CSSITE}}/downloads/celstart/castle.celzip Download Castle (3.4 megs)]|text=Here you see the castle level from Anders Wisur (indoor version). Just run it and move around. Note that this level uses parallax shaders. If your hardware cannot handle this, then Crystal Space will automatically switch to bumpmapping. Warning: this demo requires at least celstart version 4.}}
+
{{ImageTextRight|image=castle.jpg|url=[http://{{CSSITE}}/downloads/celstart/castle.celzip Download Castle] (3.4 megs) - [http://www.dailymotion.com/Elalyse/video/x2ibut_castle Video]|text=Here you see the castle level from Anders Wisur (indoor version). Just run it and move around. Note that this level uses parallax shaders. If your hardware cannot handle this, then Crystal Space will automatically switch to bumpmapping. Warning: this demo requires at least celstart version 4.}}
===Bouncy===
===Bouncy===
-
{{ImageTextRight|image=bouncy.jpg|url=[http://{{CSSITE}}/downloads/celstart/bouncy.celzip Download Bouncy (1.3 megs)]|text=Bouncy is a small demo written in XML. It features physics (using ODE). It resembles a pinball game a bit except that you can edit the level. It is certainly not a finished game but it can be used as the basis for one.}}
+
{{ImageTextRight|image=bouncy.jpg|url=[http://{{CSSITE}}/downloads/celstart/bouncy.celzip Download Bouncy] (1.3 megs) - [http://www.dailymotion.com/Elalyse/video/x2ic7k_bouncy Video]|text=Bouncy is a small demo written in XML. It features physics (using ODE). It resembles a pinball game a bit except that you can edit the level. It is certainly not a finished game but it can be used as the basis for one.}}
===CrystalDash===
===CrystalDash===
-
{{ImageTextRight|image=crystaldash.jpg|url=[http://{{CSSITE}}/downloads/celstart/crystaldash.celzip Download CrystalDash (0.2 megs)]|text=CrystalDash is a boulderdash clone written in XML. This is an example of a 2D game done using CelStart. It features a built-in level editor, sound, and a lot of nice objects to use in the levels. However it is not finished. You cannot die yet for example.}}
+
{{ImageTextRight|image=crystaldash.jpg|url=[http://{{CSSITE}}/downloads/celstart/crystaldash.celzip Download CrystalDash] (0.2 megs) - [http://www.dailymotion.com/Elalyse/video/x2icai_crystaldash Video]|text=CrystalDash is a boulderdash clone written in XML. This is an example of a 2D game done using CelStart. It features a built-in level editor, sound, and a lot of nice objects to use in the levels. However it is not finished. You cannot die yet for example.}}
===PhysicsDemo===
===PhysicsDemo===
-
{{ImageTextRight|image=physicsdemo.jpg|url=[http://{{CSSITE}}/downloads/celstart/physicsdemo.celzip Download PhysicsDemo (1 megs)]|text=PhysicsDemo is a simple demonstration of physics (using ODE) written in XML. Just collide the actor (a ball) against the objects in the scene to make them fall over. Note: this demo uses parallax shader and may run slower on older hardware due to that.}}
+
{{ImageTextRight|image=physicsdemo.jpg|url=[http://{{CSSITE}}/downloads/celstart/physicsdemo.celzip Download PhysicsDemo] (1 megs) - [http://www.dailymotion.com/Elalyse/video/x2ic3q_physicsdemo Video]|text=PhysicsDemo is a simple demonstration of physics (using ODE) written in XML. Just collide the actor (a ball) against the objects in the scene to make them fall over. Note: this demo uses parallax shader and may run slower on older hardware due to that.}}
===CelDemo===
===CelDemo===
-
{{ImageTextRight|image=celdemo.jpg|url=[http://{{CSSITE}}/downloads/celstart/celdemo.celzip Download CelDemo (7.8 megs)]|text=CelDemo is the old celdemo level featuring automatic doors, moving platforms, lights you can turn on and off and some other things. This level is a good demonstration of the kind of logic you can do with Crystal Entity Layer. However it is a bit dated now and doesn't use any of the more modern shaders.}}
+
{{ImageTextRight|image=celdemo.jpg|url=[http://{{CSSITE}}/downloads/celstart/celdemo.celzip Download CelDemo] (7.8 megs) - [http://www.dailymotion.com/related/4214807/video/x2icl4_celdemo_creation Video]|text=CelDemo is the old celdemo level featuring automatic doors, moving platforms, lights you can turn on and off and some other things. This level is a good demonstration of the kind of logic you can do with Crystal Entity Layer. However it is a bit dated now and doesn't use any of the more modern shaders.}}
===Jammer - The Gardener===
===Jammer - The Gardener===
-
{{ImageTextRight|image=jammer.jpg|url=[http://downloads.sourceforge.net/jammers/Jammer-TheGardener-1.0.celzip Download (17 megs)]|text=Live the life of a aspiring gardener on his quest through several highly dynamic environments spanning the world of Jammer T. The aim of the game is to fight off slugs and wasps that are intent on attacking your garden using the colour coded weapons.}}
+
{{ImageTextRight|image=jammer.jpg|url=[http://downloads.sourceforge.net/jammers/Jammer-TheGardener-1.0.celzip Download (17 megs)]|text=Live the life of a aspiring gardener on his quest through several highly dynamic environments spanning the world of Jammer T. The aim of the game is to fight off slugs and wasps that are intent on attacking your garden using the colour coded weapons.
 +
 
 +
'''Important Note:''' Requires CEL trunk, or you just have to wait until the next celstart release.}}
==Python Based Example Demos/Games==
==Python Based Example Demos/Games==
Line 55: Line 143:
===PyCelStartDemo===
===PyCelStartDemo===
{{ImageTextRight|image=pycelstartdemo.jpg|url=[http://carletronicon.googlepages.com/pycelstartdemo.celzip Download PyCelStartDemo (1.8 megs)]|text=This is a small python based demo level; more functionality to be added at some point.}}
{{ImageTextRight|image=pycelstartdemo.jpg|url=[http://carletronicon.googlepages.com/pycelstartdemo.celzip Download PyCelStartDemo (1.8 megs)]|text=This is a small python based demo level; more functionality to be added at some point.}}
 +
(Note: the latest version of CELstart (1.2) doesn't like some of my code / xml; most is just warnings that I'm using deprecated functions but there's also a keyword in my world that has been removed; will post updated version as soon as I have a chance to test things running under windows)

Current revision

Contents

Introduction

CELstart is an environment for making games using scripting alone (CEL's XML script or Python). Games are distributed in self-contained packages (so-called celzips) and can be played by the user by simply opening them - whether the user is on Windows, Linux or MacOS/X.

While CELstart is included with CEL you can download standalone binaries, so you need neither Crystal Space or CEL (which are included in the binary). You don't even need a C++ compiler to make games for CELstart.

One popular way to make CELstart applications is with Blender through the blender2crystal script. It is possible to make full CELstart games from within Blender.

Documentation

You can find more information about CELStart and tools to utilize it on the blender2crystal home page and in the CEL manual. Start by downloading blender2crystal and don't forget to have a look at the documentation and tutorials on this page.

Downloads

Current Release (1.4.0)

These are contributed (unofficial, unsupported) builds for CELStart from 1.4.0 release.
Also include cslight, lighter2, walktest, basemapgen, docconv and bootstrap utilities (viewmesh & python CEGUI support included only in Linux build).

OS Arch Version Link MD5 sum
Linux x86 1.4.0 Not available yet
Linux x86_64 1.4.0 celstart-1.4.0-Linux-x86_64.tar.bz2 (40Mb) celstart-1.4.0-Linux-x86_64.MD5SUM
Windows x86 1.4.0 celstart-1.4.0-Windows.zip (40Mb) celstart-1.4.0-Windows-x86.MD5SUM

Preview for next release (1.9dev)

These are contributed (unofficial, unsupported) builds for CELStart from trunk/1.9 SVN branch.
Also include lighter2, walktest, basemapgen, docconv and bootstrap utilities (viewmesh & python CEGUI support included only in Linux build).

OS Arch Version Revisions Link MD5 sum
Linux x86 1.9.0dev CS r32172, CEL r3839 celstart-1.9.0-CSr32172-CELr3839-Linux-x86.tar.bz2 (32Mb) MD5SUMS-32172.3839
Linux x86_64 1.9.0dev CS r32172, CEL r3839 celstart-1.9.0-CSr32172-CELr3839-Linux-x86_64.tar.bz2 (41Mb) MD5SUMS-32172.3839

Usage:

  • See the README file included in the archives.

0install version:

  • 0install is a system to automatically download and update software to your computer. Follow the instructions on the 0install homepage to set it up. (Note x86_64 users: you need a very recent version of 0install, 0.35 or newer, to run the package. That means you may have to install from source on some distros.) Once this is done follow the instructions from the CELstart link above to run it.

Previous Release (1.2.1)

To get started using CELstart download one of the following binaries:

Download and extract to some directory. No other installation required.
Those binaries have support for Cal3D, ODE, and Python 2.5, but have no support for CEGUI nor Bullet.

Older Releases

1.2

Important Note: To run celstart with python support you have to manually set the PYTHONPATH environment variable to point to the zip file (i.e. not the extracted zip file, just the zip file itself) that you want to run. We will try to fix this limitation in the future.

1.0.1

The old stable CELstart release can be found here:

Xml Based Example Demos/Games

Here are a few example demos for CELstart. Just download these archives and put them (unextracted!) in the current directory (from where you'll start CELstart) or else in the directory where you extracted CELstart.

ShaderTest

This is a small demo level showing several shaders in action (parallax, specular, bumpmap, glow, ...). Just run it and move around (use the arrow-keys or mousemove). Note that to actually see the shaders in full glory, you need a 3D card that can handle shader fragment programs (most modern 3D cards can do this). If your card cannot handle it, then the shaders will automatically fallback to regular bumpmapping, which is not as nice to look at.

Download ShaderTest (2.5 megs) - Video

ParticleTest

This is a small demo level showing several particle systems in action. Just run it and move around. A lot more effects are possible with particles. These are just examples, to show off what Crystal Space is capable of. Warning: this demo requires at least celstart version 4.

Download XMLParticles (0.12 megs) - Video

Castle

Download Castle (3.4 megs) - Video
Download Castle (3.4 megs) - Video
Here you see the castle level from Anders Wisur (indoor version). Just run it and move around. Note that this level uses parallax shaders. If your hardware cannot handle this, then Crystal Space will automatically switch to bumpmapping. Warning: this demo requires at least celstart version 4.

Download Castle (3.4 megs) - Video

Bouncy

Download Bouncy (1.3 megs) - Video
Download Bouncy (1.3 megs) - Video
Bouncy is a small demo written in XML. It features physics (using ODE). It resembles a pinball game a bit except that you can edit the level. It is certainly not a finished game but it can be used as the basis for one.

Download Bouncy (1.3 megs) - Video

CrystalDash

CrystalDash is a boulderdash clone written in XML. This is an example of a 2D game done using CelStart. It features a built-in level editor, sound, and a lot of nice objects to use in the levels. However it is not finished. You cannot die yet for example.

Download CrystalDash (0.2 megs) - Video

PhysicsDemo

PhysicsDemo is a simple demonstration of physics (using ODE) written in XML. Just collide the actor (a ball) against the objects in the scene to make them fall over. Note: this demo uses parallax shader and may run slower on older hardware due to that.

Download PhysicsDemo (1 megs) - Video

CelDemo

Download CelDemo (7.8 megs) - Video
Download CelDemo (7.8 megs) - Video
CelDemo is the old celdemo level featuring automatic doors, moving platforms, lights you can turn on and off and some other things. This level is a good demonstration of the kind of logic you can do with Crystal Entity Layer. However it is a bit dated now and doesn't use any of the more modern shaders.

Download CelDemo (7.8 megs) - Video

Jammer - The Gardener

Live the life of a aspiring gardener on his quest through several highly dynamic environments spanning the world of Jammer T. The aim of the game is to fight off slugs and wasps that are intent on attacking your garden using the colour coded weapons.

Important Note: Requires CEL trunk, or you just have to wait until the next celstart release. Download (17 megs)

Python Based Example Demos/Games

Here is a small demo using python with CELstart. You need to download and install Python 2.4.x yourself. To run the demo you must set the enviroment variable PYTHONPATH to the location/file of the demo, eg. "C:\celstart\PyCelStartDemo.celzip". Now you can start "celstart" and run the demo.

PyCelStartDemo

This is a small python based demo level; more functionality to be added at some point.

Download PyCelStartDemo (1.8 megs)

(Note: the latest version of CELstart (1.2) doesn't like some of my code / xml; most is just warnings that I'm using deprecated functions but there's also a keyword in my world that has been removed; will post updated version as soon as I have a chance to test things running under windows)

| Article | Discussion | View source | History |