World-Map

World Map

:information_source: :warning: This documentation was generated using AI.

The World Map is a comprehensive in-game mapping system for TazUO that provides real-time visualization of the game world, party members, markers, and various game entities.

Opening the World Map

The World Map can be opened through the top menu bar.

Core Features

Map Display

• Real-time rendering of the current game world map
• Zoom levels: 10 different zoom levels (0.125x to 8x)
  • Use mouse wheel to zoom in/out
  • Grid overlay appears automatically at 4x zoom and above (configurable)
• Map rotation: Optional 45-degree rotation (Flip Map)
• Multiple map support: Switch between different UO maps (Felucca, Trammel, etc.)

View Modes

Normal Mode

• Map follows your character automatically
• Synchronized with your in-game position

Free View Mode

• Unlocks the map from your character
• Pan anywhere on the map
• Can switch to different maps while in-game
• Navigation:
  • Hold Alt + Left Click to pan
  • Hold Middle Mouse Button to pan
  • Left Click + Drag to pan (when Free View is enabled)

Top Most Mode

• Pins the map above all other windows
• Removes the window border
• Double-click the map to toggle Top Most mode

Following System

• Follow Yourself: Default behavior, map centers on your character
• Follow Party Members: Select a party member to follow their position
• Access via right-click context menu → Follow

Display Options

Player Display

• Show Your Name: Display your character name on the map
• Show Your Healthbar: Display your HP bar on the map

Party/Group Display

• Show Party Members: Display party members on the map (requires server support)
• Show Group Name: Display party member names
• Show Group Healthbar: Display party member HP bars
• Server query packet (0xF0) is used to retrieve party/guild positions
• Note: May not work on servers with new movement system or encryption

Entity Display

• Show Mobiles: Display nearby NPCs and creatures
• Show my Corpse: Display your corpse location when dead
• Show Houses/Boats: Display multi-tile structures (houses and boats)

Coordinates

• Show Your Coordinates: Display your character’s X,Y coordinates
• Show Sextant Coordinates: Display coordinates in sextant format (N/S, E/W)
• Show Mouse Coordinates: Display world coordinates at mouse cursor position

Markers

Marker Display Options

• Show All Markers: Toggle visibility of all map markers
• Show Marker Names: Toggle marker text labels
• Show Marker Icons: Toggle marker icons (if available)
• Font Style: Choose from 6 different font styles for marker text

Marker Files

• Markers are loaded from CSV files in specific directories:
  • Data/Client/MapMarkers/ - Default marker files
  • {UO Directory}/MapMarkers/ - Server-specific markers
  • Data/{ServerName}/MapMarkers/ - Per-server custom markers
• Multiple marker files can be loaded simultaneously
• Individual marker files can be shown/hidden via context menu
• Reload Markers: Refresh marker files without restarting

User Markers

• Add Marker on Player: Create a custom marker at your current position
• User markers are saved to Data/Client/userMarkers.usr
• Default color: Blue
• Default zoom level: 3
• Markers Manager: Open dedicated UI for managing all markers
• Scripting API: Add/remove markers programmatically

  AddUserMarker(name, x, y, mapId, color)
  RemoveUserMarker(name)

Marker Icons

• Custom icons can be placed in:
  • Data/Client/MapIcons/
  • {UO Directory}/MapIcons/
  • Data/{ServerName}/MapIcons/
• Supports .png and .cur (cursor) formats
• Icons are referenced by filename in marker CSV files

Marker CSV Format

X,Y,MapID,Name,IconName,Color,ZoomLevel

Example:

1234,5678,0,My Marker,custom-icon,red,3

Supported colors: red, blue, green, yellow, purple, orange, cyan, magenta, white, black, gray

Map Zones

• Zone overlays: Display named regions/zones on the map
• Zones are defined in JSON files in the same directories as markers
• Show Grid If Zoomed: Display zone grid when zoomed in (4x+)
• Zone Options: Show/hide individual zone files
• Reload Zones: Refresh zone files without restarting

Mouse Controls

Basic Navigation

• Left Click + Drag: Pan map (only in Free View mode)
• Alt + Left Click + Drag: Pan map (works in any mode)
• Middle Mouse Button + Drag: Pan map
• Mouse Wheel Up: Zoom in
• Mouse Wheel Down: Zoom out
• Double Click: Toggle Top Most mode

Advanced Functions

• Ctrl + Left Click: Set target marker (creates temporary “Go To” marker)
• Ctrl + Right Click: Auto-walk to clicked location (pathfinding)
• Right Click: Open context menu (when not holding Ctrl)

Positional Targeting

• Enable: Context Menu → “Allow Positional Targeting”
• When enabled and targeting is active, left-clicking the map will target that position
• Useful for area spells and ground-targeted abilities

Keyboard Shortcuts

• Alt: Hold while dragging to pan the map
• Ctrl: Hold while clicking for special actions (pathfind, set marker)
• Right Click (without Ctrl): Open context menu

Go To Location

• Context Menu → “Go to Location”
• Enter X,Y coordinates to center the map at that location
• Automatically enables Free View mode
• Creates a temporary cyan marker at the target location

Web Map Integration

• Open Web Map (Browser): Launch a web-based version of the map in your browser
• Auto start web map: Automatically start the web map server when opening the World Map
• Uses the built-in MapWebServerManager

Context Menu Options

Access the context menu by right-clicking on the World Map (without holding Ctrl).

Follow

• Yourself
• Party Members (if in party)

Font Style

• Choose from 6 different font styles for markers

Map Marker Options

• Reload Markers
• Font Style selection
• Show All Markers toggle
• Show Marker Names toggle
• Show Marker Icons toggle
• Individual marker file visibility toggles

Map Zone Options

• Show Grid If Zoomed toggle
• Reload Zones
• Individual zone file visibility toggles

Names & Healthbars

• Show Your Name
• Show Your Healthbar
• Show Group Name
• Show Group Healthbar

Map Options

• Go to Location
• Flip Map
• Top Most
• Free View
  • Enable/Disable Free View
  • Change Map (0-5)

Display Filters

• Show Party Members
• Show my Corpse
• Show Mobiles
• Show Houses/Boats
• Show Your Coordinates
• Show Sextant Coordinates
• Show Mouse Coordinates
• Allow Positional Targeting

Markers

• Markers Manager
• Add Marker on Player

Web Map

• Open Web Map (Browser)
• Auto start web map

Utilities

• Reset Maps Cache (clears cached map tiles)
• Save & Close

Window Management

Resizing

• Click and drag window borders to resize
• Minimum size: 100x100 pixels
• Size is saved to profile settings

Moving

• Click and drag the title bar to move
• Position is saved to profile settings

Locking

• Lock the window to prevent accidental movement
• Locked windows can still be resized

Map Caching

• Rendered map tiles are cached to Data/Client/MapsCache/ as PNG files
• Improves performance on subsequent openings
• Reset Maps Cache: Clears cached files (useful after game updates)

Technical Details

Map Loading

• Maps are loaded asynchronously to prevent UI freezing
• Loading message displayed: “World Map Loading…”
• Map textures are generated from game data files

Party/Guild Tracking

• Uses packet 0xF0 to query party/guild positions
• Queries sent every 250ms when World Map is open
• Requires:
  • Server without new movement system flag
  • No encryption or encryption type 0
  • Profile setting enabled
• Entity positions cached for 1 second

Performance

• Map rendering is optimized with texture caching
• Entity updates throttled to prevent excessive CPU usage
• Zoom and pan operations are hardware-accelerated

Profile Settings

All World Map settings are saved per-character profile:

• Window position and size
• Zoom level
• Display options (coordinates, names, healthbars, etc.)
• Hidden marker/zone files
• Top Most state
• Free View state
• Font selection

Troubleshooting

Party members not showing

• Ensure “Show Party Members” is enabled
• Check that you’re in a party with a leader
• Server must support packet 0xF0 queries
• Server must not use new movement system or encryption

Markers not appearing

• Check “Show All Markers” is enabled
• Verify marker files are in correct directories
• Use “Reload Markers” to refresh
• Check zoom level matches marker zoom settings

Map appears blank

• Wait for map to load (check for loading message)
• Try “Reset Maps Cache” if corruption suspected
• Ensure game data files are intact

Performance issues

• Lower zoom level
• Disable mobiles/multis display
• Clear maps cache
• Reduce window size

Tips

1. Quick Navigation: Use Ctrl + Right Click to walk to any location on the map
2. Temporary Markers: Use Ctrl + Left Click to set quick navigation markers
3. Clean UI: Enable Top Most mode for an overlay-style map without borders
4. Performance: Disable mobile/multi display in crowded areas
5. Party Coordination: Use party member following to keep track of your group
6. Exploration: Use Free View + zoom to scout areas before traveling
7. Custom Markers: Build your own marker files for runes, spawn locations, etc.
8. Zone Planning: Use zone overlays with grid to plan routes and understand regions