Teleport Mod

A simple teleportation mod for Hollow Knight: Silksong.

English Documentation

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)

💡 Function Notes: Safe respawn is for escaping when stuck in bugs, reset coordinates is for clearing all data when stuck.

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
❌ While sitting on benches
❌ During cutscenes or animations
❌ When character is controlled or immobilized
❌ During loading/saving processes
❌ 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, use Alt+6, then reload the same save slot to fix camera issues
2. Character completely out of control: Emergency return to main menu (Keyboard: Ctrl+F9, no gamepad shortcut - this is an emergency measure for critical situations)
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, 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
    }
  },
  "currentEntryPointIndex": 0
}

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: 紧急传送（传送到预设安全地点）

💡 功能说明：安全重生功能用于卡BUG时脱困，重置坐标功能用于防止卡死时清空所有坐标重新开始。

安全使用指南

⚠️ 重要提醒：为避免游戏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
    }
  },
  "currentEntryPointIndex": 0
}

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

💡 提示：如果没有配置文件或文件夹，请先运行一次游戏让其自动生成。

v1.2.2

• 在特定剧情场景中禁止使用传送功能
• Teleport disabled in certain cutscene scenarios

v1.2.1

• 修复存档时间戳显示问题
• Fixed save timestamp display issues

v1.2.0

• 新增传送UI界面功能！按下 Ctrl + ` 键（位于数字键1左边，ESC键下面，同时也是波浪号~键）打开可视化传送界面
• 支持无限存档槽，可在UI内随意存档、读档、删除、覆盖、传送椅子、重置坐标、安全重生等所有功能
• Added Teleport UI Interface! Press Ctrl + ` key (located to the left of number key 1, below the ESC key, also the tilde ~ key) to open visual teleport interface
• Unlimited save slots support, all functions available in UI: save, load, delete, overwrite, bench teleport, reset coordinates, safe respawn, and more

v1.1.3

• 修复椅子传送卡进地板的问题，传送到椅子时自动添加安全偏移，提升传送体验
• Fixed bench teleport stuck in ground issue, automatically applies safe offset when teleporting to bench, improved teleport experience

v1.1.2

• 优化传送等待机制，提升稳定性，减少角色传送后在屏幕外、摄像头不跟随等传送BUG发生几率
• Optimized teleport waiting mechanism, improved stability, reduced occurrence probability of teleport bugs like hero out of screen or camera not following

v1.1.1

• 优化了安全重生的功能
• Improved safe respawn functionality

v1.1.0

• 新增安全状态检查功能，防止在角色死亡、坐椅子、重生时进行保存和传送操作，避免卡BUG
• Added safety state checks to prevent save and teleport operations during death, sitting on bench, or respawning to avoid bugs

v1.0.6

• 修复手柄摇杆误触发问题，新增完整的手柄按键自定义功能，详见README按键映射表
• Fixed gamepad joystick false trigger issues, added complete gamepad key customization, see README key mapping table

v1.0.5

• 新增紧急传送功能 (Alt+减号 或 LB+RB+X)，用于存档丢失导致困死场景的紧急救援
• 新增紧急返回主菜单功能 (Ctrl+F9)，解决角色失控（如飞起来并且无法呼出菜单只能强制关闭游戏）的问题
• 新增椅子传送功能 (Alt+7 或 LB+RB+B)，可直接传送到最后的重生点椅子
• Added emergency teleport function (Alt+minus or LB+RB+X) for emergency rescue when save data is lost causing stuck in scenes
• Added emergency return to main menu function (Ctrl+F9) to solve character out of control issues (such as flying and unable to open menu, forcing game closure)
• Added bench teleport function (Alt+7 or LB+RB+B) to directly teleport to last respawn point

v1.0.41

• 优化README文档样式和结构
• Optimized README documentation style and structure

v1.0.4

• 新增音效音量配置选项 (0.0-1.0，0为关闭)
• Added audio volume configuration option (0.0-1.0, 0 to disable)

v1.0.3

• 新增存档音效反馈功能
• 新增彩蛋音效配置选项 (默认/特殊音效切换)
• Added save sound effect feedback
• Added easter egg audio configuration option (default/special sound toggle

v1.0.2

• 修复暂停传送的BUG
• Fixed pause teleport bug

v1.0.1

• 新增手柄支持功能
• 新增按键配置功能
• 新增持续化保存功能
• 新增安全重生到入口功能（循环）
• 新增重置所有坐标功能
• Added gamepad support
• Added key configuration
• Added persistent save functionality
• Added safe respawn to entry points (cycling)
• Added reset all coordinates functionality

v1.0.0

• 初始版本
• Initial release