LightBlades

Help for iPhone

LightBlades support

Get started, solve tracking issues, or contact us.

Contact support

Email pendrawapp@gmail.com or open a GitHub issue. GitHub issues are public; avoid posting personal details, pairing codes, or camera images there. Include your iPhone model, iOS version, and a brief description of the issue.

Play on your iPhone

  1. Open LightBlades and tap Run on phone. Allow camera and motion access.
  2. Turn the phone left: its original left edge faces down and its charging port points to the right. Keep the screen facing you and the rear camera uncovered.
  3. Once tracking is ready, start the music or practice. Cut each box in its arrow’s direction; dot boxes accept any moving cut. Keep the blade and hilt clear of red walls.

Improve tracking

Keep the rear camera clear and point it toward a well-lit room with visible detail. Avoid blank walls and quick motion while tracking starts. If position tracking is limited, move slowly and use Center blade or Retry tracking. Check Camera and Motion permissions in iPhone Settings.

Add a second sword

On the game phone, tap Second sword. On the other iPhone, open LightBlades and choose Join as red sword. Select that phone and accept the invitation. Keep Wi-Fi and Bluetooth enabled and allow Local Network access. The phones connect locally; an internet connection is not needed for the nearby game.

Share the screen or play on a laptop

The in-game Share screen button explains AirPlay and USB mirroring to a Mac. For laptop play, run the LightBlades laptop companion and pair the phone using the displayed code. AirPlay and the laptop companion require a local network; USB mirroring does not require Wi-Fi.

Music credit

“Cipher” by Kevin MacLeod is licensed under Creative Commons Attribution 4.0. Visit the official track page.

Online laptop rooms

The laptop host can run npm run start:online, open the host address, and show a player the QR code. Scan with the phone’s camera and choose the LightBlades app or the browser controller. Online app pairing requires an updated app. Browser mode uses tilt to steer and does not track physical position. Keep the laptop and tunnel running during play.