This is an old revision of the document!
—-
We've already briefly experience packages at work when we tried to compile packages in the Project Manager (key F7) (id you haven't tried it yet, do it NOW!) Back then everything our game produced was a folder with 3 files - data.dcp, game.exe, and settings.exe. While both exe files are from wme engine itself, data.dcp is the actual game.
We've already touched a subject of referrencing files for our game without the data so instead of data\scenes\Circle\Circle.scene we've simply written scenes\Circle\Circle.scene. This is because WME looks into contents of ALL packages as if they were copied into one big virtual directory. Well it's not exactly that, because you can set priority to packages too, but let's start from the begining.
The best would be to start with an example. In the top level structure create a new folder and name it audio. So just for a record it will be right next to the data folder and wpr file. Then MOVE folders music and sounds into the audio folder.
The next step in the process is "Promoting" our folder to package. For this step you might need right clicking the folder tree in the project manager and choose Refresh.
Right Click folder audio and choose Promote to package.
And suddenly our folder icon changed to a package icon. From now on this package will be compiled in the target build and contents of this folder will be used when you debug your game. So now your game will again have audio! Reverse process to promote to package is Degrade to folder, which you can't done on the main package.
Ok, and why all the fuss with packages?
There are 3 great uses: