Name: Puff's Copy Machine
Version: 1
Date: 2/17/2009
Category: Miscellaneous - Spells
Author(s): Puff

Description
===========
2 spells and quests for duplicating and cloning objects.

Details
=======
This mod adds to new Lesser Powers to the game, the first being Object Refraction, uses the OBSE function "CloneForm" to duplicate the target of the spell (creating a completely new form ID). This is useful for renaming objects such as animated doors to something personalized (via the setname function in the console). The second spell, Object Reflection, simply duplicates the object or item under the cursor (keeping the same form ID). This spell allows you to make copies of statics, light sources, and items for things such as rearranging your house.

This mod makes PRODIGIOUS use of the "PlaceAtMe" command, which can quickly lead to save game bloat if left unchecked. Using this mod to duplicate a handful of statics and light sources for a house or 2 or 3 shouldn't cause any noticable problem, but still be careful. If your savegame increases beyond 10 megabytes in size, you're in trouble.

-How it works-
For those with a technical interest, the Refraction spell uses GetBaseObject to determine the targets base form ID, cloneform to make a duplicate object with a new form ID, and then placeAtMe to add it to the worldspace in the same position as the original. By casting the spell on the "Door to Ocheeva's Quarters" in the DB sanctuary, I was able to rename the new door (via setName) to something more personal, and then disable the original door. Because of the CloneForm command, this spell will increase savegame bloat significantly more than Reflection.

Reflection simply uses "GetCrosshairRef" to determine the object to be copied, then uses getBaseObject and placeAtMe to produce another copy of it (at the player's location). This is exactly like pressing "Ctrl+D" in the Construction Set Render Window. It still uses PlaceAtMe but will not be quite as bloaty as Refraction.

There are also 2 quests added, twCloneQuest and twCopyQuest. These quests run every 5 seconds and can be used (via the console) to perform the same functions as the spells. To use them, simply open the console in game mode, click on the object you wish to copy, and then type "set twCopyQuest.twBaseRef to GetBaseObject" without the quotes, press enter then exit the console (the same command can be used substituting twCloneQuest for the CloneForm version). Both of these functions place the copy 128 units in front of the player. You should not need to use these for making your duplicates, but they're there just in case. If you'd rather save a fraction of a frame in performance, you can use the stopquest command in the console to turn them off.

-Important!-
The copy spell and both quests have a tendancy to place the new copy in the floor (the same height as the player actor along the Z axis). I recommend using the TCL console command to fly around when making copies just to be sure you can actually reach the new object.

Yes, this mod can easily be used for cheating (making copies of expensive or rare items) but the way I see it, if you're going to cheat, there are better ways to do it. I made this primarily for redecorating, though I'm sure you can think of other uses for it.


Install
=======
1. Extract to your Oblivion\Data folder
2. Enable it in your Launcher
3. Play the game


Uninstall
=========
Delete the duplicate.esp from your Oblivion\Data folder


Incompatibility
===============
Requires OBSE. If you're using an old version, ask yourself why you haven't upgraded yet.
This mod should be compatible with anything, but if you find something let me know.


Known Issues or Bugs
====================
Copies created with the Reflection (copy) spell or the quests can wind up in the floor, use TCL to have them appear in the air below the player.
PlaceAtMe leads to save game bloat. BE CAREFUL how much you use these spells.


History
=======
v1.0 First release

Contact
=======
Pufthemajicdragon on TESNexus and Puf_the_majic_dragon on BethSoft's forums.

Credits
=======
Me for thinking it up and doing the work.
All of the wonderful contributors to the CS Wiki!!!!!!!
The OBSE team for some really awesome work!
Users on the Bethesda forums for their help and input!

Thanks to Bethesda for creating Oblivion.
Thanks to TESNexus.com for the a one-stop-shop resource for authors and players.
Thanks to LHammonds for the Readme Generator this file was based on.
Thanks to God for creating us all.

Tools Used
==========
Blender3D
Nifskope
Readme Generator - http://lhammonds.game-host.org/obmm/tools_readme_generator1.asp

Licensing/Legal
===============
I made this for you to use so do whatever the heck you want with it, just don't blame me if it blows up in your face.