ThMouseX is a fork from ThMouse made by hwei.

This is a tool that enables mouse control for Shoot 'em ups games, intended for Touhou Project series, allowing player character to move towards wherever the cursor points.

Demo clip: https://www.youtube.com/watch?v=uMkzmM13qpU

https://github.com/Meigyoku-Thmn/ThMouseX/releases
(Require .NET Framework 4.8 from version 2.1.0)

• Support any game's resolutions
• Support DirectX8, DirectX9 and DirectX11 games
• Support .NET Framework games via NeoLua and Lib.Harmony
• Can be opened and closed at any time, it will automatically detect configured games
• You can use Lua script (Lua, LuaJIT, or NeoLua) to configure further.

• Only works with 32-bit games, if there is a good 64-bit bullet hell game I will consider add 64-bit support.
• Doesn't work well with Steam Overlay, although this is minimal.
• Configuration is difficult.

This tool should be compatible with any Touhou games from 6 to the latest. Here is the list of preconfigured games in Games.txt:

• Touhou 6   東方紅魔郷 ～ Embodiment of Scarlet Devil (v1.02h)
• Touhou 7   東方妖々夢 ～ Perfect Cherry Blossom (v1.00b)
• Touhou 8   東方永夜抄 ～ Imperishable Night (v1.00d)
• Touhou 9   東方花映塚 ～ Phantasmagoria of Flower View (v1.50a)
• Touhou 9.5   東方文花帖 ～ Shoot the Bullet (v1.02a)
• Touhou 10  東方風神録 ～ Mountain of Faith (v1.00a)
• Touhou 11  東方地霊殿 ～ Subterranean Animism (v1.00a)
• Touhou 12  東方星蓮船 ～ Undefined Fantastic Object (v1.00b)
• Touhou 12.5  Double Spoiler ～ 東方文花帖 (v1.00a)
• Touhou 12.8  妖精大戦争 ～ 東方三月精 Fairy Wars (v1.00a)
• Touhou 13  東方神霊廟 ～ Ten Desires (v1.00c)
• Touhou 14  東方輝針城 ～ Double Dealing Character (v1.00b)
• Touhou 14.3  弾幕アマノジャク ～ Impossible Spell Card (v1.00a)
• Touhou 15  東方紺珠伝 ～ Legacy of Lunatic Kingdom (v1.00b)
• Touhou 16  東方天空璋 ～ Hidden Star in Four Seasons (v1.00a)
• Touhou 16.5  秘封ナイトメアダイアリー 〜 Violet Detector (v1.00a)
• Touhou 17  東方鬼形獣 ～ Wily Beast and Weakest Creature (v1.00b)
• Touhou 18  東方虹龍洞 ～ Unconnected Marketeerss (v1.00a)
• Touhou 18.5  バレットフィリア達の闇市場 〜 100th Black Market (v1.00a)
• Touhou 19  東方獣王園 〜 Unfinished Dream of All Living Ghost (v1.00a)

It also have preconfiguration of some other games:

• DANMAKAI: Red Forbidden Fruit
• 東方幕華祭 〜 Fantastic Danmaku Festival
• 東方幕華祭 春雪篇 〜 Fantastic Danmaku Festival Part II
• 東方眠世界 〜 Wonderful Waking World (itch.io link)
• 東方龍隱談 〜 Chaos of Black Loong

You can add more games to Games2.txt and copy it to ThMouseX's directory, side-by-side with Games.txt.

This project can be compiled via Visual Studio (I use Visual Studio 2022), or just Visual Studio Build Tools:

• Visual Studio, select "Desktop development with C++" during installation.
• Visual Studio Build Tools, select "Visual C++ build tools" during installation.

Also you need .NET Framework 4.8 SDK.

You also need to setup vcpkg and put vcpkg folder path into the PATH of environment variables.

Remember to compile for 32-bit, toolset v143, .NET Framework 4.8, and make sure these files and folder are in the same folder:

• ConfigScripts
• 0Harmony.dll
• Common.dll
• Cursor.png
• DX8Hook.dll
• Games.txt
• Neo.Lua.dll
• NeoLuaBootstrap.dll
• Sigil.dll
• ThMCore.dll
• THMouseX.exe
• ThMouseX.txt
• VirtualKeyCodes.txt

• Fork the THMouseX repository to your Github account
  
• Go to the "Actions" tab
  
• Click "Deployment" on the left sidebar
  
• Run the workflow
  
• Wait for it, then download the produced zipped artifact (shown up in the page with url form https://github.com/<username>/ThMouseX/actions/runs/<flowid>)
  

1. Run ThMouseX.exe.
2. Run your game, or you can run your game first and then run ThMouseX.exe.
3. If the game is supported, a cursor will show upon entering the game.

• The character will move towards where the cursor points. Please note that it will NOT move immidiately with the cursor, because ThMouseX doesn't modifier any game's behavior.
• You still have to use left hand to focus and shoot.
• Left click to use bomb/spell.
• Right click to toggle mouse control.
• Press M to toggle Windows mouse cursor visibility.

1. You can close your game first or ThMouseX first, it doesn't matter.
2. Double-click the ThMouseX icon on the taskbar and press the Quit button, or right click it and press Exit.

The crosshair/cursor sprite may be changed:

1. Find your preferred crosshair in .png format and place it into the same folder as ThMouseX.exe.
2. Open up ThMouseX.txt.
3. Change the file name after "CursorTexture = " to the preferred crosshair file's name. (Don't forget the file extension name ".png".)

You can extend ThMouseX to support more Shoot 'em ups games by modifying the "Games.txt" file. You can also use Lua script for advanced cases.

Try updating your game to the latest version.

If it doesn't solve, then there are really rare bugs that I have yet found a way to fix.
Some workarounds:

• Restart ThMouseX
• Start ThMouseX FIRST, then start the game
• When starting ThMouseX, make sure your game's window is NOT minimized (this should be fixed from version 2.1.0).

This is a normal problem in every games that the in-game cursor is a little delay compared to the OS cursor. ThMouseX also doesn't change the game's behavior (it doesn't cheat), so the character still has to follow the game rule, no "teleportation".

The moving step of the character is a fixed value and usually longer than the mouse movement step you are able to make (for example, you can move the cursor 1 px, but the game character can't, if it moves, it has to move 5 px a frame). Holding SHIFT can reduce the moving step but only so much. I think this is an unsolvable issue.
But there is a case that the game character feel really lagged and sways a lot around the cursor however you try, I saw that in Touhou 7. Installing Vsync Patch does fix that.

This is a limitation of how this tool hooks into the game's routine. Please avoid turning off ThMouseX while Steam Overlay is visible.

Please avoid lauching and exiting ThMouseX many times while the game is running.
So far I only see this bug on .NET Framework games and it's a rare bug. It may has something with the library Lib.Harmony which ThMouseX uses.

This tool uses various code injection techniques, so it's normal that some antivirus programs don't like it. You can verify the source code and build it on your own using the instructions above, or set an exception case in the antivirus program for ThMouseX (including the DLLs).

Old (pre-Steam) versions of Fantastic Danmaku Festival use .NET Framework 2, so normally this tool will not work because it uses .NET Framework 4. But you can force the game to use .NET Framework 4 by putting this text file to the same place with THMHJ.exe:

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
    <startup useLegacyV2RuntimeActivationPolicy="true"> 
        <supportedRuntime version="v4.0"/>
    </startup>
</configuration>

Ensure the name of this manifest file is THMHJ.exe.config, not THMHJ.txt or THMHJ.exe.config.txt.

This can also be applied to other applications that use .NET Framework 2/3.