===================
MiniMap by Kyoma
Version 0.7.0
http://www.gamesas.com/bgsforums/index.php?showtopic=1022954
===================
1. Description
2. Installing and Requirements
3. Version History
4. Known Issues
5. Trouble Shooting
6. Contact and Feedback
7. Credits
==============
1. Description
==============
Tired of having to open up the local map each time you want to know where you are in a cave? Well, not any more for this mod gives you a MiniMap, like in Morrowind. The layout is fully configurable to suite your taste. Do you want it in the upper right corner? No problem. Do you want it to be as big as half the screen? Once again, no problem. See the MiniMap.ini for more details and settings on the layout of the MiniMap.
The MiniMap now has two different modes: Local and World. They speak for themselves I think but I'll give a short explaination anyway. You'll be able to toggle between them manually or choose to do it automatically on an interior/exterior transition. Zooming is ofcourse possible and there are seperate values used for the two different modes, both values lie between 50% and 200%. Default keys to zoom in and out are the Numpad+ and Numpad- respectively.
The Local mode is similar....It works by generating textures on-the-fly for the cells around the player and then using those textures to build a complete image of everything within two cells (or just the whole cell when you're inside). There is the option to display door icons, either limited to known or used doors or simply all doors. The appearance of the Local mode texture is determined by your Oblivion ini setting "blocalMapshader". It controls if you have the detailed colored local map or the more vague paper local map. Obviously the latter is less detailed but it also means less (possible) issues (see Known Issues).
The World mode....It is similar to the Local mode with the exception it just uses a big single texture (the same one that is used by your World Map). It will work for (almost) any worldspace with a unique worldmap. If you are in a world that does not have its own map then the last known world and position is used instead, this is similar to how the World Map works in those cases.
Here's a full list of features for the two modes.
* Local Mode
- Accurate display of surroundings, including all mod added areas.
- Choose between color or paper style, depends on your Oblivion ini "blocalMapshader"
- Display door icons, can be limited to known or found doors only.
- Zoom in and out between 50% and 200%.
* World Mode
- Uses the same map texture as your real World Map.
- Works with all vanilla worlds and mod added worlds with a unique map (the ones I know of).
- Zoom in and out between 50% and 200%.
* Things not (yet) possible
- Quest markers, either in Local or World mode.
- Map markers in World mode.
- Names of the doors next to the door icon, it may be possible for the majority of the doors but available room is still an issue.
- Fog-of-War (the black unexplored areas) in Local mode, I have no way to detect or create such areas on the MiniMap.
==============================
2. Installing and Requirements
==============================
* Copy the esp, ini file and menus folder to your data folder. This mod requires:
- OBSE v0018 beta4 or higher. You can find the latest version at http://obse.silverlock.org/.
- Oblivion v1.2.0.416.
- If you are updating from below v0.6.2 you MUST make a clean save before using this mod.
* Open and inspect the MiniMap.ini file, some settings WILL need to be changed or verified.
- The "Critical Settings" section MUST be inspected atleast as it can differ for each user.
- The rest of the ini file contains details on each setting, probably more than you'll find in this readme.
* Rename the correct "Menus\Main\hud_main_menu_xyz.xml" to "Menus\Main\hud_main_menu.xml". UIs supported:
- Vanilla
- DarNifiedUI
- DarkUI'd DarN
- OblivionXP, Vanilla
- OblivionXP, DarNifiedUI
- OblivionXP, DarkUI'd DarN
- If you have a different UI mod installed you will need to open your "Menus\Main\hud_main_menu.xml" file and add the following line:
. I've uploaded a picture at TESNexus which shows at what line it should be added, If you do not have a "Menus\Main\hud_main_menu.xml" you should use the Vanilla file as stated above.
==================
3. Version History
==================
* 0.7.0
- Added a world mode that can be used apart from the local mode on the MiniMap.
- New option to automatically switch between local and world mode on transition between interior and exterior.
- Made the zoom in and zoom out steps configurable.
- Added an option to show a red dot instead of an arrow on the MiniMap.
- Reworked the frame a bit and added an optional thicker frame.
- Increased the amount of grids displayed from 9 to 25 (configurable) for when you are playing with either a large MiniMap or zoomed out alot. Grids are only used when their texture already exists.
- The 'Toggle-Key' now toggles between the local mode and the world mode, hold it down for approx. 2 seconds to hide the MiniMap. Press it again to show it, doesn't have to be 2 seconds.
- Corrected a slight positioning error with the local MiniMap, barely noticable unless zoomed in but still worth fixing I guess.
- Half a dozen other changes which I forgot to track, mostly tweaks and small bugfixes (some of which were introduced while working on all of the above).
* 0.6.3
- The MiniMap is now hidden when you're viewing your inventory (and stats, skills, factions, etc).
- Removed a leftover debug line
* 0.6.2
- Rewrote everything using the power of OBSE v18. Although no major additions the internal works of the mod have been greatly optimized.
- Changed the way the iWaterHack setting works, the previous implementation was horribly broken. This time I've done extensive testing to ensure it works correctly.
- Reduced the number of files generated in a single sweep from 25 to 9. This results in far less object/tree cutoff aswell as reducing the possible fps hit when textures are being generated.
- Added rudimentory debugging, not really spectacular but better than nothing.
- Fixed a few bugs with the water detection for exterior cells. The amount of false-positives should be reduced to zero.
- Fixed a few (but serious) bugs with the door icon system.
* 0.6.1
- Re-added the precise positioning values from v0.5.3 for users that still experience stretching issues.
* 0.6.0
- Finally a proper fix for people with a widescreen resolution or otherwise problematic. See the ini for a setting (iScreenWidth) that needs to be adjusted according to your resolution.
- Fixed a specific crash when entering the IC Market District, other crashes might have had the same cause so they might be fixed aswell.
- Fixed door icons not appearing when entering a new cell for which the textures needed to be generated.
- Added option to turn off the zoom info displayed on the MiniMap.
- Fixed door icons appearing above the player marker instead of below it. They now also appear beneath the MiniMap frame at the edge.
- Fixed sometimes getting weird blotches on the MiniMap due to the distantLOD being off.
* 0.5.3
- Made the precise positioning values of the MiniMap configurable. Should be used to find the correct values for when you experience stretching on the MiniMap.
* 0.5.2
- Added debug setting to halt all MiniMap script processing. To be used to determine cause of CTD for some.
- Made zoom in/out and toggle keys configurable.
* 0.5.1
- Forgot to pack the textures needed for the MiniMap. Player arrow should now work.
- Last minute change resulted in strange layers appearing over the MiniMap.
* 0.5
- Beta release
===============
4. Known Issues
===============
* This mod uses a command called "OutputLocalMapPictures" (OLMP) which generates textures to the harddrive of the current cells around the player. They will only be generated once per cell (grid) after you visit it. The texture files are located in "Textures\Maps\.." and are each 256Kb. A quick overview: A quick runthrough from one side of the Shivering Isles to the other results in a total size of just over 42Mb. A larger overview: I explored all outdoor areas on the Shivering Isles and the total size was around 240Mb, and that's a large area! It is safe to delete these files when they become too large - they will be generated again should it be nessecary.
* There is no Fog-of-War (the black/hidden areas on the Local Map for places you haven't been to yet) on the MiniMap and there's nothing I can do about it. Either accept it or don't use this mod.
* When in or around cities, you may notice black areas or strange gaps on the other side of the city walls. This is, unfortunately, beyond my control as well. It happens because there simply isn't any land at those black areas. Under normal circumstances you never reach those areas and because of the Fog-of-War on the local map you never see it either.
* The appearence of the water on the MiniMap can look a bit odd. This is because the sunglare, fog and the time-of-day affect how the water looks like on the textures from the above. Because the files are only generated once per cell it can result in strange transitions of the water color. Two settings control this to some extend:
- In the ini there is a setting called "iWaterHack". Setting it to 1 will remove the water reflection and sunglare for one frame just before textures are generated. The result is a smooth water color and the only downside is that the water . Setting it to 2 will also force the gamehour to a user-specified value for one frame. This way, the water will always look the same when it comes to how dark or light the color is. Ofcourse this has a visual drawback when textures are generated so you'll have to decide if it's worth it or not.
- In the ini there are two settings called "fFogNear" and "fFogFar". Fog has big influence on the water color, when present, the water will mimic the color of the fog. Very often this results in unnatural looking water. I recommend values of 0 and 500000 respectively, to temporarily move any fog far far away. Set both to 0 to disable changing the fog in any way.
- There is only one thing left I haven't been able to fix and that is being underwater. When you are swimming and the camera is underwater you will get a different color than when the camera is above the water. Maybe in the future I'll be able to fix this last remaining obstacle
* Sometimes the trees can appear to be cut off around the border of a cell grid. I already use code to minimize this as much as possible but if it happens alot or really annoys you, you can set bToggleTrees to 1 in the MiniMap ini. Since version 0.6.2 the tree cutoff has greatly reduced.
* Sometimes you'll see dark objects (most often rocks) on the MiniMap, these are objects which were fading in or out at the time the texture was generated. I can increase this distance to force all objects to be displayed but objects that are already fading won't be updated until you look in the direction they can be found.
* Sometimes when you enter a new exterior cell and the MiniMap needs to generate textures the DistantLOD land stays hidden but the trees and objects are visible as normal. This should go away as soon as you move or look around a little bit. The worse that can happen is that it takes a few seconds to restore the DistantLOD. But most of the time you won't notice the effect.
===================
5. Trouble Shooting
===================
=======================
6. Contact and Feedback
=======================
Should you have any questions or comments, you can PM me (kyoma) at the Elder Scrolls Forum or post in the forum thread (see top of readme). Alternatively you can email me at daaf(dot)paradox(at)gmail.com
==========
7. Credits
==========
* The OBSE team, for the many many new functions they provided.
* DarN, with help trying to figure out alot of XML problems.
* shadeMe, for support, harassment and suggestions. And ofcourse bumping the mod.....
* DragoonWraith, for the mega-help with a translating coordinates system!
* Scanti, for explaining how the ModWaterShader command works.
* wrinklyninja, for help and advice on how the weather and fog works in Oblivion.
* NdranC on TESNexus, his feedback on a beta-beta version led me to great improvements and optimizations!
* All the other people whose name I forgot.