NEW: Master Swift design patterns with my latest book! >>

How to debug physics in a SpriteKit scene using showsPhysics

Written by Paul Hudson    @twostraws

SpriteKit’s SKView class has a few built-in debugging options, of which two are enabled by default: showsFPS to show the current frames per second, and showsNodeCount to show how many nodes are currently in your scene.

If you’re having trouble understanding the way your physics objects are behaving, you should enable the showsPhysics option on your view, like this:

view.showsPhysics = true

You can put that into GameViewController.swift if you’re using Xcode’s default SpriteKit template, alongside showsFPS and showsNodeCount.

When set to true, showsPhysics will automatically draw blue lines around all your physics shapes, allowing you to see them in exactly the same way as the physics engine does. Hopefully you’ll be able to see where you’ve made a mistake and can correct it quickly!

Available from iOS 8.0

Did this solution work for you? Please pass it on!

Other people are reading…

About the Swift Knowledge Base

This is part of the Swift Knowledge Base, a free, searchable collection of solutions for common iOS questions.

Become a Swift guru

I wrote a book called Pro Swift that's dedicated to helping you master the Swift language, and it includes seven hours of video demonstrating each technique!

Click here to visit the Hacking with Swift store >>