Platinum Arts Sandbox Free 3D Game Maker - User contributions [en]

Compiling the source code

2014-06-07T16:24:36Z

Mike:

This page discusses on how to modify and compile the [http://www.sandboxgamemaker.com/wiki/index.php?title=Development source code].

=Windows=

[http://www.codeblocks.org/downloads/26 Click here] to download the version of Codeblocks with the mingw compiler.

Then go into your \src\windows folder. Click on sandbox.cbp and codeblocks should load up. Go to build and then build and it should create the Windows binary :)

If you get "Invalid Compiler" when building, you need to set up the Mingw Compiler location. When you are in Codeblocks go to "Settings" > "Compiler and Debugger". Then click the ">" button until you get to "Toolchain Executables". Click the "Auto-Detect" button. It should find the Mingw folder, if it is pointing to the wrong location click the "..." button and find the folder yourself.

If you are getting errors while compiling such as having to do with "_UnwindResume" you might have to link the libraries. You could do so like this: Go to "Settings" > "Compiler and Debugger", then click Linker Settings. Under link libraries click "Add" and go to the \src\lib folder then highlight all the ".lib" files and click "Ok". Now try compiling! :D
Other Methods: There is a visual C++ project file included that you can use. Load up the proper file and compile :) I'm not sure if you'd need any libraries but you probably shouldn't need any.

=Linux=
==Makefile==

First of all, make sure you have the the SDL and SDL_Image and SDL_Mixer development libraries installed on your system.
Next up, go into src folder. and type 'make install', you can replace 'install' any of the following

* all - compiles client and server targets (see below)
* libenet - compiles the enet library
* clean - cleans up temporary files
* client - builds enet and all clients
* server - builds enet and all servers
* install - builds the client and server targets (see the two above) and copies the produced binaries into ../bin/

==Debug==

A debug file is already set up. Debug versions can be compiled by invoking...
<code>
make -f Makefile.debug install
</code>

After this, simply run sandbox as normal with --debug at the end, for example...
<code>
# this will load up gdb with the rpg's debug binary in windowed mode
./sandbox_unix -grpg --debug -t0

# to stop the program at any time, use ctrl - C
# to run the program, type this once gdb has started
run

# to get a backtrace once sandbox has crashed
bt full

# print a variable - also note you can type cast
print variablename
</code>

We would strongly recommend that you get familiar with gdb and its commands if you intend to do debugging.

==trouble shooting==

'''sandbox cannot find 'SDL/*.h' files''' 
Make sure that the SDL, SDL_mixer and SDL_image libraries are installed

'''enet fails to compile''' 
If you see "./configure: /bin/sh^M: bad interpreter" use dos2unix to convert enet/configure 
Otherwise invoke make -C enet distclean

if sandbox fails to compile for any other reason, do let us know

=MAC OSX=

To start, you should have Xcode installed on your computer. Either install the Developer tools from the OS X install disks that came with your computer, or download Xcode from the apple website:
http://developer.apple.com/technology/xcode.html

Building the app for PPC and Intel macs differs from that point. Once you get Xcode running, do the following:

For PPC users only:

Download SDL: http://www.libsdl.org/release/SDL-1.2.9.dmg

Download SDL_Image: http://www.libsdl.org/projects/SDL_image/release/SDL_image-1.2.9.dmg

Download SDL_Mixer: http://www.libsdl.org/projects/SDL_mixer/release/SDL_mixer-1.2.8.dmg

For Intel users only:

Download SDL from: http://www.libsdl.org/download-1.2.php

Download SDL_Image from: http://www.libsdl.org/projects/SDL_image/

Download SDL_Mixer from: http://www.libsdl.org/projects/SDL_mixer/

Put each .framework file into /Library/Frameworks

Download the latest Multiplatform.zip of Sandbox. Unzip and double click on PASX.X.Xmultiplatform/src/xcode/sandbox.xcodeproj

Xcode will open the project.

Change the '''Active Build Configuration''' from ''Debug'' to ''Release''. Click on build. the Binary should compile without the SDL libraries, so be sure to add them to ''sandbox.app''. You can do this by following these steps:

1: Go to /Library/Frameworks and copy SDL.framework, SDL_Mixer.framework, and SDL_Image.framework.

2: Right-click(ctrl+click) on ''sandbox.app'' and select ''Show Package Contents''.

3: Create a folder called ''Frameworks'' inside the ''Contents'' folder of ''sandbox.app'', and paste the SDL libraries inside that folder.

If you want the launcher to be specific to your architecture, go to the "Project" menu and click "Edit Project Settings". Change ''''Architectures'''' from "ppc i386" to your architecture (ppc for power pc and i386 for intel).

By default the executables, launcher and sandbox, are created in the folder PASX.X.Xmultiplatform/src/xcode/build/Release/

Move the compiled sandbox.app into the top level of the ''sandbox'' folder. The launcher.app should be one level above that folder.

'''Note:''' If for some reason the code did not compile, follow these steps:

- If not already omitted, try leaving out '''(but not deleting)''' master.cpp and any .c, .cpp, and .h files reported missing by Xcode in the project file.

- Add any extra .c, .cpp, and .h files, one at a time, from the folders named enid, engine, fpsgame, and shared to the corresponding folders in the Xcode project file.

--[[User:Popinman32|Popinman32]] 22:28, 6 August 2010 (UTC)

Maintained by Popinman32 and other MacOSX users.

=FreeBSD=

Unwritten

Development

2014-06-07T16:21:48Z

Mike:

We've no intention of releasing development, or testing versions. alas we have a stable development repository available. Using it is not meant for the faint of heart, we (by that I mean Hirato) may occasionally break something.

Obtaining development versions is useful for testing, and it allows users (like yourself) to test out that latest and greatest of the feature set.

On a side note, we use SVN for our development repository needs.

and for those in search of the Eisenstern derived, "Master Chef Ogro" RPG, simply substitute 
https://github.com/PlatinumArts/Platinum-Arts-Sandbox-Free-Game-Maker 
for 
https://github.com/calimer/Master-Chef-Ogro

=Main Windows SVN How To=

'''''Using Tortoise SVN or GIT'''''

One of the easiest and most popular ways of using SVN on Windows is through the program Tortoise SVN here [http://tortoisesvn.net/downloads] The top link under Windows 32 is what most people want to get. After installing Tortoisesvn, create a folder and call it PAS. Right click on the folder and select SVN Checkout. Under where it says URL enter:

Main Version https://github.com/PlatinumArts/Platinum-Arts-Sandbox-Free-Game-Maker 

Under where it says checkout directory enter where you put the PAS folder. You can click on those three dots to navigate to it. After that hit okay and you should start downloading Sandbox to the PAS folder. Once you've finished you'll need to compile the source code to get fully up to date, please see our [[Compiling_the_source_code]] instructions for that. To update right click the PAS folder and select update. If you delete a file by accident you can just select update to restore it :)

=Main POSIX system SVN How To= (NEEDS TO BE UPDATED AND TESTED WITH THE GITHUB, USE LINK IN ABOVE SECTION)

'''''Using the trusty old, Command Line'''''

The first step would be to obtain an SVN client, in any popular Linux distribution this can be found in the "subversion" package, OS X users should find a copy bundled with the xcode family of tools for their system.

Now simply fire up a terminal window, we recommend executing the following command in your home directory or a dedicated directory.
feel free to substitute sandbox with an alternative destination.

<code>
svn co http://www.sandboxgamemaker.com/sandboxpretessa/trunk sandbox
</code>

If you'd like to checkout the other branches as well (currently only sandboxlite) execute the following command instead

<code>
svn co http://www.sandboxgamemaker.com/sandboxpretessa/ sandbox
</code>

the following are some common and useful commands you should get used to if you're planning to use the SVN, for all of them you may pass --help for further details

<code>
svn update # updates to the latest version available on the repository
svn revert --recursive # reverts any changes you've made to your checkout
svn diff -r BASE > mypatch.diff # generates a patch from your changes to the SVN you can send to us
</code>

=Gui Interfaces=

A well designed GUI can ease the effort that may other wise be required to commit changes, access the repository, do diff (differences between two versions of a file, also called a patch). GUIs also take a bit of time getting used to, as they often have different and confusing ways of defining a repository and checking it out

==kdesvn==
[[image:kdesvn.png|left|thumb|200px|A screenshot of the context menus in KDE 3.5]]
[[image:kdesvn1.png|right|thumb|200px|A screenshot of the checkout dailogue in KDE 3.5]]
'''Konqueror'''

A KDE svn client, integrates with konqueror to allow easy manipulation of svn directories via right click context menus and possibly other methods.

to use kdesvn (our way), install it and launch konqueror. type ~ into the location bar.

now, create a new folder named 'sandbox' or 'pas' or whatever.

enter the directory then right click or right click the directory, and then hover your cursor over 'actions', then 'Subversion', kdesvn should be in suffixing brackets. click 'checkout from a repository'

make sure the destination directory is as you want it. Enter http://www.sandboxgamemaker.com/sandboxpretessa/ into the 'Enter URL' field. Make sure that HEAD is selected of the below options, and that is recurses directories. Untick 'append source url name to folder' as I already made you create a valid directory

congrats, once it fetches about 80 MB, you have the latest dev of sandbox. just periodically right click the folder, and follow the context menus to update it. you can also do diffs, revert your changes and review logs through the simple to use context menu.

'''Stand alone GUI'''

using the Standalone GUI is simple and easy, simply start it up (ALT-F2, and enter kdesvn into the box that appears), click on 'Subversion' at the top bar, hover it over 'General', and then click, 'Checkout a Repository'. Alternatively you can click the button 3rd from the right in the bar, it should have the tooltip, 'Checkout a Repository'

in the window that appears, click the folder icon and select a directory to check it into, the 'append source url name to folder' is optional, depending on where you chose. somewhere in your home folder (~) is recommended. once again, enter http://www.sandboxgamemaker.com/sandboxpretessa/ into the URL field.

and you're done. note, you may wish to tick the 'load last opened url on start' in the 'settings' area of the main gui.

==Rapid SVN==

Works on both Linux and Windows. Not quite as easy to use as the SVN programs that integrate with the browsers but it is another alternative.

==eSvn==

===Checking out the repo===

===What else is there to do===

===File Mapping===

=Important Revisions=
This is mostly for people who want to get 'release' versions from the repos.
*3359 - Final 2.7.1 package
*3253 - Final 2.7.0 build
*2774 - Final 2.6.1 build
*2655 - Final 2.6.0 build
*1523 - Final 2.5.0 build
*1165 - Final 2.4.0rc1 build
*760 - Final 2.3.0 Release build
*446 - Final 2.2.0 release
*441 - 2.2.0 fileplanet release
*~200 - 2.1.0 release (sorry there were a few problems that make it difficult to be more accurate)
*89 - 2.0.0 release

Development

2014-06-07T16:20:43Z

Mike: /* Main POSIX system SVN How To */

We've no intention of releasing development, or testing versions. alas we have a stable development repository available. Using it is not meant for the faint of heart, we (by that I mean Hirato) may occasionally break something.

Obtaining development versions is useful for testing, and it allows users (like yourself) to test out that latest and greatest of the feature set.

On a side note, we use SVN for our development repository needs.

and for those in search of the Eisenstern derived, "Master Chef Ogro" RPG, simply substitute 
http://www.sandboxgamemaker.com/sandboxpretessa/ 
for 
http://svnrpg.kids.platinumarts.net/kidsrpg

=Main Windows SVN How To=

'''''Using Tortoise SVN or GIT'''''

One of the easiest and most popular ways of using SVN on Windows is through the program Tortoise SVN here [http://tortoisesvn.net/downloads] The top link under Windows 32 is what most people want to get. After installing Tortoisesvn, create a folder and call it PAS. Right click on the folder and select SVN Checkout. Under where it says URL enter:

Main Version https://github.com/PlatinumArts/Platinum-Arts-Sandbox-Free-Game-Maker 

Under where it says checkout directory enter where you put the PAS folder. You can click on those three dots to navigate to it. After that hit okay and you should start downloading Sandbox to the PAS folder. Once you've finished you'll need to compile the source code to get fully up to date, please see our [[Compiling_the_source_code]] instructions for that. To update right click the PAS folder and select update. If you delete a file by accident you can just select update to restore it :)

=Main POSIX system SVN How To= (NEEDS TO BE UPDATED AND TESTED WITH THE GITHUB, USE LINK IN ABOVE SECTION)

'''''Using the trusty old, Command Line'''''

The first step would be to obtain an SVN client, in any popular Linux distribution this can be found in the "subversion" package, OS X users should find a copy bundled with the xcode family of tools for their system.

Now simply fire up a terminal window, we recommend executing the following command in your home directory or a dedicated directory.
feel free to substitute sandbox with an alternative destination.

<code>
svn co http://www.sandboxgamemaker.com/sandboxpretessa/trunk sandbox
</code>

If you'd like to checkout the other branches as well (currently only sandboxlite) execute the following command instead

<code>
svn co http://www.sandboxgamemaker.com/sandboxpretessa/ sandbox
</code>

the following are some common and useful commands you should get used to if you're planning to use the SVN, for all of them you may pass --help for further details

<code>
svn update # updates to the latest version available on the repository
svn revert --recursive # reverts any changes you've made to your checkout
svn diff -r BASE > mypatch.diff # generates a patch from your changes to the SVN you can send to us
</code>

=Gui Interfaces=

A well designed GUI can ease the effort that may other wise be required to commit changes, access the repository, do diff (differences between two versions of a file, also called a patch). GUIs also take a bit of time getting used to, as they often have different and confusing ways of defining a repository and checking it out

==kdesvn==
[[image:kdesvn.png|left|thumb|200px|A screenshot of the context menus in KDE 3.5]]
[[image:kdesvn1.png|right|thumb|200px|A screenshot of the checkout dailogue in KDE 3.5]]
'''Konqueror'''

A KDE svn client, integrates with konqueror to allow easy manipulation of svn directories via right click context menus and possibly other methods.

to use kdesvn (our way), install it and launch konqueror. type ~ into the location bar.

now, create a new folder named 'sandbox' or 'pas' or whatever.

enter the directory then right click or right click the directory, and then hover your cursor over 'actions', then 'Subversion', kdesvn should be in suffixing brackets. click 'checkout from a repository'

make sure the destination directory is as you want it. Enter http://www.sandboxgamemaker.com/sandboxpretessa/ into the 'Enter URL' field. Make sure that HEAD is selected of the below options, and that is recurses directories. Untick 'append source url name to folder' as I already made you create a valid directory

congrats, once it fetches about 80 MB, you have the latest dev of sandbox. just periodically right click the folder, and follow the context menus to update it. you can also do diffs, revert your changes and review logs through the simple to use context menu.

'''Stand alone GUI'''

using the Standalone GUI is simple and easy, simply start it up (ALT-F2, and enter kdesvn into the box that appears), click on 'Subversion' at the top bar, hover it over 'General', and then click, 'Checkout a Repository'. Alternatively you can click the button 3rd from the right in the bar, it should have the tooltip, 'Checkout a Repository'

in the window that appears, click the folder icon and select a directory to check it into, the 'append source url name to folder' is optional, depending on where you chose. somewhere in your home folder (~) is recommended. once again, enter http://www.sandboxgamemaker.com/sandboxpretessa/ into the URL field.

and you're done. note, you may wish to tick the 'load last opened url on start' in the 'settings' area of the main gui.

==Rapid SVN==

Works on both Linux and Windows. Not quite as easy to use as the SVN programs that integrate with the browsers but it is another alternative.

==eSvn==

===Checking out the repo===

===What else is there to do===

===File Mapping===

=Important Revisions=
This is mostly for people who want to get 'release' versions from the repos.
*3359 - Final 2.7.1 package
*3253 - Final 2.7.0 build
*2774 - Final 2.6.1 build
*2655 - Final 2.6.0 build
*1523 - Final 2.5.0 build
*1165 - Final 2.4.0rc1 build
*760 - Final 2.3.0 Release build
*446 - Final 2.2.0 release
*441 - 2.2.0 fileplanet release
*~200 - 2.1.0 release (sorry there were a few problems that make it difficult to be more accurate)
*89 - 2.0.0 release

Development

2014-06-07T16:18:33Z

Mike: /* Main Windows SVN How To */

We've no intention of releasing development, or testing versions. alas we have a stable development repository available. Using it is not meant for the faint of heart, we (by that I mean Hirato) may occasionally break something.

Obtaining development versions is useful for testing, and it allows users (like yourself) to test out that latest and greatest of the feature set.

On a side note, we use SVN for our development repository needs.

and for those in search of the Eisenstern derived, "Master Chef Ogro" RPG, simply substitute 
http://www.sandboxgamemaker.com/sandboxpretessa/ 
for 
http://svnrpg.kids.platinumarts.net/kidsrpg

=Main Windows SVN How To=

'''''Using Tortoise SVN or GIT'''''

One of the easiest and most popular ways of using SVN on Windows is through the program Tortoise SVN here [http://tortoisesvn.net/downloads] The top link under Windows 32 is what most people want to get. After installing Tortoisesvn, create a folder and call it PAS. Right click on the folder and select SVN Checkout. Under where it says URL enter:

Main Version https://github.com/PlatinumArts/Platinum-Arts-Sandbox-Free-Game-Maker 

Under where it says checkout directory enter where you put the PAS folder. You can click on those three dots to navigate to it. After that hit okay and you should start downloading Sandbox to the PAS folder. Once you've finished you'll need to compile the source code to get fully up to date, please see our [[Compiling_the_source_code]] instructions for that. To update right click the PAS folder and select update. If you delete a file by accident you can just select update to restore it :)

=Main POSIX system SVN How To=

'''''Using the trusty old, Command Line'''''

The first step would be to obtain an SVN client, in any popular Linux distribution this can be found in the "subversion" package, OS X users should find a copy bundled with the xcode family of tools for their system.

Now simply fire up a terminal window, we recommend executing the following command in your home directory or a dedicated directory.
feel free to substitute sandbox with an alternative destination.

<code>
svn co http://www.sandboxgamemaker.com/sandboxpretessa/trunk sandbox
</code>

If you'd like to checkout the other branches as well (currently only sandboxlite) execute the following command instead

<code>
svn co http://www.sandboxgamemaker.com/sandboxpretessa/ sandbox
</code>

the following are some common and useful commands you should get used to if you're planning to use the SVN, for all of them you may pass --help for further details

<code>
svn update # updates to the latest version available on the repository
svn revert --recursive # reverts any changes you've made to your checkout
svn diff -r BASE > mypatch.diff # generates a patch from your changes to the SVN you can send to us
</code>

=Gui Interfaces=

A well designed GUI can ease the effort that may other wise be required to commit changes, access the repository, do diff (differences between two versions of a file, also called a patch). GUIs also take a bit of time getting used to, as they often have different and confusing ways of defining a repository and checking it out

==kdesvn==
[[image:kdesvn.png|left|thumb|200px|A screenshot of the context menus in KDE 3.5]]
[[image:kdesvn1.png|right|thumb|200px|A screenshot of the checkout dailogue in KDE 3.5]]
'''Konqueror'''

A KDE svn client, integrates with konqueror to allow easy manipulation of svn directories via right click context menus and possibly other methods.

to use kdesvn (our way), install it and launch konqueror. type ~ into the location bar.

now, create a new folder named 'sandbox' or 'pas' or whatever.

enter the directory then right click or right click the directory, and then hover your cursor over 'actions', then 'Subversion', kdesvn should be in suffixing brackets. click 'checkout from a repository'

make sure the destination directory is as you want it. Enter http://www.sandboxgamemaker.com/sandboxpretessa/ into the 'Enter URL' field. Make sure that HEAD is selected of the below options, and that is recurses directories. Untick 'append source url name to folder' as I already made you create a valid directory

congrats, once it fetches about 80 MB, you have the latest dev of sandbox. just periodically right click the folder, and follow the context menus to update it. you can also do diffs, revert your changes and review logs through the simple to use context menu.

'''Stand alone GUI'''

using the Standalone GUI is simple and easy, simply start it up (ALT-F2, and enter kdesvn into the box that appears), click on 'Subversion' at the top bar, hover it over 'General', and then click, 'Checkout a Repository'. Alternatively you can click the button 3rd from the right in the bar, it should have the tooltip, 'Checkout a Repository'

in the window that appears, click the folder icon and select a directory to check it into, the 'append source url name to folder' is optional, depending on where you chose. somewhere in your home folder (~) is recommended. once again, enter http://www.sandboxgamemaker.com/sandboxpretessa/ into the URL field.

and you're done. note, you may wish to tick the 'load last opened url on start' in the 'settings' area of the main gui.

==Rapid SVN==

Works on both Linux and Windows. Not quite as easy to use as the SVN programs that integrate with the browsers but it is another alternative.

==eSvn==

===Checking out the repo===

===What else is there to do===

===File Mapping===

=Important Revisions=
This is mostly for people who want to get 'release' versions from the repos.
*3359 - Final 2.7.1 package
*3253 - Final 2.7.0 build
*2774 - Final 2.6.1 build
*2655 - Final 2.6.0 build
*1523 - Final 2.5.0 build
*1165 - Final 2.4.0rc1 build
*760 - Final 2.3.0 Release build
*446 - Final 2.2.0 release
*441 - 2.2.0 fileplanet release
*~200 - 2.1.0 release (sorry there were a few problems that make it difficult to be more accurate)
*89 - 2.0.0 release

Development

2013-12-09T19:04:06Z

Mike:

We've no intention of releasing development, or testing versions. alas we have a stable development repository available. Using it is not meant for the faint of heart, we (by that I mean Hirato) may occasionally break something.

Obtaining development versions is useful for testing, and it allows users (like yourself) to test out that latest and greatest of the feature set.

On a side note, we use SVN for our development repository needs.

and for those in search of the Eisenstern derived, "Master Chef Ogro" RPG, simply substitute 
http://www.sandboxgamemaker.com/sandboxpretessa/ 
for 
http://svnrpg.kids.platinumarts.net/kidsrpg

=Main Windows SVN How To=

'''''Using Tortoise SVN'''''

One of the easiest and most popular ways of using SVN on Windows is through the program Tortoise SVN here [http://tortoisesvn.net/downloads] The top link under Windows 32 is what most people want to get. After installing Tortoisesvn, create a folder and call it PAS. Right click on the folder and select SVN Checkout. Under where it says URL enter:

Main Version http://www.sandboxgamemaker.com/sandboxpretessa/ 

Under where it says checkout directory enter where you put the PAS folder. You can click on those three dots to navigate to it. After that hit okay and you should start downloading Sandbox to the PAS folder. Once you've finished you'll need to compile the source code to get fully up to date, please see our [[Compiling_the_source_code]] instructions for that. To update right click the PAS folder and select update. If you delete a file by accident you can just select update to restore it :)

=Main POSIX system SVN How To=

'''''Using the trusty old, Command Line'''''

The first step would be to obtain an SVN client, in any popular Linux distribution this can be found in the "subversion" package, OS X users should find a copy bundled with the xcode family of tools for their system.

Now simply fire up a terminal window, we recommend executing the following command in your home directory or a dedicated directory.
feel free to substitute sandbox with an alternative destination.

<code>
svn co http://www.sandboxgamemaker.com/sandboxpretessa/trunk sandbox
</code>

If you'd like to checkout the other branches as well (currently only sandboxlite) execute the following command instead

<code>
svn co http://www.sandboxgamemaker.com/sandboxpretessa/ sandbox
</code>

the following are some common and useful commands you should get used to if you're planning to use the SVN, for all of them you may pass --help for further details

<code>
svn update # updates to the latest version available on the repository
svn revert --recursive # reverts any changes you've made to your checkout
svn diff -r BASE > mypatch.diff # generates a patch from your changes to the SVN you can send to us
</code>

=Gui Interfaces=

A well designed GUI can ease the effort that may other wise be required to commit changes, access the repository, do diff (differences between two versions of a file, also called a patch). GUIs also take a bit of time getting used to, as they often have different and confusing ways of defining a repository and checking it out

==kdesvn==
[[image:kdesvn.png|left|thumb|200px|A screenshot of the context menus in KDE 3.5]]
[[image:kdesvn1.png|right|thumb|200px|A screenshot of the checkout dailogue in KDE 3.5]]
'''Konqueror'''

A KDE svn client, integrates with konqueror to allow easy manipulation of svn directories via right click context menus and possibly other methods.

to use kdesvn (our way), install it and launch konqueror. type ~ into the location bar.

now, create a new folder named 'sandbox' or 'pas' or whatever.

enter the directory then right click or right click the directory, and then hover your cursor over 'actions', then 'Subversion', kdesvn should be in suffixing brackets. click 'checkout from a repository'

make sure the destination directory is as you want it. Enter http://www.sandboxgamemaker.com/sandboxpretessa/ into the 'Enter URL' field. Make sure that HEAD is selected of the below options, and that is recurses directories. Untick 'append source url name to folder' as I already made you create a valid directory

congrats, once it fetches about 80 MB, you have the latest dev of sandbox. just periodically right click the folder, and follow the context menus to update it. you can also do diffs, revert your changes and review logs through the simple to use context menu.

'''Stand alone GUI'''

using the Standalone GUI is simple and easy, simply start it up (ALT-F2, and enter kdesvn into the box that appears), click on 'Subversion' at the top bar, hover it over 'General', and then click, 'Checkout a Repository'. Alternatively you can click the button 3rd from the right in the bar, it should have the tooltip, 'Checkout a Repository'

in the window that appears, click the folder icon and select a directory to check it into, the 'append source url name to folder' is optional, depending on where you chose. somewhere in your home folder (~) is recommended. once again, enter http://www.sandboxgamemaker.com/sandboxpretessa/ into the URL field.

and you're done. note, you may wish to tick the 'load last opened url on start' in the 'settings' area of the main gui.

==Rapid SVN==

Works on both Linux and Windows. Not quite as easy to use as the SVN programs that integrate with the browsers but it is another alternative.

==eSvn==

===Checking out the repo===

===What else is there to do===

===File Mapping===

=Important Revisions=
This is mostly for people who want to get 'release' versions from the repos.
*3359 - Final 2.7.1 package
*3253 - Final 2.7.0 build
*2774 - Final 2.6.1 build
*2655 - Final 2.6.0 build
*1523 - Final 2.5.0 build
*1165 - Final 2.4.0rc1 build
*760 - Final 2.3.0 Release build
*446 - Final 2.2.0 release
*441 - 2.2.0 fileplanet release
*~200 - 2.1.0 release (sorry there were a few problems that make it difficult to be more accurate)
*89 - 2.0.0 release

Development

2013-12-09T19:02:51Z

Mike:

We've no intention of releasing development, or testing versions. alas we have a stable development repository available. Using it is not meant for the faint of heart, we (by that I mean Hirato) may occasionally break something.

Obtaining development versions is useful for testing, and it allows users (like yourself) to test out that latest and greatest of the feature set.

On a side note, we use SVN for our development repository needs.

and for those in search of the Eisenstern derived, "Master Chef Ogro" RPG, simply substitute 
http://www.sandboxgamemaker.com/sandboxpretessa/ 
for 
http://svnrpg.kids.platinumarts.net/kidsrpg

=Main Windows SVN How To=

'''''Using Tortoise SVN'''''

One of the easiest and most popular ways of using SVN on Windows is through the program Tortoise SVN here [http://tortoisesvn.net/downloads] The top link under Windows 32 is what most people want to get. After installing Tortoisesvn, create a folder and call it PAS. Right click on the folder and select SVN Checkout. Under where it says URL enter:

Main Version http://www.svn.kids.platinumarts.net/32pas32/trunk/ 

Under where it says checkout directory enter where you put the PAS folder. You can click on those three dots to navigate to it. After that hit okay and you should start downloading Sandbox to the PAS folder. Once you've finished you'll need to compile the source code to get fully up to date, please see our [[Compiling_the_source_code]] instructions for that. To update right click the PAS folder and select update. If you delete a file by accident you can just select update to restore it :)

=Main POSIX system SVN How To=

'''''Using the trusty old, Command Line'''''

The first step would be to obtain an SVN client, in any popular Linux distribution this can be found in the "subversion" package, OS X users should find a copy bundled with the xcode family of tools for their system.

Now simply fire up a terminal window, we recommend executing the following command in your home directory or a dedicated directory.
feel free to substitute sandbox with an alternative destination.

<code>
svn co http://www.svn.kids.platinumarts.net/32pas32/trunk sandbox
</code>

If you'd like to checkout the other branches as well (currently only sandboxlite) execute the following command instead

<code>
svn co http://www.svn.kids.platinumarts.net/32pas32 sandbox
</code>

the following are some common and useful commands you should get used to if you're planning to use the SVN, for all of them you may pass --help for further details

<code>
svn update # updates to the latest version available on the repository
svn revert --recursive # reverts any changes you've made to your checkout
svn diff -r BASE > mypatch.diff # generates a patch from your changes to the SVN you can send to us
</code>

=Gui Interfaces=

A well designed GUI can ease the effort that may other wise be required to commit changes, access the repository, do diff (differences between two versions of a file, also called a patch). GUIs also take a bit of time getting used to, as they often have different and confusing ways of defining a repository and checking it out

==kdesvn==
[[image:kdesvn.png|left|thumb|200px|A screenshot of the context menus in KDE 3.5]]
[[image:kdesvn1.png|right|thumb|200px|A screenshot of the checkout dailogue in KDE 3.5]]
'''Konqueror'''

A KDE svn client, integrates with konqueror to allow easy manipulation of svn directories via right click context menus and possibly other methods.

to use kdesvn (our way), install it and launch konqueror. type ~ into the location bar.

now, create a new folder named 'sandbox' or 'pas' or whatever.

enter the directory then right click or right click the directory, and then hover your cursor over 'actions', then 'Subversion', kdesvn should be in suffixing brackets. click 'checkout from a repository'

make sure the destination directory is as you want it. Enter http://www.svn.kids.platinumarts.net/32pas32/trunk/ into the 'Enter URL' field. Make sure that HEAD is selected of the below options, and that is recurses directories. Untick 'append source url name to folder' as I already made you create a valid directory

congrats, once it fetches about 80 MB, you have the latest dev of sandbox. just periodically right click the folder, and follow the context menus to update it. you can also do diffs, revert your changes and review logs through the simple to use context menu.

'''Stand alone GUI'''

using the Standalone GUI is simple and easy, simply start it up (ALT-F2, and enter kdesvn into the box that appears), click on 'Subversion' at the top bar, hover it over 'General', and then click, 'Checkout a Repository'. Alternatively you can click the button 3rd from the right in the bar, it should have the tooltip, 'Checkout a Repository'

in the window that appears, click the folder icon and select a directory to check it into, the 'append source url name to folder' is optional, depending on where you chose. somewhere in your home folder (~) is recommended. once again, enter http://www.svn.kids.platinumarts.net/32pas32/trunk/ into the URL field.

and you're done. note, you may wish to tick the 'load last opened url on start' in the 'settings' area of the main gui.

==Rapid SVN==

Works on both Linux and Windows. Not quite as easy to use as the SVN programs that integrate with the browsers but it is another alternative.

==eSvn==

===Checking out the repo===

===What else is there to do===

===File Mapping===

=Important Revisions=
This is mostly for people who want to get 'release' versions from the repos.
*3359 - Final 2.7.1 package
*3253 - Final 2.7.0 build
*2774 - Final 2.6.1 build
*2655 - Final 2.6.0 build
*1523 - Final 2.5.0 build
*1165 - Final 2.4.0rc1 build
*760 - Final 2.3.0 Release build
*446 - Final 2.2.0 release
*441 - 2.2.0 fileplanet release
*~200 - 2.1.0 release (sorry there were a few problems that make it difficult to be more accurate)
*89 - 2.0.0 release

Contact The Team

2013-09-24T10:25:57Z

Mike: /* Developer Chatroom */

Interested in getting into contact with us? Here are a few quick easy ways to do so :)

== Developer Chatroom ==

The easiest way of finding us is to join our developer chatroom.

'''NOTE: KIDS MUST HAVE PARENTAL PERMISSION TO JOIN AND WE CANNOT BE RESPONSIBLE FOR THINGS SAID IN THERE. ALSO WE ARE FREQUENTLY IDLE IN THE CHATROOM WORKING ON SANDBOX, IF YOU EXPECT A RESPONSE PLEASE WAIT'''

You can simply [https://kiwiirc.com/client/irc.oftc.net/sandbox click here] or if you already have an irc client it is [irc://irc.oftc.net/sandbox irc.OFTC.net #Sandbox]

If you don't want to use your webbrowser to connect to the chatroom, and instead want to use a standalone program, then you can use Xchat at http://silverex.org This is the free version of xchat, as the main version of xchat has a 30 day trial. 
Instructions: 
1)In the xchat menu to go the network list 
2)Find OFTC or add irc.OFTC.net then select edit 
3) In favorite channels add #sandbox and
set it to autoconnect 
4) With OFTC still highlighted, hit connect and join us :D 

== Forums ==

Obviously we check this on a regular basis so feel free to post there. http://forum.sandboxgamemaker.com

== E-mail ==

You
can contact us at PlatinumArts@gmail.com PLEASE NO TECHNICAL SUPPORT QUESTIONS. PLACE TECHNICAL SUPPORT QUESTIONS IN THE FORUM OR CHATROOM

== Social Site ==

We currently have a social site in the works, you can visit it here: http://www.sandboxgamemaker.com/game-design-community/

Main Page

2012-10-22T12:16:12Z

Mike:

'''Platinum Arts Sandbox Free 3D Game Maker''' is a 3D game maker based on the Cube 2 engine that allows users to quickly and easily create and edit their own worlds in game, even cooperatively. It is free, open-source, and easy to use for Kids and Adults. Sandbox logo by [http://sashazavisha.deviantart.com/art/young-creator-120946941 sashaZavisha].

<div style="width:49%;float:left;">

== General information ==

* [[Platinum Arts Sandbox|About Platinum Arts Sandbox]]
* [http://SandboxGameMaker.com Project homepage]
* [[FAQ]]
* [http://www.svn.kids.platinumarts.net/32pas32/trunk/LICENSE.txt License]
* [[Contact The Team]]
* [[cmdline arguments|Command line Arguments]]
* [[packaging guide|The Packaging Guide]]
* [[server list|List Of Sandbox Servers]]

== Installation ==
* [[Installing Platinum Arts Sandbox]]
* [[Compiling the source code]]
* [[package managers|Some Notes for package managers]]

== Development ==

* [[bug reports|Bug Reports]]
* [[Coding Style]]
* [[Contributing]]
* [[development|Obtaining the development version]]
* [[Todo|To do list]]
* [[content request| Content Request - Help us out!!]]

== Future Projects ==
=== Kid Friendly RPG ===

* [[Concept Document]]
* [[Brainstorming area]]

=== Master Chef Ogro 2 ===
* [[Brainstorming]]

=== Undercover Kids Game ===
* [[To Do List]]

</div>
<div style="width:49%;float:right;">

== Getting started ==

* [[Map Editing Basics]]
* [[Mapping Taboos]]
* [[Beginner's video tutorials]]
* [[Water Wars Guide]]

== Advanced topics ==

* [[Cooperative Editing]] (General Server set up)
* [[Cooperative Editing 2]] (Easier way using Hamachi)
* [[Adding Models to Sandbox]]
* [http://sandboxgamemaker.com/platinumartssandboxeditref.html Editing Reference Guide]
* [http://sauerbraten.org/docs/models.html Model Reference Guide]
* [[Configuration Reference Guide]]
* [[Cubescript]]
* [[Menu Editing]] ([[New menu editing|newui]])
* [[map_config|Map Configuration]]

== Modules ==

* [[FPS|FPS - First Person Shooter ]]
* [[RPG|RPG - Role Playing Game]]
* [[SSP|SSP - Side Scrolling Platformer]]
* [[MovieCube|MovieCube - Machinima Tool]]
* [[Vehicle Simulator]]

== Tutorials ==
*[[Tips on Making a Good Map]]
*[[Tutorials List | Text Tutorials List]]
*[[Video Tutorials List]]

== Other ==
*[[Soundtrack]]
*[[PAS related websites]]
*[[Custom Content Websites]]

Compiling the source code

2011-10-10T05:06:04Z

Mike: /* Windows */

This page discusses on how to modify and compile the source code.

=Windows=

[http://www.codeblocks.org/downloads/26 Click here] to download the version of Codeblocks with the mingw compiler.

Then go into your \src\windows folder. Click on sandbox.cbp and codeblocks should load up. Go to build and then build and it should create the Windows binary :)

If you get "Invalid Compiler" when building, you need to set up the Mingw Compiler location. When you are in Codeblocks go to "Settings" > "Compiler and Debugger". Then click the ">" button until you get to "Toolchain Executables". Click the "Auto-Detect" button. It should find the Mingw folder, if it is pointing to the wrong location click the "..." button and find the folder yourself.

If you are getting errors while compiling such as having to do with "_UnwindResume" you might have to link the libraries. You could do so like this: Go to "Settings" > "Compiler and Debugger", then click Linker Settings. Under link libraries click "Add" and go to the \src\lib folder then highlight all the ".lib" files and click "Ok". Now try compiling! :D
Other Methods: There is a visual C++ project file included that you can use. Load up the proper file and compile :) I'm not sure if you'd need any libraries but you probably shouldn't need any.

=Linux=
==Makefile==

First of all, make sure you have the the SDL and SDL_Image and SDL_Mixer development libraries installed on your system.
Next up, go into src folder. and type 'make install', you can replace 'install' any of the following

* all - compiles client and server targets (see below)
* libenet - compiles the enet library
* clean - cleans up temporary files
* client - builds enet and all clients
* server - builds enet and all servers
* install - builds the client and server targets (see the two above) and copies the produced binaries into ../bin/

==Debug==

A debug file is already set up. Debug versions can be compiled by invoking...
<code>
make -f Makefile.debug install
</code>

After this, simply run sandbox as normal with --debug at the end, for example...
<code>
# this will load up gdb with the rpg's debug binary in windowed mode
./sandbox_unix -grpg --debug -t0

# to stop the program at any time, use ctrl - C
# to run the program, type this once gdb has started
run

# to get a backtrace once sandbox has crashed
bt full

# print a variable - also note you can type cast
print variablename
</code>

We would strongly recommend that you get familiar with gdb and its commands if you intend to do debugging.

==trouble shooting==

'''sandbox cannot find 'SDL/*.h' files''' 
Make sure that the SDL, SDL_mixer and SDL_image libraries are installed

'''enet fails to compile''' 
If you see "./configure: /bin/sh^M: bad interpreter" use dos2unix to convert enet/configure 
Otherwise invoke make -C enet distclean

if sandbox fails to compile for any other reason, do let us know

=MAC OSX=

To start, you should have Xcode installed on your computer. Either install the Developer tools from the OS X install disks that came with your computer, or download Xcode from the apple website:
http://developer.apple.com/technology/xcode.html

Building the app for PPC and Intel macs differs from that point. Once you get Xcode running, stop there.

For PPC users only:
Download SDL: http://www.libsdl.org/release/SDL-1.2.9.dmg
Copy the SDL.framework folder to /Library/Frameworks

Download SDL_Image: http://www.libsdl.org/projects/SDL_image/release/SDL_image-1.2.9.dmg
Copy the SDL_image.framework folder to /Library/Frameworks

Download SDL_Mixer: http://www.libsdl.org/projects/SDL_mixer/release/SDL_mixer-1.2.8.dmg
Copy the SDL_mixer.framework folder to /Library/Frameworks

For Intel users only:

Download SDL from: http://www.libsdl.org/download-1.2.php

Download SDL_Image from: http://www.libsdl.org/projects/SDL_image/

Download SDL_Mixer from: http://www.libsdl.org/projects/SDL_mixer/

Put the .framework file for each into /Library/Frameworks

Download the latest Multiplatform.zip of Sandbox. Unzip and double click on PASX.X.Xmultiplatform/src/xcode/sandbox.xcodeproj

Xcode will open the project.

1. First remove the folder "Other Sources". When asked, only delete references and not the files themselves.

2. Right click(ctrl+click) and select "Add" then "New Group". This will make a new folder. Rename it to "Other Sources".

3. Now, right click(ctrl+click) on the new "Other Sources" and select "Add" then "Existing Files...", when asked add the folder "fpsgame".

4. Repeat that process for the folders "shared","enet",and "engine". Then go into "engine" and remove the reference to "master.cpp".

5. Now that we have our source updated, lets change the configuration to something better suited for us. Change ''''Architectures'''' from "ppc i386" to your architecture (ppc for power pc and i386 for intel).

6. Go to the "Project" menu and click "Edit Project Settings". Find "Framework Search Paths" and add ''''/System/Library/Frameworks'''' (no slash on the end) and remove ''''$(USER_LIBRARY_DIR)/Frameworks/'''' as frameworks are not normally installed there. Put ''''/System/Library/Frameworks'''' first.

7. Exit the settings editor. Change the '''Active Build Configuration''' from ''Debug'' to ''Release''. Click on build - the Binary should compile ''without''.

By default the executables, launcher and sandbox, are created in the folder PASX.X.Xmultiplatform/src/xcode/build/Release/

Rename the PASX.X.Xmultiplatform folder to ''sandbox'' and move the compiled sandbox.app into the top level of that folder. The launcher.app should be on the same level, but outside, the renamed ''sandbox'' folder.

If you still have problems compiling, remove the folder ''includes'' inside ''enet''.

--[[User:Popinman32|Popinman32]] 22:28, 6 August 2010 (UTC)

Maintained by Popinman32 and other MacOSX users.

=FreeBSD=

Unwritten

Compiling the source code

2011-10-10T05:05:38Z

Mike:

This page discusses on how to modify and compile the source code.

=Windows=

[http://www.codeblocks.org/downloads/26 Click here] to download the version of Codeblocks with the mingw compiler.

Then go into your \src\windows folder. Click on sandbox.cbp and codeblocks should load up. Go to build and then build and it should create the Windows binary :)
If you get "Invalid Compiler" when building, you need to set up the Mingw Compiler location. When you are in Codeblocks go to "Settings" > "Compiler and Debugger". Then click the ">" button until you get to "Toolchain Executables". Click the "Auto-Detect" button. It should find the Mingw folder, if it is pointing to the wrong location click the "..." button and find the folder yourself.

If you are getting errors while compiling such as having to do with "_UnwindResume" you might have to link the libraries. You could do so like this: Go to "Settings" > "Compiler and Debugger", then click Linker Settings. Under link libraries click "Add" and go to the \src\lib folder then highlight all the ".lib" files and click "Ok". Now try compiling! :D
Other Methods: There is a visual C++ project file included that you can use. Load up the proper file and compile :) I'm not sure if you'd need any libraries but you probably shouldn't need any.

=Linux=
==Makefile==

First of all, make sure you have the the SDL and SDL_Image and SDL_Mixer development libraries installed on your system.
Next up, go into src folder. and type 'make install', you can replace 'install' any of the following

* all - compiles client and server targets (see below)
* libenet - compiles the enet library
* clean - cleans up temporary files
* client - builds enet and all clients
* server - builds enet and all servers
* install - builds the client and server targets (see the two above) and copies the produced binaries into ../bin/

==Debug==

A debug file is already set up. Debug versions can be compiled by invoking...
<code>
make -f Makefile.debug install
</code>

After this, simply run sandbox as normal with --debug at the end, for example...
<code>
# this will load up gdb with the rpg's debug binary in windowed mode
./sandbox_unix -grpg --debug -t0

# to stop the program at any time, use ctrl - C
# to run the program, type this once gdb has started
run

# to get a backtrace once sandbox has crashed
bt full

# print a variable - also note you can type cast
print variablename
</code>

We would strongly recommend that you get familiar with gdb and its commands if you intend to do debugging.

==trouble shooting==

'''sandbox cannot find 'SDL/*.h' files''' 
Make sure that the SDL, SDL_mixer and SDL_image libraries are installed

'''enet fails to compile''' 
If you see "./configure: /bin/sh^M: bad interpreter" use dos2unix to convert enet/configure 
Otherwise invoke make -C enet distclean

if sandbox fails to compile for any other reason, do let us know

=MAC OSX=

To start, you should have Xcode installed on your computer. Either install the Developer tools from the OS X install disks that came with your computer, or download Xcode from the apple website:
http://developer.apple.com/technology/xcode.html

Building the app for PPC and Intel macs differs from that point. Once you get Xcode running, stop there.

For PPC users only:
Download SDL: http://www.libsdl.org/release/SDL-1.2.9.dmg
Copy the SDL.framework folder to /Library/Frameworks

Download SDL_Image: http://www.libsdl.org/projects/SDL_image/release/SDL_image-1.2.9.dmg
Copy the SDL_image.framework folder to /Library/Frameworks

Download SDL_Mixer: http://www.libsdl.org/projects/SDL_mixer/release/SDL_mixer-1.2.8.dmg
Copy the SDL_mixer.framework folder to /Library/Frameworks

For Intel users only:

Download SDL from: http://www.libsdl.org/download-1.2.php

Download SDL_Image from: http://www.libsdl.org/projects/SDL_image/

Download SDL_Mixer from: http://www.libsdl.org/projects/SDL_mixer/

Put the .framework file for each into /Library/Frameworks

Download the latest Multiplatform.zip of Sandbox. Unzip and double click on PASX.X.Xmultiplatform/src/xcode/sandbox.xcodeproj

Xcode will open the project.

1. First remove the folder "Other Sources". When asked, only delete references and not the files themselves.

2. Right click(ctrl+click) and select "Add" then "New Group". This will make a new folder. Rename it to "Other Sources".

3. Now, right click(ctrl+click) on the new "Other Sources" and select "Add" then "Existing Files...", when asked add the folder "fpsgame".

4. Repeat that process for the folders "shared","enet",and "engine". Then go into "engine" and remove the reference to "master.cpp".

5. Now that we have our source updated, lets change the configuration to something better suited for us. Change ''''Architectures'''' from "ppc i386" to your architecture (ppc for power pc and i386 for intel).

6. Go to the "Project" menu and click "Edit Project Settings". Find "Framework Search Paths" and add ''''/System/Library/Frameworks'''' (no slash on the end) and remove ''''$(USER_LIBRARY_DIR)/Frameworks/'''' as frameworks are not normally installed there. Put ''''/System/Library/Frameworks'''' first.

7. Exit the settings editor. Change the '''Active Build Configuration''' from ''Debug'' to ''Release''. Click on build - the Binary should compile ''without''.

By default the executables, launcher and sandbox, are created in the folder PASX.X.Xmultiplatform/src/xcode/build/Release/

Rename the PASX.X.Xmultiplatform folder to ''sandbox'' and move the compiled sandbox.app into the top level of that folder. The launcher.app should be on the same level, but outside, the renamed ''sandbox'' folder.

If you still have problems compiling, remove the folder ''includes'' inside ''enet''.

--[[User:Popinman32|Popinman32]] 22:28, 6 August 2010 (UTC)

Maintained by Popinman32 and other MacOSX users.

=FreeBSD=

Unwritten

Compiling the source code

2011-10-10T05:05:21Z

Mike: /* Windows */

This page discusses on how to modify and compile the source code.

=Windows=

[http://www.codeblocks.org/downloads/26 Click here] to download the version of Codeblocks with the mingw compiler: [1]

Then go into your \src\windows folder. Click on sandbox.cbp and codeblocks should load up. Go to build and then build and it should create the Windows binary :)
If you get "Invalid Compiler" when building, you need to set up the Mingw Compiler location. When you are in Codeblocks go to "Settings" > "Compiler and Debugger". Then click the ">" button until you get to "Toolchain Executables". Click the "Auto-Detect" button. It should find the Mingw folder, if it is pointing to the wrong location click the "..." button and find the folder yourself.

If you are getting errors while compiling such as having to do with "_UnwindResume" you might have to link the libraries. You could do so like this: Go to "Settings" > "Compiler and Debugger", then click Linker Settings. Under link libraries click "Add" and go to the \src\lib folder then highlight all the ".lib" files and click "Ok". Now try compiling! :D
Other Methods: There is a visual C++ project file included that you can use. Load up the proper file and compile :) I'm not sure if you'd need any libraries but you probably shouldn't need any.

=Linux=
==Makefile==

First of all, make sure you have the the SDL and SDL_Image and SDL_Mixer development libraries installed on your system.
Next up, go into src folder. and type 'make install', you can replace 'install' any of the following

* all - compiles client and server targets (see below)
* libenet - compiles the enet library
* clean - cleans up temporary files
* client - builds enet and all clients
* server - builds enet and all servers
* install - builds the client and server targets (see the two above) and copies the produced binaries into ../bin/

==Debug==

A debug file is already set up. Debug versions can be compiled by invoking...
<code>
make -f Makefile.debug install
</code>

After this, simply run sandbox as normal with --debug at the end, for example...
<code>
# this will load up gdb with the rpg's debug binary in windowed mode
./sandbox_unix -grpg --debug -t0

# to stop the program at any time, use ctrl - C
# to run the program, type this once gdb has started
run

# to get a backtrace once sandbox has crashed
bt full

# print a variable - also note you can type cast
print variablename
</code>

We would strongly recommend that you get familiar with gdb and its commands if you intend to do debugging.

==trouble shooting==

'''sandbox cannot find 'SDL/*.h' files''' 
Make sure that the SDL, SDL_mixer and SDL_image libraries are installed

'''enet fails to compile''' 
If you see "./configure: /bin/sh^M: bad interpreter" use dos2unix to convert enet/configure 
Otherwise invoke make -C enet distclean

if sandbox fails to compile for any other reason, do let us know

=MAC OSX=

To start, you should have Xcode installed on your computer. Either install the Developer tools from the OS X install disks that came with your computer, or download Xcode from the apple website:
http://developer.apple.com/technology/xcode.html

Building the app for PPC and Intel macs differs from that point. Once you get Xcode running, stop there.

For PPC users only:
Download SDL: http://www.libsdl.org/release/SDL-1.2.9.dmg
Copy the SDL.framework folder to /Library/Frameworks

Download SDL_Image: http://www.libsdl.org/projects/SDL_image/release/SDL_image-1.2.9.dmg
Copy the SDL_image.framework folder to /Library/Frameworks

Download SDL_Mixer: http://www.libsdl.org/projects/SDL_mixer/release/SDL_mixer-1.2.8.dmg
Copy the SDL_mixer.framework folder to /Library/Frameworks

For Intel users only:

Download SDL from: http://www.libsdl.org/download-1.2.php

Download SDL_Image from: http://www.libsdl.org/projects/SDL_image/

Download SDL_Mixer from: http://www.libsdl.org/projects/SDL_mixer/

Put the .framework file for each into /Library/Frameworks

Download the latest Multiplatform.zip of Sandbox. Unzip and double click on PASX.X.Xmultiplatform/src/xcode/sandbox.xcodeproj

Xcode will open the project.

1. First remove the folder "Other Sources". When asked, only delete references and not the files themselves.

2. Right click(ctrl+click) and select "Add" then "New Group". This will make a new folder. Rename it to "Other Sources".

3. Now, right click(ctrl+click) on the new "Other Sources" and select "Add" then "Existing Files...", when asked add the folder "fpsgame".

4. Repeat that process for the folders "shared","enet",and "engine". Then go into "engine" and remove the reference to "master.cpp".

5. Now that we have our source updated, lets change the configuration to something better suited for us. Change ''''Architectures'''' from "ppc i386" to your architecture (ppc for power pc and i386 for intel).

6. Go to the "Project" menu and click "Edit Project Settings". Find "Framework Search Paths" and add ''''/System/Library/Frameworks'''' (no slash on the end) and remove ''''$(USER_LIBRARY_DIR)/Frameworks/'''' as frameworks are not normally installed there. Put ''''/System/Library/Frameworks'''' first.

7. Exit the settings editor. Change the '''Active Build Configuration''' from ''Debug'' to ''Release''. Click on build - the Binary should compile ''without''.

By default the executables, launcher and sandbox, are created in the folder PASX.X.Xmultiplatform/src/xcode/build/Release/

Rename the PASX.X.Xmultiplatform folder to ''sandbox'' and move the compiled sandbox.app into the top level of that folder. The launcher.app should be on the same level, but outside, the renamed ''sandbox'' folder.

If you still have problems compiling, remove the folder ''includes'' inside ''enet''.

--[[User:Popinman32|Popinman32]] 22:28, 6 August 2010 (UTC)

Maintained by Popinman32 and other MacOSX users.

=FreeBSD=

Unwritten

Brainstorming

2011-08-19T21:03:27Z

Mike: Protected "Brainstorming" ([edit=autoconfirmed] (indefinite) [move=autoconfirmed] (indefinite))

== Basic Concept ==
After the defeat of the Evil King, Shadow Ogro went into hiding. Three years have passed and the Cabbage Golems returned to their peaceful state. Master Chef Ogro returned to his little bakery in Cider City to exhibit his master skills from the recipes learned on his last adventure. Far beyond Cider City and Cabbage Patch Fort, even farther than the Dough Bread Mountains lurks a great evil. Inside Sugar Crystal Cave a twisted plot is stirring. Reports of new creatures have been traveling across the kingdom of Ograria where they reach Master Chef Ogro's ears. Master Chef Ogro picks up his wooden spoon and says "Let's bake this cake."

'''Title Concepts'''
*The Exciting Adventures Of Master Chef Ogro 2 - The Shadow Returns

'''Main Game Goals'''
* Keep the game grade school friendly as much as possible.
* Keep it open, where you don't have to follow a single path.
* Make it as easy and informative to read for younger audiences.
* Give the game life, and personality.

=='''Gameplay Concepts'''==

'''General'''
* Finding New Recipes to make stronger produce items such as golden apples.
* Tempering ability to upgrade weapons/armors with the right materials, such as Ironware for stronger pot armor.
* Special Produce collection to ' tame ' certain creatures to help you on your quest such as Candy Apples.
* New currency maybe seeds. Regular Seeds, Silver Seeds, Golden Seeds. Nice idea.
* A sling to launch produce such as apples. Maybe upgradable.
* Maybe have stage ranks, and whichever rank you score in win special items.
* Life Fruit to give you more health

'''Puzzle Concepts'''
* Use of ' Produce Side-Effects ' to get past certain parts. Like shrinking to fit in smaller areas.
* Mini-Games to win certain prizes. Maybe to get past certain areas.
* Perhaps timed puzzle areas.
* Mazes and enemy waves.

'''Combat Strategy Concepts'''
* Upgradable weapons.
* Augmented weapons for effects against certain enemies.

'''Creature Concepts'''
* The Evil Sugar Army is full of many old and new creatures.

'''New Creature Concepts'''
* Taffy Golem - Replacing the Cabbage Golem.
* Malicious Chocolate Bar - No idea what to make these fellas do.
* Gumdrop Monsters - Small little buggers hard to hit.
* Sugar Imps - These guys can throw unhealthy foods at you.
* Evil Candy Chefs - They can conjure up other enemies, like summoners.

'''Recipe Concepts'''
* Have hidden recipes throughout the game to upgrade stuff.
* Maybe hide some temepring materials around.
* Hidden stronger Side-Effect items.

'''Side-Effect (Spell) Concepts'''
* Starfruit - Shoot Starfruit Energy.
* Mini Pear - Turns you small.
* Mega Pumpkin - Turns you giant.

Pitch in some more ideas please.

Content request

2011-08-19T21:02:50Z

Mike: Protected "Content request" ([edit=autoconfirmed] (indefinite) [move=autoconfirmed] (indefinite))

==Models Wanted List==

NEED 
* Vegetable extractor (a vegetable type pump) - serves as the kid friendly rpg melee attack
* A frog with animations to be The Master Chef's companion
* (DONE) Treasure chest with open and close animation. (Captain Ahab made one.)
* Cabbage - Assigned to Mike/calimer 
* Monsters for the sidescroller - Mike/calimer working on one 
* doors with opening, and mapmodel animations. kinda sci-fi ish. see door1.jpg for a messy concept drawing. Also one to fit in an rpg and one for modern times
* Elevator/Platform models, something like out of jak and daxter (a round thing that hovers or has some fire or something underneath it) would be quite cool. (Captain Ahab made one.)
* More Varieties of trees, from small ferns to huge overgrown oaks and willows.
* (DONE) A waterwheel, like those medieval kind that spins around as a stream pushes it. (Captain Ahab made one.)
* A player character for sandbox lite (it needs to meet debian free, so CC3 BY SA at the most)
* Map Models for weapons. vegetable pump, Carrot Launcher, snow ball projectiles, and other weapons.

WOULD BE NICE 

* master chef ogro model with chef hat and potentially pots and pans that can be used for armor
* Squirt gun models for the water wars mode 
* Kid player models for water wars mode 

* vegetable related creatures 
* evil king for the RPG 
* Animals - Deer (eats grass, drinks water),
* bunnies hopping around
* Npcs - miner, fishing dude
* bird(s)
* frogs
* more fish? whales? dolphins?

==Levels==
* an eye candy map to show off the graphics

Would be nice 
* levels for the sidescroller, though it is getting a lot of updates.
* any levels with fun and unique gameplay/quests
* levels for the RPG

Contributing

2011-08-19T21:02:12Z

Mike: Protected "Contributing" ([edit=autoconfirmed] (indefinite) [move=autoconfirmed] (indefinite))

=Code=

examples of code contributions
* bug fixes
* additional features
* cleanups

if you've any of the above, send them to Hirato, the code will be included if he approves. He can be contacted through the [http://forum.sandboxgamemaker.com forums] (the PM system) or via [irc://irc.oftc.net/sandbox IRC] (the latter is recommended). 
If you desire any feedback on your code, post it in the "Show of Your Work in Progress" forum, and tag it with [patch] - eg "[patch]continuous jumping", for a patch that makes you jump nonstop.

If you lack any ideas of what to implement, should you wish to contribute in this way, there are various todo lists that should help you out
* http://www.svn.kids.platinumarts.net/32pas32/trunk/sandboxtodo.txt
* http://www.svn.kids.platinumarts.net/32pas32/trunk/src/rpggame/rpgtodo.txt
* http://www.svn.kids.platinumarts.net/32pas32/trunk/src/sspgame/ssptodo.txt

Making several good patches, which are accepted, is a good way of convincing us you have what it takes to be on the development team.

==Style==
The files in the engine and the respective game modules use slightly differing styles... The easiest way is simply to remain consistent with the style present in the file.

===Braces===

Braces are not indented and are to be placed on a new line (unless the statement in question is a one liner). Braces are not required inside switch statements. They are not required after if's or else's either, PROVIDED there's only 1 statement following their invocation.

===Indents===

Indents are done either via Tabulators or 4 spaces. Make sure you know which style the files use, and that your text editor currently uses that style before modifying them. Hirato uses a size of 8 spaces for the Tabulators, mimicking him might help you identify the style in the files.

'''things to indent'''
* The body within braces
* cases within a switch
* any lines beyond the first of a macro
* items after their respective if and else statements

===One-liners===

One liners are permitted, but only if they are short small and simple. If the length is in excess of 30 characters, you should consider just expanding it out instead.

===Pointers===

To help ease confusion, pointers are written C style. That is next to the variable name (char *string) instead of next to the type (char* string).
To those not in the know, char* string1, string2; does not declare two pointers, but a pointer and a character.

===Whitespace===

when declaring functions, there must be 1 empty line of whitespace between the end of the prior definition and the beginning of the new one. Variables and prototype definitions may be declared without any whitespace between each declaration. Provided they are grouped sensibly. It's recommended that the code also be grouped into 2-10 line blocks which concentrate on a certain aspect to help with readability. A series of one liners may also be grouped without spaces between.

==licensing==

By sending in your code, YOU give US permission to relicense the code under the zlib/libpng license and include it as part of our source distribution(s), irregardless of the code's original license. By extension, this means you're NOT PERMITTED to REVOKE permission for us to use the code, should you decide you no longer wish for your code to be inside sandbox

=Art=

This category includes custom maps, models and textures. Just send them in, if they're of acceptable quality, and of an acceptable license, we'll add them right in. 
You can also post them on the forums, we tend to look there occasionally, and the community would doubtlessly be excited to see what people are making/working on for sandbox

==licenses==

These are a listing of licenses we recommend for art assets included in sandbox.

* Creative Commons - Attribution
* Creative Commons - Attribution + Share-Alike
* MIT/X11
* Public Domain

=Other=

==Testing==

As a rule of thumb, there are '''ALWAYS''' bugs, if you're up to it, just use sandbox as you normally would, and keep an eye out for any oddities, and put extra effort into trying to break things. Should something go wrong, give us the exact steps you took, and we'll do out best to fix it. We recommend using the [[Development|SVN version]].

See Also
* [[Development]]
* [[Bug reports]]

Package managers

2011-08-19T21:01:23Z

Mike: Protected "Package managers" ([edit=autoconfirmed] (indefinite) [move=autoconfirmed] (indefinite))

<big><big><big><big>Work in Progress</big></big></big></big>

if you don't know what the .deb and .rpm file containers are used for, or what yast, or apt, or yum, or whatever is, please go back now.

=What to modify=

Sandbox by default is set up to install inside /usr/local/sandbox, the scripts which controls this is sandbox_unix_usr, and for the source parts, src/install.sh

you should see a variable near the top named SANDBOX_DIR or similar, change it's value to point to your preferred path for installation

for /usr/bin/sandbox, link it to ${SANDBOX_DIR}/sandbox_unix_usr

The files automatically store the user's personal data inside ~/.platinumarts

=Security freaks=

Sandbox statically compiles against enet, a UDP networking library.

For those who are most likely going to be attacked by the security team for including sandbox with a statically compiled version of Enet, Compile it with dynamic links, but make sure to include the latest version of enet. The maintainer for Enet works on the cube 2 engine, and hence the most up to date version of the library can be found from the sauerbraten repository.

svn co https://sauerbraten.svn.sourceforge.net/svnroot/sauerbraten/src/enet enet

=Dependencies=

==required==
* libSDL
* libSDL_mixer
* libSDL_image
* libGL (provided by either mesa or the proprietary OpenGL drivers)

==optional==
* smpeg - for mpeg3 playback
* mikmod - for mod playback
* timidity - for mid playback

==launcher==
* wxwidgets 2.8 (unicode)

Server list

2011-08-19T21:00:37Z

Mike: Protected "Server list" ([edit=autoconfirmed] (indefinite) [move=autoconfirmed] (indefinite))

===PAS Multiplayer Servers===

There is 1 24/7 server list.
/connect 98.196.225.18 

If you have a server you want to share then edit this page to add it. 

The "Main Server" will most likely be up soon. 
My server
Description: Hello
Password:hiplzjoin
Max clients:18

===24/7 PAS Servers===
/connect 98.196.225.18

===KG SERVERS===

KG SERVER OFFER FREE SERVERS BETWEEN 5 TO 8 PM GMT+0 BUT PLEASE NOTE WE CAN NOT ALWAYS HAVE A SERVER DUE TO MOST OF THE KGSERVERS PC'S ARE FULL UP OR A ADMIN MAY NOT BE ONLINE IF YOU NEED A SERVER PLEASE TELL US 4 DAYS BEFORE YOU NEED IT PLEASE CONTACT US AT mail@host3kg.cz.cc

Current server.

SVN server: I.P 81.97.168.157

To join open up sandbox and type /connect 81.97.168.157

This server is up between 5 to 8 pm GMT+0 (Times depend on if i have a spare server at that time.

===Public Servers(Setup and Working only)===
SandBlox PAS Gaming(RPG) | Version: Current SVN | Host: sandblox.no-ip.org:22382 
SandBlox PAS Gaming(Co-Op) | Version: Current SVN | Host: sandblox.no-ip.org:22383 

===In development===
SandBlox PAS Gaming(Co-Op)for 2.6 
GMansLand OMG comming Soon

Packaging guide

2011-08-19T21:00:18Z

Mike: Protected "Packaging guide" ([edit=autoconfirmed] (indefinite) [move=autoconfirmed] (indefinite))

This is mostly a set of guidelines for people packaging up their maps for redistribution among peers in the sandbox community

it's important to note that if you intend to distribute more than the ogz itself, that you're to use zip archives, or tar archives with either bzip or gzip compression. (non-windows platforms support this natively, for windows, use 7zip or winrar)

rar is not to be used, simply for cross platform concerns (linux supports it poorly, and OSX I believe doesn't support it at all)

=What to include in the zip=

==the basic zip structure==
[] indicates a folder, - the level.

* [packages]
* - [base]
* - - map.ogz
* - - map.cfg
* - - map-art.cfg
* - - map.jpg
* - - map_big.jpg

if it's just a map, feel free to omit the base and package directories form the hierarchy.

note that other users do NOT want to pick through you archive to extract everything, so the first folder should always be packages, not the second! 
it's less painful that way, and allows some operating systems to add the files, instead of overwriting the whole packages directory.

==invalid substitutes for "map"==

When one names his map, there's a few things you can't do, you're not allowed to name the map as to...

* contains any brackets (this is includes braces and square brackets)
* contain any punctuation (the only exception is the fullstop signaling the file extension)
* contain greater than or less than signs, the engine WILL ignore them
* contain forward or back slashes

just for social standards, mapnames aren't allowed to
* contain any form of prejudice against a group of people
* contain any "swear" words

==taking the map.jpg screenshots==

'''Note: png, bmp and tga are also allowed, but not recommended (the engine will identify the extension automatically)'''

map.jpg
# go into windowed mode and resize the window to 512x512 or 1024x1024
# press Ctrl-F12 to take the screenshot
# open the screenshot in the gimp or photoshop and resize it to either 512x512 or 256x256 and save it into packages/base, whilst substituting map for the map's name (note that resolutions that are not 2^n (where n is an integer) display oddly, and mapshots above 512^512 won't be accepted)
## you might like to play with /fov to try a different/better view for the screenshot

map_big.jpg
# use your standard resolution in sandbox, such as 1024x768 (1280x960 or above is suggested, note that if the map's included in sandbox, it won't be allowed past 1280x960)
## NOTE: 2.3.3 and later (development versions), scale the images based on size, so feel free to use 16:9, anything older requires you to use 4:3.
# ctrl-F12 to take a screenshot
# open the screenshot in the gimp or photoshop and save it to packages/base as map_big.jpg, whilst substituting map for the map's name

==Custom art==

custom art created by you is to be placed in either 1 or more of the following 3 directories

* [packages]
* - [my_name]
* - [models]
* - - [my_name]
* - [sounds]
* - - [my_name]

packages/my_name is to be used for textures, music, and other graphical data 
packages/models/my_name is to be used for hosting models, and any relevant skins, which aren't going to be used as regular textures 
packages/sounds/my_name is to be used for any custom SFX you wish to add

the above assumes of course, you're including your art, while including the art of another, you can either but them in a sub directory with THEIR alias, or keep them with your files. 
<big>just don't forget to give proper attribution within the readmes</big>

Cmdline arguments

2011-08-19T21:00:01Z

Mike: Protected "Cmdline arguments" ([edit=autoconfirmed] (indefinite) [move=autoconfirmed] (indefinite))

in sandbox (and in fact, pretty much all cube 2 related projects), there are universal, server and client command line options, this is just a list of them, and their accepted values, note all arguments must be prefixed with a '-', also one big difference compared to other programs, there can be no spaces between the argument and the given value, eg -gssp

to change which arguments are used on launch by default, edit...
:'''Windows''': edit the clickhere to start bat or use the launcher
:'''Linux''': edit the sandbox_unix script, or use the launcher

=Linux/FreeBSD=

This section applies exclusively to the sandbox_unix script, note that all but -g use two dashes. run the script with -h, --help or -? for more information.

:'''g''' - sets which game module to use, valid arguments are '''''fps, movie''''' or '''''ssp'''''
:: -gfps
: '''--help''' - displays the help
: '''--debug''' - opens debug variants of binaries inside gdb using provided arguments; the user will need to launch ti manually
: '''--server''' - launches a server as opposed to a normal client (only for supported modules)
: '''--master''' - starts up a masterserver as opposed to a normal client (not included by default)

=Universal=
:'''m''' - sets which webserver to use as it's masterserver to retrieve server listings and register your server on
: -mkids.platinumarts.net

=client=
:'''q''' - sets which directory to use as home, it saves all files here
:: -qprofiles/anonymous
:'''k''' - adds a directory as if it's in the main branch, perfect for loading mods without overwriting existing files
:: -kmod
:'''r''' - executes a configuration file before any real loading begins, executes init.cfg if no arguments are given
: -rinit.cfg
:'''d''' - run the client as a dedicated server, this is already true for the server executable
:'''w''' - sets the window's width, note if it can't find -h, it'll multiple this value by 3 and divide by 4 and use that as -h
:: -w1600
:'''h''' - sets the window's height, will multiply by 4 and divide by 3 and use the new value as -w if -w can't be found
:: -h1200
:'''z''' - sets the value for depthbits, max at 32
:: -z24
:'''b''' - sets the colour depth, the desktop depth is used when at 0
:: -b32
:'''a''' - sets the value for antialiasing, should be a power of two, max at 16
:: -a4
:'''v''' - sets vsync, vsync prevents frame tearing but also caps fps at your monitor's refresh rate
:: -v1
:'''t''' - t0 or t by itself will made the game windowed, t1 will run fullscreen
::-t1
:'''s''' - sets the stencil bits, a power of two, above 0 and below 32, 1 is the default
:: -s1
:'''f''' - f0 or f by itself will run sandbox in fixed-function mode (shaders are off), if given a number (1 or 2), it'll set the shader quality to that value (with shader on of course)
:: -f2
:'''l''' - use as the start up map instead of the game module's default
:: -lvillage
:'''x''' - execute the cubescript string at startup
:: -x"musicvol 0"

=server=
note the servers have additional options available for each game module

:'''u''' - sets the maximum upload rate, best if left at 0
:: -u6000
:'''c''' - sets the maximum amountof clients that can connect to the server
:: -c12
:'''i''' - sets the ip to host the server on, if you possess multiple ips, best if left alone
:: -i123.45.67.89

==fps server==
:'''n''' - sets a name for the server for when it shows in someone's server list
:: -n"This server is awesome"
:'''p''' - sets the password needed to grab admin
:: -p123abc
:'''o''' - sets whether people can grab master with or without the need for auth
:: -o1

==movie server==
:'''n''' - sets a name for the server for when it shows in someone's server list
:: -n"This server is awesome"
:'''p''' - sets the password needed to grab admin
:: -pabc123
:'''o''' - sets whether people can grab master with or without the need for approval
:: -o1

Platinum Arts Sandbox

2011-08-19T20:58:12Z

Mike: Protected "Platinum Arts Sandbox" ([edit=autoconfirmed] (indefinite) [move=autoconfirmed] (indefinite))

About Platinum Arts Sandbox Free 3D Game Maker:

Platinum Arts Sandbox Free 3D Game Maker is an open source game design program for kids and adults. Through the ingame and cooperative editing and focus on ease of use the program is easy enough for kids to use but powerful enough for full game projects. Sandbox includes Save The Princess Gameplay, an RPG Maker, a Sidescoller maker, a Movie Maker aka Machinima, Save The Banana Base Capture, and more! Sandbox is already being used in many schools and colleges throughout the world and included in game design contests.

Platinum Arts Sandbox will be easy enough for kids to use but also powerful enough for full game projects.

Contact The Team

2011-06-05T19:03:33Z

Mike: Undo revision 966 by Daltonds1 (Talk)

Interested in getting into contact with us? Here are a few quick easy ways to do so :)

== Developer Chatroom ==

The easiest way of finding us is to join our developer chatroom.

'''NOTE: KIDS MUST HAVE PARENTAL PERMISSION TO JOIN AND WE CANNOT BE RESPONSIBLE FOR THINGS SAID IN THERE. ALSO WE ARE FREQUENTLY IDLE IN THE CHATROOM WORKING ON SANDBOX, IF YOU EXPECT A RESPONSE PLEASE WAIT'''

You can simply [http://sandboxgamemaker.com/irc/irc.html click here] or if you already have an irc client it is [irc://irc.oftc.net/sandbox irc.OFTC.net #Sandbox] In addition you can try our new [http://widget.mibbit.com/?settings=ca48890d9db5ad90e8d98c1d1d3ce14b&server=irc.oftc.net&channel=%23sandbox&noServerTab=false&autoConnect=true mibbit link].

If you don't want to use your webbrowser to connect to the chatroom, and instead want to use a standalone program, then you can use Xchat at http://silverex.org This is the free version of xchat, as the main version of xchat has a 30 day trial. 
Instructions: 
1)In the xchat menu to go the network list 
2)Find OFTC or add irc.OFTC.net then select edit 
3) In favorite channels add #sandbox and set it to autoconnect 
4) With OFTC still highlighted, hit connect and join us :D 

== Forums ==

Obviously we check this on a regular basis so feel free to post there. http://forum.sandboxgamemaker.com

== E-mail ==

You can contact us at PlatinumArts@gmail.com PLEASE NO TECHNICAL SUPPORT QUESTIONS. PLACE TECHNICAL SUPPORT QUESTIONS IN THE FORUM OR CHATROOM

Main Page

2011-06-05T19:02:14Z

Mike: Reverted edits by Bentley (Talk) to last revision by Kid Matthew

'''Platinum Arts Sandbox Free 3D Game Maker''' is a 3D game maker based on the Cube 2 engine that allows users to quickly and easily create and edit their own worlds in game, even cooperatively. It is free, open source, and easy to use for Kids and Adults. Sandbox logo by [http://sashazavisha.deviantart.com/art/young-creator-120946941 sashaZavisha].

<div style="width:49%;float:left;">

== General information ==

* [[Platinum Arts Sandbox|About Platinum Arts Sandbox]]
* [http://SandboxGameMaker.com Project homepage]
* [[FAQ]]
* [[Contact The Team]]
* [[cmdline arguments|Command line Arguments]]
* [[packaging guide|The Packaging Guide]]
* [[server list|List Of Sandbox Servers]]

== Installation ==

* [[Installing Platinum Arts Sandbox]]
* [[Compiling the source code]]
* [[package managers|Some Notes for package managers]]

== Development ==

* [[bug reports|Bug Reports]]
* [[Contributing]]
* [[development|Obtaining the development version]]
* [[Todo|To do list]]
* [[content request| Content Request - Help us out!!]]

== Kid Friendly RPG ==
* [[Concept Document]]
* [[Brainstorming area]]

== Master Chef Ogro 2 ==
* [[Brainstorming]]

== Undercover Kids Game ==
* [[To Do List]]

</div>
<div style="width:49%;float:right;">

== Getting started ==

* [[Map Editing Basics]]
* [[Mapping Taboos]]
* [[Beginner's video tutorials]]
* [[Good free programs for Sandbox]]

== Advanced topics ==

* [[Cooperative Editing]] (Server set up)
* [[Cooperative Editing 2]] (Without Port forwarding)
* [[Adding Models to Sandbox]]
* [http://sandboxgamemaker.com/platinumartssandboxeditref.html Editing Reference Guide]
* [http://sauerbraten.org/docs/models.html Model Reference Guide]
* [[Configuration Reference Guide]]
* [[Cubescript]]
* [[Menu Editing]] ([[New menu editing|newui]])
* [[map_config|Map Configuration]]

== Example Modules ==

* [[FPS|FPS - First Person Shooter (default)]]
* [[RPG|RPG - Role Playing Game]]
* [[SSP|SSP - Side Scrolling Platformer]]
* [[MovieCube|MovieCube - Machinima Tool]]
* [[Vehicle Simulator]]

== Tutorials ==

*[[Tutorials List | Text Tutorials List]]
*[[Video Tutorials List]]
</div>

__NOTOC__

Compiling the source code

2010-12-11T20:35:18Z

Mike: /* Windows */

This page discusses on how to modify and compile the source code.

=Windows=

Click here to download the version of Codeblocks '''with the mingw compiler''':
[http://www.codeblocks.org/downloads/26]

Then go into your \src\windows folder. Click on sandbox.cbp and codeblocks should load up. Go to build and then build and it should create the Windows binary :)

If you get "Invalid Compiler" when building, you need to set up the Mingw Compiler location. When you are in Codeblocks go to "Settings" > "Compiler and Debugger". Then click the ">" button until you get to "Toolchain Executables". Click the "Auto-Detect" button. It should find the Mingw folder, if it is pointing to the wrong location click the "..." button and find the folder yourself.

If you are getting errors while compiling such as having to do with "_UnwindResume" you might have to link the libraries. You could do so like this: Go to "Settings" > "Compiler and Debugger", then click Linker Settings. Under link libraries click "Add" and go to the \src\lib folder then highlight all the ".lib" files and click "Ok". Now try compiling! :D

Other Methods: There is a visual C++ project file included that you can use. Load up the proper file and compile :) I'm not sure if you'd need any libraries but you probably shouldn't need any.

=Linux=

<big>NOTE</big> The Binaries are compiled for 32 bit systems, so if you're on a 64 bit system, you'll have to 1) compile your own, by using modified versions of the below instructions, or 2) install and use 32 bit libraries.

==Makefile==

First of all, make sure you have the the SDL and SDL_Image and SDL_Mixer development libraries installed on your system.
Next up, go into src folder. and type 'make', you can add one of the following at the end of the line

* all - compiles the client
* libenet - compiles enet library
* clean - cleans up temporary files
* client - builds enet and integrates it into a client
* install - compiles enet and the client, and compies the client in /bin_unix/
* distinstall - creates a directory names /usr/local/sandbox/, and copies everything in there. it then sets permissions and some symlinks, so you can play the game by typing 'sandbox' into a console.
* distclean - deletes /usr/local/sandbox/

The compile automatically defaults to 'all'

Chances are, you won't have everything you needed installed, so if you receive any errors from missing devel libraries and frameworks, just installed them too.
if you receive errors similar "bash: ./configure: /bin/sh^M: bad interpreter" you'll need to use a dos to unix converted (such as tofrodos) to convert them to a unix friendly format.

==Debug==

A debug file is already set up. Debug versions can be compiled by invoking...
<code>
make -C src -f Makefile.debug install
</code>

After this, you'd start up gdb with the game mode of your choice, for example....

<code>
# this will load up gdb using the 32 bit FPS client
gdb bin/debug_client_32_fps

# this will execute sandbox, provide any additional arguments which were used
run -q${HOME}/.platinumarts -r

# when sandbox crashes, this will produce a back which will be very useful to us
bt full
</code>

There are plenty of additional features available through gdb, but they are beyond the scope of this synopsis.

=MAC OSX=

To start, you should have Xcode installed on your computer. Either install the Developer tools from the OS X install disks that came with your computer, or download Xcode from the apple website:
http://developer.apple.com/technology/xcode.html

Building the app for PPC and Intel macs differs from that point. Once you get Xcode running, stop there.

For PPC users only:
Download SDL: http://www.libsdl.org/release/SDL-1.2.9.dmg
Copy the SDL.framework folder to /Library/Frameworks

Download SDL_Image: http://www.libsdl.org/projects/SDL_image/release/SDL_image-1.2.9.dmg
Copy the SDL_image.framework folder to /Library/Frameworks

Download SDL_Mixer: http://www.libsdl.org/projects/SDL_mixer/release/SDL_mixer-1.2.8.dmg
Copy the SDL_mixer.framework folder to /Library/Frameworks

There is no SDL for Intel users so you have to compile that by yourself:
[http://www.libsdl.org/release/SDL-1.2.14.tar.gz]
[http://www.libsdl.org/release/SDL-1.2.14.zip]

Put the .framework file for each into ""/System/Library/Frameworks/"" or where-ever you keep your frameworks.

Download the latest Multiplatform.zip of Sandbox. Unzip and double click on PASX.X.Xmultiplatform/src/xcode/sandbox.xcodeproj

Xcode will open the project.

1. First remove the folder "Other Sources". When asked, only delete references and not the files themselves.

2. Right click(ctrl+click) and select "Add" then "New Group". This will make a new folder. Rename it to "Other Sources".

3. Now, right click(ctrl+click) on the new "Other Sources" and select "Add" then "Existing Files...", when asked add the folder "fpsgame".

4. Repeat that process for the folders "shared","enet",and "engine". Then go into "engine" and remove the reference to "master.cpp".

5. Now that we have our source updated, lets change the configuration to something better suited for us. Change ''''Architectures'''' from "ppc i386" to your architecture (ppc for power pc and i386 for intel).

6. Go to the "Project" menu and click "Edit Project Settings". Find "Framework Search Paths" and add ''''/System/Library/Frameworks'''' (no slash on the end) and remove ''''$(USER_LIBRARY_DIR)/Frameworks/'''' as frameworks are not normally installed there. Put ''''/System/Library/Frameworks'''' first.

7. Exit the settings editor. Change the '''Active Build Configuration''' from ''Debug'' to ''Release''. Click on build - the Binary should compile ''without''.

By default the executables, launcher and sandbox, are created in the folder PASX.X.Xmultiplatform/src/xcode/build/Release/

Rename the PASX.X.Xmultiplatform folder to ''sandbox'' and move the compiled sandbox.app into the top level of that folder. The launcher.app should be on the same level, but outside, the renamed ''sandbox'' folder.

If you still have problems compiling, remove the folder ''includes'' inside ''enet''.

--[[User:Popinman32|Popinman32]] 22:28, 6 August 2010 (UTC)

Maintained by Popinman32 and other MacOSX users.

=FreeBSD=

Unwritten

Compiling the source code

2010-12-11T20:34:11Z

Mike: /* Windows */

This page discusses on how to modify and compile the source code.

=Windows=

Click here to download the version of Codeblocks with the mingw compiler:
[http://www.codeblocks.org/downloads/26]

Then go into your \src\windows folder. Click on sandbox.cbp and codeblocks should load up. Go to build and then build and it should create the Windows binary :)

If you get "Invalid Compiler" when building, you need to set up the Mingw Compiler location. When you are in Codeblocks go to "Settings" > "Compiler and Debugger". Then click the ">" button until you get to "Toolchain Executables". Click the "Auto-Detect" button. It should find the Mingw folder, if it is pointing to the wrong location click the "..." button and find the folder yourself.

If you are getting errors while compiling such as having to do with "_UnwindResume" you might have to link the libraries. You could do so like this: Go to "Settings" > "Compiler and Debugger", then click Linker Settings. Under link libraries click "Add" and go to the \src\lib folder then highlight all the ".lib" files and click "Ok". Now try compiling! :D

Other Methods: There is a visual C++ project file included that you can use. Load up the proper file and compile :) I'm not sure if you'd need any libraries but you probably shouldn't need any.

=Linux=

<big>NOTE</big> The Binaries are compiled for 32 bit systems, so if you're on a 64 bit system, you'll have to 1) compile your own, by using modified versions of the below instructions, or 2) install and use 32 bit libraries.

==Makefile==

First of all, make sure you have the the SDL and SDL_Image and SDL_Mixer development libraries installed on your system.
Next up, go into src folder. and type 'make', you can add one of the following at the end of the line

* all - compiles the client
* libenet - compiles enet library
* clean - cleans up temporary files
* client - builds enet and integrates it into a client
* install - compiles enet and the client, and compies the client in /bin_unix/
* distinstall - creates a directory names /usr/local/sandbox/, and copies everything in there. it then sets permissions and some symlinks, so you can play the game by typing 'sandbox' into a console.
* distclean - deletes /usr/local/sandbox/

The compile automatically defaults to 'all'

Chances are, you won't have everything you needed installed, so if you receive any errors from missing devel libraries and frameworks, just installed them too.
if you receive errors similar "bash: ./configure: /bin/sh^M: bad interpreter" you'll need to use a dos to unix converted (such as tofrodos) to convert them to a unix friendly format.

==Debug==

A debug file is already set up. Debug versions can be compiled by invoking...
<code>
make -C src -f Makefile.debug install
</code>

After this, you'd start up gdb with the game mode of your choice, for example....

<code>
# this will load up gdb using the 32 bit FPS client
gdb bin/debug_client_32_fps

# this will execute sandbox, provide any additional arguments which were used
run -q${HOME}/.platinumarts -r

# when sandbox crashes, this will produce a back which will be very useful to us
bt full
</code>

There are plenty of additional features available through gdb, but they are beyond the scope of this synopsis.

=MAC OSX=

To start, you should have Xcode installed on your computer. Either install the Developer tools from the OS X install disks that came with your computer, or download Xcode from the apple website:
http://developer.apple.com/technology/xcode.html

Building the app for PPC and Intel macs differs from that point. Once you get Xcode running, stop there.

For PPC users only:
Download SDL: http://www.libsdl.org/release/SDL-1.2.9.dmg
Copy the SDL.framework folder to /Library/Frameworks

Download SDL_Image: http://www.libsdl.org/projects/SDL_image/release/SDL_image-1.2.9.dmg
Copy the SDL_image.framework folder to /Library/Frameworks

Download SDL_Mixer: http://www.libsdl.org/projects/SDL_mixer/release/SDL_mixer-1.2.8.dmg
Copy the SDL_mixer.framework folder to /Library/Frameworks

There is no SDL for Intel users so you have to compile that by yourself:
[http://www.libsdl.org/release/SDL-1.2.14.tar.gz]
[http://www.libsdl.org/release/SDL-1.2.14.zip]

Put the .framework file for each into ""/System/Library/Frameworks/"" or where-ever you keep your frameworks.

Download the latest Multiplatform.zip of Sandbox. Unzip and double click on PASX.X.Xmultiplatform/src/xcode/sandbox.xcodeproj

Xcode will open the project.

1. First remove the folder "Other Sources". When asked, only delete references and not the files themselves.

2. Right click(ctrl+click) and select "Add" then "New Group". This will make a new folder. Rename it to "Other Sources".

3. Now, right click(ctrl+click) on the new "Other Sources" and select "Add" then "Existing Files...", when asked add the folder "fpsgame".

4. Repeat that process for the folders "shared","enet",and "engine". Then go into "engine" and remove the reference to "master.cpp".

5. Now that we have our source updated, lets change the configuration to something better suited for us. Change ''''Architectures'''' from "ppc i386" to your architecture (ppc for power pc and i386 for intel).

6. Go to the "Project" menu and click "Edit Project Settings". Find "Framework Search Paths" and add ''''/System/Library/Frameworks'''' (no slash on the end) and remove ''''$(USER_LIBRARY_DIR)/Frameworks/'''' as frameworks are not normally installed there. Put ''''/System/Library/Frameworks'''' first.

7. Exit the settings editor. Change the '''Active Build Configuration''' from ''Debug'' to ''Release''. Click on build - the Binary should compile ''without''.

By default the executables, launcher and sandbox, are created in the folder PASX.X.Xmultiplatform/src/xcode/build/Release/

Rename the PASX.X.Xmultiplatform folder to ''sandbox'' and move the compiled sandbox.app into the top level of that folder. The launcher.app should be on the same level, but outside, the renamed ''sandbox'' folder.

If you still have problems compiling, remove the folder ''includes'' inside ''enet''.

--[[User:Popinman32|Popinman32]] 22:28, 6 August 2010 (UTC)

Maintained by Popinman32 and other MacOSX users.

=FreeBSD=

Unwritten

Compiling the source code

2010-12-11T20:33:18Z

Mike: /* Windows */

This page discusses on how to modify and compile the source code.

=Windows=

Click here to download the version of Codeblocks with the mingw compiler:
[http://prdownload.berlios.de/codeblocks/codeblocks-10.05mingw-setup.exe]

Then go into your \src\windows folder. Click on sandbox.cbp and codeblocks should load up. Go to build and then build and it should create the Windows binary :)

If you get "Invalid Compiler" when building, you need to set up the Mingw Compiler location. When you are in Codeblocks go to "Settings" > "Compiler and Debugger". Then click the ">" button until you get to "Toolchain Executables". Click the "Auto-Detect" button. It should find the Mingw folder, if it is pointing to the wrong location click the "..." button and find the folder yourself.

If you are getting errors while compiling such as having to do with "_UnwindResume" you might have to link the libraries. You could do so like this: Go to "Settings" > "Compiler and Debugger", then click Linker Settings. Under link libraries click "Add" and go to the \src\lib folder then highlight all the ".lib" files and click "Ok". Now try compiling! :D

Other Methods: There is a visual C++ project file included that you can use. Load up the proper file and compile :) I'm not sure if you'd need any libraries but you probably shouldn't need any.

=Linux=

<big>NOTE</big> The Binaries are compiled for 32 bit systems, so if you're on a 64 bit system, you'll have to 1) compile your own, by using modified versions of the below instructions, or 2) install and use 32 bit libraries.

==Makefile==

First of all, make sure you have the the SDL and SDL_Image and SDL_Mixer development libraries installed on your system.
Next up, go into src folder. and type 'make', you can add one of the following at the end of the line

* all - compiles the client
* libenet - compiles enet library
* clean - cleans up temporary files
* client - builds enet and integrates it into a client
* install - compiles enet and the client, and compies the client in /bin_unix/
* distinstall - creates a directory names /usr/local/sandbox/, and copies everything in there. it then sets permissions and some symlinks, so you can play the game by typing 'sandbox' into a console.
* distclean - deletes /usr/local/sandbox/

The compile automatically defaults to 'all'

Chances are, you won't have everything you needed installed, so if you receive any errors from missing devel libraries and frameworks, just installed them too.
if you receive errors similar "bash: ./configure: /bin/sh^M: bad interpreter" you'll need to use a dos to unix converted (such as tofrodos) to convert them to a unix friendly format.

==Debug==

A debug file is already set up. Debug versions can be compiled by invoking...
<code>
make -C src -f Makefile.debug install
</code>

After this, you'd start up gdb with the game mode of your choice, for example....

<code>
# this will load up gdb using the 32 bit FPS client
gdb bin/debug_client_32_fps

# this will execute sandbox, provide any additional arguments which were used
run -q${HOME}/.platinumarts -r

# when sandbox crashes, this will produce a back which will be very useful to us
bt full
</code>

There are plenty of additional features available through gdb, but they are beyond the scope of this synopsis.

=MAC OSX=

To start, you should have Xcode installed on your computer. Either install the Developer tools from the OS X install disks that came with your computer, or download Xcode from the apple website:
http://developer.apple.com/technology/xcode.html

Building the app for PPC and Intel macs differs from that point. Once you get Xcode running, stop there.

For PPC users only:
Download SDL: http://www.libsdl.org/release/SDL-1.2.9.dmg
Copy the SDL.framework folder to /Library/Frameworks

Download SDL_Image: http://www.libsdl.org/projects/SDL_image/release/SDL_image-1.2.9.dmg
Copy the SDL_image.framework folder to /Library/Frameworks

Download SDL_Mixer: http://www.libsdl.org/projects/SDL_mixer/release/SDL_mixer-1.2.8.dmg
Copy the SDL_mixer.framework folder to /Library/Frameworks

There is no SDL for Intel users so you have to compile that by yourself:
[http://www.libsdl.org/release/SDL-1.2.14.tar.gz]
[http://www.libsdl.org/release/SDL-1.2.14.zip]

Put the .framework file for each into ""/System/Library/Frameworks/"" or where-ever you keep your frameworks.

Download the latest Multiplatform.zip of Sandbox. Unzip and double click on PASX.X.Xmultiplatform/src/xcode/sandbox.xcodeproj

Xcode will open the project.

1. First remove the folder "Other Sources". When asked, only delete references and not the files themselves.

2. Right click(ctrl+click) and select "Add" then "New Group". This will make a new folder. Rename it to "Other Sources".

3. Now, right click(ctrl+click) on the new "Other Sources" and select "Add" then "Existing Files...", when asked add the folder "fpsgame".

4. Repeat that process for the folders "shared","enet",and "engine". Then go into "engine" and remove the reference to "master.cpp".

5. Now that we have our source updated, lets change the configuration to something better suited for us. Change ''''Architectures'''' from "ppc i386" to your architecture (ppc for power pc and i386 for intel).

6. Go to the "Project" menu and click "Edit Project Settings". Find "Framework Search Paths" and add ''''/System/Library/Frameworks'''' (no slash on the end) and remove ''''$(USER_LIBRARY_DIR)/Frameworks/'''' as frameworks are not normally installed there. Put ''''/System/Library/Frameworks'''' first.

7. Exit the settings editor. Change the '''Active Build Configuration''' from ''Debug'' to ''Release''. Click on build - the Binary should compile ''without''.

By default the executables, launcher and sandbox, are created in the folder PASX.X.Xmultiplatform/src/xcode/build/Release/

Rename the PASX.X.Xmultiplatform folder to ''sandbox'' and move the compiled sandbox.app into the top level of that folder. The launcher.app should be on the same level, but outside, the renamed ''sandbox'' folder.

If you still have problems compiling, remove the folder ''includes'' inside ''enet''.

--[[User:Popinman32|Popinman32]] 22:28, 6 August 2010 (UTC)

Maintained by Popinman32 and other MacOSX users.

=FreeBSD=

Unwritten

FAQ

2010-06-27T12:16:50Z

Mike: /* How do I add an NPC to the game? */

A list of questions we've been asked and the answers too them 
This is still an FAQ as the order of the questions and answers will be rearranged periodically based on the frequency they've been asked

You may wish to use Ctrl-F with a few keywords (eg model) to find your query with a common solution faster

= General =

== '''The game starts up, and closes shortly afterwards''' ==

This is sort of an ambiguous situation, read carefully

:'''A1:''' If you saw a message similar to, could not load core textures, you're trying to run the bin directly, or in the wrong directory. please use the sandbox_unix bash script, or the click_me_to_start batch, or the Launcher.
:'''A2:''' You might have broken/corrupt drivers. Please install the newest ones provided by your GPU (aka, video card) manufacturer, especially if you use windows, since Microsoft's default OGL (WGL) implementation is horrible and is hardly capable of running sandbox.
:'''A3:''' Your graphics card might not have shader support, though sandbox should automatically turn it off, if it doesn't, use the launcher turn shaders off. Otherwise in linux enter -f in the launch command. On windows, open CLICK_ME_TO_START.bat with notepad (or you can right click the file and select edit) and add -f after the sandbox.exe Note: If given a number (f1 or f2), it'll set the shader quality to that value.
:'''A4:''' If you have an '''ATI card''' you might need to do this "I found that it wont run unless you disable the Catalyst A.I. After i did that it loaded right up! Hope this helps anyone that has problems running sandbox." Thanks Fudwumper!!

== '''I have really low FPS and/or bad performance, what do I do?''' ==

:'''A1:''' Make sure you update your graphics card drivers. Also just because you have a new computer doesn't mean you have the latest graphic cards drivers.
:'''A2:''' Lower the resolution
:'''A3:''' Try turning shaders off

== '''Are there weapons in Sandbox?''' ==

Sandbox is intended to be kid friendly. In the RPG there is "action" with a melee vegetable extractor and spells. Also we will be doing a child friendly squirt gun battle mode. However if someone wanted to make adult violence from the rpg and water gun mode they certainly could though that is not our current focus.

=='''How do I edit/play MULTIPLAYER with my friends/other people?'''==

Our next release will include a master server so people can see all the servers available, but currently you need to directly connect to the server. For instructions on how to do this and how to set up a server [http://sandboxgamemaker.com/wiki/index.php?title=Cooperative_Editing please see this link].

== '''How do I add my own models and characters to Sandbox?''' ==

Please see the [[Adding_Models_to_Sandbox]] page for tutorials on model creation and bringing your creations into Sandbox.

=='''My Mouse only has 1 button''' ==

:This means you don't have access to a scroll wheel, which is mostly referred to as universal delta in the documentation.
:'''A1:''' go into options and click the "''PG UP and PG DN as universal delta''"
:'''A2:''' delete config*.cfg and open data/defaults.cfg and modify the mouse4 and mouse 5 binds, mouse 2 and 3 (right and wheel clicks respectively) are mostly for convenience and not nearly as important as the wheel.
:'''A3:''' Obtain a mouse with a scroll wheel :P

= Editing =

=='''How do I add an NPC to the game?'''==

Take a look at village.cfg and savetheprincess.cfg which are located in the packages/base folder. You can open them with a text editor such as notepad or wordpad. If you check out where the models are listed you'll notice near the end of the savetheprincess.cfg that there is mmodel rc/pink This is the princess. To add this to your own map you can either copy this config and rename it to exactly what your map is named, or you can create your own config and add it at the bottom of the list. To create your own config all you have to do is create a new text document, name it exactly how your map is spelled and change the .txt at the end to .cfg [http://www.svn.kids.platinumarts.net/32pas32/trunk/packages/base/fps/savetheprincess.cfg Savetheprincess.cfg for reference]

=='''How do I make an NPC talk and/or give quests?'''==

Review the previous question on how to add the npc. If you look at the savetheprincess.cfg you'll notice this
level_trigger_1 = [showgui Princess-Robochimp]
newgui Princess-Robochimp [
guitext "Thank you for saving me!" chat
guitext "You're my hero!" chat
]

That is the format for making a character talk. You can copy and modify that code according to what you'd like your character to say. Now you need to into the map and fly over to Princess robochimp. In edit mode click on her and then press . Make sure to press enter after you've made your modifications to save the entity. If you set the 3rd attribute to 1 she'll talk once, if set at 11 she'll talk each time she is approached. For the 4th attribute it needs to be set to 1 to correspond to the code in the config. If it was level_trigger_2 in the config then that 4th attribute would need to be 2. If notice in Savetheprincess the 1 1 values to make her talk are actually in an invisible model close to her. This is so that it shows her idle animation (jumping with the arms up). To make a model invisible set the 2nd attribute to 0. Setting up quests works in a similar fashion, check out village.cfg and take a look at the quest code. Try changing it to what you are looking to do. For a version that isn't so complicated [http://sandboxgamemaker.com/villageold.cfg check out the old version of village.cfg] that I modified to be a quest to find five keys.

=='''How do I make items that can be picked up?'''==

Please review the previous question. The third attribute needs to be 12 and then it will be picked up.

=='''How do I add creatures such as butterflies to my map'''==

:Type /newent creature 0-6 Note: 0 is the butterfly, 1 the dragon, etc
:note if you're using 2.2.0 or older, it's /newent monster

=='''How do I light my map?'''==

A basic way to do it is first select an area on the map where you want to place it. Then go to the new light menu. Make sure you select a color and a radius and then select create light. You can either enter /calclight in the console or you can go to editing gui and then lighting and select what options you want when creating your lights. Finish the process and your map will be lit according to the light you created :) [http://www.kids.platinumarts.net/wiki/index.php?title=Lighting Check here for more detailed information]

=='''The lights aren't working'''==

:'''A1:''' Check if you placed any lights inside mapmodels or geometry
:'''A2:''' Did you calculate lightmaps? ie, the /calclight and /patchlight commands
:'''A3:''' Does the light have a very small radius, or RGB values of 0? ie light 256 0 0 0 won't make any light, light 256 200 100 50 should emit a relatively bright orange.

=='''How do I make sloped "roofs" like those in house?'''==

Note, this refers to sloped geometry in general

:'''A1:''' Hold the middle mouse button, and selected the vertices (point were 2 or more edges meet) you wish to edit, and scroll up/down to deform the cube
:'''A2:''' Select 1 or more cubes, and hold in Q. Scroll while hovering over a vertice to deform that specific vertice in the whole selection
:'''A3:''' select 1 or more cubes, and hold F. Scroll the wheel to deform the whole face (collection of 3 or 4 vertices, note computers are limited to triangles and quadrilaterals, a circle for example is a series of triangles).

=='''How do I create grass?'''==

First make sure grass is turned on! (/grass 1)

Hold the Y button down and scroll with the mouse wheel until you come to the texture that includes the 3D grass. To change what texture the grass is linked with check /data/default_map_settings.cfg

To add grass, add a autograss "texture" to a texture's loading statement

=='''How do I create rain or snow?'''==
To add a water particle entity to the map:

:Type /newent particles 10 300 256 868 1000 in the console

10 is the type, 300 the shape, 256 the radius, 868, a 12 bit colour, 1000 the fading time

To add snow particles entity to the map:

:Type /newent particles 12 300 256 0xFFFFFA 10000 0 0 0

=='''I can't see my custom mapmodels'''==
:'''A1''' Check that the mmodel command of the model you're trying to load points to a valid object, relevant to packages/models, if you use windows, just invert the slash (note that the model listings are generated automatically on mapsave from 2.3 onwards)
:'''A2''' is there a tris.* present? or a md*.cfg or an obj.cfg loading the current model if it isn't named tris.*?
:'''A3''' note that mmodel is directed to a directory, not to the model file

=='''How do I edit my map's configuration'''==
:'''A1''' use an external file editor like notepad or kate to open the respective map configuration
:'''A2''' enter editmode, and press F6, then the load button in the GUI that appears

'''Is there any program to make editing easier?'''

:'''A1''' Yes, It's called Notepad++. You can download it here http://notepad-plus.sourceforge.net/uk/site.htm

= Other =

=='''Are there any sandbox user groups?'''==
:In short no, if there are any, we're not aware of them

=='''Can I use sandbox maps in (insert fave game here)'''==
:In most cases this can't be done, unless the engine you're using happens to be cube 2, or has support for the cube 2 octree map format. However you can export the map geometry to .obj format using the command /writeobj

Platinum Arts Sandbox

2010-06-27T11:31:41Z

Mike:

Main Page

2010-02-11T20:47:28Z

Mike: Undo revision 662 by Fallen47 (Talk)

'''Platinum Arts Sandbox Free 3D Game Maker''' is a 3D game maker based on the Cube 2 engine that allows users to quickly and easily create and edit their own worlds in game, even cooperatively. It is free, open source, and easy to use for Kids and Adults. Sandbox logo by [http://sashazavisha.deviantart.com/art/young-creator-120946941 sashaZavisha].

<div style="width:49%;float:left;">

== General information ==

* [[Platinum Arts Sandbox|About Platinum Arts Sandbox]]
* [http://SandboxGameMaker.com Project homepage]
* [[FAQ]]
* [[Contact The Team]]
* [[cmdline arguments|Command line Arguments]]
* [[packaging guide|The Packaging Guide]]
* [[server list|List Of Sandbox Servers]]

== Installation ==

* [[Installing Platinum Arts Sandbox]]
* [[Compiling the source code]]
* [[package managers|Some Notes for package managers]]

== Development ==

* [[bug reports|Bug Reports]]
* [[Contributing]]
* [[development|Obtaining the development version]]
* [[content request| Content Request - Help us out!!]]

== Getting started ==

* [[Map Editing Basics]]
* [[Mapping Taboos]]
* [[Beginner's video tutorials]]
* [[Good free programs for Sandbox]]

</div>
<div style="width:49%;float:right;">

== Advanced topics ==

* [[Cooperative Editing]] (Server set up)
* [[Adding Models to Sandbox]]
* [http://sandboxgamemaker.com/platinumartssandboxeditref.html Editing Reference Guide]
* [http://sauerbraten.org/docs/models.html Model Reference Guide]
* [[Configuration Reference Guide]]
* [[Translations|Engine/menu translations]]
* [[Cubescript|Programming in Cubescript]]
* [[map_config|Map Configuration]]
* [[musicpacks|Music Pack Documentation]]

== Tutorials ==

* [[Mapmodels|Loading and adding mapmodels]]
* [[Menu Editing|How to modify the menu]]
* [[Lighting|How to light a map properly]] 
* [[Creating a shop script]]
* [[Wings3D to Sandbox flash tutorials]]
* [[Importing .OBJ files]]
* [[Adding custom textures to a new map]]
* [[Glowmaps]]
* [[MovieCube]]

== Kid Friendly RPG ==
* [[Concept Document]]
* [[Brainstorming area]]

== Master Chef Ogro 2 ==
* [[Brainstorming]]

== Undercover Kids Game ==
* [[To Do List]]

</div>

__NOTOC__

Main Page

2010-01-22T04:16:04Z

Mike:

'''Platinum Arts Sandbox Free 3D Game Maker''' is a 3D game maker based on the Cube 2 engine that allows users to quickly and easily create and edit their own worlds in game, even cooperatively. It is free, open source, and easy to use for Kids and Adults. Sandbox logo by [http://sashazavisha.deviantart.com/art/young-creator-120946941 sashaZavisha].

<div style="width:49%;float:left;">

== General information ==

* [[Platinum Arts Sandbox|About Platinum Arts Sandbox]]
* [http://SandboxGameMaker.com Project homepage]
* [[FAQ]]
* [[Contact The Team]]
* [[cmdline arguments|Command line Arguments]]
* [[packaging guide|The Packaging Guide]]

== Installation ==

* [[Installing Platinum Arts Sandbox]]
* [[Compiling the source code]]
* [[package managers|Some Notes for package managers]]

== Development ==

* [[bug reports|Bug Reports]]
* [[Contributing]]
* [[development|Obtaining the development version]]
* [[content request| Content Request - Help us out!!]]

== Getting started ==

* [[Map Editing Basics]]
* [[Mapping Taboos]]
* [[Beginner's video tutorials]]
* [[Good free programs for Sandbox]]

</div>
<div style="width:49%;float:right;">

== Advanced topics ==

* [[Cooperative Editing]] (Server set up)
* [[Adding Models to Sandbox]]
* [http://sandboxgamemaker.com/platinumartssandboxeditref.html Editing Reference Guide]
* [http://sauerbraten.org/docs/models.html Model Reference Guide]
* [[Configuration Reference Guide]]
* [[Translations|Engine/menu translations]]
* [[Cubescript|Programming in Cubescript]]
* [[map_config|Map Configuration]]
* [[musicpacks|Music Pack Documentation]]

== Tutorials ==

* [[Mapmodels|Loading and adding mapmodels]]
* [[Menu Editing|How to modify the menu]]
* [[Lighting|How to light a map properly]] 
* [[Creating a shop script]]
* [[Wings3D to Sandbox flash tutorials]]
* [[Importing .OBJ files]]
* [[Adding custom textures to a new map]]
* [[Glowmaps]]
* [[MovieCube]]

== Kid Friendly RPG ==
* [[Concept Document]]
* [[Brainstorming area]]

== Master Chef Ogro 2 ==
* [[Brainstorming]]

== Undercover Kids Game ==
* [[To Do List]]

</div>

__NOTOC__

Main Page

2010-01-22T03:17:15Z

Mike:

'''Platinum Arts Sandbox Free 3D Game Maker''' is a 3D game maker based on the Cube 2 engine that allows users to quickly and easily create and edit their own worlds in game, even cooperatively. It is free, open source, and easy to use for Kids and Adults. Sandbox logo by sashaZavisha.

<div style="width:49%;float:left;">

== General information ==

* [[Platinum Arts Sandbox|About Platinum Arts Sandbox]]
* [http://SandboxGameMaker.com Project homepage]
* [[FAQ]]
* [[Contact The Team]]
* [[cmdline arguments|Command line Arguments]]
* [[packaging guide|The Packaging Guide]]

== Installation ==

* [[Installing Platinum Arts Sandbox]]
* [[Compiling the source code]]
* [[package managers|Some Notes for package managers]]

== Development ==

* [[bug reports|Bug Reports]]
* [[Contributing]]
* [[development|Obtaining the development version]]
* [[content request| Content Request - Help us out!!]]

== Getting started ==

* [[Map Editing Basics]]
* [[Mapping Taboos]]
* [[Beginner's video tutorials]]
* [[Good free programs for Sandbox]]

</div>
<div style="width:49%;float:right;">

== Advanced topics ==

* [[Cooperative Editing]] (Server set up)
* [[Adding Models to Sandbox]]
* [http://sandboxgamemaker.com/platinumartssandboxeditref.html Editing Reference Guide]
* [http://sauerbraten.org/docs/models.html Model Reference Guide]
* [[Configuration Reference Guide]]
* [[Translations|Engine/menu translations]]
* [[Cubescript|Programming in Cubescript]]
* [[map_config|Map Configuration]]
* [[musicpacks|Music Pack Documentation]]

== Tutorials ==

* [[Mapmodels|Loading and adding mapmodels]]
* [[Menu Editing|How to modify the menu]]
* [[Lighting|How to light a map properly]] 
* [[Creating a shop script]]
* [[Wings3D to Sandbox flash tutorials]]
* [[Importing .OBJ files]]
* [[Adding custom textures to a new map]]
* [[Glowmaps]]
* [[MovieCube]]

== Kid Friendly RPG ==
* [[Concept Document]]
* [[Brainstorming area]]

== Master Chef Ogro 2 ==
* [[Brainstorming]]

== Undercover Kids Game ==
* [[To Do List]]

</div>

__NOTOC__

FAQ

2010-01-20T12:41:27Z

Mike: /* I have really low FPS and/or bad performance, what do I do? */

A list of questions we've been asked and the answers too them 
This is still an FAQ as the order of the questions and answers will be rearranged periodically based on the frequency they've been asked

You may wish to use Ctrl-F with a few keywords (eg model) to find your query with a common solution faster

= General =

== '''The game starts up, and closes shortly afterwards''' ==

This is sort of an ambiguous situation, read carefully

:'''A1:''' If you saw a message similar to, could not load core textures, you're trying to run the bin directly, or in the wrong directory. please use the sandbox_unix bash script, or the click_me_to_start batch, or the Launcher.
:'''A2:''' You might have broken/corrupt drivers. Please install the newest ones provided by your GPU (aka, video card) manufacturer, especially if you use windows, since Microsoft's default OGL (WGL) implementation is horrible and is hardly capable of running sandbox.
:'''A3:''' Your graphics card might not have shader support, though sandbox should automatically turn it off, if it doesn't, use the launcher turn shaders off. Otherwise in linux enter -f in the launch command. On windows, open CLICK_ME_TO_START.bat with notepad (or you can right click the file and select edit) and add -f after the sandbox.exe Note: If given a number (f1 or f2), it'll set the shader quality to that value.
:'''A4:''' If you have an '''ATI card''' you might need to do this "I found that it wont run unless you disable the Catalyst A.I. After i did that it loaded right up! Hope this helps anyone that has problems running sandbox." Thanks Fudwumper!!

== '''I have really low FPS and/or bad performance, what do I do?''' ==

:'''A1:''' Make sure you update your graphics card drivers. Also just because you have a new computer doesn't mean you have the latest graphic cards drivers.
:'''A2:''' Lower the resolution
:'''A3:''' Try turning shaders off

== '''Are there weapons in Sandbox?''' ==

Sandbox is intended to be kid friendly. In the RPG there is "action" with a melee vegetable extractor and spells. Also we will be doing a child friendly squirt gun battle mode. However if someone wanted to make adult violence from the rpg and water gun mode they certainly could though that is not our current focus.

=='''How do I edit/play MULTIPLAYER with my friends/other people?'''==

Our next release will include a master server so people can see all the servers available, but currently you need to directly connect to the server. For instructions on how to do this and how to set up a server [http://sandboxgamemaker.com/wiki/index.php?title=Cooperative_Editing please see this link].

== '''How do I add my own models and characters to Sandbox?''' ==

Please see the [[Adding_Models_to_Sandbox]] page for tutorials on model creation and bringing your creations into Sandbox.

=='''My Mouse only has 1 button''' ==

:This means you don't have access to a scroll wheel, which is mostly referred to as universal delta in the documentation.
:'''A1:''' go into options and click the "''PG UP and PG DN as universal delta''"
:'''A2:''' delete config*.cfg and open data/defaults.cfg and modify the mouse4 and mouse 5 binds, mouse 2 and 3 (right and wheel clicks respectively) are mostly for convenience and not nearly as important as the wheel.
:'''A3:''' Obtain a mouse with a scroll wheel :P

= Editing =

=='''How do I add an NPC to the game?'''==

Take a look at village.cfg and savetheprincess.cfg which are located in the packages/base folder. You can open them with a text editor such as notepad or wordpad. If you check out where the models are listed you'll notice near the end of the savetheprincess.cfg that there is mmodel rc/pink This is the princess. To add this to your own map you can either copy this config and rename it to exactly what your map is named, or you can create your own config and add it at the bottom of the list. To create your own config all you have to do is create a new text document, name it exactly how your map is spelled and change the .txt at the end to .cfg [http://www.svn.kids.platinumarts.net/32pas32/trunk/packages/base/savetheprincess.cfg Savetheprincess.cfg for reference]

=='''How do I make an NPC talk and/or give quests?'''==

Review the previous question on how to add the npc. If you look at the savetheprincess.cfg you'll notice this
level_trigger_1 = [showgui Princess-Robochimp]
newgui Princess-Robochimp [
guitext "Thank you for saving me!" chat
guitext "You're my hero!" chat
]

That is the format for making a character talk. You can copy and modify that code according to what you'd like your character to say. Now you need to into the map and fly over to Princess robochimp. In edit mode click on her and then press . Make sure to press enter after you've made your modifications to save the entity. If you set the 3rd attribute to 1 she'll talk once, if set at 11 she'll talk each time she is approached. For the 4th attribute it needs to be set to 1 to correspond to the code in the config. If it was level_trigger_2 in the config then that 4th attribute would need to be 2. If notice in Savetheprincess the 1 1 values to make her talk are actually in an invisible model close to her. This is so that it shows her idle animation (jumping with the arms up). To make a model invisible set the 2nd attribute to 0. Setting up quests works in a similar fashion, check out village.cfg and take a look at the quest code. Try changing it to what you are looking to do. For a version that isn't so complicated [http://sandboxgamemaker.com/villageold.cfg check out the old version of village.cfg] that I modified to be a quest to find five keys.

=='''How do I make items that can be picked up?'''==

Please review the previous question. The third attribute needs to be 12 and then it will be picked up.

=='''How do I add creatures such as butterflies to my map'''==

:Type /newent creature 0-6 Note: 0 is the butterfly, 1 the dragon, etc
:note if you're using 2.2.0 or older, it's /newent monster

=='''How do I light my map?'''==

A basic way to do it is first select an area on the map where you want to place it. Then go to the new light menu. Make sure you select a color and a radius and then select create light. You can either enter /calclight in the console or you can go to editing gui and then lighting and select what options you want when creating your lights. Finish the process and your map will be lit according to the light you created :) [http://www.kids.platinumarts.net/wiki/index.php?title=Lighting Check here for more detailed information]

=='''The lights aren't working'''==

:'''A1:''' Check if you placed any lights inside mapmodels or geometry
:'''A2:''' Did you calculate lightmaps? ie, the /calclight and /patchlight commands
:'''A3:''' Does the light have a very small radius, or RGB values of 0? ie light 256 0 0 0 won't make any light, light 256 200 100 50 should emit a relatively bright orange.

=='''How do I make sloped "roofs" like those in house?'''==

Note, this refers to sloped geometry in general

:'''A1:''' Hold the middle mouse button, and selected the vertices (point were 2 or more edges meet) you wish to edit, and scroll up/down to deform the cube
:'''A2:''' Select 1 or more cubes, and hold in Q. Scroll while hovering over a vertice to deform that specific vertice in the whole selection
:'''A3:''' select 1 or more cubes, and hold F. Scroll the wheel to deform the whole face (collection of 3 or 4 vertices, note computers are limited to triangles and quadrilaterals, a circle for example is a series of triangles).

=='''How do I create grass?'''==

First make sure grass is turned on! (/grass 1)

Hold the Y button down and scroll with the mouse wheel until you come to the texture that includes the 3D grass. To change what texture the grass is linked with check /data/default_map_settings.cfg

To add grass, add a autograss "texture" to a texture's loading statement

=='''How do I create rain?'''==
To add a water particle entity to the map:

:Type /newent particles 10 300 256 868 1000 in the console

10 is the type, 300 the shape, 256 the radius, 868, a 12 bit colour, 1000 the fading time

=='''I can't see my custom mapmodels'''==
:'''A1''' Check that the mmodel command of the model you're trying to load points to a valid object, relevant to packages/models, if you use windows, just invert the slash (note that the model listings are generated automatically on mapsave from 2.3 onwards)
:'''A2''' is there a tris.* present? or a md*.cfg or an obj.cfg loading the current model if it isn't named tris.*?
:'''A3''' note that mmodel is directed to a directory, not to the model file

=='''How do I edit my map's configuration'''==
:'''A1''' use an external file editor like notepad or kate to open the respective map configuration
:'''A2''' enter editmode, and press F6, then the load button in the GUI that appears

'''Is there any program to make editing easier?'''

:'''A1''' Yes, It's called Notepad++. You can download it here http://notepad-plus.sourceforge.net/uk/site.htm

= Other =

=='''Are there any sandbox user groups?'''==
:in short no, if there are any, we're not aware of them

=='''Can I use sandbox maps in (insert fave game here)'''==
:in most cases this can't be done, unless the engine you're using happens to be cube 2, or has support for the cube 2 octree map format. However you can export the map geometry to .obj format using the command /writeobj

FAQ

2010-01-20T12:39:36Z

Mike:

A list of questions we've been asked and the answers too them 
This is still an FAQ as the order of the questions and answers will be rearranged periodically based on the frequency they've been asked

You may wish to use Ctrl-F with a few keywords (eg model) to find your query with a common solution faster

= General =

== '''The game starts up, and closes shortly afterwards''' ==

This is sort of an ambiguous situation, read carefully

:'''A1:''' If you saw a message similar to, could not load core textures, you're trying to run the bin directly, or in the wrong directory. please use the sandbox_unix bash script, or the click_me_to_start batch, or the Launcher.
:'''A2:''' You might have broken/corrupt drivers. Please install the newest ones provided by your GPU (aka, video card) manufacturer, especially if you use windows, since Microsoft's default OGL (WGL) implementation is horrible and is hardly capable of running sandbox.
:'''A3:''' Your graphics card might not have shader support, though sandbox should automatically turn it off, if it doesn't, use the launcher turn shaders off. Otherwise in linux enter -f in the launch command. On windows, open CLICK_ME_TO_START.bat with notepad (or you can right click the file and select edit) and add -f after the sandbox.exe Note: If given a number (f1 or f2), it'll set the shader quality to that value.
:'''A4:''' If you have an '''ATI card''' you might need to do this "I found that it wont run unless you disable the Catalyst A.I. After i did that it loaded right up! Hope this helps anyone that has problems running sandbox." Thanks Fudwumper!!

== '''I have really low FPS and/or bad performance, what do I do?''' ==

:'''A1:''' Make sure you update your graphics card drivers
:'''A2:''' Lower the resolution
:'''A3:''' Try turning shaders off

== '''Are there weapons in Sandbox?''' ==

Sandbox is intended to be kid friendly. In the RPG there is "action" with a melee vegetable extractor and spells. Also we will be doing a child friendly squirt gun battle mode. However if someone wanted to make adult violence from the rpg and water gun mode they certainly could though that is not our current focus.

=='''How do I edit/play MULTIPLAYER with my friends/other people?'''==

Our next release will include a master server so people can see all the servers available, but currently you need to directly connect to the server. For instructions on how to do this and how to set up a server [http://sandboxgamemaker.com/wiki/index.php?title=Cooperative_Editing please see this link].

== '''How do I add my own models and characters to Sandbox?''' ==

Please see the [[Adding_Models_to_Sandbox]] page for tutorials on model creation and bringing your creations into Sandbox.

=='''My Mouse only has 1 button''' ==

:This means you don't have access to a scroll wheel, which is mostly referred to as universal delta in the documentation.
:'''A1:''' go into options and click the "''PG UP and PG DN as universal delta''"
:'''A2:''' delete config*.cfg and open data/defaults.cfg and modify the mouse4 and mouse 5 binds, mouse 2 and 3 (right and wheel clicks respectively) are mostly for convenience and not nearly as important as the wheel.
:'''A3:''' Obtain a mouse with a scroll wheel :P

= Editing =

=='''How do I add an NPC to the game?'''==

Take a look at village.cfg and savetheprincess.cfg which are located in the packages/base folder. You can open them with a text editor such as notepad or wordpad. If you check out where the models are listed you'll notice near the end of the savetheprincess.cfg that there is mmodel rc/pink This is the princess. To add this to your own map you can either copy this config and rename it to exactly what your map is named, or you can create your own config and add it at the bottom of the list. To create your own config all you have to do is create a new text document, name it exactly how your map is spelled and change the .txt at the end to .cfg [http://www.svn.kids.platinumarts.net/32pas32/trunk/packages/base/savetheprincess.cfg Savetheprincess.cfg for reference]

=='''How do I make an NPC talk and/or give quests?'''==

Review the previous question on how to add the npc. If you look at the savetheprincess.cfg you'll notice this
level_trigger_1 = [showgui Princess-Robochimp]
newgui Princess-Robochimp [
guitext "Thank you for saving me!" chat
guitext "You're my hero!" chat
]

That is the format for making a character talk. You can copy and modify that code according to what you'd like your character to say. Now you need to into the map and fly over to Princess robochimp. In edit mode click on her and then press . Make sure to press enter after you've made your modifications to save the entity. If you set the 3rd attribute to 1 she'll talk once, if set at 11 she'll talk each time she is approached. For the 4th attribute it needs to be set to 1 to correspond to the code in the config. If it was level_trigger_2 in the config then that 4th attribute would need to be 2. If notice in Savetheprincess the 1 1 values to make her talk are actually in an invisible model close to her. This is so that it shows her idle animation (jumping with the arms up). To make a model invisible set the 2nd attribute to 0. Setting up quests works in a similar fashion, check out village.cfg and take a look at the quest code. Try changing it to what you are looking to do. For a version that isn't so complicated [http://sandboxgamemaker.com/villageold.cfg check out the old version of village.cfg] that I modified to be a quest to find five keys.

=='''How do I make items that can be picked up?'''==

Please review the previous question. The third attribute needs to be 12 and then it will be picked up.

=='''How do I add creatures such as butterflies to my map'''==

:Type /newent creature 0-6 Note: 0 is the butterfly, 1 the dragon, etc
:note if you're using 2.2.0 or older, it's /newent monster

=='''How do I light my map?'''==

A basic way to do it is first select an area on the map where you want to place it. Then go to the new light menu. Make sure you select a color and a radius and then select create light. You can either enter /calclight in the console or you can go to editing gui and then lighting and select what options you want when creating your lights. Finish the process and your map will be lit according to the light you created :) [http://www.kids.platinumarts.net/wiki/index.php?title=Lighting Check here for more detailed information]

=='''The lights aren't working'''==

:'''A1:''' Check if you placed any lights inside mapmodels or geometry
:'''A2:''' Did you calculate lightmaps? ie, the /calclight and /patchlight commands
:'''A3:''' Does the light have a very small radius, or RGB values of 0? ie light 256 0 0 0 won't make any light, light 256 200 100 50 should emit a relatively bright orange.

=='''How do I make sloped "roofs" like those in house?'''==

Note, this refers to sloped geometry in general

:'''A1:''' Hold the middle mouse button, and selected the vertices (point were 2 or more edges meet) you wish to edit, and scroll up/down to deform the cube
:'''A2:''' Select 1 or more cubes, and hold in Q. Scroll while hovering over a vertice to deform that specific vertice in the whole selection
:'''A3:''' select 1 or more cubes, and hold F. Scroll the wheel to deform the whole face (collection of 3 or 4 vertices, note computers are limited to triangles and quadrilaterals, a circle for example is a series of triangles).

=='''How do I create grass?'''==

First make sure grass is turned on! (/grass 1)

Hold the Y button down and scroll with the mouse wheel until you come to the texture that includes the 3D grass. To change what texture the grass is linked with check /data/default_map_settings.cfg

To add grass, add a autograss "texture" to a texture's loading statement

=='''How do I create rain?'''==
To add a water particle entity to the map:

:Type /newent particles 10 300 256 868 1000 in the console

10 is the type, 300 the shape, 256 the radius, 868, a 12 bit colour, 1000 the fading time

=='''I can't see my custom mapmodels'''==
:'''A1''' Check that the mmodel command of the model you're trying to load points to a valid object, relevant to packages/models, if you use windows, just invert the slash (note that the model listings are generated automatically on mapsave from 2.3 onwards)
:'''A2''' is there a tris.* present? or a md*.cfg or an obj.cfg loading the current model if it isn't named tris.*?
:'''A3''' note that mmodel is directed to a directory, not to the model file

=='''How do I edit my map's configuration'''==
:'''A1''' use an external file editor like notepad or kate to open the respective map configuration
:'''A2''' enter editmode, and press F6, then the load button in the GUI that appears

'''Is there any program to make editing easier?'''

:'''A1''' Yes, It's called Notepad++. You can download it here http://notepad-plus.sourceforge.net/uk/site.htm

= Other =

=='''Are there any sandbox user groups?'''==
:in short no, if there are any, we're not aware of them

=='''Can I use sandbox maps in (insert fave game here)'''==
:in most cases this can't be done, unless the engine you're using happens to be cube 2, or has support for the cube 2 octree map format. However you can export the map geometry to .obj format using the command /writeobj

FAQ

2010-01-20T12:28:52Z

Mike:

A list of questions we've been asked and the answers too them 
This is still an FAQ as the order of the questions and answers will be rearranged periodically based on the frequency they've been asked

you may wish to use Ctrl-F with a few keywords (eg model) to find your query with a common solution faster

= General =

'''The game starts up, and closes shortly afterwards''' 
This is sort of an ambiguous situation, read carefully

:'''A1:''' If you saw a message similar to, could not load core textures, you're trying to run the bin directly, or in the wrong directory. please use the sandbox_unix bash script, or the click_me_to_start batch, or the Launcher.
:'''A2:''' You might have broken/corrupt drivers. Please install the newest ones provided by your GPU (aka, video card) manufacturer, especially if you use windows, since Microsoft's default OGL (WGL) implementation is horrible and is hardly capable of running sandbox.
:'''A3:''' Your graphics card might not have shader support, though sandbox should automatically turn it off, if it doesn't, use the launcher turn shaders off. Otherwise in linux enter -f in the launch command. On windows, open CLICK_ME_TO_START.bat with notepad (or you can right click the file and select edit) and add -f after the sandbox.exe Note: If given a number (f1 or f2), it'll set the shader quality to that value.
:'''A4:''' If you have an '''ATI card''' you might need to do this "I found that it wont run unless you disable the Catalyst A.I. After i did that it loaded right up! Hope this helps anyone that has problems running sandbox." Thanks Fudwumper!!

'''I have really low FPS and/or bad performance, what do I do?'''
:'''A1:''' Make sure you update your graphics card drivers
:'''A2:''' Lower the resolution
:'''A3:''' Try turning shaders off

'''Are there weapons in Sandbox?''' 

Sandbox is intended to be kid friendly. In the RPG there is "action" with a melee vegetable extractor and spells. Also we will be doing a child friendly squirt gun battle mode. However if someone wanted to make adult violence from the rpg and water gun mode they certainly could though that is not our current focus.

'''How do I edit/play MULTIPLAYER with my friends/other people?''' 

Our next release will include a master server so people can see all the servers available, but currently you need to directly connect to the server. For instructions on how to do this and how to set up a server [http://sandboxgamemaker.com/wiki/index.php?title=Cooperative_Editing please see this link].

'''How do I add my own models and characters to Sandbox?'''

Please see the [[Adding_Models_to_Sandbox]] page for tutorials on model creation and bringing your creations into Sandbox.

'''My Mouse only has 1 button'''

:this means you don't have access to a scroll wheel, which is mostly referred to as universal delta in the documentation.
:'''A1:''' go into options and click the "''PG UP and PG DN as universal delta''"
:'''A2:''' delete config*.cfg and open data/defaults.cfg and modify the mouse4 and mouse 5 binds, mouse 2 and 3 (right and wheel clicks respectively) are mostly for convenience and not nearly as important as the wheel.
:'''A3:''' Obtain a mouse with a scroll wheel :P

= Editing =

'''How do I add an NPC to the game?'''

Take a look at village.cfg and savetheprincess.cfg which are located in the packages/base folder. You can open them with a text editor such as notepad or wordpad. If you check out where the models are listed you'll notice near the end of the savetheprincess.cfg that there is mmodel rc/pink This is the princess. To add this to your own map you can either copy this config and rename it to exactly what your map is named, or you can create your own config and add it at the bottom of the list. To create your own config all you have to do is create a new text document, name it exactly how your map is spelled and change the .txt at the end to .cfg [http://www.svn.kids.platinumarts.net/32pas32/trunk/packages/base/savetheprincess.cfg Savetheprincess.cfg for reference]

'''How do I make an NPC talk and/or give quests?'''

Review the previous question on how to add the npc. If you look at the savetheprincess.cfg you'll notice this
level_trigger_1 = [showgui Princess-Robochimp]
newgui Princess-Robochimp [
guitext "Thank you for saving me!" chat
guitext "You're my hero!" chat
]

That is the format for making a character talk. You can copy and modify that code according to what you'd like your character to say. Now you need to into the map and fly over to Princess robochimp. In edit mode click on her and then press . Make sure to press enter after you've made your modifications to save the entity. If you set the 3rd attribute to 1 she'll talk once, if set at 11 she'll talk each time she is approached. For the 4th attribute it needs to be set to 1 to correspond to the code in the config. If it was level_trigger_2 in the config then that 4th attribute would need to be 2. If notice in Savetheprincess the 1 1 values to make her talk are actually in an invisible model close to her. This is so that it shows her idle animation (jumping with the arms up). To make a model invisible set the 2nd attribute to 0. Setting up quests works in a similar fashion, check out village.cfg and take a look at the quest code. Try changing it to what you are looking to do. For a version that isn't so complicated [http://sandboxgamemaker.com/villageold.cfg check out the old version of village.cfg] that I modified to be a quest to find five keys.

'''How do I make items that can be picked up?'''

Please review the previous question. The third attribute needs to be 12 and then it will be picked up.

'''How do I add creatures such as butterflies to my map'''

:Type /newent creature 0-6 Note: 0 is the butterfly, 1 the dragon, etc
:note if you're using 2.2.0 or older, it's /newent monster

'''How do I light my map?'''

A basic way to do it is first select an area on the map where you want to place it. Then go to the new light menu. Make sure you select a color and a radius and then select create light. You can either enter /calclight in the console or you can go to editing gui and then lighting and select what options you want when creating your lights. Finish the process and your map will be lit according to the light you created :) [http://www.kids.platinumarts.net/wiki/index.php?title=Lighting Check here for more detailed information]

'''The lights aren't working'''

:'''A1:''' Check if you placed any lights inside mapmodels or geometry
:'''A2:''' Did you calculate lightmaps? ie, the /calclight and /patchlight commands
:'''A3:''' Does the light have a very small radius, or RGB values of 0? ie light 256 0 0 0 won't make any light, light 256 200 100 50 should emit a relatively bright orange.

'''How do I make sloped "roofs" like those in house?''' 
Note, this refers to sloped geometry in general

:'''A1:''' Hold the middle mouse button, and selected the vertices (point were 2 or more edges meet) you wish to edit, and scroll up/down to deform the cube
:'''A2:''' Select 1 or more cubes, and hold in Q. Scroll while hovering over a vertice to deform that specific vertice in the whole selection
:'''A3:''' select 1 or more cubes, and hold F. Scroll the wheel to deform the whole face (collection of 3 or 4 vertices, note computers are limited to triangles and quadrilaterals, a circle for example is a series of triangles).

'''How do I create grass?'''

first make sure grass is turned on! (/grass 1)

Hold the Y button down and scroll with the mouse wheel until you come to the texture that includes the 3D grass. To change what texture the grass is linked with check /data/default_map_settings.cfg

to add grass, add a autograss "texture" to a texture's loading statement

'''How do I create rain?'''

To add a water particle entity to the map:

:Type /newent particles 10 300 256 868 1000 in the console

10 is the type, 300 the shape, 256 the radius, 868, a 12 bit colour, 1000 the fading time

'''I can't see my custom mapmodels'''

:'''A1''' Check that the mmodel command of the model you're trying to load points to a valid object, relevant to packages/models, if you use windows, just invert the slash (note that the model listings are generated automatically on mapsave from 2.3 onwards)
:'''A2''' is there a tris.* present? or a md*.cfg or an obj.cfg loading the current model if it isn't named tris.*?
:'''A3''' note that mmodel is directed to a directory, not to the model file

'''How do I edit my map's configuration'''

:'''A1''' use an external file editor like notepad or kate to open the respective map configuration
:'''A2''' enter editmode, and press F6, then the load button in the GUI that appears

'''Is there any program to make editing easier?'''

:'''A1''' Yes, It's called Notepad++. You can download it here http://notepad-plus.sourceforge.net/uk/site.htm

= Other =

'''Are there any sandbox user groups?'''

:in short no, if there are any, we're not aware of them

'''Can I use sandbox maps in (insert fave game here)'''

:in most cases this can't be done, unless the engine you're using happens to be cube 2, or has support for the cube 2 octree map format.

FAQ

2010-01-20T12:28:05Z

Mike:

A list of questions we've been asked and the answers too them 
This is still an FAQ as the order of the questions and answers will be rearranged periodically based on the frequency they've been asked

you may wish to use Ctrl-F with a few keywords (eg model) to find your query with a common solution faster

= General =

'''The game starts up, and closes shortly afterwards''' 
This is sort of an ambiguous situation, read carefully

:'''A1:''' If you saw a message similar to, could not load core textures, you're trying to run the bin directly, or in the wrong directory. please use the sandbox_unix bash script, or the click_me_to_start batch, or the Launcher.
:'''A2:''' You might have broken/corrupt drivers. Please install the newest ones provided by your GPU (aka, video card) manufacturer, especially if you use windows, since Microsoft's default OGL (WGL) implementation is horrible and is hardly capable of running sandbox.
:'''A3:''' Your graphics card might not have shader support, though sandbox should automatically turn it off, if it doesn't, use the launcher turn shaders off. Otherwise in linux enter -f in the launch command. On windows, open CLICK_ME_TO_START.bat with notepad (or you can right click the file and select edit) and add -f after the sandbox.exe Note: If given a number (f1 or f2), it'll set the shader quality to that value.
:'''A4:''' If you have an '''ATI card''' you might need to do this "I found that it wont run unless you disable the Catalyst A.I. After i did that it loaded right up! Hope this helps anyone that has problems running sandbox." Thanks Fudwumper!!

'''I have really low FPS and/or bad performance, what do I do?'''
:'''A1:''' Make sure you update your graphics card drivers
:'''A2:''' Lower the resolution
:'''A3:''' Try turning shaders off

'''Are there weapons in Sandbox?''' 

Sandbox is intended to be kid friendly. In the RPG there is "action" with a melee vegetable extractor and spells. Also we will be doing a child friendly squirt gun battle mode. However if someone wanted to make adult violence from the rpg and water gun mode they certainly could though that is not our current focus.

'''How do I edit/play MULTIPLAYER with my friends/other people?''' 

Our next release will include a master server so people can see all the servers available, but currently you need to directly connect to the server. For instructions on how to do this and how to set up a server [http://sandboxgamemaker.com/wiki/index.php?title=Cooperative_Editing please see this link].

'''How do I add my own models and characters to Sandbox?'''

Please see the [Adding_Models_to_Sandbox]page for tutorials on model creation and bringing your creations into Sandbox.

'''My Mouse only has 1 button'''

:this means you don't have access to a scroll wheel, which is mostly referred to as universal delta in the documentation.
:'''A1:''' go into options and click the "''PG UP and PG DN as universal delta''"
:'''A2:''' delete config*.cfg and open data/defaults.cfg and modify the mouse4 and mouse 5 binds, mouse 2 and 3 (right and wheel clicks respectively) are mostly for convenience and not nearly as important as the wheel.
:'''A3:''' Obtain a mouse with a scroll wheel :P

= Editing =

'''How do I add an NPC to the game?'''

Take a look at village.cfg and savetheprincess.cfg which are located in the packages/base folder. You can open them with a text editor such as notepad or wordpad. If you check out where the models are listed you'll notice near the end of the savetheprincess.cfg that there is mmodel rc/pink This is the princess. To add this to your own map you can either copy this config and rename it to exactly what your map is named, or you can create your own config and add it at the bottom of the list. To create your own config all you have to do is create a new text document, name it exactly how your map is spelled and change the .txt at the end to .cfg [http://www.svn.kids.platinumarts.net/32pas32/trunk/packages/base/savetheprincess.cfg Savetheprincess.cfg for reference]

'''How do I make an NPC talk and/or give quests?'''

Review the previous question on how to add the npc. If you look at the savetheprincess.cfg you'll notice this
level_trigger_1 = [showgui Princess-Robochimp]
newgui Princess-Robochimp [
guitext "Thank you for saving me!" chat
guitext "You're my hero!" chat
]

That is the format for making a character talk. You can copy and modify that code according to what you'd like your character to say. Now you need to into the map and fly over to Princess robochimp. In edit mode click on her and then press . Make sure to press enter after you've made your modifications to save the entity. If you set the 3rd attribute to 1 she'll talk once, if set at 11 she'll talk each time she is approached. For the 4th attribute it needs to be set to 1 to correspond to the code in the config. If it was level_trigger_2 in the config then that 4th attribute would need to be 2. If notice in Savetheprincess the 1 1 values to make her talk are actually in an invisible model close to her. This is so that it shows her idle animation (jumping with the arms up). To make a model invisible set the 2nd attribute to 0. Setting up quests works in a similar fashion, check out village.cfg and take a look at the quest code. Try changing it to what you are looking to do. For a version that isn't so complicated [http://sandboxgamemaker.com/villageold.cfg check out the old version of village.cfg] that I modified to be a quest to find five keys.

'''How do I make items that can be picked up?'''

Please review the previous question. The third attribute needs to be 12 and then it will be picked up.

'''How do I add creatures such as butterflies to my map'''

:Type /newent creature 0-6 Note: 0 is the butterfly, 1 the dragon, etc
:note if you're using 2.2.0 or older, it's /newent monster

'''How do I light my map?'''

A basic way to do it is first select an area on the map where you want to place it. Then go to the new light menu. Make sure you select a color and a radius and then select create light. You can either enter /calclight in the console or you can go to editing gui and then lighting and select what options you want when creating your lights. Finish the process and your map will be lit according to the light you created :) [http://www.kids.platinumarts.net/wiki/index.php?title=Lighting Check here for more detailed information]

'''The lights aren't working'''

:'''A1:''' Check if you placed any lights inside mapmodels or geometry
:'''A2:''' Did you calculate lightmaps? ie, the /calclight and /patchlight commands
:'''A3:''' Does the light have a very small radius, or RGB values of 0? ie light 256 0 0 0 won't make any light, light 256 200 100 50 should emit a relatively bright orange.

'''How do I make sloped "roofs" like those in house?''' 
Note, this refers to sloped geometry in general

:'''A1:''' Hold the middle mouse button, and selected the vertices (point were 2 or more edges meet) you wish to edit, and scroll up/down to deform the cube
:'''A2:''' Select 1 or more cubes, and hold in Q. Scroll while hovering over a vertice to deform that specific vertice in the whole selection
:'''A3:''' select 1 or more cubes, and hold F. Scroll the wheel to deform the whole face (collection of 3 or 4 vertices, note computers are limited to triangles and quadrilaterals, a circle for example is a series of triangles).

'''How do I create grass?'''

first make sure grass is turned on! (/grass 1)

Hold the Y button down and scroll with the mouse wheel until you come to the texture that includes the 3D grass. To change what texture the grass is linked with check /data/default_map_settings.cfg

to add grass, add a autograss "texture" to a texture's loading statement

'''How do I create rain?'''

To add a water particle entity to the map:

:Type /newent particles 10 300 256 868 1000 in the console

10 is the type, 300 the shape, 256 the radius, 868, a 12 bit colour, 1000 the fading time

'''I can't see my custom mapmodels'''

:'''A1''' Check that the mmodel command of the model you're trying to load points to a valid object, relevant to packages/models, if you use windows, just invert the slash (note that the model listings are generated automatically on mapsave from 2.3 onwards)
:'''A2''' is there a tris.* present? or a md*.cfg or an obj.cfg loading the current model if it isn't named tris.*?
:'''A3''' note that mmodel is directed to a directory, not to the model file

'''How do I edit my map's configuration'''

:'''A1''' use an external file editor like notepad or kate to open the respective map configuration
:'''A2''' enter editmode, and press F6, then the load button in the GUI that appears

'''Is there any program to make editing easier?'''

:'''A1''' Yes, It's called Notepad++. You can download it here http://notepad-plus.sourceforge.net/uk/site.htm

= Other =

'''Are there any sandbox user groups?'''

:in short no, if there are any, we're not aware of them

'''Can I use sandbox maps in (insert fave game here)'''

:in most cases this can't be done, unless the engine you're using happens to be cube 2, or has support for the cube 2 octree map format.

Main Page

2010-01-17T23:32:14Z

Mike:

'''Platinum Arts Sandbox Free 3D Game Maker''' is a 3D game maker based on the Cube 2 engine that allows users to quickly and easily create and edit their own worlds in game, even cooperatively. It is free, open source, and easy to use for Kids and Adults.

<div style="width:49%;float:left;">

== General information ==

* [[Platinum Arts Sandbox|About Platinum Arts Sandbox]]
* [http://SandboxGameMaker.com Project homepage]
* [[FAQ]]
* [[Contact The Team]]
* [[cmdline arguments|Command line Arguments]]
* [[packaging guide|The Packaging Guide]]

== Installation ==

* [[Installing Platinum Arts Sandbox]]
* [[Compiling the source code]]
* [[package managers|Some Notes for package managers]]

== Development ==

* [[bug reports|Bug Reports]]
* [[Contributing]]
* [[development|Obtaining the development version]]
* [[content request| Content Request - Help us out!!]]

== Getting started ==

* [[Map Editing Basics]]
* [[Mapping Taboos]]
* [[Beginner's video tutorials]]
* [[Good free programs for Sandbox]]

</div>
<div style="width:49%;float:right;">

== Advanced topics ==

* [[Cooperative Editing]] (Server set up)
* [[Adding Models to Sandbox]]
* [http://sandboxgamemaker.com/platinumartssandboxeditref.html Editing Reference Guide]
* [http://sauerbraten.org/docs/models.html Model Reference Guide]
* [[Configuration Reference Guide]]
* [[Translations|Engine/menu translations]]
* [[Cubescript|Programming in Cubescript]]
* [[map_config|Map Configuration]]
* [[musicpacks|Music Pack Documentation]]

== Tutorials ==

* [[Mapmodels|Loading and adding mapmodels]]
* [[Menu Editing|How to modify the menu]]
* [[Lighting|How to light a map properly]] 
* [[Creating a shop script]]
* [[Wings3D to Sandbox flash tutorials]]
* [[Importing .OBJ files]]
* [[Adding custom textures to a new map]]
* [[Glowmaps]]
* [[MovieCube]]

== Kid Friendly RPG ==
* [[Concept Document]]
* [[Brainstorming area]]

== Master Chef Ogro 2 ==
* [[Brainstorming]]

== Undercover Kids Game ==
* [[To Do List]]

</div>

__NOTOC__

MovieCube

2010-01-17T23:30:47Z

Mike:

MovieCube is a Open Source Machinima production tool, based on the Cube 2 Engine, known from the game Sauerbraten. MovieCube is part of the Platinum Arts Sandbox Free 3D Game Maker project.

== What is Machinima ==
''"Machinima (pronounced /məˈʃiːnɨmə/ or /məˈʃɪnɨmə/) is the use of real-time three-dimensional (3-D) graphics rendering engines to generate computer animation."''
[http://en.wikipedia.org/wiki/Machinima Machinima on Wikipedia]
== Start MovieCube ==
'''Windows:''' Use the Launcher and select the MovieCube tab or click on MovieCube.bat 
'''Linux:''' change into your PAS folder, <code>./bin/sandbox_client_32_movie</code>

== Quick Overview ==
As MovieCube is under heavy development, things are in change. So before you post support requests, consult this wiki. All recent changes will be announced here.

In MovieCube you can produce Live Machinima in multiplayer mode as well as working on scripted Machinima projects. You can import various model formats as md2, md3, md5 and obj. As modeling software we recommend blender, which provides exporters for these formats.

As MovieCube is based on the Cube2 Engine, known from the game Sauerbraten, you can create your own movie sets and maps with an powerfull and easy to use ingame editor also in cooperation over the net.

=== Tutorial on scripting commands ===

''editmode'':

*Press "E" to get into the editmode, type:

<code>/newent waypoint</code>

*used as waypoints and spawnpoints for characters
*attr1: character yaw when used as spawnpoint
*attr2: radius/area

<code>/newcharacter [name]</code>

*adds a new character definition, you can now add commands to the characters command queue

<code>/appendactionspawn [name] [state] [waypoint map uid]</code>

*add the spawn command to character definition referenced by param name, param state should be always 0 at the moment, param map uid is the unique identifier of the waypoint you want to spawn your character
(every map entity mapmodels, waypoints ... has a unique id, they cannot changed by users)

<code>/appendactionwait [name] [state] [milliseconds]</code>

*lets a characters wait for certain milliseconds

<code>/appendactionmove [name] [state] [waypoint map uid]</code>

*lets the character walk to a given wayoint

''normal mode''

<code>/addcharacter [name]</code>

*spawns a new character based on character definition given by name, you can repeat this several times

=== How to use this ===

*go into editmode and add some waypoints: 
<code>/newent waypoint</code> 
*add a new character definiton, a temporary character will spawn in fron of you 
<code>/newcharacharacter mychar</code> 
*add some actions: 
<code>/appendactionwait mychar 0 5000 
/appendactionspawn mychar 0 0 
/appendactionmove mychar 0 1 
/appendactionwait mychar 0 5000 
/appendactionmove mychar 0 2</code> 
*leave editmode, your temp character will disapear 
*spawn a real character 
<code>/addcharacter mychar</code> 
*and another one 
<code>/addcharacter mychar</code>
*let a character action run as loop
<code>/loopchar = (addcharacter mychar); loopcharacter $loopchar</code>

*The "appendaction..." commands starts with the name of the character, the state (we have only state 0 at the moment) and the parameter of the command itself, e.g. waypoint id in spawn or move or the time in milliseconds in the wait command.
*All map entities including waypoints have an unique id, use this id as last parameter in <code>appendactionspawn</code> and <code>appendactionmode</code> to choose the waypoints. You will find these id's in editmode shown on top of the waypoint entities.

== Character System ==
=== Manage Characters ===
In MovieCube you can define characters, their appearance and the actions they will do. To make a movie or animation you can spawn different instances of an character.
<code>newcharacter name</code> - adds a new character to your map. In editmode the new character will spawn in front of you.
=== Character Commands ===
After you created a new character you can add commands the character will execute like change model or let the character move to a waypoint.
=== Character States ===
''(not implemented)''
All commands you add to an charater where stored in command queue. Every character can hold different commands queues (aka states) and switch between them. The first state is created automatically when you create a new character. In States you can define different types of actions, e.g. use state 0 for configuring the character, state 1 for walk actions, state 2 for talk or interact with others. Spawned characters can receive signals forces them to change their actual state. (this does not work at the moment.)
=== adding and changing Charactermodels ===
If MovieCube starts only the default charactermodel is avabiable. To add more character models load them with the preloadplayermodel command.

<code>preloadplayermodel [path]</code>

<code>thirdperson 2; preloadplayermodel ogre; setplayermodel 1</code>
This will load a new playermodel and registers the animations. You can test this by changing your playermodel:

=== Overwrite Animation (AO) ===
''(not fully implemented)''
In MovieCube you can overwrite the exisiting standard animations of an player or charactermodel.
You can test this on your playermodel. If your model has an animation 50 (depends on the model you use), you can use this animation to overwrite the standard animation for e.g. swimming by using the following animation overwrite id's:

Animation Overwrites ID's:

<code>AO_DEAD = 0, AO_DYING = 1, AO_IDLE = 2, AO_FORWARD, = 3, AO_BACKWARD = 4,
AO_LEFT =5, AO_RIGHT = 6, AO_HOLD = 7, AO_ACTION = 8, AO_GESTURE = 9, AO_PAIN = 10,
AO_JUMP = 11, AO_SINK = 12, AO_SWIM = 13, AO_EDIT = 14, AO_LAG = 15
</code>

<code>setao 13 50</code> - now animation 50 is used as swimming animation

Future versions of MovieCube will provide a GUI for that.

=== adding Attachments ===
MovieCube supports adding various attachments to the player or characters. Keep in mind that the model you use has to support this. The model needs special tags to attach stuff to it. For md5 models you have to define these tags with the <code>md5tag</code> command in the md5.cfg config file of your model.

<code>md5tag [armature bone] [tag name]</code> - the armature bone are the existing bones of your model, the tag names are names hardcoded in MovieCube and refers to body parts.

Sample tag configuration of an model:

<code>
md5tag Head tag_head 
md5tag Arm.L tag_rarm 
md5tag Arm.R tag_larm 
... 
</code>

complete list of body parts and their corresponding tag names:

0 "Head" - "tag_head" 
1 "Neck" - "tag_neck" 
2 "LeftShoulder" - "tag_lshoulder" 
3 "RightShoulder", "tag_rshoulder" 
4 "LeftArm", "tag_larm" 
5 "RightArm", "tag_rarm" 
6 "LeftForearm", "tag_lforearm" 
7 "RightForearm", "tag_rforearm" 
8 "LeftHand", "tag_lhand" 
9 "RightHand", "tag_rhand" 
10 "Belly", "tag_belly" 
11 "Hip", "tag_hip" 
12 "LeftThigh", "tag_lthigh" 
13 "RightThigh", "tag_rthigh" 
14 "LeftShin", "tag_lshin" 
15 "RightShin", "tag_rshin" 
16 "LeftFoot", "tag_lfoot" 
17 "RightFoot", "tag_rfoot" 

To attach an other model to playermodel use the following commands:

<code>playerattach 8 "items/flag" 0</code>

or

<code>playerattach (getattachnum LeftHand) "items/flag" 0</code>

this will attach the model stored in packages/models/items/flags onto your players left Hand. the last parameter controls the animation of the attached model. just leave it blank, if it dont have any animation.

== Record Movies ==

=== using the engine ===

*<code>moview 320</code> - set the width of your video clip
*<code>movieh 240</code> - set the height of your video clip
*<code>movie myclip</code> - record movie into file myclip.avi

=== high resolution capture with glc (linux) ===

[http://nullkey.ath.cx/projects/glc/ glc opengl capture]

==== capture a sandbox movie with glc: ====
<code>
glc-capture --start --out=/path/out.glc --fps=25 bin/sandbox_client_32_movie -t -w1024 -h768
</code>

==== playback: ====

you can use glc-play or mplayer:

<code>
glc-play /path/out.glc
glc-play /path/out.glc -y 1 -o - | mplayer -demuxer y4m -
</code>

==== encoding: ====

<code>glc-play /path/out.glc -o - -y 1| mencoder -demuxer y4m - -nosound -ovc x264 -x264encopts qp=18:pass=1 -of avi -o /path/video.avi</code>

you can find more examples at the glc website.

== Record Demos ==

MovieCube

2010-01-17T23:30:12Z

Mike:

MovieCube is a Open Source Machinima production tool, based on the Cube 2 Engine, known from the game Sauerbraten. It is part of the Platinum Arts Sandbox Free 3D Game Maker project.

== What is Machinima ==
''"Machinima (pronounced /məˈʃiːnɨmə/ or /məˈʃɪnɨmə/) is the use of real-time three-dimensional (3-D) graphics rendering engines to generate computer animation."''
[http://en.wikipedia.org/wiki/Machinima Machinima on Wikipedia]
== Start MovieCube ==
'''Windows:''' Use the Launcher and select the MovieCube tab or click on MovieCube.bat 
'''Linux:''' change into your PAS folder, <code>./bin/sandbox_client_32_movie</code>

== Quick Overview ==
As MovieCube is under heavy development, things are in change. So before you post support requests, consult this wiki. All recent changes will be announced here.

In MovieCube you can produce Live Machinima in multiplayer mode as well as working on scripted Machinima projects. You can import various model formats as md2, md3, md5 and obj. As modeling software we recommend blender, which provides exporters for these formats.

As MovieCube is based on the Cube2 Engine, known from the game Sauerbraten, you can create your own movie sets and maps with an powerfull and easy to use ingame editor also in cooperation over the net.

=== Tutorial on scripting commands ===

''editmode'':

*Press "E" to get into the editmode, type:

<code>/newent waypoint</code>

*used as waypoints and spawnpoints for characters
*attr1: character yaw when used as spawnpoint
*attr2: radius/area

<code>/newcharacter [name]</code>

*adds a new character definition, you can now add commands to the characters command queue

<code>/appendactionspawn [name] [state] [waypoint map uid]</code>

*add the spawn command to character definition referenced by param name, param state should be always 0 at the moment, param map uid is the unique identifier of the waypoint you want to spawn your character
(every map entity mapmodels, waypoints ... has a unique id, they cannot changed by users)

<code>/appendactionwait [name] [state] [milliseconds]</code>

*lets a characters wait for certain milliseconds

<code>/appendactionmove [name] [state] [waypoint map uid]</code>

*lets the character walk to a given wayoint

''normal mode''

<code>/addcharacter [name]</code>

*spawns a new character based on character definition given by name, you can repeat this several times

=== How to use this ===

*go into editmode and add some waypoints: 
<code>/newent waypoint</code> 
*add a new character definiton, a temporary character will spawn in fron of you 
<code>/newcharacharacter mychar</code> 
*add some actions: 
<code>/appendactionwait mychar 0 5000 
/appendactionspawn mychar 0 0 
/appendactionmove mychar 0 1 
/appendactionwait mychar 0 5000 
/appendactionmove mychar 0 2</code> 
*leave editmode, your temp character will disapear 
*spawn a real character 
<code>/addcharacter mychar</code> 
*and another one 
<code>/addcharacter mychar</code>
*let a character action run as loop
<code>/loopchar = (addcharacter mychar); loopcharacter $loopchar</code>

*The "appendaction..." commands starts with the name of the character, the state (we have only state 0 at the moment) and the parameter of the command itself, e.g. waypoint id in spawn or move or the time in milliseconds in the wait command.
*All map entities including waypoints have an unique id, use this id as last parameter in <code>appendactionspawn</code> and <code>appendactionmode</code> to choose the waypoints. You will find these id's in editmode shown on top of the waypoint entities.

== Character System ==
=== Manage Characters ===
In MovieCube you can define characters, their appearance and the actions they will do. To make a movie or animation you can spawn different instances of an character.
<code>newcharacter name</code> - adds a new character to your map. In editmode the new character will spawn in front of you.
=== Character Commands ===
After you created a new character you can add commands the character will execute like change model or let the character move to a waypoint.
=== Character States ===
''(not implemented)''
All commands you add to an charater where stored in command queue. Every character can hold different commands queues (aka states) and switch between them. The first state is created automatically when you create a new character. In States you can define different types of actions, e.g. use state 0 for configuring the character, state 1 for walk actions, state 2 for talk or interact with others. Spawned characters can receive signals forces them to change their actual state. (this does not work at the moment.)
=== adding and changing Charactermodels ===
If MovieCube starts only the default charactermodel is avabiable. To add more character models load them with the preloadplayermodel command.

<code>preloadplayermodel [path]</code>

<code>thirdperson 2; preloadplayermodel ogre; setplayermodel 1</code>
This will load a new playermodel and registers the animations. You can test this by changing your playermodel:

=== Overwrite Animation (AO) ===
''(not fully implemented)''
In MovieCube you can overwrite the exisiting standard animations of an player or charactermodel.
You can test this on your playermodel. If your model has an animation 50 (depends on the model you use), you can use this animation to overwrite the standard animation for e.g. swimming by using the following animation overwrite id's:

Animation Overwrites ID's:

<code>AO_DEAD = 0, AO_DYING = 1, AO_IDLE = 2, AO_FORWARD, = 3, AO_BACKWARD = 4,
AO_LEFT =5, AO_RIGHT = 6, AO_HOLD = 7, AO_ACTION = 8, AO_GESTURE = 9, AO_PAIN = 10,
AO_JUMP = 11, AO_SINK = 12, AO_SWIM = 13, AO_EDIT = 14, AO_LAG = 15
</code>

<code>setao 13 50</code> - now animation 50 is used as swimming animation

Future versions of MovieCube will provide a GUI for that.

=== adding Attachments ===
MovieCube supports adding various attachments to the player or characters. Keep in mind that the model you use has to support this. The model needs special tags to attach stuff to it. For md5 models you have to define these tags with the <code>md5tag</code> command in the md5.cfg config file of your model.

<code>md5tag [armature bone] [tag name]</code> - the armature bone are the existing bones of your model, the tag names are names hardcoded in MovieCube and refers to body parts.

Sample tag configuration of an model:

<code>
md5tag Head tag_head 
md5tag Arm.L tag_rarm 
md5tag Arm.R tag_larm 
... 
</code>

complete list of body parts and their corresponding tag names:

0 "Head" - "tag_head" 
1 "Neck" - "tag_neck" 
2 "LeftShoulder" - "tag_lshoulder" 
3 "RightShoulder", "tag_rshoulder" 
4 "LeftArm", "tag_larm" 
5 "RightArm", "tag_rarm" 
6 "LeftForearm", "tag_lforearm" 
7 "RightForearm", "tag_rforearm" 
8 "LeftHand", "tag_lhand" 
9 "RightHand", "tag_rhand" 
10 "Belly", "tag_belly" 
11 "Hip", "tag_hip" 
12 "LeftThigh", "tag_lthigh" 
13 "RightThigh", "tag_rthigh" 
14 "LeftShin", "tag_lshin" 
15 "RightShin", "tag_rshin" 
16 "LeftFoot", "tag_lfoot" 
17 "RightFoot", "tag_rfoot" 

To attach an other model to playermodel use the following commands:

<code>playerattach 8 "items/flag" 0</code>

or

<code>playerattach (getattachnum LeftHand) "items/flag" 0</code>

this will attach the model stored in packages/models/items/flags onto your players left Hand. the last parameter controls the animation of the attached model. just leave it blank, if it dont have any animation.

== Record Movies ==

=== using the engine ===

*<code>moview 320</code> - set the width of your video clip
*<code>movieh 240</code> - set the height of your video clip
*<code>movie myclip</code> - record movie into file myclip.avi

=== high resolution capture with glc (linux) ===

[http://nullkey.ath.cx/projects/glc/ glc opengl capture]

==== capture a sandbox movie with glc: ====
<code>
glc-capture --start --out=/path/out.glc --fps=25 bin/sandbox_client_32_movie -t -w1024 -h768
</code>

==== playback: ====

you can use glc-play or mplayer:

<code>
glc-play /path/out.glc
glc-play /path/out.glc -y 1 -o - | mplayer -demuxer y4m -
</code>

==== encoding: ====

<code>glc-play /path/out.glc -o - -y 1| mencoder -demuxer y4m - -nosound -ovc x264 -x264encopts qp=18:pass=1 -of avi -o /path/video.avi</code>

you can find more examples at the glc website.

== Record Demos ==

MovieCube

2010-01-17T23:24:58Z

Mike: /* Start MovieCube */

MovieCube is a OpenSource Machinima production tool, based on the Cube2 Engine, known from the game Sauerbraten. It is part of the Platinum Arts Sandbox project.

== What is Machinima ==
''"Machinima (pronounced /məˈʃiːnɨmə/ or /məˈʃɪnɨmə/) is the use of real-time three-dimensional (3-D) graphics rendering engines to generate computer animation."''
[http://en.wikipedia.org/wiki/Machinima Machinima on Wikipedia]
== Start MovieCube ==
'''Windows:''' Use the Launcher and select the MovieCube tab or click on MovieCube.bat 
'''Linux:''' change into your PAS folder, <code>./bin/sandbox_client_32_movie</code>

== Quick Overview ==
As MovieCube is under heavy development, things are in change. So before you post support requests, consult this wiki. All recent changes will be announced here.

In MovieCube you can produce Live Machinima in multiplayer mode as well as working on scripted Machinima projects. You can import various model formats as md2, md3, md5 and obj. As modeling software we recommend blender, which provides exporters for these formats.

As MovieCube is based on the Cube2 Engine, known from the game Sauerbraten, you can create your own movie sets and maps with an powerfull and easy to use ingame editor also in cooperation over the net.

=== Tutorial on scripting commands ===

''editmode'':

*Press "E" to get into the editmode, type:

<code>/newent waypoint</code>

*used as waypoints and spawnpoints for characters
*attr1: character yaw when used as spawnpoint
*attr2: radius/area

<code>/newcharacter [name]</code>

*adds a new character definition, you can now add commands to the characters command queue

<code>/appendactionspawn [name] [state] [waypoint map uid]</code>

*add the spawn command to character definition referenced by param name, param state should be always 0 at the moment, param map uid is the unique identifier of the waypoint you want to spawn your character
(every map entity mapmodels, waypoints ... has a unique id, they cannot changed by users)

<code>/appendactionwait [name] [state] [milliseconds]</code>

*lets a characters wait for certain milliseconds

<code>/appendactionmove [name] [state] [waypoint map uid]</code>

*lets the character walk to a given wayoint

''normal mode''

<code>/addcharacter [name]</code>

*spawns a new character based on character definition given by name, you can repeat this several times

=== How to use this ===

*go into editmode and add some waypoints: 
<code>/newent waypoint</code> 
*add a new character definiton, a temporary character will spawn in fron of you 
<code>/newcharacharacter mychar</code> 
*add some actions: 
<code>/appendactionwait mychar 0 5000 
/appendactionspawn mychar 0 0 
/appendactionmove mychar 0 1 
/appendactionwait mychar 0 5000 
/appendactionmove mychar 0 2</code> 
*leave editmode, your temp character will disapear 
*spawn a real character 
<code>/addcharacter mychar</code> 
*and another one 
<code>/addcharacter mychar</code>
*let a character action run as loop
<code>/loopchar = (addcharacter mychar); loopcharacter $loopchar</code>

*The "appendaction..." commands starts with the name of the character, the state (we have only state 0 at the moment) and the parameter of the command itself, e.g. waypoint id in spawn or move or the time in milliseconds in the wait command.
*All map entities including waypoints have an unique id, use this id as last parameter in <code>appendactionspawn</code> and <code>appendactionmode</code> to choose the waypoints. You will find these id's in editmode shown on top of the waypoint entities.

== Character System ==
=== Manage Characters ===
In MovieCube you can define characters, their appearance and the actions they will do. To make a movie or animation you can spawn different instances of an character.
<code>newcharacter name</code> - adds a new character to your map. In editmode the new character will spawn in front of you.
=== Character Commands ===
After you created a new character you can add commands the character will execute like change model or let the character move to a waypoint.
=== Character States ===
''(not implemented)''
All commands you add to an charater where stored in command queue. Every character can hold different commands queues (aka states) and switch between them. The first state is created automatically when you create a new character. In States you can define different types of actions, e.g. use state 0 for configuring the character, state 1 for walk actions, state 2 for talk or interact with others. Spawned characters can receive signals forces them to change their actual state. (this does not work at the moment.)
=== adding and changing Charactermodels ===
If MovieCube starts only the default charactermodel is avabiable. To add more character models load them with the preloadplayermodel command.

<code>preloadplayermodel [path]</code>

<code>thirdperson 2; preloadplayermodel ogre; setplayermodel 1</code>
This will load a new playermodel and registers the animations. You can test this by changing your playermodel:

=== Overwrite Animation (AO) ===
''(not fully implemented)''
In MovieCube you can overwrite the exisiting standard animations of an player or charactermodel.
You can test this on your playermodel. If your model has an animation 50 (depends on the model you use), you can use this animation to overwrite the standard animation for e.g. swimming by using the following animation overwrite id's:

Animation Overwrites ID's:

<code>AO_DEAD = 0, AO_DYING = 1, AO_IDLE = 2, AO_FORWARD, = 3, AO_BACKWARD = 4,
AO_LEFT =5, AO_RIGHT = 6, AO_HOLD = 7, AO_ACTION = 8, AO_GESTURE = 9, AO_PAIN = 10,
AO_JUMP = 11, AO_SINK = 12, AO_SWIM = 13, AO_EDIT = 14, AO_LAG = 15
</code>

<code>setao 13 50</code> - now animation 50 is used as swimming animation

Future versions of MovieCube will provide a GUI for that.

=== adding Attachments ===
MovieCube supports adding various attachments to the player or characters. Keep in mind that the model you use has to support this. The model needs special tags to attach stuff to it. For md5 models you have to define these tags with the <code>md5tag</code> command in the md5.cfg config file of your model.

<code>md5tag [armature bone] [tag name]</code> - the armature bone are the existing bones of your model, the tag names are names hardcoded in MovieCube and refers to body parts.

Sample tag configuration of an model:

<code>
md5tag Head tag_head 
md5tag Arm.L tag_rarm 
md5tag Arm.R tag_larm 
... 
</code>

complete list of body parts and their corresponding tag names:

0 "Head" - "tag_head" 
1 "Neck" - "tag_neck" 
2 "LeftShoulder" - "tag_lshoulder" 
3 "RightShoulder", "tag_rshoulder" 
4 "LeftArm", "tag_larm" 
5 "RightArm", "tag_rarm" 
6 "LeftForearm", "tag_lforearm" 
7 "RightForearm", "tag_rforearm" 
8 "LeftHand", "tag_lhand" 
9 "RightHand", "tag_rhand" 
10 "Belly", "tag_belly" 
11 "Hip", "tag_hip" 
12 "LeftThigh", "tag_lthigh" 
13 "RightThigh", "tag_rthigh" 
14 "LeftShin", "tag_lshin" 
15 "RightShin", "tag_rshin" 
16 "LeftFoot", "tag_lfoot" 
17 "RightFoot", "tag_rfoot" 

To attach an other model to playermodel use the following commands:

<code>playerattach 8 "items/flag" 0</code>

or

<code>playerattach (getattachnum LeftHand) "items/flag" 0</code>

this will attach the model stored in packages/models/items/flags onto your players left Hand. the last parameter controls the animation of the attached model. just leave it blank, if it dont have any animation.

== Record Movies ==

=== using the engine ===

*<code>moview 320</code> - set the width of your video clip
*<code>movieh 240</code> - set the height of your video clip
*<code>movie myclip</code> - record movie into file myclip.avi

=== high resolution capture with glc (linux) ===

[http://nullkey.ath.cx/projects/glc/ glc opengl capture]

==== capture a sandbox movie with glc: ====
<code>
glc-capture --start --out=/path/out.glc --fps=25 bin/sandbox_client_32_movie -t -w1024 -h768
</code>

==== playback: ====

you can use glc-play or mplayer:

<code>
glc-play /path/out.glc
glc-play /path/out.glc -y 1 -o - | mplayer -demuxer y4m -
</code>

==== encoding: ====

<code>glc-play /path/out.glc -o - -y 1| mencoder -demuxer y4m - -nosound -ovc x264 -x264encopts qp=18:pass=1 -of avi -o /path/video.avi</code>

you can find more examples at the glc website.

== Record Demos ==

MovieCube

2010-01-17T23:24:37Z

Mike: /* Start MovieCube */

MovieCube is a OpenSource Machinima production tool, based on the Cube2 Engine, known from the game Sauerbraten. It is part of the Platinum Arts Sandbox project.

== What is Machinima ==
''"Machinima (pronounced /məˈʃiːnɨmə/ or /məˈʃɪnɨmə/) is the use of real-time three-dimensional (3-D) graphics rendering engines to generate computer animation."''
[http://en.wikipedia.org/wiki/Machinima Machinima on Wikipedia]
== Start MovieCube ==
'''Windows''' Use the Launcher and select the MovieCube tab or click on MovieCube.bat 
'''Linux:''' change into your PAS folder, <code>./bin/sandbox_client_32_movie</code>

== Quick Overview ==
As MovieCube is under heavy development, things are in change. So before you post support requests, consult this wiki. All recent changes will be announced here.

In MovieCube you can produce Live Machinima in multiplayer mode as well as working on scripted Machinima projects. You can import various model formats as md2, md3, md5 and obj. As modeling software we recommend blender, which provides exporters for these formats.

As MovieCube is based on the Cube2 Engine, known from the game Sauerbraten, you can create your own movie sets and maps with an powerfull and easy to use ingame editor also in cooperation over the net.

=== Tutorial on scripting commands ===

''editmode'':

*Press "E" to get into the editmode, type:

<code>/newent waypoint</code>

*used as waypoints and spawnpoints for characters
*attr1: character yaw when used as spawnpoint
*attr2: radius/area

<code>/newcharacter [name]</code>

*adds a new character definition, you can now add commands to the characters command queue

<code>/appendactionspawn [name] [state] [waypoint map uid]</code>

*add the spawn command to character definition referenced by param name, param state should be always 0 at the moment, param map uid is the unique identifier of the waypoint you want to spawn your character
(every map entity mapmodels, waypoints ... has a unique id, they cannot changed by users)

<code>/appendactionwait [name] [state] [milliseconds]</code>

*lets a characters wait for certain milliseconds

<code>/appendactionmove [name] [state] [waypoint map uid]</code>

*lets the character walk to a given wayoint

''normal mode''

<code>/addcharacter [name]</code>

*spawns a new character based on character definition given by name, you can repeat this several times

=== How to use this ===

*go into editmode and add some waypoints: 
<code>/newent waypoint</code> 
*add a new character definiton, a temporary character will spawn in fron of you 
<code>/newcharacharacter mychar</code> 
*add some actions: 
<code>/appendactionwait mychar 0 5000 
/appendactionspawn mychar 0 0 
/appendactionmove mychar 0 1 
/appendactionwait mychar 0 5000 
/appendactionmove mychar 0 2</code> 
*leave editmode, your temp character will disapear 
*spawn a real character 
<code>/addcharacter mychar</code> 
*and another one 
<code>/addcharacter mychar</code>
*let a character action run as loop
<code>/loopchar = (addcharacter mychar); loopcharacter $loopchar</code>

*The "appendaction..." commands starts with the name of the character, the state (we have only state 0 at the moment) and the parameter of the command itself, e.g. waypoint id in spawn or move or the time in milliseconds in the wait command.
*All map entities including waypoints have an unique id, use this id as last parameter in <code>appendactionspawn</code> and <code>appendactionmode</code> to choose the waypoints. You will find these id's in editmode shown on top of the waypoint entities.

== Character System ==
=== Manage Characters ===
In MovieCube you can define characters, their appearance and the actions they will do. To make a movie or animation you can spawn different instances of an character.
<code>newcharacter name</code> - adds a new character to your map. In editmode the new character will spawn in front of you.
=== Character Commands ===
After you created a new character you can add commands the character will execute like change model or let the character move to a waypoint.
=== Character States ===
''(not implemented)''
All commands you add to an charater where stored in command queue. Every character can hold different commands queues (aka states) and switch between them. The first state is created automatically when you create a new character. In States you can define different types of actions, e.g. use state 0 for configuring the character, state 1 for walk actions, state 2 for talk or interact with others. Spawned characters can receive signals forces them to change their actual state. (this does not work at the moment.)
=== adding and changing Charactermodels ===
If MovieCube starts only the default charactermodel is avabiable. To add more character models load them with the preloadplayermodel command.

<code>preloadplayermodel [path]</code>

<code>thirdperson 2; preloadplayermodel ogre; setplayermodel 1</code>
This will load a new playermodel and registers the animations. You can test this by changing your playermodel:

=== Overwrite Animation (AO) ===
''(not fully implemented)''
In MovieCube you can overwrite the exisiting standard animations of an player or charactermodel.
You can test this on your playermodel. If your model has an animation 50 (depends on the model you use), you can use this animation to overwrite the standard animation for e.g. swimming by using the following animation overwrite id's:

Animation Overwrites ID's:

<code>AO_DEAD = 0, AO_DYING = 1, AO_IDLE = 2, AO_FORWARD, = 3, AO_BACKWARD = 4,
AO_LEFT =5, AO_RIGHT = 6, AO_HOLD = 7, AO_ACTION = 8, AO_GESTURE = 9, AO_PAIN = 10,
AO_JUMP = 11, AO_SINK = 12, AO_SWIM = 13, AO_EDIT = 14, AO_LAG = 15
</code>

<code>setao 13 50</code> - now animation 50 is used as swimming animation

Future versions of MovieCube will provide a GUI for that.

=== adding Attachments ===
MovieCube supports adding various attachments to the player or characters. Keep in mind that the model you use has to support this. The model needs special tags to attach stuff to it. For md5 models you have to define these tags with the <code>md5tag</code> command in the md5.cfg config file of your model.

<code>md5tag [armature bone] [tag name]</code> - the armature bone are the existing bones of your model, the tag names are names hardcoded in MovieCube and refers to body parts.

Sample tag configuration of an model:

<code>
md5tag Head tag_head 
md5tag Arm.L tag_rarm 
md5tag Arm.R tag_larm 
... 
</code>

complete list of body parts and their corresponding tag names:

0 "Head" - "tag_head" 
1 "Neck" - "tag_neck" 
2 "LeftShoulder" - "tag_lshoulder" 
3 "RightShoulder", "tag_rshoulder" 
4 "LeftArm", "tag_larm" 
5 "RightArm", "tag_rarm" 
6 "LeftForearm", "tag_lforearm" 
7 "RightForearm", "tag_rforearm" 
8 "LeftHand", "tag_lhand" 
9 "RightHand", "tag_rhand" 
10 "Belly", "tag_belly" 
11 "Hip", "tag_hip" 
12 "LeftThigh", "tag_lthigh" 
13 "RightThigh", "tag_rthigh" 
14 "LeftShin", "tag_lshin" 
15 "RightShin", "tag_rshin" 
16 "LeftFoot", "tag_lfoot" 
17 "RightFoot", "tag_rfoot" 

To attach an other model to playermodel use the following commands:

<code>playerattach 8 "items/flag" 0</code>

or

<code>playerattach (getattachnum LeftHand) "items/flag" 0</code>

this will attach the model stored in packages/models/items/flags onto your players left Hand. the last parameter controls the animation of the attached model. just leave it blank, if it dont have any animation.

== Record Movies ==

=== using the engine ===

*<code>moview 320</code> - set the width of your video clip
*<code>movieh 240</code> - set the height of your video clip
*<code>movie myclip</code> - record movie into file myclip.avi

=== high resolution capture with glc (linux) ===

[http://nullkey.ath.cx/projects/glc/ glc opengl capture]

==== capture a sandbox movie with glc: ====
<code>
glc-capture --start --out=/path/out.glc --fps=25 bin/sandbox_client_32_movie -t -w1024 -h768
</code>

==== playback: ====

you can use glc-play or mplayer:

<code>
glc-play /path/out.glc
glc-play /path/out.glc -y 1 -o - | mplayer -demuxer y4m -
</code>

==== encoding: ====

<code>glc-play /path/out.glc -o - -y 1| mencoder -demuxer y4m - -nosound -ovc x264 -x264encopts qp=18:pass=1 -of avi -o /path/video.avi</code>

you can find more examples at the glc website.

== Record Demos ==

Main Page

2010-01-17T23:22:32Z

Mike: /* Advanced topics */

'''Platinum Arts Sandbox''' is a 3D game maker based on the Cube 2 engine that allows users to quickly and easily create and edit their own worlds in game, even cooperatively. It is free, open source, and easy to use for Kids and Adults.

<div style="width:49%;float:left;">

== General information ==

* [[Platinum Arts Sandbox|About Platinum Arts Sandbox]]
* [http://SandboxGameMaker.com Project homepage]
* [[FAQ]]
* [[Contact The Team]]
* [[cmdline arguments|Command line Arguments]]
* [[packaging guide|The Packaging Guide]]

== Installation ==

* [[Installing Platinum Arts Sandbox]]
* [[Compiling the source code]]
* [[package managers|Some Notes for package managers]]

== Development ==

* [[bug reports|Bug Reports]]
* [[Contributing]]
* [[development|Obtaining the development version]]
* [[content request| Content Request - Help us out!!]]

== Getting started ==

* [[Map Editing Basics]]
* [[Mapping Taboos]]
* [[Beginner's video tutorials]]
* [[Good free programs for Sandbox]]

</div>
<div style="width:49%;float:right;">

== Advanced topics ==

* [[Cooperative Editing]] (Server set up)
* [[Adding Models to Sandbox]]
* [http://sandboxgamemaker.com/platinumartssandboxeditref.html Editing Reference Guide]
* [http://sauerbraten.org/docs/models.html Model Reference Guide]
* [[Configuration Reference Guide]]
* [[Translations|Engine/menu translations]]
* [[Cubescript|Programming in Cubescript]]
* [[map_config|Map Configuration]]
* [[musicpacks|Music Pack Documentation]]

== Tutorials ==

* [[Mapmodels|Loading and adding mapmodels]]
* [[Menu Editing|How to modify the menu]]
* [[Lighting|How to light a map properly]] 
* [[Creating a shop script]]
* [[Wings3D to Sandbox flash tutorials]]
* [[Importing .OBJ files]]
* [[Adding custom textures to a new map]]
* [[Glowmaps]]
* [[MovieCube]]

== Kid Friendly RPG ==
* [[Concept Document]]
* [[Brainstorming area]]

== Master Chef Ogro 2 ==
* [[Brainstorming]]

== Undercover Kids Game ==
* [[To Do List]]

</div>

__NOTOC__

Adding Models to Sandbox

2010-01-17T23:21:33Z

Mike: /* Creating Your Own Models */

== Adding Models to Sandbox ==

===Creating Your Own Models===
Interested in creating your own models and characters? We recommend using the free modeling tool [http://www.blender.org/ Blender]. 
'''Blender Tutorials''': 
[http://en.wikibooks.org/wiki/Blender_3D:_Noob_to_Pro Blender 3D Noob To Pro] 

'''Wings3D Tutorials''': 
[[Wings3D_to_Sandbox_flash_tutorials]]

===Adding Your Model To Sandbox===
Sandbox supports .md2, .md3, .obj and .md5 For characters you should export as an md5. For static models .md3 and md5 are fine. For additional information on the models and commands that can be used with them, please see the [http://sauerbraten.org/docs/models.html Model Reference Guide]

===Exporting md3 models from Blender to Sandbox===
=====[http://forum.sandboxgamemaker.com/viewtopic.php?f=24&t=807 Daniel_San's Tutorial (Recommended) - Forum Link With Pictures]=====

=====Alternative Tutorial (OLDER)=====

[http://cube.wikispaces.com/MD3+Export+From+Blender+Tutorial Old Tutorial]

Blender 2.47 (and 2.48?) guide (more up to date steps for 1 & 2)

1. First you need to download this zip file:
[http://johnny3d.promail.ca/wikitut/blendermd3_updated.zip]

You need to extract that zip into your Blender scripts folder. For me the pathname is:
Program Files\Blender Foundation\Blender\.blender\scripts

Notice the .blender, that means it is a hidden folder, so you need to make sure you can see hidden folders (or even just try to paste that path in the file browser).

Now load up blender and make sure you see .md3 as an export format. If you see it in there then you are all set to follow the next steps and eventually export the model.

2. Next we and UV map it. Hit tab for Edit Mode. In the "Mesh" menu click new next to UV Texture. Make the name skin.jpg Click A to make sure the cube is selected. Then click U and select Unwrap Smart Projections

3. Now we convert to triangles. Make sure you have everything selected still with A and that you are still in edit mode. Press SPACEBAR and go to EDIT -> FACES -> CONVERT TO TRIANGLES

4. Models must face east (Roate -90 degrees)

5. Follow the rest of the old tutorial linked at the top. Mainly, you need to export it now as an md3 and make a md3.cfg for it. You can look at the md3.cfg of other models to get an idea of what goes in there.

Exporting animated md3 models from Blender [http://cube.wikispaces.com/Blender+Animated+Md3+Export]

Adding Models to Sandbox

2010-01-17T23:20:42Z

Mike:

== Adding Models to Sandbox ==

===Creating Your Own Models===
Interested in creating your own models and characters? We recommend using the free modeling tool Blender. 
'''Blender Tutorials''': 
[http://en.wikibooks.org/wiki/Blender_3D:_Noob_to_Pro Blender 3D Noob To Pro] 

'''Wings3D Tutorials''': 
[[Wings3D_to_Sandbox_flash_tutorials]]

===Adding Your Model To Sandbox===
Sandbox supports .md2, .md3, .obj and .md5 For characters you should export as an md5. For static models .md3 and md5 are fine. For additional information on the models and commands that can be used with them, please see the [http://sauerbraten.org/docs/models.html Model Reference Guide]

===Exporting md3 models from Blender to Sandbox===
=====[http://forum.sandboxgamemaker.com/viewtopic.php?f=24&t=807 Daniel_San's Tutorial (Recommended) - Forum Link With Pictures]=====

=====Alternative Tutorial (OLDER)=====

[http://cube.wikispaces.com/MD3+Export+From+Blender+Tutorial Old Tutorial]

Blender 2.47 (and 2.48?) guide (more up to date steps for 1 & 2)

1. First you need to download this zip file:
[http://johnny3d.promail.ca/wikitut/blendermd3_updated.zip]

You need to extract that zip into your Blender scripts folder. For me the pathname is:
Program Files\Blender Foundation\Blender\.blender\scripts

Notice the .blender, that means it is a hidden folder, so you need to make sure you can see hidden folders (or even just try to paste that path in the file browser).

Now load up blender and make sure you see .md3 as an export format. If you see it in there then you are all set to follow the next steps and eventually export the model.

2. Next we and UV map it. Hit tab for Edit Mode. In the "Mesh" menu click new next to UV Texture. Make the name skin.jpg Click A to make sure the cube is selected. Then click U and select Unwrap Smart Projections

3. Now we convert to triangles. Make sure you have everything selected still with A and that you are still in edit mode. Press SPACEBAR and go to EDIT -> FACES -> CONVERT TO TRIANGLES

4. Models must face east (Roate -90 degrees)

5. Follow the rest of the old tutorial linked at the top. Mainly, you need to export it now as an md3 and make a md3.cfg for it. You can look at the md3.cfg of other models to get an idea of what goes in there.

Exporting animated md3 models from Blender [http://cube.wikispaces.com/Blender+Animated+Md3+Export]

Adding Models to Sandbox

2010-01-17T23:10:07Z

Mike:

== Adding Models to Sandbox ==

===Exporting md3 models from Blender to Sandbox===
=====[http://forum.sandboxgamemaker.com/viewtopic.php?f=24&t=807 Daniel_San's Tutorial (Recommended) - Forum Link With Pictures]=====

=====Alternative Tutorial (OLDER)=====

[http://cube.wikispaces.com/MD3+Export+From+Blender+Tutorial Old Tutorial]

Blender 2.47 (and 2.48?) guide (more up to date steps for 1 & 2)

1. First you need to download this zip file:
[http://johnny3d.promail.ca/wikitut/blendermd3_updated.zip]

You need to extract that zip into your Blender scripts folder. For me the pathname is:
Program Files\Blender Foundation\Blender\.blender\scripts

Notice the .blender, that means it is a hidden folder, so you need to make sure you can see hidden folders (or even just try to paste that path in the file browser).

Now load up blender and make sure you see .md3 as an export format. If you see it in there then you are all set to follow the next steps and eventually export the model.

2. Next we and UV map it. Hit tab for Edit Mode. In the "Mesh" menu click new next to UV Texture. Make the name skin.jpg Click A to make sure the cube is selected. Then click U and select Unwrap Smart Projections

3. Now we convert to triangles. Make sure you have everything selected still with A and that you are still in edit mode. Press SPACEBAR and go to EDIT -> FACES -> CONVERT TO TRIANGLES

4. Models must face east (Roate -90 degrees)

5. Follow the rest of the old tutorial linked at the top. Mainly, you need to export it now as an md3 and make a md3.cfg for it. You can look at the md3.cfg of other models to get an idea of what goes in there.

Exporting animated md3 models from Blender [http://cube.wikispaces.com/Blender+Animated+Md3+Export]

Adding Models to Sandbox

2010-01-17T23:08:32Z

Mike:

== Adding Models to Sandbox ==

===Exporting md3 models from Blender to Sandbox===
=====[http://forum.sandboxgamemaker.com/viewtopic.php?f=24&t=807 Daniel_San's Tutorial - Forum Link With Pictures]=====

=====Alternative Tutorial (OLDER)=====

[http://cube.wikispaces.com/MD3+Export+From+Blender+Tutorial Old Tutorial]

Blender 2.47 (and 2.48?) guide (more up to date steps for 1 & 2)

1. First you need to download this zip file:
[http://johnny3d.promail.ca/wikitut/blendermd3_updated.zip]

You need to extract that zip into your Blender scripts folder. For me the pathname is:
Program Files\Blender Foundation\Blender\.blender\scripts

Notice the .blender, that means it is a hidden folder, so you need to make sure you can see hidden folders (or even just try to paste that path in the file browser).

Now load up blender and make sure you see .md3 as an export format. If you see it in there then you are all set to follow the next steps and eventually export the model.

2. Next we and UV map it. Hit tab for Edit Mode. In the "Mesh" menu click new next to UV Texture. Make the name skin.jpg Click A to make sure the cube is selected. Then click U and select Unwrap Smart Projections

3. Now we convert to triangles. Make sure you have everything selected still with A and that you are still in edit mode. Press SPACEBAR and go to EDIT -> FACES -> CONVERT TO TRIANGLES

4. Models must face east (Roate -90 degrees)

5. Follow the rest of the old tutorial linked at the top. Mainly, you need to export it now as an md3 and make a md3.cfg for it. You can look at the md3.cfg of other models to get an idea of what goes in there.

Exporting animated md3 models from Blender [http://cube.wikispaces.com/Blender+Animated+Md3+Export]

Main Page

2010-01-14T01:02:40Z

Mike: /* Advanced topics */

'''Platinum Arts Sandbox''' is a 3D game maker based on the Cube 2 engine that allows users to quickly and easily create and edit their own worlds in game, even cooperatively. It is free, open source, and easy to use for Kids and Adults.

<div style="width:49%;float:left;">

== General information ==

* [[Platinum Arts Sandbox|About Platinum Arts Sandbox]]
* [http://SandboxGameMaker.com Project homepage]
* [[FAQ]]
* [[Contact The Team]]
* [[cmdline arguments|Command line Arguments]]
* [[packaging guide|The Packaging Guide]]

== Installation ==

* [[Installing Platinum Arts Sandbox]]
* [[Compiling the source code]]
* [[package managers|Some Notes for package managers]]

== Development ==

* [[bug reports|Bug Reports]]
* [[Contributing]]
* [[development|Obtaining the development version]]
* [[content request| Content Request - Help us out!!]]

== Getting started ==

* [[Map Editing Basics]]
* [[Mapping Taboos]]
* [[Beginner's video tutorials]]
* [[Good free programs for Sandbox]]

</div>
<div style="width:49%;float:right;">

== Advanced topics ==

* [[Cooperative Editing]] (Server set up)
* [http://sandboxgamemaker.com/platinumartssandboxeditref.html Editing Reference Guide]
* [http://sauerbraten.org/docs/models.html Model Reference Guide]
* [[Configuration Reference Guide]]
* [[Translations|Engine/menu translations]]
* [[Adding Models to Sandbox]]
* [[Cubescript|Programming in Cubescript]]
* [[map_config|Map Configuration]]
* [[musicpacks|Music Pack Documentation]]

== Tutorials ==

* [[Mapmodels|Loading and adding mapmodels]]
* [[Menu Editing|How to modify the menu]]
* [[Lighting|How to light a map properly]] 
* [[Creating a shop script]]
* [[Wings3D to Sandbox flash tutorials]]
* [[Importing .OBJ files]]
* [[Adding custom textures to a new map]]
* [[Glowmaps]]
* [[MovieCube]]

== Kid Friendly RPG ==
* [[Concept Document]]
* [[Brainstorming area]]

== Master Chef Ogro 2 ==
* [[Brainstorming]]

== Undercover Kids Game ==
* [[To Do List]]

</div>

__NOTOC__

FAQ

2010-01-03T00:27:14Z

Mike: /* General */

A list of questions we've been asked and the answers too them 
This is still an FAQ as the order of the questions and answers will be rearranged periodically based on the frequency they've been asked

you may wish to use Ctrl-F with a few keywords (eg model) to find your query with a common solution faster

= General =

'''The game starts up, and closes shortly afterwards''' 
This is sort of an ambiguous situation, read carefully

:'''A1:''' If you saw a message similar to, could not load core textures, you're trying to run the bin directly, or in the wrong directory. please use the sandbox_unix bash script, or the click_me_to_start batch, or the Launcher.
:'''A2:''' You might have broken/corrupt drivers. Please install the newest ones provided by your GPU (aka, video card) manufacturer, especially if you use windows, since Microsoft's default OGL (WGL) implementation is horrible and is hardly capable of running sandbox.
:'''A3:''' Your graphics card might not have shader support, though sandbox should automatically turn it off, if it doesn't, use the launcher turn shaders off. Otherwise in linux enter -f in the launch command. On windows, open CLICK_ME_TO_START.bat with notepad (or you can right click the file and select edit) and add -f after the sandbox.exe Note: If given a number (f1 or f2), it'll set the shader quality to that value.
:'''A4:''' If you have an '''ATI card''' you might need to do this "I found that it wont run unless you disable the Catalyst A.I. After i did that it loaded right up! Hope this helps anyone that has problems running sandbox." Thanks Fudwumper!!

'''I have really low FPS and/or bad performance, what do I do?'''
:'''A1:''' Make sure you update your graphics card drivers
:'''A2:''' Lower the resolution
:'''A3:''' Try turning shaders off

'''Are there weapons in Sandbox?''' 

Sandbox is intended to be kid friendly. In the RPG there is "action" with a melee vegetable extractor and spells. Also we will be doing a child friendly squirt gun battle mode. However if someone wanted to make adult violence from the rpg and water gun mode they certainly could though that is not our current focus.

'''How do I edit/play MULTIPLAYER with my friends/other people?''' 

Our next release will include a master server so people can see all the servers available, but currently you need to directly connect to the server. For instructions on how to do this and how to set up a server [http://sandboxgamemaker.com/wiki/index.php?title=Cooperative_Editing please see this link].

'''My Mouse only has 1 button'''

:this means you don't have access to a scroll wheel, which is mostly referred to as universal delta in the documentation.
:'''A1:''' go into options and click the "''PG UP and PG DN as universal delta''"
:'''A2:''' delete config*.cfg and open data/defaults.cfg and modify the mouse4 and mouse 5 binds, mouse 2 and 3 (right and wheel clicks respectively) are mostly for convenience and not nearly as important as the wheel.
:'''A3:''' Obtain a mouse with a scroll wheel :P

= Editing =

'''How do I add an NPC to the game?'''

Take a look at village.cfg and savetheprincess.cfg which are located in the packages/base folder. You can open them with a text editor such as notepad or wordpad. If you check out where the models are listed you'll notice near the end of the savetheprincess.cfg that there is mmodel rc/pink This is the princess. To add this to your own map you can either copy this config and rename it to exactly what your map is named, or you can create your own config and add it at the bottom of the list. To create your own config all you have to do is create a new text document, name it exactly how your map is spelled and change the .txt at the end to .cfg [http://www.svn.kids.platinumarts.net/32pas32/trunk/packages/base/savetheprincess.cfg Savetheprincess.cfg for reference]

'''How do I make an NPC talk and/or give quests?'''

Review the previous question on how to add the npc. If you look at the savetheprincess.cfg you'll notice this
level_trigger_1 = [showgui Princess-Robochimp]
newgui Princess-Robochimp [
guitext "Thank you for saving me!" chat
guitext "You're my hero!" chat
]

That is the format for making a character talk. You can copy and modify that code according to what you'd like your character to say. Now you need to into the map and fly over to Princess robochimp. In edit mode click on her and then press . Make sure to press enter after you've made your modifications to save the entity. If you set the 3rd attribute to 1 she'll talk once, if set at 11 she'll talk each time she is approached. For the 4th attribute it needs to be set to 1 to correspond to the code in the config. If it was level_trigger_2 in the config then that 4th attribute would need to be 2. If notice in Savetheprincess the 1 1 values to make her talk are actually in an invisible model close to her. This is so that it shows her idle animation (jumping with the arms up). To make a model invisible set the 2nd attribute to 0. Setting up quests works in a similar fashion, check out village.cfg and take a look at the quest code. Try changing it to what you are looking to do. For a version that isn't so complicated [http://sandboxgamemaker.com/villageold.cfg check out the old version of village.cfg] that I modified to be a quest to find five keys.

'''How do I make items that can be picked up?'''

Please review the previous question. The third attribute needs to be 12 and then it will be picked up.

'''How do I add creatures such as butterflies to my map'''

:Type /newent creature 0-6 Note: 0 is the butterfly, 1 the dragon, etc
:note if you're using 2.2.0 or older, it's /newent monster

'''How do I light my map?'''

A basic way to do it is first select an area on the map where you want to place it. Then go to the new light menu. Make sure you select a color and a radius and then select create light. You can either enter /calclight in the console or you can go to editing gui and then lighting and select what options you want when creating your lights. Finish the process and your map will be lit according to the light you created :) [http://www.kids.platinumarts.net/wiki/index.php?title=Lighting Check here for more detailed information]

'''The lights aren't working'''

:'''A1:''' Check if you placed any lights inside mapmodels or geometry
:'''A2:''' Did you calculate lightmaps? ie, the /calclight and /patchlight commands
:'''A3:''' Does the light have a very small radius, or RGB values of 0? ie light 256 0 0 0 won't make any light, light 256 200 100 50 should emit a relatively bright orange.

'''How do I make sloped "roofs" like those in house?''' 
Note, this refers to sloped geometry in general

:'''A1:''' Hold the middle mouse button, and selected the vertices (point were 2 or more edges meet) you wish to edit, and scroll up/down to deform the cube
:'''A2:''' Select 1 or more cubes, and hold in Q. Scroll while hovering over a vertice to deform that specific vertice in the whole selection
:'''A3:''' select 1 or more cubes, and hold F. Scroll the wheel to deform the whole face (collection of 3 or 4 vertices, note computers are limited to triangles and quadrilaterals, a circle for example is a series of triangles).

'''How do I create grass?'''

first make sure grass is turned on! (/grass 1)

Hold the Y button down and scroll with the mouse wheel until you come to the texture that includes the 3D grass. To change what texture the grass is linked with check /data/default_map_settings.cfg

to add grass, add a autograss "texture" to a texture's loading statement

'''How do I create rain?'''

To add a water particle entity to the map:

:Type /newent particles 10 300 256 868 1000 in the console

10 is the type, 300 the shape, 256 the radius, 868, a 12 bit colour, 1000 the fading time

'''I can't see my custom mapmodels'''

:'''A1''' Check that the mmodel command of the model you're trying to load points to a valid object, relevant to packages/models, if you use windows, just invert the slash (note that the model listings are generated automatically on mapsave from 2.3 onwards)
:'''A2''' is there a tris.* present? or a md*.cfg or an obj.cfg loading the current model if it isn't named tris.*?
:'''A3''' note that mmodel is directed to a directory, not to the model file

'''How do I edit my map's configuration'''

:'''A1''' use an external file editor like notepad or kate to open the respective map configuration
:'''A2''' enter editmode, and press F6, then the load button in the GUI that appears

'''Is there any program to make editing easier?'''

:'''A1''' Yes, It's called Notepad++. You can download it here http://notepad-plus.sourceforge.net/uk/site.htm

= Other =

'''Are there any sandbox user groups?'''

:in short no, if there are any, we're not aware of them

'''Can I use sandbox maps in (insert fave game here)'''

:in most cases this can't be done, unless the engine you're using happens to be cube 2, or has support for the cube 2 octree map format.

FAQ

2010-01-03T00:26:41Z

Mike: /* General */

A list of questions we've been asked and the answers too them 
This is still an FAQ as the order of the questions and answers will be rearranged periodically based on the frequency they've been asked

you may wish to use Ctrl-F with a few keywords (eg model) to find your query with a common solution faster

= General =

'''The game starts up, and closes shortly afterwards''' 
This is sort of an ambiguous situation, read carefully

:'''A1:''' If you saw a message similar to, could not load core textures, you're trying to run the bin directly, or in the wrong directory. please use the sandbox_unix bash script, or the click_me_to_start batch, or the Launcher.
:'''A2:''' You might have broken/corrupt drivers. Please install the newest ones provided by your GPU (aka, video card) manufacturer, especially if you use windows, since Microsoft's default OGL (WGL) implementation is horrible and is hardly capable of running sandbox.
:'''A3:''' Your graphics card might not have shader support, though sandbox should automatically turn it off, if it doesn't, use the launcher turn shaders off. Otherwise in linux enter -f in the launch command. On windows, open CLICK_ME_TO_START.bat with notepad (or you can right click the file and select edit) and add -f after the sandbox.exe Note: If given a number (f1 or f2), it'll set the shader quality to that value.
:'''A4''' If you have an '''ATI card''' you might need to do this "I found that it wont run unless you disable the Catalyst A.I. After i did that it loaded right up! Hope this helps anyone that has problems running sandbox." Thanks Fudwumper!!

'''I have really low FPS and/or bad performance, what do I do?'''
:'''A1''' Make sure you update your graphics card drivers
:'''A2''' Lower the resolution
:'''A3''' Try turning shaders off

'''Are there weapons in Sandbox?''' 

Sandbox is intended to be kid friendly. In the RPG there is "action" with a melee vegetable extractor and spells. Also we will be doing a child friendly squirt gun battle mode. However if someone wanted to make adult violence from the rpg and water gun mode they certainly could though that is not our current focus.

'''How do I edit/play MULTIPLAYER with my friends/other people?''' 

Our next release will include a master server so people can see all the servers available, but currently you need to directly connect to the server. For instructions on how to do this and how to set up a server [http://sandboxgamemaker.com/wiki/index.php?title=Cooperative_Editing please see this link].

'''My Mouse only has 1 button'''

:this means you don't have access to a scroll wheel, which is mostly referred to as universal delta in the documentation.
:'''A1:''' go into options and click the "''PG UP and PG DN as universal delta''"
:'''A2:''' delete config*.cfg and open data/defaults.cfg and modify the mouse4 and mouse 5 binds, mouse 2 and 3 (right and wheel clicks respectively) are mostly for convenience and not nearly as important as the wheel.
:'''A3:''' Obtain a mouse with a scroll wheel :P

= Editing =

'''How do I add an NPC to the game?'''

Take a look at village.cfg and savetheprincess.cfg which are located in the packages/base folder. You can open them with a text editor such as notepad or wordpad. If you check out where the models are listed you'll notice near the end of the savetheprincess.cfg that there is mmodel rc/pink This is the princess. To add this to your own map you can either copy this config and rename it to exactly what your map is named, or you can create your own config and add it at the bottom of the list. To create your own config all you have to do is create a new text document, name it exactly how your map is spelled and change the .txt at the end to .cfg [http://www.svn.kids.platinumarts.net/32pas32/trunk/packages/base/savetheprincess.cfg Savetheprincess.cfg for reference]

'''How do I make an NPC talk and/or give quests?'''

Review the previous question on how to add the npc. If you look at the savetheprincess.cfg you'll notice this
level_trigger_1 = [showgui Princess-Robochimp]
newgui Princess-Robochimp [
guitext "Thank you for saving me!" chat
guitext "You're my hero!" chat
]

That is the format for making a character talk. You can copy and modify that code according to what you'd like your character to say. Now you need to into the map and fly over to Princess robochimp. In edit mode click on her and then press . Make sure to press enter after you've made your modifications to save the entity. If you set the 3rd attribute to 1 she'll talk once, if set at 11 she'll talk each time she is approached. For the 4th attribute it needs to be set to 1 to correspond to the code in the config. If it was level_trigger_2 in the config then that 4th attribute would need to be 2. If notice in Savetheprincess the 1 1 values to make her talk are actually in an invisible model close to her. This is so that it shows her idle animation (jumping with the arms up). To make a model invisible set the 2nd attribute to 0. Setting up quests works in a similar fashion, check out village.cfg and take a look at the quest code. Try changing it to what you are looking to do. For a version that isn't so complicated [http://sandboxgamemaker.com/villageold.cfg check out the old version of village.cfg] that I modified to be a quest to find five keys.

'''How do I make items that can be picked up?'''

Please review the previous question. The third attribute needs to be 12 and then it will be picked up.

'''How do I add creatures such as butterflies to my map'''

:Type /newent creature 0-6 Note: 0 is the butterfly, 1 the dragon, etc
:note if you're using 2.2.0 or older, it's /newent monster

'''How do I light my map?'''

A basic way to do it is first select an area on the map where you want to place it. Then go to the new light menu. Make sure you select a color and a radius and then select create light. You can either enter /calclight in the console or you can go to editing gui and then lighting and select what options you want when creating your lights. Finish the process and your map will be lit according to the light you created :) [http://www.kids.platinumarts.net/wiki/index.php?title=Lighting Check here for more detailed information]

'''The lights aren't working'''

:'''A1:''' Check if you placed any lights inside mapmodels or geometry
:'''A2:''' Did you calculate lightmaps? ie, the /calclight and /patchlight commands
:'''A3:''' Does the light have a very small radius, or RGB values of 0? ie light 256 0 0 0 won't make any light, light 256 200 100 50 should emit a relatively bright orange.

'''How do I make sloped "roofs" like those in house?''' 
Note, this refers to sloped geometry in general

:'''A1:''' Hold the middle mouse button, and selected the vertices (point were 2 or more edges meet) you wish to edit, and scroll up/down to deform the cube
:'''A2:''' Select 1 or more cubes, and hold in Q. Scroll while hovering over a vertice to deform that specific vertice in the whole selection
:'''A3:''' select 1 or more cubes, and hold F. Scroll the wheel to deform the whole face (collection of 3 or 4 vertices, note computers are limited to triangles and quadrilaterals, a circle for example is a series of triangles).

'''How do I create grass?'''

first make sure grass is turned on! (/grass 1)

Hold the Y button down and scroll with the mouse wheel until you come to the texture that includes the 3D grass. To change what texture the grass is linked with check /data/default_map_settings.cfg

to add grass, add a autograss "texture" to a texture's loading statement

'''How do I create rain?'''

To add a water particle entity to the map:

:Type /newent particles 10 300 256 868 1000 in the console

10 is the type, 300 the shape, 256 the radius, 868, a 12 bit colour, 1000 the fading time

'''I can't see my custom mapmodels'''

:'''A1''' Check that the mmodel command of the model you're trying to load points to a valid object, relevant to packages/models, if you use windows, just invert the slash (note that the model listings are generated automatically on mapsave from 2.3 onwards)
:'''A2''' is there a tris.* present? or a md*.cfg or an obj.cfg loading the current model if it isn't named tris.*?
:'''A3''' note that mmodel is directed to a directory, not to the model file

'''How do I edit my map's configuration'''

:'''A1''' use an external file editor like notepad or kate to open the respective map configuration
:'''A2''' enter editmode, and press F6, then the load button in the GUI that appears

'''Is there any program to make editing easier?'''

:'''A1''' Yes, It's called Notepad++. You can download it here http://notepad-plus.sourceforge.net/uk/site.htm

= Other =

'''Are there any sandbox user groups?'''

:in short no, if there are any, we're not aware of them

'''Can I use sandbox maps in (insert fave game here)'''

:in most cases this can't be done, unless the engine you're using happens to be cube 2, or has support for the cube 2 octree map format.

Brainstorming area

2009-10-21T18:30:49Z

Mike:

SVN Information
http://svnrpg.kids.platinumarts.net/kidsrpg

== Ideas For The Kid Friendly RPG ==

'''WORKING TITLE:'''
The Exciting Adventures Of Master Chef Ogro - Fruits and Vegetables Extraordinaire

(Previous - Master Chef Ogro The Vegetable Crusader) (Produce Extraordinaire?)

== '''Main Goals''' ==

* Try to keep it E for Engorged with cake
* Use a cel shader for a cartoony look
* Keep it grade school friendly if possible

Main Objective - Stop evil village (Evil Chef/monster) from destroying all produce and filling the world with his unhealthy cakes

Secondary Objective - Find and save the rare produce.

Tertiary Objective - Increase your culinary skills by using and upgrading various kitchen utensils and foods

== '''Gameplay concepts''' ==

'''General'''

* Finding rare Super Squash gives adds to your health bar (like a heart container)
* Certain produce grants certain abilities such as running fast, flying, taming creatures such as a dragon, super jump, super health? etc
* "bad" produce when thrown at an enemy will have a certain effect, freeze, slow, sleep, run away, stop time?
* Magic bag of replication - serves kind of like mana for the fruit "spells".
* Food sling that can be upgraded? Enhances the effects of the fruit? or how about it holds a certain amount of fruit
* Melee produce?
* Getting back part of recipes (completing the level)

'''Puzzles'''

* Use the thrill of being chased, jumping.
* Idea of various mini games to proceed to the next room
* Timers for certain puzzles
* Simple running with obstacles - http://www.albinoblacksheep.com/games/run is a great example

'''Strategy'''

* Having different weapons, such as a long carrot, spatula, 2 pots connected by string cheese (nun chucks, cheese chucks? HEHEHE)
* The more you use a weapon the better you get at it and the stronger it is. and more combos?
* Not all weapons work on every bad guy, some are better than others

'''Creatures'''

* They are attracted to the super squash and try to eat it. If they eat it all you are sent back to your last "regrow center" to regrow the squash.

'''Monster types'''
* butterfly
* bear
* dragon
* cabbage golem
* wolf
* elf dude
* snake dragon
* goblin
* horse?

'''Prototype level'''
- Farm where there is a nearby cave and you need to find a special fruit.
- Save it from a rock golem boss and his minions that want to squish all the produce and destroy the special fruit.
- Instead of "coins" or "currency" you barter with a special fruit called funny fruit.
- You can collect them all over the world and trade them in for other fruit and items.
- You can tame animals and use them to run you to places faster.

== Storyline ==

IN THE LAND OF ORGRAREA(org rare re a)

UPDATE: There is an evil king who is trying to get the people of the land of Ograria fat by feeding them cake (launching it with catapults?). He wants to get them fat so that they will be unable to resist his attempts to take over Ograria so that he can have all the delicious vegetables for himself. He has created a master chef of his own called Shadow Ogro. Shadow Ogro can harness the power of rotten produce to create produce monsters which are going around trying to terrorize the populace and take their super squash and valuable produce. The Evil King and Shadow Ogro want to make people scared to eat vegetables so that they will eat his cake. Ogro, Master Chef for the King of Ograria is not about to let this happen and wants to restore the joys of eating produce for everyone and stop this unhealthy take over. Also he might have a "Chefress" who gets kidnapped.

(olderconcept) 
On his way to a cooking contest. Master chef ogro has his major ingredients for the contest stolen by some wild animals. He has to find his taken ingredients from the animals while keeping his own ingredients he still has safe. The bad chef stole a secret recipe to the best tasting food in the world. Even worse he turned the recipe against Chef Ogro and is using cake instead of vegetables to help make monsters and continue to take over the world. Ogro has to get the pieces of the recipe back while still stopping the bad chef from taking over the world with his cake.

'''Brainstorming area'''

Adding Jokes (joke npc?) and Joke magic, jokes that are so corny they do damage to the produce creations. Here is an example of corny jokes:
http://www.geocities.com/meshki123/vjokes.htm 
Ideas for it: 
Jokes about certain produce do more "damage" to it?
Find different jokes to combine them to make one super joke that is a spell?

melee - Vegetable extractor - different lvls, upgrades, new ones found 
strong pump: slow to pump but massive extracting 
fast pump: not much extracting but quick extraction action 

Spells - vegetable 
starfruit - shoots starfruit energy

Map Ideas:
Spiral going either up or down with monsters attacking you on the way down. Having to not get hit by the flying monkeys trying to get your squash. If hit you need to chase it down and get your super squash.

Sleeping Animals that you have to get past them to get super squash.

Dragon Riding

Glitch World!!! A weird messed up world where you sometimes get teleported to the object is to get the super squash/recipe bit and return to the regular world.

*******CONCEPT OF CHARACTERS**********

******OGRO******
*Has a white shirt(chef coat)
*Has a pot on his head
*various cooking instruments used as armor such as (pots, pans, bowls,Table cloth cape,

******Evil Chef ****

*Black apron

*

*

*********Shadow Ogro******

* Same as Ogro except black colored like a shadow.

Compiling the source code

2009-10-21T18:28:17Z

Mike: /* Main Method */

This page discusses on how to modify and compile the source code.

==Windows:==

===Main Method===
Click here to download the version of Codeblocks with the mingw compiler:
[http://kids.platinumarts.net/codeblocks.exe]

Then go into your \src\windows folder. Click on sandbox.cbp and codeblocks should load up. Go to build and then build and it should create the Windows binary :)

If you get "Invalid Compiler" when building, you need to set up the Mingw Compiler location. When you are in Codeblocks go to "Settings" > "Compiler and Debugger". Then click the ">" button until you get to "Toolchain Executables". Click the "Auto-Detect" button. It should find the Mingw folder, if it is pointing to the wrong location click the "..." button and find the folder yourself.

If you are getting errors while compiling such as having to do with "_UnwindResume" you might have to link the libraries. You could do so like this: Go to "Settings" > "Compiler and Debugger", then click Linker Settings. Under link libraries click "Add" and go to the \src\lib folder then highlight all the ".lib" files and click "Ok". Now try compiling! :D

Other Methods: There is a visual C++ project file included that you can use. Load up the proper file and compile :) I'm not sure if you'd need any libraries but you probably shouldn't need any.

==POSIX systems==

You may need to convert some of the text file from dos format. There's a handy program to do it with so you may need to install and use tofrodos

===Linux===

<big>NOTE</big> The Binaries are compiled for 32 bit systems, so if you're on a 64 bit system, you'll have to 1) compile your own, by using modified versions of the below instructions, or 2) install and use 32 bit libraries.

====Makefile====

First of all, make sure you have the the SDL and SDL_Image and SDL_Mixer development libraries installed on your system.
Next up, go into src folder. and type 'make', you can add one of the following at the end of the line

* all - compiles the client
* libenet - compiles enet library
* clean - cleans up temporary files
* client - builds enet and integrates it into a client
* install - compiles enet and the client, and compies the client in /bin_unix/
* distinstall - creates a directory names /usr/local/sandbox/, and copies everything in there. it then sets permissions and some symlinks, so you can play the game by typing 'sandbox' into a console.
* distclean - deletes /usr/local/sandbox/

The compile automatically defaults to 'all'

Chances are, you won't have everything you needed installed, so if you receive any errors from missing devel libraries and frameworks, just installed them too.
if you receive errors similar "bash: ./configure: /bin/sh^M: bad interpreter" you'll need to use 'fromdos' to convert them to unix friendly files.

====Debug====

If you're interested in compiling a version with debugging symbols, just follow the instructions.

# first, open the Makefile with a text editor,
# next, you'll need to add '-ggdb3' somewhere in the 'CXXOPTFLAGS' list. It's normally recommended to clear everything else out of there. you're not meant to optimise and debug simultaneously.
# thirdly, scroll down to near the end, and remove all the lines with 'strip' in them
# finally, you may wish to change the PLATFROM_PREFIX to something else, like debug for example.

====Debug under Linux====

Compile the debug version with: make install -f Makefile.debug
Than start gdb and type this:

file bin/debug_client
run -r -t

when it crash than type bt

===MAC OSX===

To start, you should have Xcode installed on your computer. Either install the Developer tools from the OS X install disks that came with your computer, or download Xcode from the apple website:
http://developer.apple.com/technology/xcode.html

Download SDL: http://www.libsdl.org/release/SDL-1.2.13.dmg
Copy the SDL.framework folder to /Library/Frameworks

Download SDL_Image: http://www.libsdl.org/projects/SDL_image/release/SDL_image-1.2.6.dmg
Copy the SDL_image.framework folder to /Library/Frameworks

Download SDL_Mixer: http://www.libsdl.org/projects/SDL_mixer/release/SDL_mixer-1.2.8.dmg
Copy the SDL_mixer.framework folder to /Library/Frameworks

Download the latest Multiplatform.zip of Sandbox. Unzip and double click on PASX.X.Xmultiplatform/src/xcode/sandbox.xcodeproj

Xcode will open the project. Change the '''Active Build Configuration''' from ''Debug'' to ''Release''. Click on build - the Binary should compile without any errors.

By default the executables, launcher and sandbox, are created in the folder PASX.X.Xmultiplatform/src/xcode/build/Release/

Rename the PASX.X.Xmultiplatform folder to ''sandbox'' and move the compiled sandbox.app into the top level of that folder. The launcher.app should be on the same level, but outside, the renamed ''sandbox'' folder.

===FreeBSD===

Unwritten

To Do List

2009-09-11T00:42:40Z

Mike: /* Public Relations */

TO DO LIST for the Undercover Kids Game geared for 3rd - 5th Graders
[http://www.theundercoverkids.com/ Undercover Kids Homepage]

MOST IMPORTANT THING TO DO - MAKE SURE THE GAME IS FUN! 

==Concept Art==
[http://www.theundercoverkids.com/PhotoAlbum.aspx?id=68595 Official Photo Gallery]

== Levels ==
===Farm===
Attic [http://photos-a.ak.fbcdn.net/hphotos-ak-snc1/hs029.snc1/2372_52991966445_52990406445_1585552_384_n.jpg Concept Art] 
Barn And Hole with Man Hole [http://photos-b.ak.fbcdn.net/hphotos-ak-snc1/hs029.snc1/2372_52992001445_52990406445_1585553_4499_n.jpg Concept Art] 

===Holland===
[http://photos-d.ak.fbcdn.net/hphotos-ak-snc1/hs029.snc1/2372_52991796445_52990406445_1585547_8188_n.jpg Concept Art] 
Find more pictures for references :) 
Area with a manhole (house?) 

==3D Art and Animation==
[http://www.theundercoverkids.com/BookCharacters.aspx?id=1 Character Concept] 
Katie (with fake cel shading?) 
Jake (with fake cel shading?) 
Cooper (dog) 
Aunt Jean 
Dirk 
Chest (use Ahabs?) 
Farm Animals? 
Holland People 

==2D Art==
Flowers [http://womenwhoride.typepad.com/photos/uncategorized/2008/03/29/2008_holland.jpg Example] 
Wheat (already in Master Chef but could be improved) 

==Writing==
===Quests===
====Farm====
Perhaps Traveling to Neighboring Farms?
Jumping Puzzles?
====Holland====
Finding Cooper (quests needed to be completed before characters will give information?) 
Helping other residents of Holland find missing items, or people, or running errands, gathering supplies/resources (apples for pie like in village), etc
Jumping Puzzles? Hard to get to locations?
===Game Summary===
Ganked from the book summary, let's revise it to make sense for the game :) 
 
Meet The Undercover Kids... Katie, Jake, and their dog, Cooper. As they explore their aunt’s farm, they find a SECRET HOLE in the back of the barn. They travel across the ocean to Holland. Cooper gets lost. They meet an EVIL WAITER. And they realize getting home is harder than they thought. For the kids in your life order a copy of The Undercover Kids Holland Adventure to find the missing pieces. 
 
Rough conversation summarizing: 
We have a farm map and in the back there is a manhole where this random dude Dirk from holland is and he tells them that if you have this wristband you can use the manhole, in the hole that he's in, you can travel to other places.
So the kids play in the attic and find this talking chest that has all these goodies in it, including the band
and so then they can travel to Holland. The ideas for Holland are in the works but an idea is that their dog gets lost and they have to find it. 
I was thinking it would be neat to have to unravel clues to try to find the dog, like work as a detective to put together stuff found that clues you in and also since hirato has his NPCs in the new RPG where they have different levels of friendliness, maybe you know someone knows something but since they don't know you they won't give you the info. Help them out though and they are more willing to talk.

==Music And Sound==
Farm Theme Music? 
Holland Theme Music? 

==Coding==
 
==Public Relations==
What schools is it going to be pitched to? 
How will it be advertised? 
Is the audience schools, or kids outside of school, or both?

To Do List

2009-09-11T00:40:08Z

Mike: /* 3D Art and Animation */