ReadMe for mod_MumbleLink v1.0
by zsawyer, 2011-03-21


About:
This is a minecraft mod based on ModLoaderV5. It's purpose is to be able to use 
Minecraft in conjunction with Mumble's positional audio feature. 
(http://mumble.sourceforge.net/)
It uses the Mumble Link Plugin v1.2.0 and adds native mumble support. 
Tested with Mumble 1.2.2 .



Prerequisites:

- Minecraft 1.3 (beta)
- ModLoaderV5 installed (http://www.minecraftforum.net/viewtopic.php?t=80246)
- Mumble + advanced option "Link to Game and Transmit Position" activated 
    (tested with 1.2.3)



Installing the Mod:

1. copy "bin" folder and its contents into your .minecraft-folder 
    (C:\Users\<username>\AppData\Roaming\.minecraft)
2. insert "mod_MumbleLink.class" into your minecraft.jar 
    (using 7zip [http://www.7-zip.org], WinRar or similar)



Notes: 

- suggested Mumble settings (differing from defaults): 
-- Maximum Distance: 60m 
-- Minimum Volume: 0%

- link delay: 6 seconds - normal link delay appears to be about 6 seconds after 
    joining a minecraft server. This may vary depending on the PC. 

- starting order: it does not matter if mumble or minecraft is started first

- DLL locations:
-- DLLs should be located in 
--- C:\Users\<username>\AppData\Roaming\.minecraft\bin\natives\mumbleLink\mod_MumbleLink.dll
--- C:\Users\<username>\AppData\Roaming\.minecraft\bin\natives\mumbleLink\msvcr100.dll
-- placing the DLLs from "bin/natives/mumbleLink" into the execution directory 
    of your Minecraft.exe will work as well



Troubleshooting:

- Please check the ModLoader.txt in your .minecraft-folder for an error message.
-- Error messages from this mod will be indicated by "[mod_MumbleLink]" infront 
    of the message

- Errors will occur as Minecraft stalling on a Black Screen after login 
    followed by crashing/disappearing
-- This usually indicates installation errors, check ModLoader.txt for details



FAQ:

- Mumble does not Link:
    - in "ModLoader.txt" search for: 
        "Mod Loaded: "mod_MumbleLink 1.0" from mod_MumbleLink.class" 
        - If this is missing the .class was either not copied to the 
            minecraft.jar or your do not have ModLoader installed. 

- the ModLoader.txt sais something about "ODSHook"-something 
    - Your version of ModLoader is not compatible with this mod. You will need 
    to upgrade to ModloaderV5 for this mod to work (After upgrading to 
    ModLoaderV5 your other mods will most-likely not work anymore and need to 
    be updated as well). 



Known Issues:
- Does (probably) not work under Linux or MacOSX
- Does not work with PRMumble(0.5Beta) even after copying the link.dll (1.2.0) 
    into PRMumble's plugin folder - it will say "linked" but the audio 
    will not be positional



Acknowledgements:

talkingBEERmug  : Thanks for testing and decompiling the 128-bit encryption
Steeve          : Thanks for providing the Mumble-Server we tested on
xDownSetx       : Thanks for helping with testing

