⚔️ Erenshor SwingSync

Your hits land when your blade does. Removes the classic-MMO "server said you hit it half a second before your character swung" disconnect from Erenshor melee combat.

⏱️ 30 Seconds to Understand

Erenshor faithfully recreates 1999-era MMO combat, including the part where the "server" resolves your hit instantly while your character is still winding up the swing:

VANILLA:
  [attack round fires]
   ├─ damage number pops ──────────► you see "You hit Rat for 12!"
   ├─ combat log updates
   └─ swing animation STARTS ... ~0.5s later the blade finally connects (with nothing)

SWINGSYNC:
  [attack round fires]
   └─ swing animation STARTS
        ... windup ...
        └─ blade connects ─────────► damage number, log, sounds, flinch, all land HERE

Same damage, same DPS, same attack speed. Only the feedback timing moves.

✨ Key Features

🚀 Quick Start

1. Install BepInEx 5.4.23+ (64-bit) into your Erenshor folder
2. Download ErenshorSwingSync.zip from Releases
3. Extract into your Erenshor folder so it looks like this:

Erenshor/
├── BepInEx/
│   ├── core/
│   └── plugins/
│       └── ErenshorSwingSync.dll   ← the mod
├── Erenshor_Data/
├── Erenshor.exe
└── winhttp.dll                     ← from BepInEx

1. Launch the game. That's it. Swing at something and enjoy living in the present day.

🎛️ Configuration Reference

Config file is generated on first launch at Erenshor/BepInEx/config/com.blackhorse311.erenshor.swingsync.cfg. All values apply live, no restart needed.

💡 If impacts feel early or late for your weapon's animation, nudge SwingDelaySeconds by 0.05 until it feels right. BepInEx.ConfigurationManager (press F1 in game) makes this painless.

🧩 Compatibility

🔧 Troubleshooting

🛠️ Building from Source

Requirements: .NET SDK 8+, Erenshor installed, BepInEx 5.4.23+ installed into the game folder.

git clone https://github.com/Blackhorse311/ErenshorSwingSync.git
cd ErenshorSwingSync
dotnet build -c Release -p:GameDir="C:\Path\To\Steam\steamapps\common\Erenshor"

The build references Assembly-CSharp.dll and BepInEx assemblies from your game folder and copies the built DLL into BepInEx/plugins automatically (skipped gracefully if the folder doesn't exist).

🔒 Security & Compliance

• No game files are modified. All changes are runtime Harmony patches; removing the DLL restores 100% vanilla behavior
• No network calls, no telemetry, no data collection. The mod reads its config file and patches two game methods, nothing else
• No redistributed game code. This repository contains only original mod source
• AI collaboration disclosure: This mod was developed by Blackhorse311 in collaboration with Claude (Anthropic). All code was human-reviewed and play-tested before release

🙏 Credits

• Burgee Media for Erenshor, the single-player MMO we all wished for (go wishlist and buy it)
• BepInEx team for the plugin framework
• Blackhorse311 - author

Community Contributors

Your name here! PRs and well-described issues welcome.

📜 Changelog

1.1.1

• Fixed NPCs attacking many times per second during the sync window (the "grass spider machine gun"). Their attack-round timer is now set the moment their swing starts, exactly like vanilla

1.1.0

• NPCs and SimPlayers now sync their swings too, their hits on you land with their animations
• Their attack cadence is backdated after each deferred hit, so mob DPS is unchanged from vanilla
• Separate [NPCs] config section with its own toggle and delay

1.0.1

• Fixed every swing failing with an NRE when the game destroyed the mod's coroutine host mid-session (impacts now run on the game's own combat components)

1.0.0

• Initial release: player melee and mining swings sync with their animations

💬 Support

• 🐛 Report a bug
• 💡 Request a feature

Include your BepInEx/LogOutput.log with bug reports and I'll take a look!