Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/tantk/psychic-kungfu-master-mod

Wuxia-themed cheat mod for 今古群侠传 (JinGu) — MelonLoader plugin + Tauri UI. Companion data reference site for items and NPC gift preferences.
https://github.com/tantk/psychic-kungfu-master-mod

cheat-engine game-mod harmony melonloader tauri unity wuxia

Last synced: 8 days ago
JSON representation

Wuxia-themed cheat mod for 今古群侠传 (JinGu) — MelonLoader plugin + Tauri UI. Companion data reference site for items and NPC gift preferences.

Awesome Lists containing this project

README 

          
# JinGu Cheats / 今古群侠传 修改器



A MelonLoader-based cheat mod for **今古群侠传 (JinGu)** by 金十四工作室, with an external Tauri-based UI in a separate window — wuxia-themed, with five user-switchable color themes.



🔗 **[Download latest release](https://github.com/tantk/psychic-kungfu-master-mod/releases/latest)** · 📖 **[Data reference site (items + NPC gifts)](https://tantk.github.io/psychic-kungfu-master-mod/)** · 🐛 **[Report a bug](https://github.com/tantk/psychic-kungfu-master-mod/issues/new)**



> **Compatibility:** tested against JinGu Steam build of 2026-05-18 with MelonLoader 0.7.3.



## Screenshots



| 主公 Self · stats + XP + reputation | 物品 Items · 948-item browser | 角色 NPCs · editor grid |

|:---:|:---:|:---:|

| ![Self tab — six pillars, direct XP sliders, rate-boost toggle, leader card](screenshot/01-self-stats.png) | ![Items tab — full item browser with category filter and sortable columns](screenshot/02-items-browser.png) | ![NPCs tab — editor grid filtered by faction](screenshot/03-npc-editor.png) |



## Features



### 主公 / Self

- 无限银两 / Max Money toggle

- 无敌 / God Mode toggle (friendly Roles take 0 damage in combat)

- + 银两 buttons (10k / 100k / 1M / 10M) — leader card shows the live amount

- + N for the six pillars (根骨 / 力道 / 体魄 / 敏捷 / 技巧 / 悟性), each click adds 1, with live values displayed

- 直接经验 / Direct XP sliders for 实战 (combat) and 内功 (internal qi) — adds raw XP to the pool that drives the skill level

- 经验加成 / XP Rate Boost toggles for 实战经验 / 武学经验 / 内功经验 — set the rate via slider, flip the toggle on to apply

- + N for the six weapon masteries (刀法 / 剑法 / 拳掌 / 枪棍 / 暗器 / 琴功)

- 战斗 · 全员回满 / heal full team

- 武学 · 满级所有武学 / one-click max all learned martial arts

- 声望 / Reputation sliders for 善恶 (good ↔ evil), 名望 (fame), 情缘 (romance) — ± by chosen amount



### 探索 / Explore

- 无消耗 / Free Actions toggle (no 精力 / 体力 cost for crafting, alchemy, etc.)

- 时停 / Freeze Time toggle (world clock paused)

- 回满 精力 + 体力 / recover both stamina pools (current / max shown live)

- + 精力上限 / + 体力上限 — raise the caps permanently

- + N 时辰 / advance the world clock by 1 / 4 / 12 hours



### 活动 / Mini-games

- 钓鱼 / Fishing — random ×1 / ×10 / ×50 (weighted by the game's own loot table)

- 打猎 / Hunting — same, weighted by `m_itemValue`

- 驯兽 / Animal Taming — one-click max all bonds, or max one specific animal by npcId

- 生活技 直接经验 / Living Arts Direct XP sliders for 钓鱼 / 打猎 / 驯兽 / 炼丹 / 打造 / 挖掘 / 下棋 / 采集

- 生活技 经验加成 / Living Arts XP Rate Boost toggles for all 8 living arts



### 物品 / Items

- Full master item browser (948 items) with **two-level category filter mirroring the in-game inventory**:

  - **主类** (main): 全部 · 武器 · 防具 · 秘籍 · 消耗 · 杂物

  - **子类** (subcategory): 24 game-defined subcategories that narrow with the main filter

- Cross-field text search

- Click any row to expand the full record, add to inventory at any quantity, or — for 丹方 / 图纸 — skip the alchemy / forging mini-game to craft the resulting item directly



### 角色 / NPCs

- NPC editor — pick any NPC by ID, edit money, affection (好感度), friend level (which drives the in-game Character record swap and therefore the NPC's stats + skills), robed / show / deaded flags, camp

- Character editor — edit the six pillars per character, add or remove martial-arts (active) and inner skills (passive), reset to baseline snapshot

- Use the friend-level field to unlock companion progression that's normally gated behind personal quests



### 门派 / Sects

- Per-sect editor — set membership flag, mass-adjust favor across all NPCs in a sect (presets ±10 / ±50 / ±100 / ±999, or any custom amount)



### 关于 / About

- 5 swappable color themes: 墨黑 (Ink) · 宣纸 (Paper) · 青瓷 (Celadon) · 赤壁 (Crimson) · 竹简 (Bamboo)

- 4 font presets · 4 size scales (responsive zoom)

- Per-cheat key bindings — you pick which keys to use, no defaults baked in

- Persistent error log surfaced in the UI



## Requirements



- **OS**: Windows 10 / 11 x64

- **WebView2 Runtime**: required by the Tauri UI. Windows 11 has it pre-installed; on Windows 10 most systems already have it via cumulative updates. If the UI window fails to open, install it from .



## ⚠ About antivirus warnings



Windows Defender and most antivirus products **will flag the cheat DLL** because it hooks into another process and uses reflection to modify game state — those are the same techniques real malware uses. There is no honest way to make this go away without a code-signing certificate; the source for everything in the release is in this repository for you to inspect.



What might happen and what to do:



- **SmartScreen** ("Windows protected your PC") on the setup .exe — click **More info → Run anyway**. SmartScreen flags unsigned downloads by default; reputation builds over time as more people install.

- **Defender** flags the dropped DLL after install — open Virus & threat protection → Allow on device, or add an exclusion for the game folder (`C:\Program Files (x86)\Steam\steamapps\common\JinGu\JinGu\`) before installing.

- **Some third-party AV** (Avast / Kaspersky / etc.) may quarantine the DLL silently. If the mod "isn't loading," check your AV's quarantine list first.



If you'd rather not allow exceptions for unsigned binaries, don't install.



## Install (recommended — the installer)



**Download `JinGuCheats-Setup-v0.1.0.exe`** from the [Releases page](https://github.com/tantk/psychic-kungfu-master-mod/releases). Double-click it. Walk through the wizard.



The installer auto-detects your JinGu folder via the Steam registry, extracts the bundled MelonLoader, patches the Mono runtime, drops the mod files into `Mods\`, and prints the recommended Steam Launch Option on the finish page. The whole thing is one .exe — **MelonLoader 0.7.3 is bundled inside it**, no separate download.



A mod is a modification to a game, not its own Windows app — so Setup deliberately **does not** register in Add/Remove Programs. To uninstall, right-click `\Mods\uninstall.bat` and *Run as administrator*. It removes `version.dll`, `MelonLoader\`, `Mods\`, and `UserData\`. Save files live in `%LOCALAPPDATA%Low\金十四工作室\JinGu\SaveDatas\` and are untouched.



### Recommended Steam Launch Option



Steam updates occasionally revert the patched Mono runtime back to the stripped originals, which silently breaks the mod. To auto-repair on every launch, paste this into Steam → JinGu → Properties → General → Launch Options:



```

"C:\Program Files (x86)\Steam\steamapps\common\JinGu\JinGu\Mods\pre-launch.bat" %command%

```



(Replace the path if your Steam library is elsewhere — the installer shows your exact path on the finish page.)



## Install (fallback — the portable zip)



If the installer fails (overzealous AV, locked-down corporate machine, etc.), the same files are also packaged as `JinGuCheats-v0.1.0.zip`:



1. Extract anywhere.

2. **Right-click `install.bat` → Run as administrator** (self-elevates if you forget). Same steps as the wizard, just console-based.

3. To uninstall: **right-click `uninstall.bat` → Run as administrator**.



## Install — manual mode (no installer)



If you'd rather not run a script:



1. **Extract the bundled `MelonLoader.x64.zip`** from the release into your JinGu folder (`C:\Program Files (x86)\Steam\steamapps\common\JinGu\JinGu\`). After extracting, `version.dll` should sit next to `JinGu.exe`.



2. **Patch the stripped Mono runtime.** Open PowerShell, paste, hit Enter:



   ```powershell

   $src = "C:\Program Files (x86)\Steam\steamapps\common\JinGu\JinGu\MelonLoader\Dependencies\MonoBleedingEdgePatches"

   $dst = "C:\Program Files (x86)\Steam\steamapps\common\JinGu\JinGu\JinGu_Data\Managed"

   foreach ($f in "mscorlib.dll","System.dll","System.Core.dll","System.Runtime.dll") {

     attrib -R "$dst\$f" 2>$null

     Copy-Item "$src\$f" "$dst\$f" -Force

   }

   ```



3. **Copy these from the release zip into `\Mods\`**:

   - `JinGuCheats.dll`

   - `jingu-cheats-ui.exe`

   - `pre-launch.bat`  (optional — for the auto-heal feature below)

   - `pre-launch.ps1`  (optional — used by the bat)



4. **Optional auto-heal Steam Launch Option** — Steam updates revert the corlibs every few patches. Pasting this once into `Steam → JinGu → Properties → General → Launch Options` makes Steam re-patch them on every launch:



   ```

   "C:\Program Files (x86)\Steam\steamapps\common\JinGu\JinGu\Mods\pre-launch.bat" %command%

   ```



5. Launch through Steam.



> The bundled MelonLoader is 0.7.3. Newer versions may work but are unverified — for predictable behavior, use the bundled copy.



## Using the cheats



### Through the UI



The UI window has tabs across the top: **主公** (Self) · **探索** (Explore) · **活动** (Mini-games) · **物品** (Items) · **角色** (NPCs) · **门派** (Sects) · **关于** (About).



- **Toggles** (无限银两, 无敌, 无消耗, 时停, XP rate boosts) — flip on/off in their tab

- **Buttons** (+ 十万 银两, + 根骨, 满级所有武学, ...) — click to apply

- **Sliders + Apply** — set the amount, click Apply (or flip the toggle for rate boosts)

- **Live values** — small badges next to each cheat show the current in-game value, updated a few times per second

- **Hotkeys** — in the About tab, click "未绑定" next to each cheat and press your chosen key



The leader card at the top shows your character's name, current money, in-game time, and difficulty.



### Through hotkeys



By default no hotkeys are bound — you pick them. In the UI's 关于 / About tab:



1. Find the cheat you want a hotkey for

2. Click the "未绑定" / "Not bound" button next to it

3. A small modal appears: "Press any key to bind"

4. Press the key you want (e.g. F2)

5. Done — the button now shows the key name



Press Escape during binding to cancel. Click the "×" next to a binding to clear it.



## Troubleshooting



### "Windows Defender / antivirus flags the DLL"



Game-cheat DLLs are routinely flagged by AV products even when they're benign — they hook into another process and reflection-modify game state, which looks like malware behavior. If you're not comfortable with that, don't install. If you trust the build, allow the file in your AV exclusions. The full source is in this repository for inspection.



### "UI didn't appear"



Check `MelonLoader\Latest.log` in the game folder. Look for:



```

[JinGu_Cheats] === JinGu Cheats X.Y.Z READY ===

```



If you see that, the plugin loaded. The UI should follow within a second.



If the UI process spawned (`pid N` in the log) but you don't see a window, alt-tab around — fullscreen games can hide it. If you see a `WebView2 runtime not found` error, install it from .



### "TypeLoadException" in the log



Steam reverted a corlib. Re-run step 2 above, or set up the auto-heal in step 5.



### "Game won't launch after install"



Most likely your `version.dll` from MelonLoader isn't being loaded. Make sure `version.dll` sits in the same folder as `JinGu.exe` (not inside any subfolder).



If Windows SmartScreen blocks the unsigned `version.dll`, right-click it → Properties → check "Unblock" at the bottom.



### "Black screen after splash / studio logo / Unity logo"



If the game shows the noise / studio / anti-piracy / Unity intros normally and then **freezes on a black screen** before reaching the login menu, check for a stray `doorstop_config.ini` in your game folder:



```

C:\Program Files (x86)\Steam\steamapps\common\JinGu\JinGu\doorstop_config.ini

```



This file is **not** shipped by JinGu Cheats. It's a leftover from:

- An older MelonLoader install (≤ v0.5.x — newer versions embed the config inside `version.dll`)

- A previous BepInEx or other Unity Doorstop-based mod on this game

- A previous modding tool you tried



When present, Unity Doorstop reads it instead of MelonLoader's embedded config and the injector silently bails out, hanging the game at the splash → login transition.



**Fix:** if you don't have another active Doorstop-based mod on this game, delete the file:

```

del "C:\Program Files (x86)\Steam\steamapps\common\JinGu\JinGu\doorstop_config.ini"

```



The `JinGu-Doctor.bat` shipped in `Mods\` will flag this automatically (see [issue #1](https://github.com/tantk/psychic-kungfu-master-mod/issues/1) for the original debug log).



### "Cheats do nothing"



You probably loaded a save when the plugin wasn't running. The leader card in the UI should show your character's name and money — if it shows "尚未载入存档", the plugin can't see your save. Save the game, close it fully, relaunch through Steam.



### "Items I add via the UI disappear"



Some items are flagged as session-only or quest-only by the game and get cleared on save/load. Try a different item from the same category — most regular items persist normally.



### Save-game compatibility



The mod doesn't modify save format. You can uninstall any time by deleting `version.dll`, `MelonLoader\`, and `Mods\` from the game folder. Saves keep working with the vanilla game.



## Uninstall



**Easy:** right-click `installer\uninstall.bat` → Run as administrator. It deletes `version.dll`, `MelonLoader\`, `Mods\`, `UserData\` after a y/N confirmation.



**Manual:** delete these from the game folder:

- `version.dll`

- `MelonLoader\`

- `Mods\`

- `UserData\`  (optional — has MelonLoader preferences and our mod's settings)



Either way, save files are untouched (they live in `%LOCALAPPDATA%Low\金十四工作室\JinGu\SaveDatas\`).



If you set the Steam Launch Option, clear it from JinGu → Properties → Launch Options.



To restore the original stripped corlibs: Steam → JinGu → Properties → Installed Files → Verify integrity. Steam will redownload them.



## Credit



Built on top of:

- [MelonLoader](https://github.com/LavaGang/MelonLoader) for the runtime injection layer

- [Harmony](https://github.com/pardeike/Harmony) for method patching

- [Tauri](https://tauri.app) for the UI shell

- [BepInEx unstripped Unity corlibs](https://unity.bepinex.dev) for restoring the runtime types Unity stripped during the game build



## License



This mod (plugin source + UI source + installer scripts) is MIT — see [LICENSE](LICENSE).



The release zip also bundles **MelonLoader 0.7.3 (Apache 2.0)**, distributed unchanged. Its license is preserved as `MelonLoader-LICENSE.md` in the release. Source and notice: .