# Worldforge Media Repository
This is the Worldforge Media Repository. It contains various resources used by 
the [Worldforge](http://www.worldforge.org) project. The bulk of the resources 
are 3d meshes, textures and sounds. But you'll also find scripts and other 
material that's useful when handling media.

## Licenses
All of the assets are by default dually licensed under either [GPL 
v2.0](http://www.gnu.org/licenses/gpl-2.0.html) or later, or [GFDL 
v1.1](http://www.gnu.org/copyleft/fdl.html) or later. However, these licenses 
can be supplanted 
by selected assets in the repository. This is then marked by a licensing file 
(often named "LICENSE" or similar). The license then applies to all assets 
contained in directories below the one containing the licensing file.

## Requirements

The most important requirement is that the source assets, be it a texture, 
3d mesh or sound, is in an open enough format. It must be possible to edit the 
asset with freely available tools. Thus

* 3d meshes must be in Blender format
* textures should be formats which can be edited with freely available tools. 
This means that standard lossless formats such as .png, .tiff and .tga works fine.
However, it's also possible to use Gimp .xcf formats. And if no special features are
used, Photoshop .psd files can also be used. This hinges on no special effects or
plugins being used however. 

## Layout
The repository is arranged in the following way. Note that some directories 
contains outdated resources for long 
abandoned clients.

### assets
  Contains all assets that are used directly by the clients. See the 
[assets/README.ASSETS.md](assets/README.ASSETS.md) file for more information. 
The bulk of the repository is contained herein.

### artwork
  Contains illustrations, clip art, artwork, and sketches used as concept art, 
on the web, in documentation, or for in game illustrations of different types. 
Should not contain diagrams, graphs, web page border details, and similar 
pictures that are not illustrations. 

### soundfx
  Sound effects, ranging from ambient sounds, to sounds produced by different 
kinds of activities, and various creature sounds.

### music
  Contains a common instrument library, mod-based music using that instrument 
library, and music in mp3 or ogg formats.

### resources
  Media that is used as tools or resources when creating new media. 
  For example brushes for paint programs, image brushes for creating specific 
effects like stone or grass textures, or noise textures that are useful for 
adding uneveness or dust to other textures. Also contains a lot of various 
scripts and tools that are useful when both organizing and creating assets.
  
### icons
  (deprecated; actively used icons are instead placed in "assets")
  Icons for various generic purposes, such as map icons, spell icons, etc. 
  Should not contain theme specific icons as those are in themes/, nor 
application specific icons as those are stored with the application.

### logos
  Contains Worldforge logos (official and submissions), as well as logos for 
other WF products / projects / teams.

### themes
  (deprecated; actively used themes are instead placed in "assets")
  User interface themes for older clients.

### scratchpad
  The scratchpad is an area for various artists to work on personal and 
experimental projects that don't fit in any of the existing categories, but that 
could nevertheles prove to be useful for others too. Each artist can create a 
directory under scratchpad named as their nickname, or named after the project 
if there's multiple people working on it. 
  For example media/scratchpad/pato/scene_setups/isometric_ground_tiles_jo.blend 
or media/scratchpad/syllus_comic/. 

### sprites
  (deprecated;  a leftover from when Worldforge focused on isometric clients)
  Isometric sprites and floor tiles.

### junkyard
  A collection of old material that is currently not used, and doesn't belong in 
any of the other categories. The junkyard is a place where you can dump things 
that are not needed but still are too good to throw away, and where you can 
search for reusable parts. It differs from the scratchpad in that the material 
is not being actively developed by anyone, and is usually old material that 
could not be placed elsewhere.