Difference between revisions of "Korman:Installation"

m (Required Software)
Line 4: Line 4:
  
  
This tutorial will show you how to properly set up '''Korman'''.
+
This tutorial will show you how to properly set up '''Blender for Korman'''.
  
 
==Introduction==
 
==Introduction==
Line 35: Line 35:
 
''Coming soon!''
 
''Coming soon!''
  
==Installing Blender==
+
==Installing Blender for Korman==
  
Download the above installer for Blender and run it, following instructions.  If you have a previous version of Blender installed, you will want to name the default install folder to something new (such as Blender2.79b) during installation. 
+
===Installer===
  
You can have multiple versions of Blender installed in the '''Blender Foundation''' folder ''as long as they're in separate sub-folders''.
+
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'''.
 
+
Remember where you install Blender 2.79b as you will need to install Korman there next.
+
 
+
<blockquote>'''NOTE: 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.'''</blockquote>
+
 
+
==Installing Korman==
+
 
+
Next, download and run the Korman Installer.
+
 
+
After a couple of prompts, it will ask where to want to install.  You want to select the folder you just installed Blender into, THEN go into the '''2.79''' subfolder (see example below).  Once this is done, click '''Install'''.
+
  
 
[[file:KorIntro02.jpg]]
 
[[file:KorIntro02.jpg]]
  
The next screen will allow you to select which version of Korman to useIf the proper Blender install directory was chosen, the Korman installer should be able to tell which version (32 or 64 bit) of Blender you have installed, so you can leave this as is in most cases.
+
It will ask where to want to installYou want to select a folder that's '''not''' in any of the Program Files folders.
  
[[file:KorIntro05.jpg]]
+
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.
  
<blockquote>'''NOTE:''' The version of Korman '''must''' match the version of Blender 2.79 (32 or 64 bit) that you installed earlier! Only change things in the drop down menu above if you're sure the installer didn't chose the correct version!</blockquote>
+
Next comes the '''Choose components''' window. You can leave this and click '''Install'''. This process may take a few minutes.
  
Once installation is complete, make sure '''Run Korman''' is checked and click '''Finish''' to start Blender.
+
Once installation is complete, click '''Finish''' to close the installer.
  
 +
===ZIP Archive===
  
===Activating Korman in Blender===
+
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'''.
  
In order to use Korman, you must first activate it.
+
===A note about Blender===
  
In Blender, press '''Ctrl+Alt+U'''. This will bring up the '''User Preferences''' menu.
+
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.
  
Click the '''Add-ons''' tab at the top of the window, then on the left, select '''System'''.
+
===Choosing Game and Python Installations===
  
[[file:KorIntro03.jpg|300px]]
+
[[file:KorIntro07.jpg]]
  
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).
+
Once you've installed Blender for Korman, go to the '''Properties''' window, then to the '''World''' panel.
  
Click the check box to the right to activate Korman.
+
Scroll down until you see the '''Plasma Games''' panel and click on the '''wrench''' to the right (see above image).
  
<blockquote>'''NOTE:''' If you get an error here, you may have the wrong version of Korman installed. It MUST be the correct version associated with your version of Blender 2.79 (32 bit or 64 bit).</blockquote>
+
[[file:KorIntro06.jpg|500px]]
  
====Choosing Game and Python Installations====
+
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.
 
+
[[file:KorIntro06.jpg|300px]]
+
 
+
Once you activate Korman, click the arrow on the left to expand its setup options.
+
 
+
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. If the option to add a game installation to the Plasma Games list is greyed out, you must follow the step below to switch from '''Blender Render''' to '''Korman''' first.
+
  
 
* 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 an online URU install, use your preferred avatar's KI number. For the server, '''server.ini''' is usually sufficient, but check your install.
Line 90: Line 75:
  
 
You can also set your Python installations here as well, but it's not required.
 
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.
 
Click '''Save User Settings''' and close the User Preferences window.
 
Finally, at the top of the Blender window, switch from '''Blender Render''' to '''Korman'''.
 
 
[[file:KorIntro04.jpg]]
 
 
  
  

Revision as of 15:41, 30 April 2022

Disambig gray.png

This is a tutorial page.Versions available: PyPRP; 3ds Max; Korman.
 
KorIntro01.jpg


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).

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.

KorIntro02.jpg

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.

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.

Choosing Game and Python Installations

KorIntro07.jpg

Once you've installed Blender for Korman, 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).

KorIntro06.jpg

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.

  • 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!


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.