Recoil

External Recoil Support

Recoil Output support was added to Sinden Driver Software in v2.08a (Released Sept2025) please ensure you are using the latest software Sinden Software

Release Note Extract Sinden Lightgun software can now read recoil outputs from MAME and DemulShooter using network outputs on port 8000. As DemulShooter is compatible with so many systems this gives wide coverage. SuperModel emulator is not yet integrated but should be added soon as it also has network outputs. Currently on Demulshooter I have only tested Model2, any quirks with other platforms should be easily solvable. Please note, if you have any instability this functionality is quite complex and would not be surprising if it causes some quirks, recreating issues and feeding back to contact@sindenlightgun.com would be appreciated. I will be creating more documentation on this and hopefully some videos after more testing and feedback. Please see ExternalRecoilOutputs.txt.

Using Recoil Support

Use Cases

1. If creating your own game or software tool, you can send TCP messages to the Sinden software. Please see RecoilTcpServerReadme.txt in the Sinden Windows folder for more information on this.
2. Talking direct to emulators or emulator tools. Please see ExternalRecoilOutputs.txt for more information on this.

Currently supported/tested emulators and tools are:

• MAME

• SuperModel3 - Untested but believe it works

• Demulshooter (covers many emulators)

• Hook Of The Reaper (covers many emulators)

Intro

What this means

Sindens are now capable of having the emulator and/or game control the speed and timing of the recoil if you happen to own a Sinden Recoil lightgun. While this allows the recoil to better match the game, this is also dependent on whether the game/emulator supports that functionality.

What's Needed

• Emulator/Program with Output support
  • MAME
  • DemulShooter
• Output Reading Software
  • MAME Hooker
  • QMameHook
  • Hook of the Reaper (HOTR)
  • OutputHooker
• Game Scripts/Settings

LUA Scripting

LUA Info

LUA is a programming language utilised by MAME/Model2Emu and other programs to add customization and functionality

• MAMEDev implementation
• lua.org

Why Gun Games Need LUA

As the light gun community is already aware, some MAME ROMs/games do not support native state output, which prevents tools like Mamehooker or Hook of The Reaper from understanding game events for force feedback (such as recoil or rumble). In these instances, LUA scripts are needed to enable state outputs (or enhanced state outputs with statistics/counters).

For example, most games will have a memory address for an ammo magazine that decreases with each shot fired, but if there is no ammo magazine in the game then the game logic may increase ammo values with every shot fired infinitely,
so simply changing AMMO_DIRECTION = "increase" will ensure the RECOIL logic correctly triggers in the correct ammo direction. Settings like this help to maximise compatibility across games with little effort being required by the end user in making things work, and will typically only require four key memory addresses:

• Credits
• Game Status* (fallback logic exists if this is missing)
• Ammo
• Life

Downloads and Links

Community LUA Scripts

Thankfully, Argon (Demulshooter dev) provided some sample Mame Model 2 LUA scripts so others could start creating their own LUA scripts and share with the community.

The below scripts are all based on the Mame Model 2 sample files originally provided by Argon (Demulshooter dev) and intended for use with HOTR. The included files are by Argon and FatherOfDucksAndMonkees plus updates to Area51 and Carnevil thanks to DiablosMatrix.

Release Notes These lua scripts aren't solely for HOTR so, if you have other lightguns and are already using something like MameHooker or QMameHook, then chances are they should also work with your setup with some minor tweaking.

There is a readme file in 2 of the archives so if you have questions please read them

LUA Scripts (Hosted by Thatman84)

djGLiTCH LUA Script Repo Project

Output Software

HOTR

Hook of the Reaper HomePage
Hook of the Reaper GitHub
Hook Of The Reaper Tutorial

QMAMEHook

QMAMEHook GitHub

OutputHooker

OutputHooker GitHub

MAME Hooker

MAME Hooker Web Site

MAME Hooker 5.1 Release 2014