Korman:Updating From PyPRP

Disambig gray.png

This is a tutorial page.

This tutorial will explain how to prepare your PyPRP-built Age for Korman.

Setting Up

Open your blend file in Blender 2.77a. Everything should open fine, but to get the Age working properly, there are a few things to adjust.

Text Files

The first order of business is to carry over the contents of your Book text file and put it into the World panel in your Properties window.

Also take the fog/clear color and fog settings from your Init text file and plug them into the fog settings in the same panel.


Once that is done, you can delete the Book and Init text files.

You will want to copy and paste the text from your AlcScript file into a separate text program and save it separately. This way, you can keep it for reference later. Once that's done, you can delete the AlcScript text file from your blend file.

Alternately, you can keep your AlcScript file in for later reference, but note that Korman will never use any of it upon export.

Plasma Objects

For things to export in Korman, they must have Plasma Object checked in the Physics panel. However, if you have a lot of objects, this could take awhile.

To simplify this, Korman has the Plasma Objects button that checks ALL objects. In the 3D window, press T to bring up the Tools panel. Make sure the Tools tab is selected, and in the Plasma panel, under Plasma Objects, you can click on Enable All.

If you want to enable only some items, you can select them in the 3D window and click Enable Selection. Alternately, to turn off the selected items, click Disable Selection.

There is also the Disable All option if you want to turn everything off.


If you'd prefer not to have a single item export, select it in 3D view, go to the Physics window and uncheck Plasma Object.



Due to the old way of lightmapping, a lot of your textures may be unchecked. In Korman, this will keep them from exporting.

To fix this, in the same Tools panel as the Plasma Objects button, click the Textures button under Enable All Textures.

NOTE: active textures do NOT interfere with the new method of lightmapping.

Your existing image stencils (blends don't export in Korman) and old lightmaps and their settings will carry over fine.

Spawn Points

Now that the AlcScript is gone, we need to set the Link in point(s) again. For this, select the Link in empty in the 3D window, then click the Physics button in the Properties window (see picture in the Plasma Objects section above).

Click Add Modifier and choose Spawn Point.



To rewire your sound emitters, see the sounds tutorial.


Cameras are not currently enabled with Korman. For now, they all must have Plasma Object unchecked.

They will be added soon.


Subworlds have been enabled in Korman. A tutorial for this will be added soon.


For every object you want to be solid, select it in the 3D window, and under the Physics panel, click Add Modifier and then click Collision.


For floors, check Blocks Avatars, Blocks Camera and Terrain. If you'd like the floor to be "slippery", uncheck Terrain.

For simple objects, Convex Hull is usually the best option. For more complex objects, choose Triangle Mesh.

NOTE: Triangle Mesh should be used as sparingly as possible to help Age performance. Use Convex Hull where possible instead.
NOTE 2: Flat planes cannot have Convex Hull collision or URU will crash.

Footstep Regions

To set up your footstep regions, you can use the footstep modifier by going to the Physics window, clicking Add Modifier and selecting Footstep.


Region Bounds should be set to Convex Hull for simple objects and Triangle Mesh for more elaborate meshes.

Surface will choose what type of footstep sounds to use.


In PyPRP, for partial transparency of a full texture, the Col slider under Map To was sometimes used.

Tutorial StencilMode.png

You can carry over your settings from this panel for all affected textures by pressing the Layer Opacities button in the Tools panel in the 3D View window.


For easier access, Korman makes layer opacity its own separate function instead of utilizing an unused, unrelated Blender slider.


You can find this panel by clicking the Textures button in the Properties window, then scrolling to the last panel.


For detailed instructions on setting your old animation curves in Korman, see the animations tutorial.


For detailed instructions on setting various clickables in Korman, see the clickables tutorial.

Changes Between PyPRP and Korman

  • Objects left with no material and not set as regions will not lock up the export (they export as invisible).
  • You can export for three different versions of URU, not just Path of the Shell/Complete Chronicles. This includes Myst Online: Uru Live.
  • You can now animate the scale of an object (ie shrink, grow, squish or stretch it).
  • A new, more visual node-based system of wiring for responders.
  • Shiny, K'veer-like floors (ie Dynamic Camera Maps).
  • No more need to copy sounds in with the blend file or convert to WAV format. You can link to the OGG sounds in URU's SFX folder directly.