Shatter Client

Test Smash Hit levels easily

Shatter Client

With Shatter Client, you can quickly test segments and entire checkpoints directly from Shatter without having to pack and install a new app on your device.

Download (v5.1.0-rc2)

Using the client

The client was made for Shatter. Please make sure you have it and Blender installed.

With Shatter installed, in Blender, go to the Scene tab and at the very bottom of the menu you will see Your IP: ...
On your device, with the Client open, click Select IP and type the IP from Blender.
Export any segment from Shatter to the Client (Alt+Shift+E) and the segment should be able to be played on your phone. Remember to set the Quick Test parameters in Blender so you can see what your segment looks and feels like in the actual level! If you want to play a checkpoint, press the Set Level button in the Client and select any level from the list.

Troubleshooting

If you're having problems, try checking these common issues:

Your PC and mobile device aren't on the same network. Check that your device is not on Mobile Data, which may prevent it from connecting to your PC.
Windows Defender is angry. Check Windows Defender and allow Blender and Python to access your networks.
You may need to install Python separately.
Make sure your segments, levels and rooms are valid. The client may crash, hang or show an empty white room if loading fails. Check if your checkpoint code is incorrect or if your segment has invalid obstacles and such.

Changelog

Version 5.1.0-rc2

Released 2025-10-28

Status text should now be more helpful
Changed various UI texts
Under the hood KnShim upgrades
Removed non-functional x86 binaries
Two cute easter eggs that are certified yippers :3

Version 5.1.0-rc1

Released 2025-10-21

Fixed some issues with asset load order in mega mode
Updated to the latest KnShim version
Support for connecting to the server over TLS
A few minor tweaks and updated splashes

Version 5.0.99

Released 2025-08-13

Load Full Mod/"mega mode" support

Menu changes

Version 5.0.0

Released 2025-07-02

Added overlay loading support! This means you can now test custom music with the client (as well as convex meshes and sound effects)
- You must use at least NxQuick 1.3 (included with Shatter OSS 1.6 and later) to use overlay mode
Boss stages are fixed (but only in overlay mode; it's not possible to fix them in older loading methods)
Various bug fixes and stability improvements

Version 4.0.4

Released 2025-06-23

Fix the menu crashing sporadically

Version 4.0.3

Released 2025-06-20

When level reloading fails, a dialogue now pops up explaining that it has failed
Better and more consistent animations for dialogues
New pause menu, but it's a little hidden because the design isn't final ;3

Version 4.0.2

Released 2025-06-19

The client now preforms a sanity check when loading from a legacy server in the pause menu
The loading spinner should disappear more reliably
Network requests will now eventually time out
Refactored network requests and updated KnShim

Version 4.0.0

Released 2025-05-07

The game now fills very wide screens properly
Menu tweaks

Version 4.0.0-rc4

Released 2025-03-29

Added a credits menu and link to Shards discord
Added a new loading screen with splash texts
Hopefully the next release will be the final 4.0 release

Version 4.0.0-rc3

Released 2025-03-08

Added an option to adjust the game framerate (64-bit devices only) to either the default, "fixed" 60 fps, or native refresh rate of the display
Assets are now cleared between level loads
Added x86 shim and libsmashhit, so the client may work on x86 devices. I don't have confirmation or the ability to test that, however.
Minor bug fixes, code cleanup

Version 4.0.0-rc2-x86b1

Released 2025-01-03

Has only support for x86 devices
Technically identifies as RC2 but isn't really

Version 4.0.0-rc1

Released 2024-12-22

Switch to using KnShim database for saving hostname/level
Use knshim's native noclip and balls cheats
Ball count and streak now update in the HUD when using cheats
Fix blank page in the level selector when the number of levels is divisible by four
Added page numbers in the level list
Improved the gear icon for settings
Fixed being able to click buttons while waiting

Frequently Asked Questions

Does Shatter Client work on Android emulators?

Shatter Client will work on any reputable Android emulator, and has been tested to work in the official emulator included with Android Studio.

We will not support emulators that don't do ARM64 emulation properly. If you must use an emulator that is broken in this way, you may be able to use Shatter Client 4.0 Beta 5, but please note that we provide absolutely no support or future updates for this version.

Where can I download old versions of the Shatter Client?

If you must use an older version of Shatter Client, you can find them in this google drive folder; however, if there is a bug introduced with a newer version of the Shatter Client, we also encourage you to report it.

What is the difference between the old Shatter Client and the new Shatter Client?

Shatter Client 4.0 was the first version to fundamentally change how the client works. Since we wanted to allow people to test the new client without replacing the stable version which connected to all server versions, we created Shatter Client 4.0 as a separate app. Shatter Client 4 has since gained the ability to connect with old servers, so using Shatter Client 3.0 and earlier isn't needed anymore.

Should I use NxQuick, Yorshex's Asset Server, or SegServ?

We recommend using NxQuick, which was built to work best with the new Shatter Client and offers the best overall experience. If you find that not all segments are loading, however, you may also want to try Yorshex's Asset Server, though please note it may freeze while loading resources. We do not ever recommend using SegServ unless you really like using a client version from years ago. Please note that SegServ will be removed in Shatter OSS 1.6.0.

Previous Versions

More previous versions and changelogs can be found at the Shatter Wiki.

Google Sites

Report abuse