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: 11 different zoom levels (0.125x to 10x)
  • 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
• Accessed from:
  • World Map -> Right Click -> Free View
  • Mouse-over World Map -> Middle Mouse button
• Navigation:
  • Hold Alt + Left Click to pan
  • Hold Middle Mouse Button to pan
  • Left Click + Drag to pan (when Free View is enabled)

Locked Mode

• Double-click the map (default action) to toggle its lock state
• Locked: the window border is hidden and the map can’t be accidentally moved/closed
• Unlocked: the border is shown again
• (The previous separate “Top Most” always-on-top/layer-order toggle has been removed — border visibility now simply follows the lock state described above)

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. Non-ally mobile dots are tinted by notoriety (innocent, criminal, enemy, murderer, etc.), matching the radar minimap, instead of all showing as red.
• Show my Corpse: Display your corpse location when dead
• Show Houses/Boats: Display multi-tile structures (houses and boats)
• Show resurrection waypoints: Display server-sent resurrection waypoints (packet 0xE5) as orange square dots, with the cliloc-translated name shown on hover. They are stored persistently and removed by the server (0xE6) or on world reset. On by default.

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
• Set sextant base coordinates: Opens a small window to set the base map X,Y (representing 0° 0’N 0° 0’E) used to convert sextant coordinates. Useful on shards whose sextant origin differs from the default.

Markers

Marker Display Options

• Show All Markers: Toggle visibility of all map markers
• Always show markers at any zoom: When enabled, markers render at full visibility on every zoom level instead of degrading to a small dot (or disappearing) when zoomed out past their configured zoom index. Marker name labels are shown at every zoom too (they are normally hidden below zoom level 6). This is a machine-wide (global) setting.
• Show Marker Names: Toggle marker text labels
• Show Marker Icons: Toggle marker icons (if available)
• Font Style: The Font Style selector lives on the main context menu (not just the marker submenu) and applies to marker text and mobile/entity/group names.
• TTF Fonts: A TTF Fonts submenu lets you use any installed TrueType font for map text (with a “None” option to fall back to the built-in fonts) and increase/decrease the font size. Your choice is saved in the World Map font settings.

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
• Import Map File: In Map Marker Options, copies a selected .map/.csv/.xml file into the current server’s marker directory and reloads markers

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 the dedicated UI for managing all markers. It can edit both .usr and .csv marker files, and supports per-row checkboxes, bulk delete, and bulk move of markers between files.
• 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 the map’s lock state (hides/shows the border). There is also an option to make double-click toggle a fullscreen world map instead — enable Toggle fullscreen world map on double click if you prefer that behavior.

Advanced Functions

• Ctrl + Left Click: Open the Add User Marker dialog to create a persistent, named marker at the clicked location
• Ctrl + Right Click: Auto-walk to clicked location (pathfinding)
• Shift + Ctrl + Right Click: Extend the active auto-walk route with another segment. If you have already started walking from A to B, Shift+Ctrl right-clicking C appends B→C so you travel A→B→C instead of restarting the route. If no path to the new point is found, the existing route is kept.
• 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
• To remove an existing marker, open the “Go-To” gump, clear the input and accept
• The Go to Location window shows a Clear button and decodes coordinates live as you type — the resolved map location is shown in green (or “Invalid coordinates” in red), including sextant (N/S, E/W) conversion.

Pathfind To Location

• Context Menu → “Pathfind to location” (below “Go to location”)
• Enter map or sextant coordinates the same way as Go to Location, but instead of just centering the map, this walks your character to that location using the pathfinder.

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
• Pathfind to Location
• Flip Map
• Free View
  • Enable/Disable Free View
  • Change Map (0-5)

Display Filters

• Show Party Members
• Show my Corpse
• Show Mobiles
• Show Houses/Boats
• Show resurrection waypoints
• Show Your Coordinates
• Show Sextant Coordinates
• Show Mouse Coordinates
• Allow Positional Targeting
• Set sextant base coordinates

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
• Lock 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. Multi-stop Routes: Chain Shift + Ctrl + Right Click to build a multi-segment walk route
3. Quick Markers: Use Ctrl + Left Click to open the Add User Marker dialog at that spot
4. Clean UI: Lock the map for an overlay-style map without a border
5. Performance: Disable mobile/multi display in crowded areas
6. Party Coordination: Use party member following to keep track of your group
7. Exploration: Use Free View + zoom to scout areas before traveling
8. Custom Markers: Build your own marker files for runes, spawn locations, etc.
9. Zone Planning: Use zone overlays with grid to plan routes and understand regions