Mods / mapteleporter
- Tags:
- Author:
- val_lav
- Side:
- Client
- Created:
- Apr 30th at 7:38 PM
- Last modified:
- 5 days ago
- Downloads:
- 1186
-
Recommended download (for Vintage Story 1.22.0 - 1.22.6):
mapteleporter_v1.2.0.zip 1-click install
MapTeleporter is a powerful utility for instant travel across the world of Vintage Story. This mod allows you to teleport directly through the map interface while ensuring player safety and coordinate precision.
Key Features
-
✨ Quick Waypoints (Shift + V): Instantly create a waypoint at your current coordinates (X, Y, Z) using a hotkey. Once created, you can open your map to rename the marker, change its color, or select a unique icon.
-
📍 Precise Teleportation: Press Shift + Right-Click on a waypoint created via the hotkey to teleport to that exact spot. This is the perfect way to return to deep underground caves or high tower peaks instantly.
-
💀 Death Marker Support: The mod supports standard death markers. You can return to the site of your last demise with a single click.
-
🌍 Surface Teleport: Shift + Right-Clicking on any empty area of the map will teleport you to the surface at that location.
-
🛡️ Safe Drop System: If you teleport to an unexplored or unloaded area ("black zone"), the mod will prioritize loading the chunk while holding you safely in the air, then lower you to the ground once the terrain is ready.
Important Information
[!IMPORTANT]
To teleport into caves (underground), you must use Quick Waypoints (Shift + V). Markers created manually through the standard map interface only save surface coordinates and cannot move you underground.
How to Use
-
Creating a Point: Stand at the desired spot and press Shift + V. This instantly saves your coordinates.
-
Editing the Point: Open your map (M), right-click the newly created marker, and select "Edit" to change its name, icon, or color.
-
Teleporting: While the map is open, hover your cursor over the marker and press Shift + Right-Click.
-
Security: A "Triple Security Filter" ensures that teleportation won't trigger accidentally while you are browsing your inventory, using a chest, or viewing the minimap.
🔧 Technical Requirements
To keep things fair and stable, this is a Synchronized Mod:
Both Sides Required: It must be installed on both the Server and the Client.
Not a Cheat: It will not work on vanilla servers or servers where the mod is not installed. It uses official API channels to move your character safely.
I hope this makes your travels in the vast world of Vintage Story a bit more pleasant! If you find any bugs, feel free to let me know.
Thanks for your help in finding bugs and useful information.
Just as a happy side note - it appears to work with Map Markers made by other mods (such as Auto Map Markers) as these store full X/Y/Z coordinates :)
https://mods.vintagestory.at/automapmarkers
KiriRae, help in finding errors
*Created by Valerii.*
| Mod Version | Mod Identifier | For Game version | Downloads | Released | Changelog | Download | 1-click mod install* |
|---|---|---|---|---|---|---|---|
| 1.2.0 | mapteleporter | 821 | May 9th at 6:22 PM | mapteleporter_v1.2.0.zip | 1-click install | ||
|
You can now teleport directly to specific locations, including underground caves, by using custom map markers. | |||||||
| 1.1.0 | mapteleporter | 262 | Apr 30th at 11:06 PM | Empty | mapteleporter_v1.1.0.zip | 1-click install | |
| 1.0.0 | mapteleporter | Apr 30th at 7:41 PM | Release Retracted | ||||
Retraction Reason:error Changelog: | |||||||
| 0.2.0 | mapteleporter | 42 | May 9th at 6:25 PM | mapteleporter_v0.2.0.zip | 1-click install | ||
|
You can now teleport directly to specific locations, including underground caves, by using custom map markers. | |||||||
| 0.1.0 | mapteleporter | 35 | May 2nd at 7:10 PM | mapteleporter_v0.1.0.zip | 1-click install | ||
|
I haven't tested it for version 1.2.6, so make a backup before testing. | |||||||
Could you add a setting to disable logging?
Would you like to disable logging just in the game's log files, or also in the in-game chat?
i suggest both, but i want to disable chat logs
Okay, I'll try to do it within a week.
First of all, thanks for this mod ❤️
One quick request is to make it possible to teleport to waypoints - something lost from transmapeporter functionality
This is useful when a waypoint may be underground or within a building to teleport directly to it; currently the mod will just teleport me above the waypoint when shift-right-clicking
@FilmBoy84 Thank you very much, I'll try to make a point-to-point teleport this weekend, so I can teleport to the cave, as I understand it.
Thank you, will look forward to the update 🍻
Yes, the ability to teleport to waypoint so i can go to waypoints in caves/buildings is what i feel is missing compared to the old transmapeporter functionality
@FilmBoy84 I got it working! However, you will need to create special markers using the Shift + V hotkey. This will create a waypoint that you can rename and customize (change its color and icon). If you use Shift + Right-Click on this marker, it will teleport you to its exact location. Death markers work as well. Please note that old markers, and new ones created through the standard map menu, will not teleport you into caves.
Amazing, thanks again
Just as a happy side note - it appears to work with Map Markers made by other mods (such as Auto Map Markers) as these store full X/Y/Z coordinates :)
FilmBoy84 As a thank you, I'll add your comment with information to the mod description)
Isn't this forbidden? I thought it was forbidden to post something like this. Otherwise, a whole post from me would have appeared here a long time ago, if you know what I mean.
What is prohibited? Can you explain?
Did you mark this mod as client-side, meaning it exploits game vulnerabilities? If it's a client, does it work on servers where mods aren't banned?
It's not an exploit. This mod uses a custom network channel and requires installation on both the server and the client. It won't work on any server that hasn't explicitly added this mod. It's a standard synchronized tool, not a client-side cheat
Okay then, thanks for the reply. I was just scared that it was a cheat.
any chance of a backport to 1.21.6? not a modder but i understand there was some kind of code upgrade between 1.21 and 1.22 so totally understandable if thats too much work or annoying or anything though!
thanks for your work either way!! :D
@goblinfool Have you tried running it on 1.21.6? Maybe it will work. If it does, I can add the version number to the source code so the game doesn't complain.
it stays greyed out in the mod manager panel, citing game version requirements. is there a way i can force it to run anyway?
thanks so much for the quick reply, i totally missed it you were so quick!
edit: modified the "version required" in the json and it seems to run just fine at the moment! thanks so much!
@goblinfool,Did it! please test it, don't open it on the main save, unfortunately I don't have the opportunity to test it on the old version, please write if everything works.
oop, deleted my edited version and am testing 0.1.0 now! seems to work really well, but I did die on impact when teleporting to a not-previously-loaded chunk. i am using a custom race mod though (the locust drider race Drocust) in case that had an effect? i'm not too concerned though, as i prefer to explore new areas myself anyway, so it would be more for quickly getting between previously explored chunks! thank you so much for your help!!! :D
@goblinfool, It's strange, the mod was made so that the chunk loads and then teleportation occurs, how often does this happen?
every time i teleport to an unexplored chunk, i tried teleporting to an unexplored place in creative mode and while i didnt die, the server still closed - whether i die or not, the server then closes from "too many errors". i presume its teleporting me first, the chunk visibly loads, then its trying to teleport me back (or a second time?) but im already dead or something and the game closes the server. i'm not too worried about it personally, i can just remember not to teleport to places i've not been before haha, but i can send you the crash logs if you'd like?
How much RAM do you have? Remember that frequent teleportation uses up a lot of RAM.
64gb, but its ddr4 so it might be to do with the speed?
I don't know, I haven't encountered this before. I have 32 DDR4. On my build, teleportation to new locations works fine, as well as to unloaded chunks. Could you tell me what error occurs when the game crashes?
https://mods.vintagestory.at/transmapeporter
thanks so much for all your help! it works with this mod's teleport function :D
i'm pretty confused about which error is causing it, because it spams thousands of errors in the log. the game itself says "shutting down server due to too many errors"
it's all good though, i really appreciate your time!! have a good day :D
I'm always happy to help, and have a nice day.
val_lav Super quick! Super thanks!
Great mod. However, I get teleported whenever I press shift + RM, even when I don't have the map open. Like when placing things in ground storage. Very inconvenient.
@KiriRae, ok, I'm already working on it, thanks for the information
@KiriRae, UPDATE: the bug is fixed.