TeleportFavorites

*Instant teleportation to your favorite map locations in Factorio 2.0+*

TeleportFavorites adds a favorites bar, map tag editor, and teleport history with shortcuts. Favorites, tags, and history stay per surface (Nauvis, Vulcanus, Gleba, etc, modded worlds too), and tag editing respects multiplayer ownership.

---

Quick start

*👋 Shortest path from install to your first teleport.*

1. Enable the mod and load a save.
2. Look at the top of the screen for the favorites bar.
3. Right-click the map to open the tag editor, set an icon or text, star it if you want it on the bar, and confirm.
4. Left-click a filled slot to teleport, or use Ctrl+1 through Ctrl+0 for slots 1–10 only.
5. Open teleport history from the bar or with Ctrl+Shift+T; use Ctrl+Minus / Ctrl+Equals to step through entries.

Details below: Getting Started, Map Tags, Teleport History, Sequential History Mode.

---

Features

• ⭐ Favorites bar — 10, 20, or 30 slots (setting); one-click teleport from the top of the screen
• 🗺️ Map tag editor — Right-click the map to create, edit, favorite, or delete tags with icons and text
• 📜 Teleport history — Scrollable list, keyboard navigation, destination-only (Standard) or full-hop (Sequential) recording. Switch modes with the history mode button on the favorites bar (next to the history button); hover for in-game tooltips
• 🔀 Drag and drop — Shift+left-click to drag slots on the bar
• 🔒 Slot locking — Ctrl+left-click locks a slot so it cannot be moved, overwritten, or dragged
• 🤝 Multiplayer-safe — Tag ownership by player name; only the creator or admins can edit or move a tag
• 🌍 Surface-aware — Favorites, tags, and history are stored per surface
• 🌐 Locales — Uses your game language where translations exist

---

Getting Started

📌 After installing the mod, look at the top of your screen for the favorites bar.

Favorites bar actions

• Teleport to a favorite — Left-click a slot
• Edit a favorite / open tag editor — Right-click a slot
• Lock / unlock a slot — Ctrl+left-click
• Start drag and drop — Shift+left-click, then click the destination slot
• Toggle bar visibility — Click the eye button
• Open teleport history — Click the history button, or Ctrl+Shift+T

Empty slots stay available until you fill them.

Clicks: Right-click opens this mod’s tag editor; left-click on the map is vanilla editor. To teleport with this mod, left-click a filled bar slot (or use hotkeys).

---

Map Tags

Creating and editing

1. Right-click anywhere on the map to open the tag editor
2. Choose an icon and/or enter text (at least one is required)
3. Click the star to add the tag to your favorites bar
4. Click Confirm to save

You can also right-click a favorite on the bar or an existing map tag to edit it.

When using TeleportFavorites, think right-click — it opens this mod’s tag editor, not the vanilla map tag UI. Left-click on the map stays vanilla; the only mod-specific left-click for “go there” is a filled slot on the favorites bar (or hotkeys).

Teleporting

• From the favorites bar: Left-click a filled slot
• From the tag editor: Use the teleport button
• Hotkeys: Ctrl+1 through Ctrl+0 teleport to favorites 1–10

You cannot teleport while you or your vehicle are moving — come to a full stop first.

Ownership and permissions

• Only the tag creator (or a server admin) can edit or move the tag
• Anyone can favorite a tag and teleport to it
• Ownership is tracked by player name for multiplayer consistency

---

Teleport History

⏮️ TeleportFavorites records teleport destinations (in Standard mode) so you can return to them later. Sequential mode instead records full hops (departure and destination); see Sequential History Mode.

What gets recorded

• Teleports from the favorites bar (click or hotkey)
• Teleports from the tag editor teleport button

What does not get recorded

• Moving through history itself (previous / next)
• Teleports from other mods or the console

Using history

• Open the history window from the favorites bar or Ctrl+Shift+T
• Click an entry to teleport there; the window can stay open for several jumps in a row
• History is per player and per surface
• Up to 128 entries; oldest entries drop off when the limit is exceeded

Keyboard shortcuts

• Toggle history window — Ctrl+Shift+T
• Previous entry — Ctrl+Minus
• Next entry — Ctrl+Equals
• First (oldest) entry — Ctrl+Shift+Minus
• Last (newest) entry — Ctrl+Shift+Equals
• Clear all history — Ctrl+Shift+Backspace (history window must be open)

---

Sequential History Mode (experimental)

In Standard mode, history is destination-only: each entry is where you arrived. In Sequential mode, history is full-hop: each teleport can add where you left from and where you went as separate steps so “Previous” can return you to your pre-teleport feet position. The mod portal summary calls this destination-only vs full-hop behavior.

Problem: 🤔 You teleport to a favorite, build elsewhere, then teleport again. In Standard mode, Previous might take you to an older destination, not the tile you stood on before the last jump.

Solution: Sequential mode pushes departure then destination onto the history stack when you teleport (subject to filtering below).

How it works

When you teleport in Sequential mode, two entries are added: first your departure position, then the destination. Ctrl+Minus once retu