Difference between revisions of "Korman:Installation"

m (Installing Blender)
m
(11 intermediate revisions by 2 users not shown)
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 14: Line 14:
 
==Required Software==
 
==Required Software==
  
Luckily, unlike 3DS Max, both Blender and Korman are free and open source, so getting copies of both is easy.
+
Luckily, unlike 3DS Max, Blender for Korman is free and open source, so getting your own copy is easy.
  
<blockquote>IMPORTANT NOTE: As of version 0.06, Blender 2.74 and 2.77a will no longer work with Korman.  Use the appropriate version of the newer 2.79 instead (see below).</blockquote>
+
<blockquote>IMPORTANT NOTE: As of 0.13, you no longer need to install Blender separately. Blender for Korman will now install both for you.</blockquote>
  
 
===Windows===
 
===Windows===
  
For '''Windows Vista''' and above, you will only need Blender version 2.79b (32 or 64 bit depending on your system) and Korman itself.
+
For '''Windows Vista''' and above, you will only need Blender for Korman (32 or 64 bit depending on your system).
  
* '''Blender 2.79b (64 bit)''' - [https://www.blender.org/download/Blender2.79/blender-2.79b-windows64.msi/] '''OR''' '''Blender 2.79b (32 bit)''' - [https://download.blender.org/release/Blender2.79/blender-2.79b-windows32.msi]
+
* '''[[Korman:0.13_Release_Notes|Blender for Korman v0.13]]'''
* '''Korman Installer 0.11a''' - [https://github.com/H-uru/korman/releases/download/v0.11a/korman-0.11a.exe]
+
  
 
+
You can choose either the installer or the ZIP archive, whichever you prefer.
<blockquote>'''NOTE:''' The '''32 bit''' version of Blender '''is no longer required'''.</blockquote>
+
  
 
===Mac===
 
===Mac===
Line 37: 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.
+
[[file:KorIntro02.jpg]]
  
<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>
+
It will ask where to want to install.  You want to select a folder that's '''not''' in any of the Program Files folders.
  
==Installing Korman==
+
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, download and run the Korman Installer.
+
Next comes the '''Choose components''' window. You can leave this and click '''Install'''. This process may take a few minutes.
  
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'''.
+
Once installation is complete, click '''Finish''' to close the installer.
  
[[file:KorIntro02.jpg]]
+
===ZIP Archive===
  
The next screen will allow you to select which version of Korman to use.  If 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.
+
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'''.
  
[[file:KorIntro05.jpg]]
+
==Activating Korman in Blender==
  
<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>
+
In order to use Blender for Korman for the first time, you must activate it.
 
+
Once installation is complete, make sure '''Run Korman''' is checked and click '''Finish''' to start Blender.
+
 
+
 
+
===Activating Korman in Blender===
+
 
+
In order to use Korman, you must first activate it.
+
  
 
In Blender, press '''Ctrl+Alt+U'''.  This will bring up the '''User Preferences''' menu.
 
In Blender, press '''Ctrl+Alt+U'''.  This will bring up the '''User Preferences''' menu.
Line 74: Line 65:
 
[[file:KorIntro03.jpg|300px]]
 
[[file:KorIntro03.jpg|300px]]
  
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).
+
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.
 
Click the check box to the right to activate Korman.
  
<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>
+
Go ahead and save your settings and close the '''User Preferences''' window.
  
====Choosing Game and Python Installations====
+
Next, at the top of the Blender window, switch from '''Blender Render''' (or whatever renderer it's using currently) to '''Korman'''.
  
[[file:KorIntro06.jpg|300px]]
+
[[file:KorIntro04.jpg]]
 +
 
 +
==Choosing Game and Python Installations==
 +
 
 +
[[file:KorIntro07.jpg]]
  
Once you activate Korman, click the arrow on the left to expand its setup options.
+
Once you've installed and activated Blender for Korman as shown above, go to the '''Properties''' window, then to the '''World''' panel.
  
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.
+
Scroll down until you see the '''Plasma Games''' panel and click on the '''wrench''' to the right (see above image).
 +
 
 +
[[file:KorIntro06.jpg|500px]]
 +
 
 +
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 an online URU install, use your preferred avatar's KI number. For the server, '''server.ini''' is usually sufficient, but check your install.
Line 92: Line 93:
  
 
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]]
+
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.
  
You are now ready to use Korman!
+
==After Installation==
 
+
 
+
To set up a basic Age from scratch, continue on to the [[Korman:Getting Started|getting started tutorial]].
+
  
 +
* To set up a basic Age from scratch, continue on to the [[Korman:Getting Started|getting started tutorial]].
  
If you're updating an existing Age from PyPRP, see [[Korman:Updating From PyPRP]].
+
* If you're updating an existing Age from PyPRP, see [[Korman:Updating From PyPRP]].
  
 
[[Category:Korman]]
 
[[Category:Korman]]

Revision as of 14:10, 10 July 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.

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.

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

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.

KorIntro04.jpg

Choosing Game and Python Installations

KorIntro07.jpg

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

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.

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