Get Manager
Hollow Knight: Silksong
CommunitiesHollow Knight: SilksongMhzTeleport

Teleport

A simple teleportation mod. 简单传送，随时掌控。
Mhzhttps://github.com/Masaicker/TeleportMod-Silksong

Details

Last Updated
2 days ago
First Uploaded
2 days ago
Downloads
9.4K
Likes
1
Size
224KB
Dependency string
Mhz-Teleport-1.1.3
Dependants
0 other mods

Categories

ModsToolsMisc
Download
DetailsRequired (1)WikiChangelogVersionsAnalysis

Teleport Mod

A simple teleportation mod for Hollow Knight: Silksong.

English Documentation

📋 Known Issues & Solutions

🔧 Camera Issues

If you find the character is off-screen after teleporting, or the camera doesn't follow character movement (character walks directly out of screen boundaries), this is usually caused by skipping the game's camera transition mechanism during teleportation. For solutions, please refer to the Safe Respawn function in the Troubleshooting Guide.

⚠️ Teleporting to Unlocked Entry Points

Both teleportation and Safe Respawn functions may sometimes teleport the character to unlocked entry points. Due to potential obstacles at unlocked entrances, the character might be "pushed into" unexpected closed areas. If you find yourself trapped in a scene that you cannot normally exit, please:

  • Use Teleport to Bench function to return to the last save point
  • Or use Emergency Teleport to return to a safe location
  • Temporarily avoid saving coordinates in such areas

📍 Special Note: The "MEMORIUM" scene (requires double jump to reach) is prone to this issue. If teleported there before unlocking double jump, you will be trapped in the scene, please be extra careful.

Usage

Keyboard Controls

  • Ctrl + 1~5: Save position 🔊 Sound effect
  • Alt + 1~5: Load position (no save data: auto teleport to bench)
  • Alt + 6: Safe respawn (cycle entry points)
  • Alt + 7: Teleport to bench (last respawn point)
  • Alt + 0: Reset all coordinates
  • Alt + -: Emergency teleport (to preset safe location) [minus key]
  • 🆘 Ctrl + F9: Emergency return to main menu (character out of control/stuck)
💡 Note: Default uses main keyboard number keys, NOT numpad keys. All key combinations are fully customizable in the config file, including modifier keys and function keys!

Gamepad Controls

  • LB + RB + Direction/A: Teleport to slot
  • LB + Start + Direction/A: Save to slot 🔊 Sound effect
  • LB + RB + Y: Safe respawn
  • LB + RB + B: Teleport to bench (last respawn point)
  • LB + Select + Start: Reset all coordinates
  • LB + RB + X: Emergency teleport (to preset safe location)
💡 Note: All gamepad controls are fully customizable to match your personal preferences.

🎮 Gamepad Key Reference

Direction Keys:

  • DPadUp = D-Pad Up
  • DPadDown = D-Pad Down
  • DPadLeft = D-Pad Left
  • DPadRight = D-Pad Right

Face Buttons:

  • JoystickButton0 = A Button
  • JoystickButton1 = B Button
  • JoystickButton2 = X Button
  • JoystickButton3 = Y Button

Shoulders & Triggers:

  • LeftBumper = Left Bumper (LB)
  • RightBumper = Right Bumper (RB)
  • LeftTrigger = Left Trigger (LT)
  • RightTrigger = Right Trigger (RT)

System Buttons:

  • JoystickButton6 = Select/Back Button
  • JoystickButton7 = Start Button
  • JoystickButton8 = Home/Guide Button

Default Gamepad Configuration:

  • Slot 1: DPadUp (D-Pad Up)
  • Slot 2: DPadDown (D-Pad Down)
  • Slot 3: DPadLeft (D-Pad Left)
  • Slot 4: DPadRight (D-Pad Right)
  • Slot 5: JoystickButton0 (A Button)
  • Teleport Modifiers: LeftBumper + RightBumper (LB + RB)
  • Save Modifiers: LeftBumper + JoystickButton7 (LB + Start)
  • Safe Respawn: JoystickButton3 (Y Button) [in teleport mode]
  • Hardcoded Teleport: JoystickButton2 (X Button) [in teleport mode]
  • Bench Teleport: JoystickButton1 (B Button) [in teleport mode]
  • Reset All: LeftBumper + JoystickButton6 + JoystickButton7 (LB + Select + Start)
⚙️ All gamepad controls can be customized in the game's config file.
💡 If older version config entries are too numerous and affect viewing, you can delete the .cfg config file and restart the game to automatically generate the latest configuration.

Safety Guidelines

⚠️ Important: Please follow these safety guidelines to avoid game bugs and data corruption!

When it's safe to use:

✅ Only save or teleport when your character is fully controllable
✅ In normal game scenes, when not in combat

Dangerous situations - DO NOT use:

❌ During boss battles
❌ Inside closed combat areas
❌ During cutscenes or animations
❌ When character is controlled or immobilized
❌ During any special states or triggered events

Important Notes:

⚠️ Avoid multiple teleportations in short time (like teleporting multiple times within 1 second)
⚠️ Do not teleport immediately after death

Troubleshooting:

🆘 If stuck/camera lost/character floating and unable to open menu:

  1. First try: Safe Respawn (Keyboard: Alt+6, Gamepad: LB+RB+Y)
    If teleported to entry point, then use load position as needed

    💡 Example: If character is off-screen after loading save, or camera doesn't follow character movement, use Alt+6 safe respawn, then reload the same save slot coordinates to fix camera/view issues

  2. Character completely out of control, or character floating and not landing: Emergency return to main menu (Keyboard: Ctrl+F9, no gamepad shortcut)

    ⚠️ Important: Do NOT use emergency return to main menu when character is dead

  3. Still not working, completely unresponsive: Restart the game

🚨 All save data lost or stuck in a scene:

If all your save slots are lost or you're trapped in an unescapable scene, use Emergency Teleport (Keyboard: Alt+- [minus key], Gamepad: LB+RB+X) to instantly teleport to a preset safe location (starting town station).

This works independently of your save data

Emergency rescue config:

If all methods fail, you can manually edit the save file with this safe config:

⚠️ Important: Close the game first, modify and save, then restart the game, and load slot 1 after entering the game (Keyboard: Alt+1, Gamepad: LB+RB+Up)

{
  "saveSlots": {
    "1": {
      "x": 71.42231,
      "y": 9.597684,
      "z": 0.004,
      "scene": "Bellway_01",
      "hasData": true
    }
  }
}

Slot 1 defaults to the station in the starting town, which is absolutely safe.

Config file location:
C:\Users\[Username]\AppData\LocalLow\Team Cherry\Hollow Knight Silksong\TeleportMod\savedata.json

Installation

  1. Install BepInEx
  2. Extract and put the Teleport related folder into BepInEx/plugins/ folder
  3. Ensure Teleport.dll, manbo.wav, and Gamesave.wav are in the same directory under the folder
  4. Start game

Config

  • Enable Detailed Logging (default: false): Show detailed logs
  • Enable Gamepad Support (default: true): Enable controller input
  • Enable Easter Egg Audio (default: false): 🎵 Enable special sound effect for saving
  • Audio Volume (default: 0.5): 🔊 Volume level for save sound effect (0.0-1.0, 0=disable)
  • Save Modifier Key (default: LeftControl): Modifier key for saving coordinates
  • Teleport Modifier Key (default: LeftAlt): Modifier key for teleporting
  • Reset Modifier Key (default: LeftAlt): Modifier key for reset functions
  • Slot 1-5 Keys (default: Alpha1-5): Keys for save slots
  • Safe Respawn Key (default: Alpha6): Key for safe respawn function
  • Bench Teleport Key (default: Alpha7): Key for bench teleport function
  • Emergency Teleport Key (default: Minus): Key for emergency teleport function
  • Reset All Key (default: Alpha0): Key for reset all function

Data Storage

Coordinate data path:
C:\Users\[Username]\AppData\LocalLow\Team Cherry\Hollow Knight Silksong\TeleportMod\savedata.json

Configuration file location:
{Game Install Directory}\BepInEx\config\Mhz.TeleportMod.cfg

💡 Note: If the config file or folder doesn't exist, please run the game once to generate it first.


传送模组

空洞骑士：丝之歌的简单传送模组。

中文文档

📋 已知问题及解决方案

🔧 摄像头问题

如果传送后发现角色在屏幕外，或者移动时摄像头不跟随角色（角色直接走出了屏幕边界），这通常是因为传送时跳过了游戏的摄像头切换机制导致的。解决方法请参考故障处理指南中的安全重生功能。

⚠️ 传送到未解锁入口的特殊情况

传送和安全重生功能有时可能将角色传送到尚未解锁的入口点。由于入口未解锁可能存在障碍物，角色可能被"挤入"到意外的密闭区域。如果发现传送后被困在一个无法正常离开的场景，请：

  • 使用传送到椅子功能返回最后的存档点
  • 或使用紧急传送返回安全位置
  • 暂时避免在这类区域保存坐标

📍 特别注意: "忆廊"场景（需要二段跳才能到达的区域）容易出现此问题。如果在未解锁二段跳时被传送进去，将会被困在场景中，请格外小心。

使用方法

键盘操作

  • Ctrl + 1~5: 保存位置 🔊 有音效提示
  • Alt + 1~5: 读取位置（无存档时自动传送到椅子）
  • Alt + 6: 安全重生（轮换入口点）
  • Alt + 7: 传送到椅子（最后的重生点）
  • Alt + 0: 重置所有坐标
  • Alt + -: 紧急传送（传送到预设安全地点）[减号键]
  • 🆘 Ctrl + F9: 紧急返回主菜单（角色失控/卡死时使用）
💡 提示：默认使用主键盘数字键，非小键盘。所有按键组合都可以在配置文件中完全自定义，包括修饰键和功能键！

手柄操作

  • LB + RB + 方向键/A: 传送到档位
  • LB + Start + 方向键/A: 保存到档位 🔊 有音效提示
  • LB + RB + Y: 安全重生
  • LB + RB + B: 传送到椅子（最后的重生点）
  • LB + Select + Start: 重置所有坐标
  • LB + RB + X: 紧急传送（传送到预设安全地点）
💡 提示：所有手柄按键均支持自定义配置，可根据个人习惯调整操作方式。

🎮 手柄按键对照表详细说明

方向键:

  • DPadUp = 方向键上
  • DPadDown = 方向键下
  • DPadLeft = 方向键左
  • DPadRight = 方向键右

面部按钮:

  • JoystickButton0 = A按钮
  • JoystickButton1 = B按钮
  • JoystickButton2 = X按钮
  • JoystickButton3 = Y按钮

肩键扳机:

  • LeftBumper = 左肩键(LB)
  • RightBumper = 右肩键(RB)
  • LeftTrigger = 左扳机(LT)
  • RightTrigger = 右扳机(RT)

系统按钮:

  • JoystickButton6 = Select/Back按钮
  • JoystickButton7 = Start按钮
  • JoystickButton8 = Home/Guide按钮

摇杆方向 (可选配置):

  • LeftStickUp/Down/Left/Right = 左摇杆方向
  • RightStickUp/Down/Left/Right = 右摇杆方向
  • LeftStickButton = 左摇杆按下(L3)
  • RightStickButton = 右摇杆按下(R3)

默认手柄配置:

  • 存档槽1: DPadUp (方向键上)
  • 存档槽2: DPadDown (方向键下)
  • 存档槽3: DPadLeft (方向键左)
  • 存档槽4: DPadRight (方向键右)
  • 存档槽5: JoystickButton0 (A按钮)
  • 传送修饰键: LeftBumper + RightBumper (LB + RB)
  • 保存修饰键: LeftBumper + JoystickButton7 (LB + Start)
  • 安全重生: JoystickButton3 (Y按钮) [传送模式下]
  • 硬编码传送: JoystickButton2 (X按钮) [传送模式下]
  • 椅子传送: JoystickButton1 (B按钮) [传送模式下]
  • 重置所有: LeftBumper + JoystickButton6 + JoystickButton7 (LB + Select + Start)
⚙️ 所有手柄操作都可以在游戏配置文件中自定义。
💡 如果旧版本配置项过多影响查看，可删除.cfg配置文件，重启游戏自动生成最新配置。

安全使用指南

⚠️ 重要提醒：为避免游戏BUG和数据损坏，请务必遵循以下安全准则！

何时可以安全使用:

✅ 只在角色完全可控制时保存或传送
✅ 在正常游戏场景中，无战斗状态时

危险情况 - 请勿使用:

❌ BOSS战期间
❌ 封闭战斗区域内
❌ 过场动画播放时
❌ 角色被控制或无法移动时
❌ 任何特殊状态或事件触发时

注意事项:

⚠️ 不要在极短时间内多次读档传送（如1秒内连续传送多次）
⚠️ 不要死亡后马上传送

故障处理:

🆘 如遇卡死/视角丢失/角色起飞无法呼出菜单：

  1. 首先尝试：安全重生（键盘：Alt+6，手柄：LB+RB+Y）
    如果传送到入口，再按需读档传送

    💡 例如：读档传送后角色在屏幕外，或摄像头不跟随角色移动，使用Alt+6安全重生，随后再读取刚才的存档坐标，能解决卡视野问题

  2. 角色完全失控，或者角色飘浮不落地时：紧急返回主菜单（键盘：Ctrl+F9，无手柄按键）

    ⚠️ 重要：角色死亡时请勿使用紧急返回主菜单

  3. 仍无效果，完全没反应时：重启游戏

🚨 所有存档丢失导致困死在某个场景：

如果你的所有存档槽都丢失导致困在无法逃脱的场景中，使用紧急传送（键盘：Alt+- [减号键]，手柄：LB+RB+X）立即传送到预设安全地点（初始小镇车站）。

此功能独立于存档数据运行

紧急救援配置:

如果所有方法都无效，可以手动编辑存档文件，使用以下安全配置：

⚠️ 重要： 先关闭游戏，修改保存后再启动游戏，进入游戏后读取1号存档即可（键盘：Alt+1，手柄：LB+RB+方向上）

{
  "saveSlots": {
    "1": {
      "x": 71.42231,
      "y": 9.597684,
      "z": 0.004,
      "scene": "Bellway_01",
      "hasData": true
    }
  }
}

1号档位默认在初始小镇的车站里，这是一个绝对安全的位置。

配置文件位置：
C:\Users\[用户名]\AppData\LocalLow\Team Cherry\Hollow Knight Silksong\TeleportMod\savedata.json

安装

  1. 安装BepInEx
  2. 解压后将Teleport相关文件夹整体放入BepInEx/plugins/文件夹
  3. 确保文件夹下的Teleport.dll、manbo.wav和Gamesave.wav在同一目录
  4. 启动游戏

配置

  • 启用详细日志 (默认: false): 显示详细日志
  • 启用手柄支持 (默认: true): 启用手柄输入
  • 启用彩蛋音效 (默认: false): 🎵 启用存档时的特殊音效
  • 音效音量 (默认: 0.5): 🔊 存档音效音量大小（0.0-1.0，设置为0关闭音效）
  • 保存修饰键 (默认: LeftControl): 保存坐标使用的修饰键
  • 传送修饰键 (默认: LeftAlt): 传送坐标使用的修饰键
  • 重置修饰键 (默认: LeftAlt): 重置功能使用的修饰键
  • 存档槽1-5按键 (默认: Alpha1-5): 存档槽使用的按键
  • 安全重生按键 (默认: Alpha6): 安全重生功能按键
  • 椅子传送按键 (默认: Alpha7): 椅子传送功能按键
  • 紧急传送按键 (默认: Minus): 紧急传送功能按键
  • 重置所有坐标按键 (默认: Alpha0): 重置所有坐标功能按键

数据存储

坐标数据路径：
C:\Users\[用户名]\AppData\LocalLow\Team Cherry\Hollow Knight Silksong\TeleportMod\savedata.json

配置文件路径：
{游戏安装目录}\BepInEx\config\Mhz.TeleportMod.cfg

💡 提示：如果没有配置文件或文件夹，请先运行一次游戏让其自动生成。
Thunderstore development is made possible with ads. Please consider making an exception to your adblock.
Thunderstore development is made possible with ads. Please consider making an exception to your adblock.
Thunderstore development is made possible with ads. Please consider making an exception to your adblock.