MiniMap

===================
MiniMap by Kyoma
Version 0.7.2
http://www.bethsoft.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.

Both modes will have an arrow that rotates according to the direction you are facing. Or if you like something less intrusive you can have a red dot instead of an arrow.

The World mode is like your world map, one big texture (the same one that is used by your real worldmap). It will work for (almost) any worldspace with a unique map. 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 real worldmap works in those cases.

The Local mode is basically a copy of your localmap. 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). Some things are in combination with the MiniMap but some are actually issues with the local map itself.

Color-Style map, although it is more detailed and shows more objects it also creates more artifacts near the cell borders. Things like trees that get cut off or large objects. If you look closely you'll notice these things in the real localmap too, the MiniMap merely makes them more obvious as you can continuously see the area instead of the brief moments in which you check the localmap. You might also see a bit wonky water on the MiniMap due to the fact not all textures were generated at the same time-of-day or during the same weather. There are ways to minimize this but it will never go away completely.

Paper-Style map, the biggest downside is ofcourse the fact it is less detailed and a bit murky. But in reality this is actually the biggest advantage, remember that the MiniMap will (almost) always be on.


Here's a 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" (paper-style is highly recommended)
- 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 possible or awaiting implementation
- Quest markers, either in Local or World mode. (still looking for a way to detect quest targets)
- Map markers in World mode. (will be implemented in next release)
- Names next to door icon. (technically possible but would take too much room)
- 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
==============================

---OMOD---
----------
* Create an OMOD from the archive and activate it. 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.

* When activated follow the instructions on which UI mod you are using.
- Vanilla
- BTmod
- 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.

* Open and inspect the MiniMap.ini file, some settings may need to be changed depending on your system.
- The ini file contains details on each setting, more than you'll find in this readme.

---Manual---
------------
* Copy the esp, ini file(s), BSA file and menus folder to your data folder. This mod requires:
- OBSE v0018 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.
- (optional) OBSE Plugin MenuQue v2 or higher. You can find the latest version at http://www.tesnexus.com/downloads/file.php?id=32200/.

* (optional with MenuQue) Select the "01 XYZ" folders that corrosponds with the UI mod you are using and copy its content to your data folder. UIs supported:
- Vanilla
- BTmod
- 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.

* Open and inspect the MiniMap.ini file, some settings may need to be changed depending on your system.
- The ini file contains details on each setting, more than you'll find in this readme.

==================
3. Version History
==================

* 0.7.2
- Added support for worldspaces from Adash: City of Magic and Nehrim.
- Implemented a way to add/define new worlds for the MiniMap through a seperate ini without having to change the esp itself.
- If you have the OBSE plugin 'MenuQue' installed you no longer need to copy the (variable) hud_main_menu.xml file.
- Simplified initial setup by removing the '"iScreenWidth" and "iTamrielMap" settings. Both can still be configured but are now optional.
* 0.7.1b
- Fixed bug with the "iWorldWidth" and "iWorldHeight" settings not being applies.
- Fixed potential bug with the player arrow not being centered in the Local mode.
* 0.7.1
- Fixed problem with the MiniMap being hidden when first installing the mod. Also fixed a few other problems with initializing.
- Fixed problem with empty space appearing on the World MiniMap if you are near the edge of the worldmap, now it will move the arrow away from the center in order to display your correct position without any empty space appearing.
- Fixed bug that could happen when you travel from Cyrodiil to a Shivering Isles interior (e.g. using a teleport spell), where the World MiniMap would display the wrong position.
- Fixed bug with the transparency setting not working completely.
- Added seperate width and height settings for the Local and World mode.
- Expanded the "iAutoMode" setting to now also having a mode where the MiniMap is not re-displayed after each reload. Default behaviour is still that.
* 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. :P
- Half a dozen other changes which I forgot to track, mostly tweaks and small bugfixes.
* 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 250000 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
===================

Problem #1: My Local MiniMap is completely black or certain areas are completely black.
Solution 1: First off, try deleting your "Textures\Maps" folder and all of its content. This is where the textures are stored that are used by the Local MiniMap. They are generated on-the-fly if they do not yet exist and sometimes the generated textures are black. And because the textures themselves exist the scripts use them anyways, they can't know if it is completely black or not.
Solution 2: If each and every area is black and the above solution didn't fix things then there isn't much more I can do. It is likely the function responsible for generating the textures (OutputLocalMapPictures) doesn't like (a part of) your Oblivion configuration or certain hardware/software combos. Although this remains just a theory I do know that, sadly, it cannot be fixed. The problem lies with the function itself and that is beyond my reach. Either turn off the Local MiniMap or not use this mod. :(

Problem #2: My World MiniMap is totally screwed up or is displaying the wrong location.
Solution 1: First check your actual world map and compare the two, it can happen that you are in a location that either has no connection to a worldspace or the connected worldspace is not parented and does not have a unique map. In those cases the World MiniMap should display the map and location of your last known 'position', similar to how the normal world map works.
Solution 2: If you are using a mod that changes the dimension or filepath of the Tamriel worldspace open the MiniMap - Worlds.ini and adjust the values. There will be instructions near the top on what to do exactly.

=======================
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..... :P
* 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.
UWAGA!!!
Do instalacji tej modyfikacji, potrzebny jest program Oblivion Mod Manager. Do pobrania w katalogu Mody/Oblivion/Inne/Oblivion Mod Manager. Dokładna instrukcja instalacji modów w opisie folderu Oblivion Mod Manager.

• Pobierz folder
• Zachomikuj folder