Report article RSS Feed A guide to the Call of Pripyat SDK.

Downloading, installing, setting up and using it, all covered! Learn how to convert Call of Pripyat maps for use in the level editor!

Posted by Beac on Jan 7th, 2011
Basic Mapping/Technical.

Using the Call of Pripyat SDK

A tutorial brought to you by Beacon, creator of CoP: Redux.



Welcome once more to a tutorial on the joys of modding for S.T.A.L.K.E.R. Call of Pripyat!

Today I'll be talking about something brand new, the CoP Software Development Kit.

The generous guys on the STALKER Dev Team at GSC Game World have graciously given us a wonderful Christmas/New Years present - the SDK for Call of Pripyat!


1: What is it?



Simply put, the SDK or Software Development Kit, is the set of tools that the developers of STALKER used to make the game.

It contains the following modules:

  • Actor Editor
  • Dialogue Editor
  • Level Editor
  • Particle Editor
  • Post-process Editor
  • Shader Editor

Each of these is used to modify different parts of the base game, and for this tutorial we'll be focusing on the Level Editor.


2: Download and Setup.



First thing you'll want to do is download the SDK installer, but the official link from GSC is terribly slow so you'll want to use this much quicker link.

Once downloaded, install it to the default directory (should be C:\Program Files\X-Ray CoP SDK or suchlike).

Next, if you already know what level it is you're looking to edit within the Level Editor, find its folder within the 'resources' folder in your CoP directory (resources/unpacked/levels/) and copy it into your SDK Root/editors/gamedata/levels/ folder, then copy the two files from within that level's terrain folder into the SDK Root/editors/gamedata/textures/terrain folder.

Without doing this, A: you won't have a level to import to the editor, and B: you'll be missing the ground textures of your level!


3: Setting up the level converter.



The next thing we need to do is convert the level you want to edit from the game format to the level editor format - to do this we need a tool developed by some great Stalker modders, to whom we are eternally grateful!

1: Download the converter tools then extract fsconverter_cop.ltx, converter.ini and converter.exe to your SDK Root/editors folder.

2: Rename fsconverter_cop.ltx to fsconverter.ltx, then open it in a notepad application (Notepad++!).

3: Find the line beginning with $sdk_root$ and replace c:\program files\X-Ray CoP SDK\editors\ with the correct directory for your PC - mine for instance is C:\Program Files (x86)\X-Ray CoP SDK\editors\

4: Edit converter.ini again with a notepad application, then scroll almost to the bottom of the file and find the line that begins with ; 3870+ - firstly edit the line two below it, beginning with $game_data$ and replace E:\Games\COP\gamedata\ with a link to your CoP SDK's gamedata folder - mine is C:\Program Files (x86)\X-Ray CoP SDK\editors\gamedata\.
Finally, do the same thing with the $game_levels$ line, but add '\levels' to the end, e.g C:\Program Files (x86)\X-Ray CoP SDK\editors\gamedata\levels\


4: Using the level converter.



Now we can go about the process of actually converting levels for use in the Level Editor!

Go to your start menu and type 'cmd'.

This should open up a black command prompt box, into which you need to type 'cd ~SDK Directory leading to the editors folder~

Like so:


This takes you into the 'editors' folder of the SDK Root, meaning we can now launch the converter.

Type the following into the command prompt box:

converter -level cop:pripyat -mode le -with_lods

Let's run through this command for an idea of what it does;

  • 'Converter' tells the PC what to run, in this case the 'converter.exe' in your SDK/editors folder.
  • '-level cop:pripyat' tells the converter application to convert the Pripyat level using the settings in the CoP part of the converter.ini.
  • '-mode le' tells it to convert it for use in the Level Editor.
  • '-with_lods' tells it to also convert the lods, enabling you to later recompile the level.

Simple enough, right?!

To convert other levels, simply replace 'cop:pripyat' with 'cop:levelname' where 'levelname' is obviously, the name of the level you want to convert!

Having inserted this command, the program should begin running and start converting your level - this will take a bit of time, especially the converting of lods.

Once finished, your level will be ready for use in the SDK Root/editors/rawdata/levels folder!


5: The Level Editor.



Now we get to the more interesting part - actually editing a level.

Navigate to your SDK Root/editors folder and proceed to launch '!LevelEditor.cmd' - launching the LE through any other method will lead to problems, so make sure to use this .cmd!

The Level Editor will start up, and eventually you'll get your first look at the editor's workspace.


Controlling the Camera:

Movement is done via the use of the Shift key and your mouse buttons:

  • Shift-LMB combined with mouse movement will move the view forward, backward, left, right etc.
  • Shift-RMB combined with mouse movement will move the view up and down vertically.
  • Shift-LMB+RMB combined with mouse movement will change the view as if you were in an FPS, allowing you to look around.

Simple!

Loading Maps:

Look to the top-right, click the 'file' button, and hit 'load' - then select the level you've converted, and the LE will load it into the workspace.

Editing Maps:


This is the Edit Mode tab, over on the middle-right of the screen.

Here you can choose what parts of the map you would like to see, and edit.

The eye icons to the left of each selection show what you can see of the map - when these are shown, you can see that part, and when they're not, you can't!

To the right of the eye icons are little checkboxes - to be able to actually edit the part you want, it has to be selected - this is done by selecting it's checkbox (as you can see, 'Object' is currently selected.

So, let me run down the most important/interesting parts of this box:

  • Object - this basically represents the majority of the level - the terrain, most buildings etc are all very large models that combine together, and this allows you to select them. It is also used to add/modify smaller objects to/in the level such as vehicles.
  • Spawn Element - this is everything from items in the level to smart-terrains. Things that are spawned into the game come under this, and it allows you to add/edit small items on the level, anomalies, smart covers etc.
  • Way Points - pretty self-explanatory, these are the waypoints in the level that tell NPCs or artifacts where to move.
  • AI Map - this is a huge surface covering the entire level that tells NPCs where they are able to move - it makes sense when you look at it, telling them which way they can go to get around obstacles, up stairs, etc.

Editing Toolbar:


This is the editing toolbar in the top-left of the screen. It's very important!

From left to right:

  • Undo - Also available with the hotkey 'Ctrl-Z'
  • Redo - Also available with the hotkey 'Ctrl-Y'
  • Select - You need to select objects, spawn elements etc. before you can move/edit them, so use this to click on things and select them!
  • Add - You use this after selecting an object in the bottom right, then clicking in the level somewhere to add it.
  • Move - Simple enough, allows you to move things around (as long as they're selected in the Edit Mode box!).
  • Rotate - Again, simple. As above, but for rotation.
  • Scale - And again! This lets you scale up/down objects.
  • Lock to X - Locks the object to the X-Axis, allowing movement/rotation only on that axis.
  • Lock to Y - As above, but for the Y-Axis.
  • Lock to Z - As above, but for the Z-Axis.
  • Lock to Z/X - This seems to allow you to drag things along, a sort of 'lock to terrain' button.

And there, we go, that's the basics of setting up and using the SDK to open a converted level from Call of Pripyat!

I hope this has been helpful, and may you go out and create some awesome stuff with its help!

'Till next time, keep safe brothers!

 - Beacon
      Creator of Call of Pripyat: Redux

Post comment Comments
Bolognius_Maximus
Bolognius_Maximus Jan 7 2011, 3:20pm says:

Ah this is awesome! Been waiting for this for a while! Thanks so much Beacon. I've really wanted a English tutorial for a while now.

+4 votes     reply to comment
jjawinte
jjawinte Jan 7 2011, 8:28pm says:

Outstandingly generous informative and concise tutorial of you to share Beacon. Well done man !

+4 votes     reply to comment
Beac
Beac Jan 8 2011, 3:31am says:

Thanks a lot guys, very happy to help. I'm very close to getting a working SoC Cordon into CoP so when I do I may write a more complicated tutorial on how to accomplish that :P

+6 votes     reply to comment
0800
0800 Apr 14 2011, 11:26am replied:

Any success with porting over Cordon from SoC, to CoP yet Beac?

+4 votes     reply to comment
Null-Entity
Null-Entity Jan 8 2011, 3:43am says:

Does that mean we could (even if not by yourself) be looking at a port of SOC into CoP?

+2 votes     reply to comment
Beac
Beac Jan 8 2011, 7:56am replied:

Yeah.

+2 votes     reply to comment
jjawinte
jjawinte Jan 8 2011, 2:36pm replied:

Excellent.

+4 votes     reply to comment
chiffmonkey
chiffmonkey Sep 15 2011, 6:59am replied:

SMRTER 0.45

+3 votes     reply to comment
SPTX
SPTX Jan 8 2011, 9:23am says:

Very nice of you. I'll forward this.

+2 votes     reply to comment
kuadziw
kuadziw Jan 10 2011, 5:48pm says:

Thanks a lot, dude!

+2 votes     reply to comment
kjfytfkytfyt
kjfytfkytfyt Jan 12 2011, 1:14am says:

for a long time now i have been thinking about making mods for stalker. now i think i finally will, great tutorial, im kinda slow so ill need to read it a few times, but like with every other editor i have used for games, i will probably ( hopefully ) get the hang of it. thanks for a tutorial in english :)

+1 vote     reply to comment
durundallives
durundallives Jan 12 2011, 10:27am says:

good stuff, keep the tutorials coming! maybe next one how to go about compiling the edited level and playing it in game?

+2 votes     reply to comment
Beac
Beac Jan 12 2011, 1:19pm replied:

I've only just managed to do this myself really, but I'll hopefully write it out eventually - thanks :)

+1 vote     reply to comment
durundallives
durundallives Jan 12 2011, 3:14pm replied:

I figured, been keeping track of the thread on GSC to try to follow along...slowly haha. Looking to expand on the involvement of the scientists, add a few levels, create some new personalities - the usual :)

+1 vote     reply to comment
kjfytfkytfyt
kjfytfkytfyt Jan 12 2011, 5:35pm says:

As you find out how to do more things, please upload more tutorials to help us all :)

+1 vote     reply to comment
Re|3uilt
Re|3uilt Jan 18 2011, 4:51pm says:

Beacon-FYI
your dropbox sdk.exe link isn't working, or i should say it downloads however, you get error window "file corrupt" when you run exe
btw-fantastic tut!

+1 vote     reply to comment
Stealth-Killer
Stealth-Killer Mar 25 2011, 9:16am says:

Awsome... really! it's a great help...
...THANKS!!!!!

+1 vote     reply to comment
Stealth-Killer
Stealth-Killer Apr 5 2011, 3:22am says:

Just one thing... Could anyone tell me how to add new weapon/ amor/other equip to Cop, withouth game crashing?

+1 vote     reply to comment
bulliz
bulliz Aug 21 2011, 8:36pm says:

I always wondered why aren't any new worlds in Stalker. I think a mod with a true open world like in morrowind will make this game perfect and last forever. But I bet it's very hard to this, what do you think?

+1 vote     reply to comment
Stealth-Killer
Stealth-Killer Oct 9 2011, 6:09am says:

Cool... Just for some reason converter.ini and converter.exe was renamed fsconverter.ini/exe... weird.. just had to rename em, and then it works... thanx!!! :D

+1 vote     reply to comment
NafNaf_95
NafNaf_95 Oct 21 2011, 11:42am says:

good tut but i cant get it to work

+1 vote     reply to comment
saho_stalker
saho_stalker Jan 21 2012, 11:09am says:

Hi Beac. i think you can do something like TD(tower defence) in multiplayer. Cordon is the-best place for this; waves of zombies and monsters and cooperation - this will be amesome i think.

+1 vote     reply to comment
davidkailov
davidkailov May 13 2012, 8:50pm says:

Hey, how are you, finally i've found some usefull information about the sdk, but i'm having a problem, i follow every step you wrote down here. But when i am at step four, converting levels the cmd tells me can't find fsconverter.ltx

I've already check it and repeated all steeps but i don't know what to do. If you could help me i'd be so pleased, thank you.

+1 vote     reply to comment
davidkailov
davidkailov May 15 2012, 11:42pm says:

Hey, don't worry i found my mistake, sorry everything's ok thank you

+1 vote     reply to comment
SurvivorSTK
SurvivorSTK Mar 11 2013, 4:57am says:

since I install it,everytime I start the application,the app is not responding at all....so LOL

+1 vote     reply to comment
cyclops12321
cyclops12321 Oct 11 2013, 4:02am says:

I am getting the following error while level converting in the command prompt:
cant load gamemtl.xr
[bug] unexpected code path ..xr\level.cxx:131
this application has requested the runtime to terminate it in an unusual way.please contact the applications support team for more information
I have followed the instructions properly..still ;(
any help will be appreciated....

+1 vote     reply to comment
TheWolfhound
TheWolfhound Dec 4 2013, 12:07pm says:

Does anybody know how to test out my Levels(how to put them back in their original form so i can play them)?

+1 vote     reply to comment
ketxxx
ketxxx Feb 5 2014, 12:50pm replied:

That would require compiling the edited levels... something which for me at least is not a easy thing to do the process is riddled with problems but I'm trying to use the SoC SDK for SoC modding, the process is the same though.

+1 vote     reply to comment
TheWolfhound
TheWolfhound Feb 19 2014, 4:21pm replied:

Please send me a private message how to compile levels if you can,thanks(sorry for late reply).

+1 vote     reply to comment
Post a Comment
click to sign in

You are not logged in, your comment will be anonymous unless you join the community today (totally free - or sign in with your social account on the right) which we encourage all contributors to do.

2000 characters limit; HTML formatting and smileys are not supported - text only

Tutorial
Browse
Tutorials
Report Abuse
Report article
Related Mods
Related Games
S.T.A.L.K.E.R.: Call of Pripyat
S.T.A.L.K.E.R.: Call of Pripyat Single Player First Person Shooter
Related Groups
S.T.A.L.K.E.R.: Way of the Wolf Dev Team
S.T.A.L.K.E.R.: Way of the Wolf Dev Team Developer with 5 members