A simple teleportation mod for Hollow Knight: Silksong.
空洞骑士：丝之歌的简单传送模组。
Ctrl + 1~5: Save position 🔊 Sound effectAlt + 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 coordinatesAlt + -: 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!
LB + RB + Direction/A: Teleport to slotLB + Start + Direction/A: Save to slot 🔊 Sound effectLB + RB + Y: Safe respawnLB + RB + B: Teleport to bench (last respawn point)LB + Select + Start: Reset all coordinatesLB + RB + X: Emergency teleport (to preset safe location)💡 Note: All gamepad controls are fully customizable to match your personal preferences.
All gamepad controls are fully customizable in the config file. Here's the complete key mapping:
Direction Keys:
DPadUp = D-Pad UpDPadDown = D-Pad DownDPadLeft = D-Pad LeftDPadRight = D-Pad RightFace Buttons:
JoystickButton0 = A ButtonJoystickButton1 = B ButtonJoystickButton2 = X ButtonJoystickButton3 = Y ButtonShoulders & Triggers:
LeftBumper = Left Bumper (LB)RightBumper = Right Bumper (RB)LeftTrigger = Left Trigger (LT)RightTrigger = Right Trigger (RT)System Buttons:
JoystickButton6 = Select/Back ButtonJoystickButton7 = Start ButtonJoystickButton8 = Home/Guide ButtonDefault Gamepad Configuration:
DPadUp (D-Pad Up)DPadDown (D-Pad Down)DPadLeft (D-Pad Left)DPadRight (D-Pad Right)JoystickButton0 (A Button)LeftBumper + RightBumper (LB + RB)LeftBumper + JoystickButton7 (LB + Start)JoystickButton3 (Y Button) [in teleport mode]JoystickButton2 (X Button) [in teleport mode]JoystickButton1 (B Button) [in teleport mode]LeftBumper + JoystickButton6 + JoystickButton7 (LB + Select + Start)⚙️ All gamepad controls can be customized in the game's config file.
⚠️ Important: Please follow these safety guidelines to avoid game bugs and data corruption!
✅ Only save or teleport when your character is fully controllable
✅ In normal game scenes, when not in combat
❌ 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
⏱️ Avoid multiple teleportations in short time (like teleporting multiple times within 1 second)
⚠️ Do not teleport immediately after death
🆘 If stuck/camera lost/character floating and unable to open menu:
Alt+6, Gamepad: LB+RB+Y), if teleported to entry point, then use load position as neededCtrl+F9, no gamepad shortcut - this is an emergency measure for critical situations)🚨 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.
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
Teleport related folder into BepInEx/plugins/ folderTeleport.dll, manbo.wav, and Gamesave.wav are in the same directory under the folderEnable Detailed Logging (default: false): Show detailed logsEnable Gamepad Support (default: true): Enable controller inputEnable Easter Egg Audio (default: false): 🎵 Enable special sound effect for savingAudio 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 coordinatesTeleport Modifier Key (default: LeftAlt): Modifier key for teleportingReset Modifier Key (default: LeftAlt): Modifier key for reset functionsSlot 1-5 Keys (default: Alpha1-5): Keys for save slotsSafe Respawn Key (default: Alpha6): Key for safe respawn functionBench Teleport Key (default: Alpha7): Key for bench teleport functionEmergency Teleport Key (default: Minus): Key for emergency teleport functionReset All Key (default: Alpha0): Key for reset all functionCoordinate 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)默认手柄配置:
DPadUp (方向键上)DPadDown (方向键下)DPadLeft (方向键左)DPadRight (方向键右)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秒内连续传送多次）
⚠️ 不要死亡后马上传送
🆘 如遇卡死/视角丢失/角色起飞无法呼出菜单：
Alt+6，手柄：LB+RB+Y），如果传送到入口，再按需读档传送Ctrl+F9，无手柄按键 - 这是非常时期的特殊手段）🚨 所有存档丢失导致困死在某个场景：
如果你的所有存档槽都丢失导致困在无法逃脱的场景中，使用紧急传送（键盘：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
Teleport相关文件夹整体放入BepInEx/plugins/文件夹Teleport.dll、manbo.wav和Gamesave.wav在同一目录启用详细日志 (默认: 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
💡 提示：如果没有配置文件或文件夹，请先运行一次游戏让其自动生成。