What is going on here?

Here you can find out all the information about a lightgun 3d print for the Wii remote which works with the Lichtknarre software and how to use lenses with it. If you don’t know what Lichtknarre is, take a look here: 

https://geekonarium.de/en/lichtknarre-lightgun/

The Wii gun cradle for Lichtknarre is a 3D print and you can use it with the 4 and 2 LED tracker from Lichtknarre. If you don’t know what these trackers mean, have a look here:

https://geekonarium.de/en/lichtknarre-lightgun-wii-4-led-tracker-plugin/

https://geekonarium.de/en/lichtknarre-lightgun-wii-2-led-tracker-plugin/

Why not simply buy a guncradle?

This gun cradle is specially designed for Lichtknarre and has the following features:

• Complete casing of the Wii Remote. This is virtually invisible and does not need to be modified for 3D printing.
• Front attachments for lenses can be fitted to reduce the distance to the screen.
• Side buttons, which operate the A button, are built in for comfortable reloading during heated gaming sessions.
• Lockable opening for inserting the nunchuck.
• Matching holster for the gun cradle.
• Trigger mechanism with elastic band

Show me!

Beta!

This guncradle is currently still a beta release. There will certainly be a few updates here and there.

How do I build the 3D print?

https://geekonarium.de/en/lightgun-lichtknarre-lk-11-c-gunshell-build-guide
(Download inclusive)

How do I use the Wii with the gun cradle?

Simply remove the two rear latches and take off the top cover. Then push the Wii remote in from behind.

Show process here as gif or video

How does it work with the lenses?

The first step is to buy lenses. Standard smartphone lenses are used for this.

You find them all over online marked places! 0.67 wide lens is preferred.

At this point, you should already know which tracker plugin you are working with in Lichtknarre. To mount the lenses, refer to the gun cradle assembly instructions for Lichtknarre:

https://geekonarium.de/en/lightgun-lichtknarre-lk-11-c-gunshell-for-3d-printing
(Download inclusive)

Calibration of the lenses with the 2 LED Tracker plugin

After you have fitted the lenses and calibrated the 2 LED tracker without the lens attachment, you will notice that the 2 LED no longer aims accurately. However, when you remove the lens again, everything is as before. This is due to the following setting:

The default lens scaling factor of the Wii is 2.16. Currently you can only use wide angle lenses. Fisheye or other lens types do not currently work.

Currently there is only a try and error method to find out the lens scaling factor. For this you always change the lens scaling factor by the trial value of 0.4 into the negative, because when you add a lens it goes more into the negative of the default value of 2.16 of the lens scaling factor and aim with the Wii at the screen from far away and close to it and in between. With each distance processing you also try to aim at the sides. If it has improved, you follow the direction, otherwise you invest the direction of the trial value. If the mouse no longer moves at all distances, you have found the right factor. Of course, you can also use smaller trial values for fine-tuning.

Since only the standard smartphone lens is actually used here, which has a magnification of 0.67, the lens scaling factor of 2.203 can be entered. Of course, it is possible that the lenses from different suppliers were not manufactured as consistently as the lens from the Wii camera and therefore differ more from each other. Spacing or other irregularities can contribute to this. This means that you can rely more on the default value without the lens than my value for the 0.67 lens. It would therefore be advisable to try a little more to see if everything fits with the lens scaling factor of 2.203 using the try and error method.

The lens may be at a different distance from the Wii camera, or other factors may cause the value to be slightly different.

The whole logic can still change here, as this topic is still under development.

Calibration of the lenses with the 4 LED Tracker plugin

The 4 LED Tracker plugin does not currently support a lens attachment. However, as the position here is more absolute, there may also be improvements if the lens attachment is fitted. However, the lens will be included in the tracking in future to improve the aiming accuracy. The lens factor setting will therefore be available. The calibration instructions will follow.

What is going on here?

Here you can find out all the information on how to build the Wii gun cradle for Lichtknarre. If you don’t know what Lichtknarre is, take a look here: 

https://geekonarium.de/en/lichtknarre-lightgun/

The Wii gun shell for Lichtknarre is a 3D print and you can use it with the 4 and 2 LED tracker from Lichtknarre. If you don’t know what these trackers mean, have a look here:

https://geekonarium.de/en/lichtknarre-lightgun-wii-4-led-tracker-plugin/

https://geekonarium.de/en/lichtknarre-lightgun-wii-2-led-tracker-plugin/

You can find more information about the gun cradle for Lichtknarre here:

https://geekonarium.de/en/lightgun-lichtknarre-lk-11-c-gunshell-for-3d-printing

What does the end product look like?

What do I need for this?

Foreword

As there are many 3D printers, materials and software out there, I can only speak from my own experience here and illustrate as best I can the building process I used. Try to stick to the specifications as much as possible. Various skills are required for this project. Of course, it is also good for beginners to implement projects that they have no experience with in order to learn. However, this requires more patience.

It also shows how to remove the support material and place the models in the 3D printer. This can of course be different on other devices.

Download

First, download the 3D print files.

3D printer specifications

Nozzle: 0.4mm

Optional:
Heated bed, enclosure

Default Cura Settings

• Overhang Angle: 65°
• Infill-Patterns: Lines
• Infill: 60%
• Slicing Tolerance: middle
• Print-Sequence: One at the time
• Wall Line Count: 3

Material

PLA+ is used for stability. Harder materials can also be used. I have no experience with resin printers. Not all components necessarily need PLA+, so these are marked again, which definitely need PLA+. Some of the parts are very delicate and must therefore be printed with PLA+ so that they have enough strength and do not bend or break.

Preparation

• It’s best to watch a few tutorials before you start:
  • https://www.youtube.com/watch?v=FfiQLWprcIU&list=PLdpISe6Jsxe7k82SDt92W1PPO2VbVhyKX&ab_channel=PushingPlastic
• https://teachingtechyt.github.io/calibration.html

Tools

Saw, pliers, pump pliers, sturdy slotted screwdriver, screw clamp, hammer, superglue

What do I need to buy?

• Magnets: 6mm x 3mm (6 holes = 2 for the gun holster and 4 for the guncradle)
• Filament: PETG, PLA+
• Lenses. More infos here: https://geekonarium.de/en/lightgun-lichtknarre-lk-11-c-gunshell-for-3d-printing

Tests

Before you start 3D printing the guncradle, you should complete the following test print:

Temperature Tower

Please do your research.

https://www.youtube.com/results?search_query=temp+tower+3d+print

Stringing Test

Please do your research.

https://www.youtube.com/results?search_query=String+test+3d+print

Accuracy Test

https://www.thingiverse.com/thing:2484766

Try to stay within the tolerance of 0.2mm. Once you have achieved this, you should have no problems printing the gun cradle. Please calibrate with the same PLA+ or other materials you want to print with.

Clean up philosophy for support material

When it comes out of the 3D printer, only the support material needs to be removed properly. This must be done properly, otherwise certain mechanisms cannot function. Sanding or edges actually have to be reworked. 

Nevertheless, for some components I point out how I have corrected certain things or removed the support material. This can be different for every printer. I will not explain every detail, which is self-explanatory.

It would also be good to have some masking tape on hand to protect against scratches before removing support material.

Placement

Pay close attention to the images when placing them. If the undersides of certain models are not placed correctly, some mechanisms may not work or certain things may not fit together. The blue marker in Cura identifies how much of a surface is flat on the print bed. Activate the Snap Rotate option in Cura. This will help you with the placement. 

The placements are chosen so that the support material can be easily removed without breaking the 3D print. 

The best is to print directly on the printer bed, because this gives a better look for the surfaces. If you print extra support material under the parts, this can lead to breakage during removal or other problems.

Magnets/Pins

Some parts can be fitted with magnets or pins. Some parts you can use Magnets or Pins and for some parts you only can use Pins. This will be indicated in the assembly section.

3D printing process

Once everything has been set up correctly and all preparations have been completed, 3D printing can now begin. If no special specifications are made, the placement can be taken from the images or the default settings for Cura can be used. I would recommend printing in exactly the same order as described in the tutorial, as you can then assemble everything on the side. Try to replicate the placement shown in the pictures. This is very important to avoid deformation. In addition, the placements are chosen so that the surfaces look as good as possible.

Let’s go!

Top/bottom plate

Files

• ButtonCoverUpper.stl
• ButtonCoverLower.stl

Special Cura settings
Infill: 100%

Material
PLA+

Placement
Make sure that everything lies flat on the print bed.

For ButtonCoverUpper.stl, when finished printing, there should be four hole indentations as below.  If the holes aren’t showing, you may have included an unwanted support layer in those locations.  You could grab a small screwdriver/x-acto knife to remove excess material, or re-print without support in those locations.

Side A-Button-Blends

Files

• ButtonCoverUpperLeftBlend.stl
• ButtonCoverUpperRightBlend.stl

Special Cura-settings
Infill: 100%

Material
PLA+

Placement
Make sure that everything lies flat on the print bed.

Side A buttons

Files

• ButtonALeft.stl
• ButtonARight.stl

Special Cura-Settings
Infill: 100%

Material
PLA+

Placement
Make sure that everything lies flat on the print bed, as shown in the picture.

Remove support material
Use the snipping pliers to cut exactly where the blue lines are in the picture. This helps to remove the support material so that the pins bend. Do not cut too deep.

More Infos in the remove support-material section of this tutorial! Videos etc.

Make sure that there is no material residue on the pins. Sand smooth if necessary, otherwise the click mechanism will not work properly. However, do not remove too much material and do not bend the pins.

Button A

Files

• ButtonA.stl

Special Cura-Settings
Infill: 100%

Placement
Make sure that everything lies flat on the print bed, as shown in the picture.

All Other Buttons Corresponding to Wiimote

Files

• Buttons folder/STL’s except those already printed ie everything except ButtonA.stl, ButtonALeft.stl & ButtonARight.stl

Special Cura-Settings
Infill: 100%

Placement
Make sure that everything is flat on the print bed, as in picture 2. Labels from the buttons must be facing down. Make sure that the areas are marked in blue when the label sides are on the print bed. Place the buttons far enough apart so that the print head does not interfere with the others. Drag each button individually into Cura, so you can make sure that one button is printed after the other if you have set the “Print Sequence” setting to “One at the time”. Whenever you import a new button into Cura, it will be printed next.

Remove support material
Buttons can have excess material on the pin, which can either be filed off or pressed together with pliers until it fits into the hole.

More Infos in the remove support-material section of this tutorial! Videos etc.

Start assembling your finished prints while printing what’s left below
Now that you’ve finished the above prints, you can assemble the button cover while waiting for the other big pieces to print below. Refer to the last page of this doc with the “Assembly” video from 00:39 to 1:03 minutes to follow the assembly of the button cover.  Slow the video down if necessary to pinpoint the pieces you have already printed. When placing wiimote button prints in their respective holes, be careful not to confuse wiimote button 1 and 2 since they look really similar. Online search a wiimote button layout to know which button goes where.

Gun case

Files

• GunCase.stl

Infill
100 %

Placement
Make sure that everything lies flat on the print bed, as shown in the picture.

Remove support material
Saw into the support material where it is marked in the picture. You can then use the pump pliers to break out part of the support material. Then take a slotted screwdriver and hammer the support material down to where the green line is marked in the picture. You can repeat the process until all the support material has been removed. Be careful and do not cut into the gun case.

More Infos in the remove support-material section of this tutorial! Videos etc.

Back-Covers

Files

• BackCover.stl
• BackCoverNunChuck.stl

Placement
Make sure that everything lies flat on the print bed, as shown in the picture.

Back-Covers-Lock

Files

• BackCoverLock.stl

Special Cura-Settings
Infill: 100%

Placement

Front-Addon

Files

• FrontAddon.stl
• FrontAddonLens.stl

Placement

Remove support material
Clamp the lens add-on in a screw clamp and tap with a screwdriver and hammer exactly where the blue lines are on the picture. Do not use too much force and tap several times until the support comes off.

Pins

Files

• MagnetPin.stl

Special Cura-Settings

Infill: 100%

Placement

Info

If you don’t want to equip everything with magnets, you can print 2 pins (CHECK THIS) that can be glued in as an alternative. Take a look at the assembly video on the last page to see where magnets can be omitted and substituted with said pins.

LINK

Trigger: Finger trigger

Files

• TriggerFinger.stl

Special Cura-Settings

Infill: 100%

Placement

Trigger: Slide

Files

• TriggerSlider.stl

Special Cura-Settings

Infill: 100%

Placement

Trigger: Rubber-Band holder

Files

• TriggerRubberMount.stl

Special Cura-Settings

Infill: 100%
Support-Angle: 40°

Placement

Grip

Files

• GunHandle.stl

Special Cura-Settings

Infill: 100%

Placement

Grip mounting bar

Files

• GunHandle.stl

Special Cura-Settings

Infill: 100%

Material

PLA+

Placement

Holster

Files

• look holster folder

Special Cura-Settings

Infill: 80%

Placement

Remove Support

Here some tips for support removal:

Gun Case

Beware how deep you cut.

Side A Button

To cut the sides helps you to remove the support material without bending the joints.

Lens addon

Assembly

The following video should be watched repeatedly at .50% speed to understand how to assemble all your prints together.  Tip: Be mindful of glue application and dry times, especially the finger trigger that could get stuck instead of sliding along the barrel. For the rubber band, any thin rubber should work and can be tied to size.

Aftermath

At the beginning the parts will be a little tight and the buttons will squeak. After a while, however, this will no longer be the case, the more you use the guncradle. If the buttons do not stop squeaking, you should sand them again till they fit without problems.

What is going on here?

Here you can learn how to configure “Lichtknarre”-Lightgun-tool for Dolphin- and Mame-emulator by using the ViGEm-connector-plugin. In theory you could also use the mouse connector-plugin, but than mutible lightguns are not possible.

If you dont know what “Lichtknarre”-Lightgun is check this out:

https://geekonarium.de/en/lightgun-lichtknarre-for-the-wii-remote-on-your-pc-computer/

Install and configure ViGem driver

Download and Install: https://github.com/nefarius/ViGEmBus/releases

Update: ViGEm installer is now in the setup routine of Lichtknarre.

The ViGEm driver does not require a test mode from windows for installation, as it is certified by microsoft. This driver allows Lightgun to create and destroy virtual Xbox gamepad devices. It’s like plugging an Xbox gamepad into your PC.

You can use as many gamepad you like. Lichtknarre will send the input to these devices so the emulator can pick them up.

Select plugin

Select the ViGEm plugin for the player and its assigned device, which should send the data to the ViGEm gamepad. The first player/device sends to the first ViGEm gamepad and the second to the second gamepad and so on.

• player1 > ViGEm connector plugin > ViGEm virtual gamepad 1 > emulator has to use virtual ViGEm gamepad 1
• player2 > ViGEm connector plugin > ViGEm virtual gamepad 2 > emulator has to use virtual ViGEm gamepad 2
• p3
• p4
• etc…

If you connect Wii Remote you will see an xBox gamepad appears in joy.cpl in windows configuration.

win > run > Enter: joy.cpl > hit enter

-or-

Use the button in Lichtknarre to show joy.cpl. 

Emulator configurations

If you are interested in adding a tutorial here, just post a link in the comments, write an email (imprint) or come to discord.

Dolphin 4

For Dolphin, you can configure the buttons normally by using the player assigned device.  To do this, select the ViGEm virtual gamepad for the associated player.

(pic is outdated, use virtual xbox gamepad)

To transfer the input from the lightgun to the axes of the virtual ViGEm gamepad into Dolphin, you have to configure the “up”, “down”, “left”, “right” dialogue manually. For this use right click on the buttons and search for “Axis X- X+ Y- Y+” and configure it like in the picture.

Make sure you strech the picture over your full screen else it is not pixel perfect targeting because the software things you use the full screen and the emulator only uses a part of the screen because maybe the game is in 4:3. 

Please read this for more infos: https://geekonarium.de/en/what-is-ir-offset-and-why-do-i-need-it/

rumble feedback

The best way is to use `Motor L“Motor R` rumble effect in Dolphin. Don’t forget to activate rumble in connector plugin settings “use rumble of connected process”.

You can find settings here:

https://geekonarium.de/en/vigem-lightgun-emulator-configuration#helpTools

Here an full example to configure native rumble feedback:

Use the right connector-plugin and controller. May be not the same.

Dolphin 5

Lichtknarre is now compatible with Dolphin 5. Injecting a hook into Dolphin to filter out real wii remotes so that they can be used by Lichtknarre. For this, however, some settings must be made in Dolphin 5:

Mame

Mame is not that easy. First configure the global config like this:

Make sure all the games uses the global configuration. By resetting the game configuration.

Afterwards start the game and configure the lightgun and the keys.

Press Tab > Enter “input (general)” > enter “player 1 controls” > scroll to Lightgun settings and configure by pressing enter.

Now goto mame.ini in your Mame folder and change the following values to the following values:

joystick_deadzone 0
joystick_saturation 1

You may also want to try out the lowlatency setting:

https://docs.mamedev.org/commandline/commandline-all.html?highlight=latency#core-performance-options

Happy playing!

You have to move the wiiremote horizontal when configuring “Lightgun X Analog” and move vertical when configure “Lightgun Y Analog”.

By hitting esc you can return to the game. But dont forget to configure the keys for coins and start by using the wii remote. You can do all this configuration for other players also.

Make sure you strech the picture over the full screen, because else the iron sight accuracy is lost. The game could be in 4:3 ratio and your screen is 16:9. For more Infos please read here: https://geekonarium.de/en/what-is-ir-offset-and-why-do-i-need-it/

Sometimes mame has problems with mouse and joystick performance. That is why I will make the input per second configurable for the ViGEm plugin in the Lichtknarre software.

You will then be able to configure it here:

Now your able to configure all the Buttons you need. Here is how i configured my Buttons with ViGEm connector:

It is very basic and you shall better include this into your actual config than override.
The configuration is located in “mame folder/cfg/default.cfg”

RetroArch

ViGEm connector plugin settings

Use ?-Buttons in the Settings to get more infos. We will only highlight important settings here, because with new version these infos are outdated very soon.

You have to set every option for play individual for every player.

Known Bugs:

• Settings has wrong labeling. It still shows vjoy labeling. But it is ViGEM labeling. This bug is because of copy pasting the Form. (fixed in 0.9.11.25-rev1)
• ViGEm Home-Buttons Feature from settings was broken. (fixed in 0.9.11.25-rev2)

see changelog: https://geekonarium.de/en/download-changelog-lightgun-lichtknarre-wiimote-line-of-sight-pc-windows/#changelog

rumble feedback

You have the option of accessing the rumble feedback from the third party tool (emulator, etc.) in the settings or having Lichtknarre trigger the rumble feedback yourself when you click on a button.

possible rumble options:

• use rumble of connected process (programm which uses vigem controller)
• rumbleA
• rumbleB

keyschemas

Can help you with calibration of the emulator if you have trouble configure the third party process (emulator). Or in other scenarios.

Lookup ?-Button for Keyschemas to get more Details.

more Tips

• Try to disable Bad-LED mode and interpolation if you want to play with this tool. Depends on the capability of your local setup.
• If you have a real Xbox controller plugged in, there could be conflicts because ViGem emulates Xbox controllers.
• Sometimes windows game controller calibration could be messed up. This is a very rare problem so go for it as last resort. In windows game controller panel you can find an calibration button under details of the device.
• If you need mutible settingsprofiles you can copy paste the Lichtknarre-Folder. Lichtknarre saves the settings in it own folder. Maybe you need for one application viGem and for another vJoy. In Future there will be a profile-feature.
• If your aim is inverted try this option:
  
   

user Tutorials

a list of tutorials made by users:

• Discussion and forum-thread by arcadecontrols.com. In this thread you can find a lot of informations/usertutorials. Keep in mind, that i only can link to one example here. So trace around:
  https://forum.arcadecontrols.com/index.php/topic,167028.msg1775470.html#msg1775470

known problems

• XBox-Gamepad translates to WASD-Keys in Steam-Apps. You can disable this. find Tutorial on the internet and post it here as comment.
• XBox-Gamepad translates to WASD-Keys for UWP-Apps. You can disable this. find Tutorial on the internet and post it here as comment.

submit your tutorial

Since I cannot test all emulators or third-party tools, you can send your tutorial to the following e-mail address and I will publish it on this website under your name:

Please use Google Docs or something similar, as I will not open any strange files.

Also:
If you have a 3D Printer and it is calibrated with the following Tutorial and you want to help me to finnish a project please contact me!

https://teachingtechyt.github.io/calibration.html

What is going on here?

Here you will learn all the information about the Lichtknarre common abilitys.

If you dont know what “Lichtknarre”-Lightgun is check this out:

https://geekonarium.de/en/lightgun-lichtknarre-for-the-wii-remote-on-your-pc-computer/

How to use commandline

There are detailed explanations of all commands with the command on cmd:

Lichtknarre.exe --help

Lichtknarre - help
##################

You can use Lichtknarre.exe even if it is already running and executed.
Thanks to the IPC communication the commands are always sent to the main
process. But only 1 command can be executed every 5 seconds.

 Keep the numerical limits of the commands otherwise this could lead to crashes.
If you have misconfigured reinstall the application or delete all ini files from
the folder.

# List of all commands from the Lichtknarre main program:

    > set connectorplugin {player index} {connector plug identifier}
  Explaination: set connector plugin for player
  Example: Lichtknarre.exe --set connectorplugin 1 mouseConnector
  Possible connector plugin identifiers: vJoy2Connector, mouseConnector
  playerindex begins at 1
  You can only edit players which are available in the tool.

# List of all commands from all Connector Plugins:

    > mouseConnector adjustAxisForPlayer {playerIndex} {adjustX} {adjustY}
     Explaination: Set adjust X,Y for player.
     Example: Lichtknarre.exe --mouseConnector adjustAxisForPlayer 1 -1.3 2.5
     playerindex begins at 1
     You can only edit players which are available in the tool.
     Floating values are with dot format. Maximal value:200 Minimal value:200

    > vigemConnector adjustAxisForPlayer {playerIndex} {adjustX} {adjustY}
     Explaination: Set adjust X,Y for player.
     Example: Lichtknarre.exe --vigemConnector adjustAxisForPlayer 1 -1.3 2.5
     playerindex begins at 1
     You can only edit players which are available in the tool.
     Floating values are with dot format. Maximal value:200 Minimal value:200

    > vjoyConnector adjustAxisForPlayer {playerIndex} {adjustX} {adjustY}
     Explaination: Set adjust X,Y for player.
     Example: Lichtknarre.exe --vjoyConnector adjustAxisForPlayer 1 -1.3 2.5
     playerindex begins at 1
     You can only edit players which are available in the tool.
     Floating values are with dot format. Maximal value:200 Minimal value:200

# List of all commands from all Tracker Plugins:

    > wii4LEDTracker set defaultIrGameOffset {Left Offset} {Right Offset} {Top Offset} {Bottom Offset}
     Explaination: set default IR game offset for Wii 4 LED tracking system
     Example: Lichtknarre.exe --wii4LEDTracker set defaultIrGameOffset 1.2 1.5 2.3 1.2
     Floating values are with dot format. Maximal value:40 Minimal value:-40

   > wii2LEDTracker set defaultIrGameOffset {Left Offset} {Right Offset} {Top Offset} {Bottom Offset}
     Explaination: set default IR game offset for Wii 2 LED tracking system
     Example: Lichtknarre.exe --wii2LEDTracker set defaultIrGameOffset 1.2 1.5 2.3 1.2
     Floating values are with dot format. Maximal value:120 Minimal value:-20

The following article is about the nuts and bolts of using the command line with Lichtknarre. This includes the following topics:

interprocess communication

Thanks to interprocess communication, you can send commands even when the Lichtknarre is already running. The command is then sent to the already running process and the current process gets the answers from the main process printed on the command line.

administrator UAC prompt

The UAC query will appear every time the commandline is called. Currently there are only two real ways to deal with this. Confirm the prompt or disable UAC. There alot of tutorials out there to deactivate UAC. But be careful, because your computer will be vulnerable. This is more suitable for people with arcade machines, which have only this one task.

If wanted I could write another seperates commandline tool, which needs less rights and sends Lichtknarre.exe the command after starting Lichtknarre. Please write me in the comments. If you know another solution please also write to me in the comments. Thanks in advance.

value limits

In the first versions there will surely be errors with the new commandline feature. therefore pay attention to the numerical limits in the description of the commands. If you exceed these on purpose it can lead to crashes. If this happens reinstall lightbar or delete all ini files from the installation folder.

Whats going on here?

Here you will learn all the information about the Lichtknarre – Wii 2 LED tracker plugin. If you don’t know what Lichtknarre is, then look here: https://geekonarium.de/en/lichtknarre-lightgun/

The Wii 2 LED Tracker Plugin lets you play with 2 LEDs and the Wii remote with the accuracy of a rear sight.

Show me!

Features

• Only needs to be calibrated once in theory.
• The user can move to a certain degree. It is not necessary to stand exactly in the spot where the calibration was made.
• Wii controllers can be quickly connected without the need for Windows menus.
• Easy to use with other games through vjoy2- or mouse-plugin.
• Yes you can rotate the Wii controller. With no adjustment time. 180° is possible
• The gun needs to be 2.3 – 2.5 times as far away as the display is wide.

Getting started

Follow this Step by Step Guide: https://www.instructables.com/Wii-Remote-As-Lightgun-With-Iron-Sight-Line-of-Sig/

Come back for troubleshooting.

Everything else you need to know

Lightgun Lichtknarre > LEDs building

Lightgun Lichtknarre > What is IR Offset and why do I need it?

Lightgun Lichtknarre > Configure Lichtknarre Lightgun for Dolphin and Mame

Troubleshooting

More troubleshooting

For more troubleshooting guide look at the 4 LED-Tracker troubleshooting guide, because i didn’t had time to finnish this guide here. But its very similiar.

Lichtknarre > Wii 4 LED Tracker plugin

What’s going on here?

Here you can learn about the Lichtknarre plug-in system. 

If you dont know what “Lichtknarre”-Lightgun is check this out:

https://geekonarium.de/en/lichtknarre-lightgun/

What is the Lichtknarre plugin-in system?

The Lichtknarre plugin system makes the software modular so that it can communicate with emulators/games and devices. Here we distinguish between two types of plugins. Connector plugin and tracker plugin. Tracker plugins are responsible for the devices and connector plugins for the games/emulators. Lichtknarre do the playermanagement inbetween and much more.

See Pipeline

The communication is standardised by the Lichtknarre app between connector and tracker plugins.

vjoy – connectorplugin

The vjoy connector plugin sends data to the vjoy software which can be downloaded here: https://sourceforge.net/projects/vjoystick/. In this case the emulator thinks the inputs comes from game controllers.

mouse – connectorplugin

The mouse connector plugin sends data to the windows mouse api.

wii 2 LED – tracker plugin

Tracks data from the wii device and do position calculation for 2 LEDs and send it to the Lichtknarre-Software.

wii 4 LED – tracker plugin

Tracks data from the wii device and do position calculation for 2 LEDs and send it to the Lichtknarre-Software.

programm it yourself

You can also programme a connector or a tracker plugin yourself. Have a look at the Github pages for this:

Maybe for your next Unity game?

(At the moment sources are not up to date on github. Please be patient. Soon working pipeline will be created etc. Come to discord if your developer

dev community

Read tutorials before asking questions! This is only for developers and not for support. Read website or write questions on the website.

You can also ask your questions in this forum: https://forum.arcadecontrols.com/index.php/topic,167028.0.html

What’s going on here?

Here you can learn what the IR-offset configuration for the “Lichtknarre”-Lightgun-tool is.

If you dont know what “Lichtknarre”-Lightgun is check this out:

https://geekonarium.de/en/lightgun-lichtknarre-for-the-wii-remote-on-your-pc-computer/

What is the IR-offset configuration?

The IR Offset configuration allows you to set the distance of the infrared lights from the edge of the screen or the edge of the game. If you want to use the software with more than one game, you should therefore set the IR offset to the edge of the screen and always play the games in stretched full screen mode.

The Software can’t know how much distance the IRs have to the screen/game, thats why it is configurable.

Visual examples for IR offsets:

Example 1

Here you can see offset from the screen and the offset from the game.

Example calculation for right offset:

Full width = 40cm
right screen offset width = 1cm
right game offset width = 3cm

right offset: (40cm / 100) * (1cm + 3cm) = 1,6% 

same calculations can be used for left/top/bottm.

How IR calibration works?

When you do the IR-offset calibration in the program, the program assumes that your games are all played in stretched full screen mode. If this is not the case, you must adjust the offset manually. Try and error.

The calibration in the programme is not perfect either. It is best to validate your values again with the mouse plug-in and adjust them if necessary. Test decrease and increase the values step by step.

Enter the values manually

You can do the calculations from the example1 or try and error based on the calibration with the following dialogs:

The values from the example1 must be entered in the right textbox, because we calculated right offset. You can apply this calculation also for left, top, bottom.

If you want to start the calibration hit the calibration-wizard dialog.

What is going on here?

Here you can learn how to configure “Lichtknarre”-Lightgun-tool for Dolphin- and Mame-emulator by using the vJoy connector-plugin. In theory you could also use the mouse connector-plugin, but than mutible lightguns are not possible.

If you dont know what “Lichtknarre”-Lightgun is check this out:

https://geekonarium.de/en/lightgun-lichtknarre-for-the-wii-remote-on-your-pc-computer/

Install and configure vJoy

Download and Install: http://vjoystick.sourceforge.net/

Update: vJoy is now in the setup routine of Lichtknarre.

I tested it with v2.

Use following configuration:

Compare exactly the settings of the picture to your settings.

You can use as many joysticks you like. Lichtknarre will send the input to these devices.

Select plugin

Select the vjoy plugin for the player and its assigned device, which should send the data to the vJoy2 controller. The first player/device sends to the first vjoy controller and the second to the second controller and so on.

• player1 > vjoy connector plugin > vjoy virtual controller 1 > emulator has to use virtual vjoy controller1
• player2 > vjoy connector plugin > vjoy virtual controller 2 > emulator has to use virtual vjoy controller2
• p3
• p4
• etc…

Every virtual vjoy controller has to be activated in vjoy configurator.

You can check your controller in joy.cpl in windows configuration.

win > run > Enter: joy.cpl > hit enter

-or-

Use the button in Lichtknarre to show joy.cpl. 

Emulator configurations

If you are interested in adding a tutorial here, just post a link in the comments, write an email (imprint) or come to discord.

Dolphin 4

For Dolphin, you can configure the buttons normally by using the controller. The Nunchuck is also supported. To do this, select the vjoy controller for the associated player.

To transfer the input from the lightgun to the axes of the vjoy2 controller into Dolphin, you have to configure the “up”, “down”, “left”, “right” dialogue manually. For this use right click on the buttons and search for “Axis X- X+ Y- Y+” and configure it like in the picture.

Make sure you strech the picture over your full screen else it is not pixel perfect targeting because the software things you use the full screen and the emulator only uses a part of the screen because maybe the game is in 4:3. 

Please read this for more infos: https://geekonarium.de/en/what-is-ir-offset-and-why-do-i-need-it/

rumble feedback

The best way is to use `constant` rumble effect in Dolphin. Don’t forget to activate rumble in connector plugin settings “use rumble of connected process”.

You can find settings here:

https://geekonarium.de/en/vjoy-lightgun-emulator-configuration/#helpTools

Here an full example to configure native rumble feedback:

Use the right connector-plugin and controller. May be not the same.

Dolphin 5

Lichtknarre is now compatible with Dolphin 5. Injecting a hook into Dolphin to filter out real wii remotes so that they can be used by Lichtknarre. For this, however, some settings must be made in Dolphin 5:

Mame

Mame is not that easy. First configure the global config like this:

Make sure all the games uses the global configuration. By resetting the game configuration.

Afterwards start the game and configure the lightgun and the keys.

Press Tab > Enter “input (general)” > enter “player 1 controls” > scroll to Lightgun settings and configure by pressing enter.

Now goto mame.ini in your Mame folder and change the following values to the following values:

joystick_deadzone 0
joystick_saturation 1

You may also want to try out the lowlatency setting:

https://docs.mamedev.org/commandline/commandline-all.html?highlight=latency#core-performance-options

Happy playing!

You have to move the wiiremote horizontal when configuring “Lightgun X Analog” and move vertical when configure “Lightgun Y Analog”.

By hitting esc you can return to the game. But dont forget to configure the keys for coins and start by using the wii remote. You can do all this configuration for other players also.

Make sure you strech the picture over the full screen, because else the iron sight accuracy is lost. The game could be in 4:3 ratio and your screen is 16:9. For more Infos please read here: https://geekonarium.de/en/what-is-ir-offset-and-why-do-i-need-it/

Sometimes mame has problems with mouse and joystick performance. That is why I will make the input per second configurable for the vJoy plugin in the Lichtknarre software.

You will then be able to configure it here:

Now your able to configure all the Buttons you need. Here is how i configured my Buttons with vJoy2 connector:

It is very basic and you shall better include this into your actual config than override.
The configuration is located in “mame folder/cfg/default.cfg”

vJoy connector plugin settings

(pic is outdated. use vjoy instead)

Use ?-Buttons in the Settings to get more infos. We will only highlight important settings here, because with new version these infos are outdated very soon.

You have to set every option for play individual for every player.

rumble feedback

You have the option of accessing the rumble feedback from the third party tool (emulator, etc.) in the settings or having Lichtknarre trigger the rumble feedback yourself when you click on a button.

possible rumble options:

• use rumble of connected process (programm which uses vigem controller)
• rumbleA
• rumbleB

keyschemas

Can help you with calibration of the emulator if you have trouble configure the third party process (emulator). Or in other scenarios.

Lookup ?-Button for Keyschemas to get more Details.

more Tips

• Try to disable Bad-LED mode and interpolation if you want to play with this tool. Depends on the capability of your local setup.
• If your aim is inverted try this option:
  
   
• If you need mutible settingsprofiles you can copy paste the Lichtknarre-Folder. Lichtknarre saves the settings in it own folder. Maybe you need for one application viGem and for another vJoy. In Future there will be a profile-feature.

user Tutorials

a list of tutorials made by users:

• Discussion and forum-thread by arcadecontrols.com. In this thread you can find a lot of informations/usertutorials. Keep in mind, that i only can link to one example here. So trace around:
  https://forum.arcadecontrols.com/index.php/topic,167028.msg1775470.html#msg1775470

submit your tutorial

Since I cannot test all emulators or third-party tools, you can send your tutorial to the following e-mail address and I will publish it on this website under your name:

Please use Google Docs or something similar, as I will not open any strange files.

Also:
If you have a 3D Printer and it is calibrated with the following Tutorial and you want to help me to finnish a project please contact me!

https://teachingtechyt.github.io/calibration.html

Whats going on here?

Here you will learn all the information about the Lichtknarre – Wii 4 LED tracker plugin. If you don’t know what Lichtknarre is, then look here: https://geekonarium.de/en/lichtknarre-lightgun/

The Wii 4 LED Tracker Plugin lets you play with 4 LEDs and the Wii remote with the accuracy of a rear sight.

Show me!

Features

• Only needs to be calibrated once in theory.
• The user can move to a certain degree. It is not necessary to stand exactly in the spot where the calibration was made.
• Wii controllers can be quickly connected without the need for Windows menus.
• Easy to use with other games through vjoy2- or mouse-plugin.
• Yes you can rotate the Wii controller. It takes about 1 second for the programme to readjust. But this is actually no problem in use.
• The gun only needs to be 1.3 – 1.5 times as far away as the display is wide.

Getting started

Follow this Step by Step Guide: https://www.instructables.com/Wii-Remote-As-Lightgun-With-Iron-Sight-Accuracy/

Come back for troubleshooting.

Everything else you need to know

Lightgun Lichtknarre > LEDs building

Lightgun Lichtknarre > What is IR Offset and why do I need it?

Lightgun Lichtknarre > Configure Lichtknarre Lightgun for Dolphin and Mame

Troubleshooting

Problems:

1. Update your Windows! Windows 10 has several Bluetooth Updates. Look here:
   • https://support.microsoft.com/en-gb/topic/september-1-2021-kb5005101-os-builds-19041-1202-19042-1202-and-19043-1202-preview-82a50f27-a56f-4212-96ce-1554e8058dc1
   • https://www.catalog.update.microsoft.com/Search.aspx?q=KB5005101
2. The special -TR version atm not working: https://wiki.dolphin-emu.org/index.php?title=Wii_Remote_Plus_(RVL-CNT-01-TR)_Connection_Guide
   1. There are wii motion plus remotes with TR and no TR.
3. The wiiremote does not want to connect.
   1. Make sure your Windows-OS is up to date.
      1. If not make sure the bluetooth driver are installed in a correct way.
   2. Make sure your wii is off and than hold 1 and 2 till it is listed. Wait 10 seconds if you accendantly hit another button or do not hold 1 and 2 simultan.
   3. See solution 5
   4. See solution 6
   5. Disconnect Mayflash Dolphin-Bar. Make sure your PC only have one bluetooth-radio. Restart your computer and try again. 
      (I want to have MayFlash Dolphin-Bar support in future as an alternative more worse position recognition, but also with iron sight accuracy.)
   6. Some antivirus software do not allow the Lichtknarre-tool to use bluetooth by default. Maybe Windows Defender. You have to configure the antivirus software that it allows the tool to use bluetooth.
4. My LEDs jump in the preview or flickers.
   1. see solution 1
   2. Configure IR sensitivity settings. Maybe to max.
   3. Use the BAD-LED mode which is available since 0.9.8.
   4. Your LEDs are too weak or have a limited glowing angle. Consider to build the LEDs from out tutorial: https://geekonarium.de/en/lightgun-lichtknarre-leds-building/
5. The cursor jumps back and forth.
   1. see solution 1 and 2
6. My cursor jumps across the screen in a kind of grid.
   1. see solution 3
7. The cursor moves too slowly.
   
   1. see solution 4
8. When I connect my Nunchuck, the programme crashes.
   1. First connect the Nunchuck and start the programme.
9. If I connect more than one Nunchuck, the programme crashes.
   1. This will hopefully be fixed in the next version.
10. My cursor moves with an offset
    1. lookup this configuration: https://geekonarium.de/en/what-is-ir-offset-and-why-do-i-need-it/
    2. If you use vjoy2 plugin and the offset is only in the emulator, than its because of the emulator/game configuration. Please check mouse plugin without emulator/game if this happens also.

Possible solutions:

1. You have other light sources around the screen.
   These must be eliminated. Even if you think there are none, there may be some due to reflections from other light sources in the surroundings. It may also be the case that yesterday everything still worked, but today it no longer works due to the incident sunlight. After these have been eliminated you should recalibrate the gun.
   
   Resources:
   
   1. You can use your smartphone’s camera to help you do this. This can make IR light sources visible.
   2. You can set the IR sensitivity in the programme. As reflective lights are usually darker, they can be excluded.
      
      
2. You are standing too close to the screen. The gun must be at least 1.3-1.5 times the screen width.
3. The wii camera only has a resolution of 1024×768, so if you have set a 4K resolution, not all pixels on the screen can be reached. You should therefore play at a lower resolution.
4. It could be that your Bluetooth device is too slow. Check the compatibility lists of the wii remote for this.
   http://wiibrew.org/wiki/List_of_Working_Bluetooth_Devices#
5. You installed third party wii software driver to your computer. For example: HID wiimote by Julian Oehr or touchmote (not sure about that). Please uninstall these drivers before usage.
   
   A good tool for this is: https://github.com/lostindark/DriverStoreExplorer
   Please beware that you can damage your pc when you do something wrong. No waranty. On your own responsibility.
   
   
6. You’r bluetooth dongle is incompatible. Please check: http://wiibrew.org/wiki/List_of_Working_Bluetooth_Devices#

Whats going on here?

Here you can learn how to build LEDs for the “Lichtknarre”-lightgun software. 

Information on the “Lichtknarre”-lightgun software can be found here:  

https://geekonarium.de/en/lightgun-lichtknarre-for-the-wii-remote-on-your-pc-computer/

no warranty

This project has not been developed to comply with industry standards, so we do not guarantee anything and will not pay for damages or other problems.

Beware: Only use the circuit if the box is closed and do not touch the LEDs when powered.

Show me!

Beware the circuit it outdated in this video tutorial, because the seller changed specifications. Use specifications from this tutorial.

Do i realy need todo that much effort?

Depends. If you realy want the ultra Version which works on Beamer etc than maybe you should build this. Since 0.9.8 we have also the BAD-LED mode. Low powered IR-LEDs should work in most cases also now! Some people had reported that 980nm LEDs which are also used in the Wii sensorbar work well for normal TV/monitor sizes without BAD-LED mode. Never validated this, but just in case:

See BAD-LED mode:

https://youtu.be/2AiFrcu059I?t=962 

You can also lookup the tutorials of other users:

Tutorials from other Users

Shopping list

• 4 x 90° lenses
  • ebay
• 4 x IR 850 nm High Power LEDs 
  • ebay
  • 1.7V-1.9V
    • Seller changed specs. Now use 2.4V with 1 Ohm resistor:
      • Lookup: https://ledcalculator.net/#p=3.0&v=2.4&c=800&n=4&o=w
  • 850nm IR LEDs have not been tested yet. (Best would be 980nm)
• 4 x 1.5 Ohm resistors
  • Amazon
  • The resistors have to take 3W of power. They will become a little warm when powered.
  • Because 850nm High Power LEDs are used with 2.4V now we use these 1 Ohm reistors:
    • Amazon
• cable
  • Amazon
  • Music cables are good because +ve and -ve are together.
• 3V power adaptor which can output 800mA * 4 LEDs = 3200mA 
  • Amazon 
    • This AC-Adapter outputs 3000mA but i dont find a better one
• 4 x plastic cases (or use 3d printed parts): 
  • Amazon
  • diameter: 24mm, height: 30mm  
  • round
  • with a screw cap
• Lustre terminal, which fits in the plastic case.
• electronic cables
• round neodym-magnets
  • Amazon
  • 6mm diameter
• plastic distribution box (look 3d printed parts)
• Power supply adapter
  
  • Amazon

Equipment

1. soldering iron
2. hot glue
3. 2mm drill
4. super glue
5. and so on

3D print parts

Enclosures for electronics as 3d prints can be found here.

Housing is compatible with power supply adapter thanks to: 

https://www.thingiverse.com/thing:2518532

Theory

We want to create following the circuit:

Here you can change the configuration of the circuit if you like: LED-Calculator

Assembly

All steps has to be repeated 4 times, because we are building 4 LEDs.

1. LEDs > case drilling

1. Put the LEDs on the closed site of the casing. Not on the side with the screw cap.
2. Mark 2 points. The holes should reach the + (positive) and – (negative) pole.
3. Drill the holes.

2. LEDs > superglue

Now superglue the LEDs. Be careful not to cover the holes and glue the holes that you can reach the +ve and -ve pole when you put cables through it.

3. LEDs > glue magnets

Now put the magnets in the screw cap. Ensure that the magnet pole faces in the same direction as the others. Put it in place with hotglue.

4. LEDs > Glue lustre terminal in and connect

Two pieces of a lustre terminal will be cut off. Connect 10mm electronic cable and connect this to the lustre terminal. Put the cable and lustre terminal in the case, so that the cables go through the holes. If needed cut off some plastic. After this solder the cables to the LEDs.

Put the lustre terminal in place in the case and hotglue it. But ensure that the screws can still be accessed in the future.

When the hotglue is cold mark the holes for the screws which are not connected with black edding. Then drill two holes in the case where the free holes in the lustre terminal are.

4. distribution box > resistors

1. Screw the LEDs together. The Leds should go in the same directions. (Look at the colours).
2. Prepare the electronic cables like as image 3.
3. Secure the cable with cable tie. Use black tie because it will become -ve pole. Not like in the picture.
4. Screw the cable to the -ve pole on the power adaptor and the other cables to the lustre terminal.

4. distribution box > prepare long cables

1. Cut off 4 cables. I would suggest 2 Meters, so its easy to use a beamer.
2. Solder the red cables on one side together. Look at image 3. Secure all with a cable tie. Screw it to the positive (+ve) pole of the power adoptor.
3. Screw the black cables to the free lustre terminal.
4. the other side of the cables should be soldered so that it is easy to screw it to the LEDs.

4. distribution box > Put everything in the box

Pack it all in the box as I did. Put the lenses on the LEDs and than you’re ready to go.

CAUTION: Only test the circuit if the box is closed. Do not touch the LEDs when they are under power. There is no warranty for anything that goes wrong.

Tutorials from other Users

• https://diylightgun.com/lightgun-details/?lgid=155#hardwaretab
• Low power LED holder with lens mount by Dragar:
  • https://thangs.com/designer/Dragar/3d-model/IR%20LED%20Lens%20holder%20for%20Lightgun%20Tracking-899769