Guild of Writers

Latest revision as of 13:21, 20 April 2024

This tutorial will show you how to properly set up Blender for Korman.

Introduction

Korman is the spiritual successor to PyPRP, created by the Guild of Writers' H'uru team specifically to streamline the Age-building process for multiple versions of URU, both online and offline.

This includes the removal of AlcScript in favor of a simpler building and programming interface, more in line with Cyan's 3DS Max plugin.

Required Software

Luckily, unlike 3DS Max, Blender for Korman is free and open source, so getting your own copy is easy.

IMPORTANT NOTE: As of 0.13, you no longer need to install Blender separately. Blender for Korman will now install both for you.

Windows

For Windows Vista and above, you will only need Blender for Korman (32 or 64 bit depending on your system).

• Blender for Korman v0.16

You can choose either the installer or the ZIP archive, whichever you prefer.

Mac

Coming soon!

Linux

Coming soon!

Installing Blender for Korman

Installer

If using the installer, run the EXE and follow the directions. If Windows Protector brings up a green error screen, just click on More Info and then Run Anyway.

It will ask where to want to install. You want to select a folder that's not in any of the Program Files folders.

You'll then have the option of where to place a Start Menu shortcut. Choose one, create one (default is Korman #.##), or just choose Do not create shortcuts if you'd prefer to do it yourself.

Next comes the Choose components window. You can leave this and click Install. This process may take a few minutes.

Once installation is complete, click Finish to close the installer.

ZIP Archive

If you're using the ZIP file, simply create a new directory for Blender for Korman and drop the ZIP's contents into that folder. You can then create a shortcut to blender.exe.

Activating Korman in Blender

In order to use Blender for Korman for the first time, you must activate it.

In Blender, press Ctrl+Alt+U. This will bring up the User Preferences menu.

Click the Add-ons tab at the top of the window, then on the left, select System.

If Korman is installed correctly, you should see it on the corresponding list that appears (you may have to scroll back up and/or hit the Refresh button at the bottom of the window).

Click the check box to the right to activate Korman.

Go ahead and save your settings and close the User Preferences window.

Next, at the top of the Blender window, switch from Blender Render (or whatever renderer it's using currently) to Korman.

Choosing Game and Python Installations

Once you've installed and activated Blender for Korman as shown above, go to the Properties window, then to the World panel.

Scroll down until you see the Plasma Games panel and click on the wrench to the right (see above image).

Here, you'll be able to choose your various game installations to export to (simply navigate to the main directory of each install, whether an online or offline version), as well as which avatar to use upon Linking into the game using Test Age or Launch Age options from the World window.

Simply click on the + to add an URU installation.

• For an online URU install, use your preferred avatar's KI number. For the server, server.ini is usually sufficient, but check your install.
• For offline URU, choose the name of your preferred testing avatar.

You can also set your Python installations here as well, but it's not required.

Click Save User Settings and close the User Preferences window.

You are now ready to use Korman!

A note about Blender

Korman's tutorials assume you already have a knowledge of Blender and its basic workings and functions. There are many off-site tutorials that can be searched for online.

After Installation

• To set up a basic Age from scratch, continue on to the getting started tutorial.

• If you're updating an existing Age from PyPRP, see Korman:Updating From PyPRP.