Development

From Platinum Arts Sandbox Free 3D Game Maker
Jump to: navigation, search

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 [1] 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.

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

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

 svn co http://www.sandboxgamemaker.com/sandboxpretessa/ sandbox

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

 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

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

A screenshot of the context menus in KDE 3.5
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