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

Adding NPC's and items to your map

2010-06-24T19:37:57Z

Chaze007:

This tutorial will teach you how to make basic GUI code. This code basically allows NPCs and stuff to talk.

//Test GUI
newgui diologue1 [
guitext "Hello, this is where the text is entered." chat
] "Hello, this is the title"

As you can see above, everything is writen in a neat fashion.
newgui - Tepresents a new GUI window, where your character will speak.
newgui diologue1 - The diologue1 text is the name of your gui window.
guitext - This represents what the character will say. Always make sure to put quotations (" ") around the text, and "chat" without quotations, at the ending.
The very last line, after the closing bracket represents the title that will appear at the top of your GUI window.

Let's move on to something more advanced.

//Test GUI
newgui diologue2 [
guitext "First line of text!" chat
guitext "Second line of text!" chat
guitext "Third line of text!." chat
] "Lines of text."

Adding more lines can make your diologue longer. Keep this in mind when explaining something big in your map.

//Test GUI
newgui diologue3 [
guitext "^fs^f0Hello, I am green text^fr" chat
] "Green Text"

Adding color tags allow you to color text
The ^fs represents the starting point basically, of where your colored text will be.
The ^f0 is the color of your text, 0 being green.
The ^fr represents the ending point of your text.
These combined allow for scattered colored text.

//Test GUI
newgui diologue4 [
guitext "^fs^f0Hello^fr, I am ^fs^f1blue^fr, no wait! ^fs^f3RED!^fr." chat
] "Colored Text"

Here is the full list of different colored text.
<ul><li>^f0 - Green
<li>^f1 - Blue
<li>^f2 - Yellow
<li>^f3 - Red
<li>^f4 - Gray
<li>^f5 - Magneta
<li>^f6 - Oramge
<li>^f7 - White

<li>^fA - Apricot
<li>^fB - Brown
<li>^fC - Corn
<li>^fD - Dodger Blue
<li>^fE - Emerald
<li>^fF - Fuchsia
<li>^fG - Gold
<li>^fH - Heliotrope
<li>^fI - Indigo
<li>^fJ - Jade
<li>^fK - Khaki
<li>^fL - Lemon
<li>^fM - Mint
<li>^fN - Navajo White
<li>^fO - Olive
<li>^fP - Pink
<li>^fR - Rose
<li>^fS - Silver
<li>^fT - Turqoise
<li>^fU - Ultramarine
<li>^fV - Violet
<li>^fW - Wheat
<li>^fY - Yellow
<li>^fZ - Zinnwaldite

<li>^fs - Start of Text
<li>^fr - End of Text</ul>

These allow for a combination of brilliant colors if used in the correct manner.
Next I will show you how to execute your GUI, and make an item for your map.

//Diologue Triggers
level_trigger_1 = [showgui diologue1; sound $select]

the level trigger chooses which tag your npc will have. As you can see it's told in the action to show the GUI of diologue1, and to play a sound.

//Item Triggers
level_trigger_2 = [jumpvel 600; sound $eatapple; showgui eatapple; echo "You've eaten an apple! You can now jump HIGHER!"]

As you can see here, this is something you'd most likely assign to be an item, the action tells it to increase the jumping velocity, to play a sound, to show a GUI, and to show text in the top left corner.

Mixing these unique functions can make for an exciting map. We hope this tutorial helped you in your troubles.

Adding NPC's and items to your map

2010-06-24T19:36:34Z

Chaze007: New page: This tutorial will teach you how to make basic GUI code. This code basically allows NPCs and stuff to talk. //Test GUI newgui diologue1 [ guitext "Hello, this is where the text is ente...

Main Page

2010-06-24T19:29:31Z

Chaze007: /* Tutorials */

'''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!!]]

== 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)
* [[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 (default)]]
* [[Movie|Movie cube]]
* [[RPG|Role Playing Game]]
* [[SSP|Side Scrolling Platformer]]
* [[Vehicle Simulator]]

== Tutorials ==

* [[Adding NPC's and items to your map]]
* [[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]]
* [[MovieCube]]

</div>

__NOTOC__

Brainstorming

2010-01-02T20:44:47Z

Chaze007:

== 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.

Brainstorming

2010-01-02T19:49:34Z

Chaze007: New page: == 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 retur...

Main Page

2010-01-02T18:58:58Z

Chaze007:

'''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]
* [[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]]

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

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

</div>

__NOTOC__

Good free programs for Sandbox

2010-01-02T18:16:42Z

Chaze007:

All the below programs are free:

Wings3d, a great modeler with a outstanding uv mapper.

http://www.wings3d.com/

Tattoo 3D, This was my first 3D texturing program. It great for fast texturing but limited on more powerfull functions as it a older program. Free to use for non-commerical work.

http://www.terabit-software.co.uk/

Blacksmith 3D, You can paint your models in realtime 3D. The "freeware" 3D painter limits your export image size to 1024 x1024 which is more than enough for Sandbox

http://www.blacksmith3d.com/blacksmith3D-3d-paint-software.php

Artweaver, a 2d paint program like photoshop. It supports layers. Some texture artist like to paint on the flat 2D uv map image for textuing and other texturing usage.

http://www.artweaver.de/index.php?en_version

Misfit Model 3D, to add bones and animations for your NPC or other models, plus to save your model as a md3 file with the animation data. be sure to get the lastest beta version

http://www.misfitcode.com/misfitmodel3d/

CharactorFx, for adding bones and animation to your models. It's a little older program but works great and saves to md2 files.

http://www.insanesoftware.de/

MD3Compile, a very quick and easy converter for md2,3ds files to a md3 file. I use it for converting my static 3ds models into a md3 file plus to rebuild my 3ds model's normals.

http://www.quakeunity.com/file=481

Notepad Plus (++), unique text tool built mainly for scripting of many different types. This can be used to edit/make CFGs in Sandbox.

http://notepad-plus.sourceforge.net/uk/site.htm

Creating a shop script

2009-11-14T17:46:28Z

Chaze007:

This is a shop example script for you to edit to your liking.

"on_start" = [

money = 0

pie = 0

sword = 0

treasure = 0

]

"level_trigger_1" = [ money = ( + $money 5 )

echo "You got 5 moneys."

]

"level_trigger_2" = "showgui Shopkeeper"

newgui Shopkeeper [

guitext "What're ya buyin, stranger?" chat

guibar

guilist [

guibutton "Pie: 10 moneys" [

if ( > $money 9 ) [

money = ( - $money 10 )

pie = ( + $pie 1 )

]

]

guibar

guibutton "Sword: 20 moneys" [

if ( > $money 19 ) [

money = ( - $money 20 )

sword = ( + $sword 1 )

]

]

guibar

guibutton "Treasure: 40 moneys" [

if ( > $money 39 ) [

money = ( - $money 40 )

treasure = ( + $treasure 1 )

]

]

]

]

newgui Inventory [

guibutton "Back" "cleargui 1"

guibar

guitext ( format "You have %1 moneys in your wallet." $money )

guitext ( format "You have %1 pies. Yum." $pie )

guitext ( format "You have %1 swords. Not that you can use them..." $sword )

guitext ( format "You have %1 treasures. Lucky you!" $treasure )

]

newgui main [

guilist [

guilist [

guibutton "Inventory" "showgui Inventory"

]

]

guibar

@main

]

Good free programs for Sandbox

2009-11-14T17:41:56Z

Chaze007: New page: All the below programs are free: Wings3d, a great modeler with a outstanding uv mapper. http://www.wings3d.com/ Tattoo 3D, This was my first 3D texturing program. It great for fast text...

Main Page

2009-11-14T17:40:21Z

Chaze007: /* Getting started */

'''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]]
* [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__

Adding custom textures to a new map

2009-11-14T17:39:33Z

Chaze007:

This Tutorial is divided into small chapters.
This will explain how to add simple textures to your sandbox creation.

CHAPTER ONE

Creating Your Own Texture(s)

First we're going to create our own textures for personal use in PASandbox.
I make my textures, the size of 512x512

http://i31.tinypic.com/2dtyc2f.png

Now, save the textures you created with the names you want.
I named mine: texture_1.png and texture_2.png.

CHAPTER TWO

Creating Your Own Texture Folder

Now we're going to make our texture folder.
Open your Sandbox folder, and open "packages"
Inside "packages" create a folder, you can name it anything, but for this tutorial I used "mytextures"
Here is my path: C:\Documents and Settings\Jim\Desktop\Sandbox\packages\mytextures
Once created, drag your textures into the folder.

http://i32.tinypic.com/2mxrb8.png

We're done with this chapter for now.

CHAPTER THREE

Creating Your Packages.cfg

Alright, now I'm going to show you how to create your own packages.cfg, and some little tips.
This part is VERY simple, open notepad.
Inside notepad we want some brief text at the top, so what you're going to do is this.

// Tutorial Textures By Chaze007

The reason we add the "//" is to make it where the following text in that line, has no use.
Basically anything that comes after "//" is not used.
This is useful for removing a certain piece of code from your packages.cfg.
It doesn't delete the line of code, so you can come back and remove the "//" later when you want to use that line, or edit.
The use of "//" is called commenting. As to "Comment Out"
Now, we're going to add our shader within the packages.cfg.
This part is also very simple.

// Tutorial Textures By Chaze007

setshader stdworld

We're done with this step.
Now we get to add our textures within the packages.cfg.
This is usually the final step within your packages.cfg.

// Tutorial Textures By Chaze007

setshader stdworld

texture 0 "mytextures/texture_1.png"

That's it.
Now, I'm going to explain the parts of this.
texture 0 can have different values, like texture s or texture n.
These are used for different types of maps, like glow maps and such.
"mytextures/ is the folder your textures are in.
texture_1.png" is your texture's name.
Now lets finish this packages.cfg up!

// Tutorial Textures By Chaze007

setshader stdworld

texture 0 "mytextures/texture_1.png"
texture 0 "mytextures/texture_2.png"

That's all of my used textures.
Now say we want more, but we don't want to use them.
We would comment them out, like this.

// Tutorial Textures By Chaze007

setshader stdworld

texture 0 "mytextures/texture_1.png"
texture 0 "mytextures/texture_2.png"
//texture 0 "mytextures/texture_3.png"
//texture 0 "mytextures/texture_4.png"
//texture 0 "mytextures/texture_5.png"

We're basically done with this chapter, save your file as "packages.cfg" and drop it in your texture (mytextures) folder.

CHAPTER FOUR

Executing Your Packages.cfg

This part is extremely easy.
We're going to execute our packages.cfg from the main file.
Open your sandbox folder, then open "data"
When you're done with that for new maps open "default_map_settings" in notepad.
For existing maps open its -art.cfg located in my_stuff/packages/base or packages/base depending how you launch Sandbox (without the extra numbers, those are backups)
You should get an extremely long list of code.
Scroll all the way down to the bottom, after this line of code.

texture 0 "golgotha/water2.jpg"
texscroll .2 -.2
texture 1 golgotha/water2over.png

setshader stdworld

You want to execute your packages.cfg so now we're going to add in this.

texture 0 "golgotha/water2.jpg"
texscroll .2 -.2
texture 1 golgotha/water2over.png

setshader stdworld

exec packages/mytextures/packages.cfg

That simple!
This line basically tells Sandbox to add your packages.cfg (your textures) into sandbox.

CHAPTER FIVE

Testing Your Textures In Sandbox

Now you want to see if it works.
Open sandbox, Create a new map, and look at the last texture tab.
Obviously from the following image, it works

http://i26.tinypic.com/2ec29sj.png

CHAPTER SIX

Adding Extras

Now that our textures work in Sandbox, we might want to add a little something extra within our textures folder.
You can add your own README.TXT with credits and such, or you can also add them in the packages.cfg with commenting.
You can add the TextureDocument.PSD (if you work in photoshop) for others to look at or to adapt your work.
You can add glow maps, and all of those things, and you can add your license if you have one.

Adding custom textures to a new map

2009-11-14T17:38:15Z

Chaze007: New page: This Tutorial is divided into small chapters. This will explain how to add simple textures to your sandbox creation. CHAPTER ONE Creating Your Own Texture(s) First we're going to create ...

This Tutorial is divided into small chapters.
This will explain how to add simple textures to your sandbox creation.

CHAPTER ONE
Creating Your Own Texture(s)
First we're going to create our own textures for personal use in PASandbox.
I make my textures, the size of 512x512

http://i31.tinypic.com/2dtyc2f.png

Now, save the textures you created with the names you want.
I named mine: texture_1.png and texture_2.png.

CHAPTER TWO
Creating Your Own Texture Folder
Now we're going to make our texture folder.
Open your Sandbox folder, and open "packages"
Inside "packages" create a folder, you can name it anything, but for this tutorial I used "mytextures"
Here is my path: C:\Documents and Settings\Jim\Desktop\Sandbox\packages\mytextures
Once created, drag your textures into the folder.

http://i32.tinypic.com/2mxrb8.png

We're done with this chapter for now.

CHAPTER THREE
Creating Your Packages.cfg
Alright, now I'm going to show you how to create your own packages.cfg, and some little tips.
This part is VERY simple, open notepad.
Inside notepad we want some brief text at the top, so what you're going to do is this.

// Tutorial Textures By Chaze007

The reason we add the "//" is to make it where the following text in that line, has no use.
Basically anything that comes after "//" is not used.
This is useful for removing a certain piece of code from your packages.cfg.
It doesn't delete the line of code, so you can come back and remove the "//" later when you want to use that line, or edit.
The use of "//" is called commenting. As to "Comment Out"
Now, we're going to add our shader within the packages.cfg.
This part is also very simple.

// Tutorial Textures By Chaze007

setshader stdworld

We're done with this step.
Now we get to add our textures within the packages.cfg.
This is usually the final step within your packages.cfg.

// Tutorial Textures By Chaze007

setshader stdworld

texture 0 "mytextures/texture_1.png"

That's it.
Now, I'm going to explain the parts of this.
texture 0 can have different values, like texture s or texture n.
These are used for different types of maps, like glow maps and such.
"mytextures/ is the folder your textures are in.
texture_1.png" is your texture's name.
Now lets finish this packages.cfg up!

// Tutorial Textures By Chaze007

setshader stdworld

texture 0 "mytextures/texture_1.png"
texture 0 "mytextures/texture_2.png"

That's all of my used textures.
Now say we want more, but we don't want to use them.
We would comment them out, like this.

// Tutorial Textures By Chaze007

setshader stdworld

texture 0 "mytextures/texture_1.png"
texture 0 "mytextures/texture_2.png"
//texture 0 "mytextures/texture_3.png"
//texture 0 "mytextures/texture_4.png"
//texture 0 "mytextures/texture_5.png"

We're basically done with this chapter, save your file as "packages.cfg" and drop it in your texture (mytextures) folder.

CHAPTER FOUR
Executing Your Packages.cfg
This part is extremely easy.
We're going to execute our packages.cfg from the main file.
Open your sandbox folder, then open "data"
When you're done with that for new maps open "default_map_settings" in notepad.
For existing maps open its -art.cfg located in my_stuff/packages/base or packages/base depending how you launch Sandbox (without the extra numbers, those are backups)
You should get an extremely long list of code.
Scroll all the way down to the bottom, after this line of code.

texture 0 "golgotha/water2.jpg"
texscroll .2 -.2
texture 1 golgotha/water2over.png

setshader stdworld

You want to execute your packages.cfg so now we're going to add in this.

texture 0 "golgotha/water2.jpg"
texscroll .2 -.2
texture 1 golgotha/water2over.png

setshader stdworld

exec packages/mytextures/packages.cfg

That simple!
This line basically tells Sandbox to add your packages.cfg (your textures) into sandbox.

CHAPTER FIVE
Testing Your Textures In Sandbox
Now you want to see if it works.
Open sandbox, Create a new map, and look at the last texture tab.
Obviously from the following image, it works

http://i26.tinypic.com/2ec29sj.png

CHAPTER SIX
Adding Extras
Now that our textures work in Sandbox, we might want to add a little something extra within our textures folder.
You can add your own README.TXT with credits and such, or you can also add them in the packages.cfg with commenting.
You can add the TextureDocument.PSD (if you work in photoshop) for others to look at or to adapt your work.
You can add glow maps, and all of those things, and you can add your license if you have one.

Importing .OBJ files

2009-11-14T17:29:56Z

Chaze007: New page: This assumes you have a obj trianglated model with it's uv map for your textures. 1. Create a new folder in the packages/models folder. Name your new folder so that is describes the model...

This assumes you have a obj trianglated model with it's uv map for your textures.

1. Create a new folder in the packages/models folder. Name your new folder so that is describes the model.

2. Save or copy your obj file into your new folder you just created.

3. Rename your obj file to tris.obj

3. Save or copy your jpg texture file into the new folder. Rename your jpg texture file to skin.jpg

Also you need a cfg file. You can copy one from the other folders or make your own using notepad.
If you copy a cfg file from another folder be sure to delete the text inside it. It can be left blank with no information.

4. Rename the cfg file obj.cfg

The model now will load with the textures and with collison detection on.

There are loading paramters that you can put in the cfg file but that can be discussed later.

----

Here is how you load the your model into the map.

Press "E" to get into edit mode.

Press the tilde key (the one above the tab key) to bring up the console's text input
type "mmodel "the name of your new folder"

Press enter.
Now your model is added to your mapmodel list.

Press the escape key. click on new mapmodel, go to the last number in the list and you will see your new model at the bottom.
It is the same name as the new folder you created in the above post.

Click on the name and your model with textures loads into the map.

Wings3D to Sandbox flash tutorials

2009-11-14T17:26:27Z

Chaze007: New page: First tutorial covers Uv mapping,exporting to a 3ds file and then coverting the 3ds to a md3 file format for loading in the game engine. Second tutorial covers 3D texture painting in Tatt...

First tutorial covers Uv mapping,exporting to a 3ds file and then coverting the 3ds to a md3 file format for loading in the game engine.

Second tutorial covers 3D texture painting in Tattoo 3d. ( I have put a link to Tattoo 3d in the forum post "Good free programs to use with Sandbox" under Tutorial/Resources

Third tutorial covers writing the md3.cfg file.

Fourth tutorial covers loading the finished md3 model into the game engine.

http://www.mediafire.com/file/ywtmlynz4zj/Wings3d.zip

http://www.mediafire.com/file/m3m3zojmgjy/Tattoo.zip

http://www.mediafire.com/?nzwglyvtm5l

http://www.mediafire.com/file/10jq2td2mt0/Modelload.zip

Creating a shop script

2009-11-14T17:24:12Z

Chaze007:

This is a Sandbox shop example script, just follow and edit it to your liking.

1.
"on_start" = [
2.
money = 0
3.
pie = 0
4.
sword = 0
5.
treasure = 0
6.
]
7.

8.
"level_trigger_1" = [ money = ( + $money 5 )
9.
echo "You got 5 moneys."
10.
]
11.

12.
"level_trigger_2" = "showgui Shopkeeper"
13.

14.
newgui Shopkeeper [
15.
guitext "What're ya buyin, stranger?" chat
16.
guibar
17.
guilist [
18.
guibutton "Pie: 10 moneys" [
19.
if ( > $money 9 ) [
20.
money = ( - $money 10 )
21.
pie = ( + $pie 1 )
22.
]
23.
]
24.
guibar
25.
guibutton "Sword: 20 moneys" [
26.
if ( > $money 19 ) [
27.
money = ( - $money 20 )
28.
sword = ( + $sword 1 )
29.
]
30.
]
31.
guibar
32.
guibutton "Treasure: 40 moneys" [
33.
if ( > $money 39 ) [
34.
money = ( - $money 40 )
35.
treasure = ( + $treasure 1 )
36.
]
37.
]
38.
]
39.
]
40.

41.
newgui Inventory [
42.
guibutton "Back" "cleargui 1"
43.
guibar
44.
guitext ( format "You have %1 moneys in your wallet." $money )
45.
guitext ( format "You have %1 pies. Yum." $pie )
46.
guitext ( format "You have %1 swords. Not that you can use them..." $sword )
47.
guitext ( format "You have %1 treasures. Lucky you!" $treasure )
48.
]
49.

50.
newgui main [
51.
guilist [
52.
guilist [
53.
guibutton "Inventory" "showgui Inventory"
54.
]
55.
]
56.
guibar
57.
@main
58.
]

Creating a shop script

2009-11-14T17:18:38Z

Chaze007:

<p style="border:5px solid; border-color:black;">"on_start" = [
money = 0
pie = 0
sword = 0
treasure = 0
]

"level_trigger_1" = [ money = ( + $money 5 )
echo "You got 5 moneys."
]

"level_trigger_2" = "showgui Shopkeeper"

newgui Shopkeeper [
guitext "What're ya buyin, stranger?" chat
guibar
guilist [
guibutton "Pie: 10 moneys" [
if ( > $money 9 ) [
money = ( - $money 10 )
pie = ( + $pie 1 )
]
]
guibar
guibutton "Sword: 20 moneys" [
if ( > $money 19 ) [
money = ( - $money 20 )
sword = ( + $sword 1 )
]
]
guibar
guibutton "Treasure: 40 moneys" [
if ( > $money 39 ) [
money = ( - $money 40 )
treasure = ( + $treasure 1 )
]
]
]
]

newgui Inventory [
guibutton "Back" "cleargui 1"
guibar
guitext ( format "You have %1 moneys in your wallet." $money )
guitext ( format "You have %1 pies. Yum." $pie )
guitext ( format "You have %1 swords. Not that you can use them..." $sword )
guitext ( format "You have %1 treasures. Lucky you!" $treasure )
]

newgui main [
guilist [
guilist [
guibutton "Inventory" "showgui Inventory"
]
]
guibar
@main
]</p>

Creating a shop script

2009-11-14T17:18:05Z

Chaze007: Replacing page with '<p style="border:1px solid; border-color:white;">YOUR TEXT GOES HERE</p>'

Creating a shop script

2009-11-14T17:17:32Z

Chaze007: New page: <div style="width:200px;height:100px;border:1… solid blue;"> "on_start" = [ money = 0 pie = 0 sword = 0 treasure = 0 ] "level_trigger_1" = [ money = ( + $money 5 ) ech...

<div style="width:200px;height:100px;border:1… solid blue;">
"on_start" = [
money = 0
pie = 0
sword = 0
treasure = 0
]

"level_trigger_1" = [ money = ( + $money 5 )
echo "You got 5 moneys."
]

"level_trigger_2" = "showgui Shopkeeper"

newgui Shopkeeper [
guitext "What're ya buyin, stranger?" chat
guibar
guilist [
guibutton "Pie: 10 moneys" [
if ( > $money 9 ) [
money = ( - $money 10 )
pie = ( + $pie 1 )
]
]
guibar
guibutton "Sword: 20 moneys" [
if ( > $money 19 ) [
money = ( - $money 20 )
sword = ( + $sword 1 )
]
]
guibar
guibutton "Treasure: 40 moneys" [
if ( > $money 39 ) [
money = ( - $money 40 )
treasure = ( + $treasure 1 )
]
]
]
]

newgui Inventory [
guibutton "Back" "cleargui 1"
guibar
guitext ( format "You have %1 moneys in your wallet." $money )
guitext ( format "You have %1 pies. Yum." $pie )
guitext ( format "You have %1 swords. Not that you can use them..." $sword )
guitext ( format "You have %1 treasures. Lucky you!" $treasure )
]

newgui main [
guilist [
guilist [
guibutton "Inventory" "showgui Inventory"
]
]
guibar
@main
]
</div>

Main Page

2009-11-14T17:10:50Z

Chaze007: /* Tutorials */

'''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]]

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

== Advanced topics ==

* [[Cooperative Editing]]
* [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__

FAQ

2009-09-07T16:52:02Z

Chaze007: /* Editing */

A list of questions we've been asked and the answers too them<br>
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'''<br>
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.

'''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?'''<br>

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?'''<br>

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?'''<br>
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.