×

OnlyWorlds map tool

This tool lets you create and manage 2d maps for your worlds. You can add pins to these maps to physically locate elements in specific places.

Getting started

1. Enter your World's API Key and PIN in the top-left bar. Click Load World.
2. Use the Map Dropdown to select an existing map, or click the '+' button to create a new.
3. Maps require a name and an image URL before you can Load Map to display the image on the canvas.
4. Save Map after loading it to store its details and pin data on the OnlyWorlds server.

Map system

Your worlds can have any number of maps.

Maps can be 'local' or 'global'.

Local means that a map is assigned to a Location.

Global means that a map represents any part of your world, not one specific Location.

All maps have a 'hierarchy' field, which means two different things.

• All global maps share the same hierarchy: a galaxy map might be hierarchy 0, a planet 1, a city 5, and a building 8.
• For local maps, hierarchy dictates the order when multiple maps are assigned to the same Location.

This means that any world can have multiple 'map stacks': one for all global maps, and any number for local maps.

Relations between Locations (using the Parent Location field) are included in these local stacks.

Sidebar tabs

• Pins Tab:
  • View elements from your world.
  • Filter elements by name or category. Use the checkbox to show only elements that already have a pin on the *current* map.
  • Click an element in the list to select it for pinning.
  • If an element has a pin icon (location_on) next to it, click the icon to pan the map to its pin.
  • Click an element's name to select it. If it doesn't have a pin, the cursor turns into a crosshair (+) over the map. Click the map to place its pin.
  • See selected pin coordinates and linked element name at the bottom.
  • Action Buttons:
    • location_on/person: Toggle between default pin markers and category-specific icons.
    • lock/lock_open: Toggle pin dragging (lock prevents accidental moves).
    • grid_on: Toggle a grid overlay.
    • label: Show labels for all currently visible pins.
    • center_focus_strong: Recenter the map view on the image.
    • clear: Clear the current pin/element selection.
• Markers Tab: (Future Feature) For placing custom markers like points of interest, paths, etc.
• Maps Tab:
  • Lists other maps in your world.
  • Click a map name to select it as the target for linking. The cursor becomes a crosshair (+) over the current map.
  • Click the current map to place a "map link" pin (map). Clicking this pin later will highlight the linked map in this list.
  • If a map in the list has a pin icon (location_on) next to it, click the icon to pan the map to its corresponding link pin *on the current map*.

Map canvas

• Placing Pins: Select an element (Pins tab) or a target map (Maps tab), then click on the map canvas.
• Moving Pins: Click and drag pins (if dragging is enabled - lock_open).
• Selecting Pins: Click a pin on the map to select it. This highlights the pin and shows its details/linked item in the active sidebar tab.
• Deleting Pins: Drag a pin over the red "Drop Pin Here to Delete" zone that appears at the bottom during a drag.
• Navigation: Use mouse wheel to zoom, click and drag the map background to pan.
• Coordinates: Bottom-right shows map coordinates (X, Y from top-left).

Saving

• The Save Map button (next to Load Map) saves the current map's details (name, URL) AND the state of all pins (element pins, map links) placed on it.
• The button turns green like this when there are unsaved changes.
• Save often! Changes are not saved automatically.

Need more help? Check the documentation or contact support.

×

Map canvas

navigation

• Zoom: Use the mouse wheel or the zoom controls (+/-) in the top-right corner of the canvas.
• Pan: Left or middle click and drag the map background.
• Recenter: Use the 'Recenter Map' button 🎯 in the sidebar to fit the camera to map view.

placing & managing pins

• Placing: Select an element or a target map (Maps tab), then click on the map canvas where you want the pin. The cursor will change to a crosshair + when ready to place.
• Moving: Click and drag pins to reposition them.
• Selecting: Click a pin on the map to select it. This highlights the pin and shows its details or linked item in the active sidebar tab.
• Deleting: Drop a pin into the red delete zone near the top of the map while dragging.

pin appearance & overlays

• Icons: Toggle between default markers location_on and category-specific icons castle using the toggle button in the sidebar.
• Labels: Temporarily show labels for all visible pins using the 'Show all labels' button 🏷️ in the sidebar.
• Grid: Enable a grid overlay using the 'Toggle grid' button ▦ in the sidebar.

×

Sidebar help

This tab lists all elements of your world. Select one and click on the map canvas to create a pin for it.

• 🏷️ temporarily show labels for all pins.
• 🎯 recenter the map view on the image bounds.
• 🔎 maximum zoom to the selected pin.
• ❌ clear the current selection.
• 🌱 spawn pins for all Characters, Creatures, and Objects that are at a selected Location. Click again to clear their pins.

×

sidebar - maps

This tab lists other maps in your world. You can embed other maps on it using special map pins.

Only global maps (without a Location assigned) can be embedded this way. Use Location pins to embed local maps.

Click a selected or local map for a large preview of the map's image.

Click the map icon to view its map stack:

• For global maps, shows the global map stack.
• For local maps, shows the map stack for the Location that the map is assigned to.