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

Installing Platinum Arts Sandbox

2010-01-30T22:01:36Z

Moon: /* Related */ add link to server set up

This article explains how to install Platinum Arts Sandbox

== Obtaining Sandbox ==

You will first have to [http://kids.platinumarts.net/download-sandbox.html download the latest release]. If it fails to load after you tried the instructions below, please read our [http://kids.platinumarts.net/wiki/index.php?title=FAQ Frequently Asked Questions]

== Installing the Windows version ==

When you click on the downloaded file it will ask you where you want to install Sandbox. If you click the three dots to the right you can browse your computer and select where you'd like to place sandbox. After you are satisfied with where it is to install hit extract. The sandbox folder will then be created where you chose to install it. Locate the folder and enter it. Click on the file that says "'''(clickheretostart)'''" and it should launch. To launch the carts click on the file that says "cartmode".

== Installing the multi-platform version ==

The multi-platform version works on Windows, Linux and Mac.

=== Linux ===

To install Sandbox in a Linux based operating system, simply download the latest sandbox multi platform zip we have available and extract it into a directory of your choice, then use chmod +x to give sandbox_unix or _SandboxLauncher executable permissions, (for the non console savvy, GNOME and KDE allow these changes on the file's properties screen). the sandbox_unix script will take care of permissions, so you may wish to run it first before resorting to the launcher.

If you wish for a system wide install, one that'll require you to only type 'sandbox' followed by any desired command line options to run the program, go into the src directory and give the install.sh script executable permissions, and then run it, it'll set everything up for you. Note: all your files will, from here on out, be saved in ~/.platinumarts.

The Makefile contains a wrapper for this, "make distinstall", if there's any problems, see the [[Compiling_the_source_code|compilation page]].

=== OSX ===

We'll leave it to you, chances are you'll want to put it in the applications, but first, before you do that, you'll have to compile your own binaries untill we can provide them for.

== Related ==

*[[compiling the source code]]
*[[Bug reports]]
* [[development|Obtaining development version]]
* [[Cooperative Editing]] (server setup)

Main Page

2009-11-26T01:11:45Z

Moon: /* Advanced topics */ add label for clarity

'''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]]
* [[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]
* [[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]]<br>
* [[Creating a shop script]]
* [[Wings3D to Sandbox flash tutorials]]
* [[Importing .OBJ files]]
* [[Adding custom textures to a new map]]
* [[Glowmaps]]

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

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

</div>

__NOTOC__

Cooperative Editing

2009-11-26T00:53:56Z

Moon: /* Starting the server */ fix sp

This is a guide that requires some knowledge of networks. Please make sure you meet the following criteria before engaging in a coop edit:
* You know where the program was installed.
* You prefer to help create interesting work and help out instead of destroying other people's work. There is no undo in Coop edit so edit responsibly.

== Quick Windows Guide (see below for more extensive info) ==

Click server.bat in your Sandbox folder. That is the server. Then load up Sandbox. You can connect to your own server by typing /connect localhost in the console, which you access by hitting the ` key above tab. Your friends will have to type /connect YOURIP (for example /connect 255.255.255.255) in their versions of Sandbox. To put the server into coopedit mode you'll have to load a map like this /coop house or /coop village for example. To quickly find your ip you can go to sites like this [http://whatismyip.com/]. If you have a router you might need to forward 28785 and 28786 UDP.

NOTE: you can use /lanconnect to connect to a local server on your LAN. you can use the server browser as well, as it defaults to scanning your LAN for servers. If the server is external, see the above, or look further below for more detail.

=Starting the server=

There are many arguments that can be passed to the client. The list is a brief overview of them
# -c sets the maximum amount of poeple you'll allow to connect
# -i Sets the IP used for the server
# -m sets the masterserver
# -n sets the servername, as it'll appear in guiservers
# -o sets whether mastermode 2 and 3 can be activated or not
# -p Sets a password for he who wants to take admin
# -u set the upstream bandwidth
# -d The standalone server executable automatically does this. but you can also run the game as a server if you add -d at the end

==Linux==

To start a linux server, it's actually more effort than the other platforms. first open up a shell, least so you can monitor progress. I'll assume you have little experience and will be quite verbose. You may need to see the Howto on [[Compiling_the_source_code|compiling the source]]

# cd to where PAS is installed. eg cd ~/PlatinumArtsSandbox
# considering you compiled it yourself, type ./bin/native_server
# before hitting enter, add any arguments you want, eg ./bin/native_server -c8 -p"password" -n"Hirato is great"

You should get a few messages about the masterserver not replying etc, they can be ignored, just launch the client as well and you're set for some multiplayer editing action.

==Mac OSX==

==Windows==

How to up a windows coopedit server. After you launch the server be sure to scroll down to the "connecting" section to learn how to connect to your server.

# Open up 'My Computer' and go to where you installed PAS, eg C:\Program Files\PlatinumArtsSandbox\
# To load a default server click server.bat
# To set server options right click server.bat, and click edit. You should see notepad open with something similar to this.
##bin\sandbox.exe -d -c4 %1 %2 %3 %4 %5
# If you wish to set a password, or a name, add the appropriate -p and -n lines and then save eg
##bin\sandbox.exe -d -c4 -p"password" -n"Hirato Is great" %1 %2 %3 %4 %5
# After you've made the changes you want then click server.bat

=Connecting=

Now that you have succeeded in starting up your server, it's time to get on there with some friend. PAS does not yet have a masterserver so the server gui will prove useless. Now depending on how you wish to connect, you have two methods. First enter the console by hitting the ` key, which is above tab.

# type /connect ingame, eg /connect 127.0.0.1 Your friends will have to type /connect ip where ip is your ip address. Example /connect 99.999.999.999 You can find your ip address by going here [http://whatismyip.com/]
# type /lanconnect ingame, this'll connect to any server on the network

Once in you can use T to talk to other players.

Note, You cannot connect to servers that aren't connected to your network, so the 192.168.0.0, 172.16.0.0 and 10.0.0.0 range of IPS are all you can connect to. You can connect to servers that aren't in your network if you forward port 28785 in the UDP protocol. forwarding 28786 is also recommended, but that is used to communicate with the masterserver, and PAS has yet to receive one. Note only the server has to forward the ports for the connection to succeed. Port forwarding is often referred to as Pin Holing in certain guides.

if you did forward the ports, and are finding some trouble connecting, check your iptables in linux, and your firewall settings in windows

=Cooperative etiquette=

Considering the people on the server behave and know what they're doing, just follow the below rules to enjoy yourself. Not that we can do anything about them being broken of course

* When connecting to a server, it's considered polite to ask for the people to send the map so you can work on a current copy instead of wrecking someone's work.
* Also don't destroy someone else's work. If you'd like to change something already made just ask.
* Share your knowledge, this is the only way newbies learn new tricks
* Offer to help out, improve textures and correct mistakes and suggest improvements. The whole point of multiplayer collaborative editing is to build maps together.
* Avoid getting upset, not that there's anything to throw a hissy fit at anyway, cept maybe for that cube that doesn't want to turn into a pentagon
* DO NOT use the very smallest cubes to do big edits (use G+scroll in editmode to adjust)