Cut the Rope: DX (Decompiled Extra) is a fan-made enhancement of the PC version of Cut the Rope, originally developed by ZeptoLab. This project aims to improve the original game's codebase, add new features, and enhance the overall gaming experience.

The game's source code is decompiled from the PC version, which serves as the foundation for development and feature expansion.

This project is a part of the Cut the Rope Home fan project, and is currently led by yell0wsuit, with help from contributors.

The logo is designed by Bingies24 and darealmrcatz.

• Cut the Rope: H5DX: a web edition of Cut The Rope, originated from the FirefoxOS version, currently being developed to improve the game's experience further.

Download the latest release from the Releases page.

• More boxes beyond DJ Box, from Spooky Box to Mechanical Box.
• Seasonal Christmas theme and decorations, available during December and January.
• Dynamic level UI, supports variable numbers of levels. Currently, the code only supports fewer than 25 levels.
• Support loading custom sprites and animations from TexturePacker in JSON array format. This allows easier modding and adding new assets.
• Improved experience and bug fixes over the original PC version.
• Better save file format. The save file (ctr_preferences.json) is stored in a CutTheRopeDX_SaveData folder, with the following fallback priority:
  • Next to the game executable (preferred for portability)
  • Documents/CutTheRopeDX_SaveData -- if the above is not writable. Usually on macOS with .app bundle installation, or some Linux setups.
  • %LOCALAPPDATA%/CutTheRopeDX_SaveData (Windows) or equivalent on other platforms

Please see issue #68 for the current short-term goals.

• Bug fixing and polish: Fix bugs, and ensure everything works smoothly.
• Code optimization and modernization: Optimize performance-critical code, and modernize codebase.

The development of Cut the Rope: DX is an ongoing process, and contributions are welcome! If you'd like to help out, please consider the following:

• Reporting issues: If you encounter any bugs or issues, please report them on the GitHub Issues page.
• Feature requests: If you have ideas for new features or improvements, feel free to submit a feature request through Issues.
• Contributing code: If you're a developer and want to contribute code, please fork the repository and submit a pull request. Make sure to read the contribution guidelines in CONTRIBUTING.md.

To test the game during the development process, follow these steps:

1. Ensure you have latest .NET installed on your machine.

2. Clone the repository to your PC:

   git clone https://github.com/yell0wsuit/cuttherope-dx.git
   cd cuttherope-dx

   You can also use GitHub Desktop for ease of cloning.

3. For most cases, you can build the game using the following commands:

   a. Windows

   dotnet publish CutTheRope\CutTheRope.csproj -c Release -f net10.0 -p:PublishAot=true -o .\CutTheRope\bin\Publish\win-x64

   b. macOS

   Without AVFoundation (will use FFmpeg for video playback):

   dotnet publish CutTheRope/CutTheRope.csproj -c Release -f net10.0 -r osx-arm64 -o ./CutTheRope/bin/Publish/osx-arm64

   Make sure you have installed FFmpeg from Homebrew.

   With AVFoundation (only for macOS 26.0 and later, requires Xcode installed):

   dotnet publish CutTheRope/CutTheRope.csproj -c Release -f net10.0-macos -r osx-arm64 -p:PublishAot=true -o ./CutTheRope/bin/Publish/osx-arm64

   Note:
   You can change osx-arm64 to osx-x64 for Intel-based version. However, we do not guarantee the game will work properly on Intel Macs.

   c. Linux

   dotnet publish CutTheRope/CutTheRope.csproj -c Release -f net10.0 -p:PublishAot=true -o ./CutTheRope/bin/Publish/linux-x64

   Warning:
   A native AOT binary built on Linux is only guaranteed to run on the same or newer Linux distribution version.

   If you encounter issues with native AOT, you can try removing the -p:PublishAot=true flag.