NUKERIS

A Nuke-native falling-block puzzle game with a Node Graph-inspired interface. Supports Nuke 12-17, Python 2.7 / 3, and PySide2 / PySide6.

First submitted: 27 August 2026

Updated: 31 August 2026

Author: kota mori

Website: https://github.com/MoriKouta/NUKERIS

Compatible Nuke versions: 12.0 or later

Compatibility: Source

Description Licence Download

A Nuke-native falling-block puzzle game designed for quick breaks while compositing.

NUKERIS runs directly inside Foundry Nuke as a dockable Qt panel.

The same nukeris.py file automatically uses PySide2 or PySide6 depending on the Nuke version, allowing NUKERIS to run across Nuke 12 through 17.

The game combines classic falling-block puzzle mechanics with a visual style inspired by Nuke's Node Graph and Properties panels. Pieces are represented as connected Nuke-style nodes using familiar node colors, connection lines, and an optional Node Graph grid.

Features

Dockable Nuke panel
Nuke-inspired Node Graph interface
Connected node-style pieces
Optional Node Graph grid
Hold piece
Next piece queue
Ghost piece
Soft Drop / Hard Drop
Wall kicks
Combo scoring
Line-clear effects
Session timer
Persistent Best Score
Automatic pause when input focus is lost
Keyboard handling designed to avoid conflicts with Nuke shortcuts
PySide2 / PySide6 compatibility

Controls

A / D — Move
S — Soft Drop
Q / E — Rotate
C — Hold
Space / W — Hard Drop
Esc — Pause and release keyboard input

Keyboard controls are active only while the NUKERIS panel owns input focus.

Best Score

NUKERIS saves your Best Score between Nuke sessions.

When a new Best Score is recorded, NUKERIS automatically creates nukeris_settings.json next to the loaded nukeris.py file.

The settings file is used only to store the Best Score.

If the settings file is missing, invalid, or cannot be written, NUKERIS continues running normally without affecting the current Nuke script.

Installation

Copy nukeris.py into your .nuke directory.

Windows:

C:\Users\<USERNAME>\.nuke\nukeris.py

Linux:

~/.nuke/nukeris.py

Add the following line to your existing menu.py:

import nukeris

Restart Nuke.
Open:

Pane → NUKERIS

The panel can then be docked anywhere in your Nuke workspace.

Safety

NUKERIS is intentionally isolated from your comp.

It does not:

Create, delete or modify nodes
Modify knobs
Modify the Viewer
Change the current frame or timeline
Modify the Undo stack
Write data into the current .nk script
Register global keyboard shortcuts

The game receives keyboard input only while its panel has focus.

Compatibility

Foundry Nuke / NukeX 12.0 - 17.x
Nuke 12.x — Python 2.7 / PySide2
Nuke 13.x - 15.x — Python 3 / PySide2
Nuke 16.x - 17.x — Python 3 / PySide6
Windows
Linux

What's New in v1.1.0

Added support for Foundry Nuke 12 through 17
Added Python 2.7 compatibility for Nuke 12
Added automatic PySide2 / PySide6 compatibility
Added persistent Best Score saving
Added nukeris_settings.json for Best Score storage
Removed the P and R game shortcuts
Improved Qt5 / Qt6 compatibility

NUKERIS v1.1.0

MIT License

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

or register to download or rate.

Comments

or register to join the conversation.