Morroblivion GUI
version .98
by Savant
________________________________

Description
________________________________
This application serves as a graphics user interface to Galadrielle's ESP_converter,
otherwise known as Morroblivion. The GUI helps customize converter settings, 
manipulate resources, and execute the converter.


Requirements
________________________________
This application requires the following to run sucessfully:
Morrowind
Oblivion
Morroblivion v.98b
.NET Framework 2.0 or higher
(If you can run Oblivion Mod Manager,
you should have the right version)


Installation
________________________________
Extract the contents of this folder into the folder housing the converter. 
Morroblivion.exe should share the same folder as ESP_conv.exe. 
Open Morroblivion.exe, and the rest is straight forward.

This application is currently in development, and I cannot guarantee
converter settings will not be messed up by it. PLEASE OH PLEASE make a
backup copy of your Morroblivion folder prior to first use.


Conflicts
________________________________
This application should not cause conflicts with any mods, with one exception. 
At the user's request, this application deletes morroblivion resource files
prior to conversion, so that resources may be updated to reflect current converter 
settings (namely, texture replacment). This will as a result delete any mesh
replacements made using Von Djangos's "Armors of Morrowind" and "Weapons of 
Morrowind" mods. This can be easily fixed by reinstalling these mods after
conversion, or simply not using this feature.


Usage
________________________________
The program is divided into several tabs, each representing converter settings you may
modify:

Object Replacement
	Replace Morrowind objects with objects or meshes from Oblivion.
	Morrowind objects are specified by their CASE SENSITIVE editor ID, 
	and may include modded content. You MUST supply what type the Morrowind object
	is, using the combo box to the right of the editor ID text field.
	Oblivion Objects are specified by their form ID in Oblivion.esm, and may NOT 
	include modded content. You can remove a morrowind object from conversion
	by selecting "Remove" in the combo box to the right, modify a Morrowind object's
	placement by selecting "Modify", or specify an object is a particular type
	(such as a tree, furniture, LOD, or an animation).
Texture Replacement
	Replace Morrowind textures with textures from Oblivion.
	Morrowind textures are specified as texture files relative to 
	Morrowind\Data Files\Textures.
	Oblivion textures are specified as .dds files relative to 
	Oblivion\Data\.
Map Marking
	Add Map markers to the Morrowind landmass.
	Specify the type of marker, the name of the marker, and the marker's position.
	For Town markers, you must give a name for the town, and an ABSOLUTE position 
	for the marker.
	For all other marker types, you must specify the CASE SENSITIVE name of an 
	interior cell, and its position RELATIVE to that interior's teleport marker 
	residing in an Exterior cell.
Armor Binding
	Merge multiple Morrowind armor segments into a single (Morrowind) armor segment.
	For instance, pauldrons may be merged into a single cuirass under this tab.
	Morrowind armor segments are specified using their CASE SENSITIVE editor ID.
Furniture Tweaking
	Modify a Morrowind static to be used as furniture in Oblivion.
	To do so, you must specify how characters will interact with the object
	(such as whether it will be used as a chair, a bed, etc.)
	Specify the CASE SENSITIVE editor ID of a morrowind static, the type of furniture
	it is (numbered 1 through 14 - furniture types are undocumented in the converter.),
	and the position/rotation of a character who sits or sleeps on it.
	All furniture statics must be specified as such in the Object Replacement tab
	using the "Furniture" object type.

Under each tab, you may add an entry you specify to the list, remove a selected entry 
from the list, or replace a selected entry from the list with an entry you 
specify. 

You may also "Comment out" entries using the check boxes to the right of each
entry. This will remove the entries from the converter's consideration, allowing you to 
make comments in your converter settings, or temporarily remove entries for experimentation.

Entries you entered manually may also appear commented out becuase of incorrect file syntax. 
This is done automatically by this application to ensure syntax errors do not cause problems
with conversion. If this occurs, DO NOT uncomment these entries! Many syntax errors will 
cause entire blocks of converter settings to not run properly. Furthermore, such entries 
will just be automatically commented out the next time you start up this application. The best
response to incorrect syntax is to use this application to re enter the line in the converter 
settings. This application should be far less likely to enter invalid syntax than manually 
editing settings files.

General Morroblivion settings, such as what mods are converted or where game folders can 
be accessed, can be modified under Tools>Settings... In addition to typical converter
settings, you may also opt for features provided by this application in this Dialog.
By selecting "Overwrite files," this application will delete old morroblivion resource files 
from previous conversions, allowing updates to texture replacement settings to be reflected
in game.
By selecting "Modify load order," this application will modify the load order of 
morroblivion_ob.esm, fixing a problem causing large amounts of "invisible" or "underwater"
exterior cells in English versions of Oblivion. 

Underneath the tab panel are the buttons "Save" and "Convert." The save button saves changes
made to converter settings in the current session of this application. The convert button
saves changes and begins conversion.


FAQ
________________________________
What is Morroblivion?
	Morroblivion is a project attempting to import the landmass of Morrowind into the
	Oblivion game Engine, centering around a .esp converter and a .nif both made by 
	the member, Galadrielle.

Wasn't this project banned?
	Bethesda has indeed banned discussion of the mod on its official forums, and has
	requested TesNexus and Planet Elder Scrolls take down the download for the converter.
	This was in response to Morroblivion's ability to transfer 3rd party content (meshes,
	textures, and sounds) into Oblivion, which Bethesda is obligated to prevent by
	the producers of this content. Nevertheless, mods that rely on the converter
	still can be posted, and updates to the converter can be posted on sites, elsewhere.
	
	Its our ultimate hope we can recreate or replace the objects in Morrowind, and 
	legitimately release the mod on these sites.

What does Morroblivion convert?
	Morroblivion converts almost all objects in Morrowind, with the exception of creatures
	and some animated statics (waterfalls, fires, etc.). Any object that cannot be converted
	can be replaced by a similar Object from oblivion by specifying the replacement
	in the converter settings this application alters.

	Quests, most scripts, and dialog outside the CS are also unable to be converted, thus
	far, though mods exist to alleviate some problems.

Will this work in my language?
	If your version of Morrowind is in English, it will convert to Oblivion in English,
	if its in French, it will convert to French, if its in ancient Klingon, it'll convert
	to ancient Klingon. 

I cannot convert on Vista
	Vista is not allowing the converter to access a file in C:\ Move the converter to 
	the base of C:\ and if all else fails, create a copy of Morrowind and Oblivion somewhere
	other than in Program Files.

I receive an error while running the converter.
	Check that you have all the right files, have specified the right folders for Oblivion
	and Morrowind, and if all else fails, the majority of problems can be fixed by running
	the converter more than once.

How do I reach Morrowind?
	There are a number of mods which are capable of doing this without using the console.
	The .esp packaged with this mod works best for French users, while CNME, Anvil Alternate
	Arrival, and Morroblivion Travel Quests work best for English users.
	If you're not interested in using these mods, simply open the console in game (hit '~'),
	type "player.coc BalmoraVSTemple" (no quotes), and you will be teleported to the temple
	in the city of Balmora.

I'm experiencing large amounts of "invisible" or "underwater" landmass.
	This is a problem with the load order of morrowind_ob.esm.
	Simply check "Modify load order" under Tools>Settings, convert, and the problem will be
	fixed. 

People in Morrowind are missing arms.
	Some clothing is not entirely converted. If you prefer to use oblivion clothing over
	low quality Morrowind clothing, the mod "Morroblivion Object Replacer" will fix this
	issue.

I'm experiencing a number of missing meshes
	As mentioned before, the converter is still in development, and many things have yet to
	be fixed. Some issues can be alleviated by customizing converter replacements using this
	application.

Where can I recieve updates about the project?
	Links to a number of resources can be found under Help>About... in this application.
	The most up to date resource is obviously the official thread, located in 

When is the next converter update?
	It'll come when it comes. Galadrielle not too long ago has stated the next version 
	is in the works, just so you don't get worried.

How can I help?
	Anyway you'd like! The English Morroblivion community has no centralized leadership,
	so whatever hasn't been done yet is fair game. Quest modding and 3D modeling is most
	sorely needed, but if you don't have many skills, bug testing and even spreading the 
	word about the mod works just fine. Speaking of which, I could even use some testers 
	for this app. :)


History
________________________________
.98, 2008/10/04	
	Rewrote into C#
	updated to .98x converter
	undo/redo functionality
	copy/paste functionality
	numerous productivity enhancements

.9, 2008/08/11
	Initial release for .97x converter in Java.


Credits
________________________________
The SharpDevelop community
	For the great open source alternative to Visual Studio used for portions of this
	application.
The Morroblivion community
	For keeping the dream alive.
Galadrielle
	For doing the impossible.
LHammonds
	For the Readme Generator this file was based on.
TESNexus.com
	For the one-stop-shop resource for authors and players, including its many 
	quality Morroblivion mods.
Bethesda
	For not one but two great games.


Tools Used
________________________________
SharpDevelop
	http://www.icsharpcode.net/OpenSource/SD/
IcoEdit
	http://www.mapletop.com/icoedit/faq.html
Readme Generator
	http://lhammonds.game-host.org/obmm/tools_readme_generator1.asp

Licensing/Legal
________________________________
This application is provided as-is with no warranty, expressed or implied.
I am not responsible if this application blows up in your face. 
This application is currently in development, and I cannot guarantee
converter settings will not be messed up by it, so once again, PLEASE OH PLEASE,
make a backup copy of your Morroblivion folder prior to first use.

You may distribute this application however you like, provided this readme is
included and unaltered. Galadrielle has automatic permission to include this in 
any distributions of the converter.

Feel free to contact me through the email given in this application if you'd like 
to try your hand at the source code. I only ask you give me a preview before release,
so that I can merge new code with any new code I might have. If I do not respond 
within two weeks, feel free to release it anyway.