How to install configuration package (OS X)

Note: If you thing than this page is outdated, no, it is fresh, I have no Yosemite because it currently works buggy for me and I still use Mavericks to make screenshots for this article. Anyway this article useful for both Yosemite and Marericks.

The installation process of configuration package is simple and easy.

After download you have the one archive file which have included subdirectory.

Inside this subdirectory you will found set of *.INI files which defining settings and game items and data directory with configuration package media: Graphics, Music, Sounds.

Versions of configuration packages:

Full - have everything in one archive.
Lite - without musics and sounds, have smaller size than full, and you have possible to work with levels and worlds, but without playback of internal music. Music and sounds you can copy from other source into data/music subdirectory of configuration package.
Base - Smallest version which have only config files without any media. Use these versions for quick updates of configuration package only.

 

Note: Before start installing of config pack you must copy "PGE Project" folder from DMG into your "Applications" folder. Then you should try to run editor or engine even if any error will be happened.

How to install:

1) First of all, download config pack by clicking to "Download" link:

file:///_server/172.16.0.10/WebHosting/engine.wohlnet.ru/docs/docs/_configs/_img/osx_download.png

2) When find the data directory and find inside it the "configs" directory

file:///_server/172.16.0.10/WebHosting/engine.wohlnet.ru/docs/docs/_configs/_img/osx_look_for_data_dir1.png

file:///_server/172.16.0.10/WebHosting/engine.wohlnet.ru/docs/docs/_configs/_img/osx_look_for_data_dir2.png

3) When config pack zip archive will be downloaded it would be automatically unpacked, then simply drag and drop it into "configs" folder in your "Data Directory".

file:///_server/172.16.0.10/WebHosting/engine.wohlnet.ru/docs/docs/_configs/_img/osx_drag_drop.png

4) When config pack will be moved into configs dir, it should work in the PGE.

(If you isn't run editor first time and you want to start using of installed configuration package when you already have pre-installed, you can switch configurations between themeselves in the
[Tools -> Global configuration -> Switch configuration...] menu.

You also can check "Ask every startup" to select config pack on each startup of editor).

file:///_server/172.16.0.10/WebHosting/engine.wohlnet.ru/docs/docs/_configs/_img/osx_config_packs_list.png

 

Check configuration status

You can check correctnessof installation of configuration pack in the
[Tools -> Global configuration -> Current configuration status...]

Status tab, is a list of successfully loaded or failed media files

 file:///_server/172.16.0.10/WebHosting/engine.wohlnet.ru/docs/docs/_configs/_img/Config_status_osx.png

 

Directories tab is a list of media paths:

file:///_server/172.16.0.10/WebHosting/engine.wohlnet.ru/docs/docs/_configs/_img/Config_Status_2_osx.png


Where Level data - is a path to the "blocks", "background", "background2", "npc", "effect" folders
Where World map data - is a path to the "tile", "scene", "path", "level", "player" folders
Where Characters folder - is a path to sprites of your playable characters (each character have own folder for sprites, for example, "demo", "iris", "kood", "raocow", etc.)

 

Errors tab - list of errors which appeared while configuration is load.

file:///_server/172.16.0.10/WebHosting/engine.wohlnet.ru/docs/docs/_configs/_img/Config_Status_3_osx.png