Latest Posts

Changes in GettingStarted

Editor Comment

Added Bazaar intro


Revision Differences of Revision 7

# Getting Started as a Creator of Game Content ¶
_(under construction) started 19 Dec 2010_ ¶

Contents ¶
[TOC] ¶


## Introduction ¶
So you are interested in creating content for the project? Great! Welcome! ¶
Whether you are a coder, graphic artist, musician, or web guru, there are some steps to take to get started as a productive participant. You may not be familiar with the development environment and tools used in the Widelands project, so this page is intended to outline what is needed by a creator of content. ¶

## Launchpad.net ¶
All of the files that make up the source code, documentation, graphic and audio content of Widelands is maintained in one of three repositories ("trunks") on [Launchpad.net](https://launchpad.net) ¶

* __The main development ["trunk"](https://launchpad.net/widelands)__ - contains all of the application-related files, (i.e. everything that is needed short of a compiler and libraries to build and compile an executable version of the game.) ¶
* __The ["media trunk"](https://launchpad.net/widelands-media)__ - contains the graphic and audio sources used to generate Wideland's visual and audio content. ¶
* __The ["website trunk"](https://code.launchpad.net/widelands-website)__ - contains the code that supports this website. ¶

### Establishing a Launchpad.net Account ¶
Just as the main repositories are referred to as "trunks" on Launchpad, revisions from development are referred to as "branches". More on that later. ¶
While you don't need an account to download branches from Launchpad, a Launchpad.net account is required if you wish to effect any changes. ¶
[This link](https://help.launchpad.net/YourAccount/NewAccount) will take you to the Launchpad website page for setting up a new account. ¶

### SSH Key Description and Use ¶
Launchpad trusts that you are who you claim to be. Later, such as when you're using the bug tracker's email interface, you'll need to use an electronic signature to prove your identity. ¶

A Secure Shell or SSH is a network protocol that allows data to be exchanged using a secure channel between two networked devices, encrypting and decrypting the data to ensure it is received by the intended party. ¶

[This link](https://help.launchpad.net/YourAccount/CreatingAnSSHKeyPair) ¶
takes you to where the Launchpad site documents the process of setting up an SSH Key pair for use in Launchpad. ¶

## UbLauntuchpad Linux tenvractironment withe Bazaare they ref

### Descr iption and Links ¶
Well, with asll of the progranm OdevelopmenPGPt Kprojey.cts that

Foare __MS Windhowus__ed on Launchperad.net, including systems your cWidelan aldso refefor to, [there is wa nebsite](htd to keeps://www. tracf.bnl.gk ov/docs/auf thenti chation/gessh/srevishkeygenwin) for ins that arue ctionstantly obeing howmade to sthet uprograms and uscontent SSHof Keys.all Forf mthorse informationy pronjects. SSH, There yoLau mnchpay fid.ndet websithe [Wutiklipzedis a afrticlee](htt Op://en.wikipedia.Sorg/wiki/PuTTY) on thrce PuTTY utility canlled [it'sBazaar hfomer site](hte tp://www.chiarsk.g of vereesionend. contrgol.uk/~ It is througth Bazaar (bzr) tham/putty/) canll give yuplouads eveand mdownloads are inperformationed. ¶

To gohe dBzrPrirmectlyr to thpage PuTTYis dowanload site [xcelicklent hrerfe](http://www.chiark.greencend. for g.uk/~sgetatham/putty/dowinload.hg stml) ¶

## Launchpad inrteractiond with Bazaar.

###It Deis structured priptmarily fonr coders and Lihenksce refers
_Expsolelainy to bazaarthe maind add eveliopmenk to sitrunk. Specifics for the medowia trunloadk cand be fourthnd ber inflo_w.

> *TIP: B___QbzrPrimer___ - _(liIs ank optional putility (reaglly an exte)_ ¶
>nsion *of Qbzr) that can be used in -concert _(with Bazaar. It provief des a graphical user ipnterface (GUI) whionch makes loptg ionquiries alnd uother tasks a little easityer. Here is and l[Link](http://wiki.bazaar.canonical.com/QBzr) to site)_ s homepage.

### Procedures ¶

#### Creating a personal branch ¶
_Outline the process and list the commands as an example_ ¶

#### Downloading ¶
_Outline the process and list the commands as an example_ ¶
#### Adding / Committing ¶
_Outline the process and list the commands as an example_ ¶

#### Uploading ¶
_Outline the process and list the commands as an example_ ¶

## Directory structure of the media trunk ¶
_Show high/mid-level directory tree with explanations of the folders used by content creators_ ¶

## Directory structure of the main trunk ¶
_Show high-level directory tree with explanations of the folders used by content creators_ ¶

## General Graphic Development ¶

### Links to existing wiki pages on blender perspective, color, etc. ¶

## 2D Graphic Development ¶
_brief descriptive listing of the graphical elements in each following category (e.g. screen backgrounds, borders, buttons, map terrain, etc.) Mention the tools like GIMP, etc. that can be used, resizing, and perhaps some testing and quality control suggestions._ ¶

### WL User Interface Graphics ¶

### WL Game 2D Graphics ¶

### WL Editor 2D Graphics ¶

## 3D Graphic Development ¶

### Description of Blender and links to get it ¶

### The templates ¶
_List the template files and their intended use_ ¶

### The scripts ¶
_List the python scripts in the tools directory and describe what they do_ ¶

### Animation ¶
_Describe the process of animation as it is done for Widelands workers, buildings and other bobs_ ¶

## Description of conf files for graphic elements ¶

### What they are and how they are used ¶

### Common Parameters ¶

#### Pics/Dirpics ¶

#### Hotspot ¶

#### Playercolor ¶

### Animation Parameters ¶

### Building Parameters ¶

### Worker Parameters ¶

### Other ¶

### The extent to which a content creator may modify them ¶
_Warn about changing parameters that would effect game play_ ¶

## Music & Sound Development ¶
_Describe the considerations for creators of music and sounds_