Information and Troubleshooting
Information and Troubleshooting
1
Contents
1 Information 4
1.1 URLs in this document . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.2 ”3D Ripper Pro” and other similar tools . . . . . . . . . . . . . . . . . . . 4
1.3 The Dyno bot’s ”help” message . . . . . . . . . . . . . . . . . . . . . . . 4
1.4 sfConfig . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.5 Latest version: v1.18.0 beta 2 . . . . . . . . . . . . . . . . . . . . . . . . 5
2 Common issues 6
2.1 Distorted textures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
2.2 ”URL is not supported” . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
2.3 Converted files not present in ”downloads” folder . . . . . . . . . . . . . 7
2.4 ”Newtonsoft.Json.JsonReaderException” . . . . . . . . . . . . . . . . . 7
2.5 Pasting (Ctrl+V) a link crashes the tool . . . . . . . . . . . . . . . . . . . 8
4 Retarded issues 10
4.1 ”I can’t rip from [insert link to page without 3D viewer]!” . . . . . . . . . . 10
4.2 3dcadbrowser.com & shapeways.com . . . . . . . . . . . . . . . . . . . 11
2
4.3 ”[plug-in] is broken, fix it!” . . . . . . . . . . . . . . . . . . . . . . . . . . 11
4.4 ”sfConfigGenerator does nothing and closes immediately!” . . . . . . . 11
4.5 Sketchfab model not visible in Blender . . . . . . . . . . . . . . . . . . . 11
4.6 Spector.js not working or giving watermarked textures . . . . . . . . . . 11
4.7 Textures extracted with Spector.js are too small . . . . . . . . . . . . . . 11
4.8 2D view not available for Sketchfab model . . . . . . . . . . . . . . . . . 12
4.9 Tool stuck on ”Dumping .binz files...” and opens a Chrome window . . . 12
4.10 Missing textures when ripping a Sketchfab model . . . . . . . . . . . . . 12
4.11 ”The tool isn’t downloading all the formats offered by Sketchfab!” . . . . 12
4.12 Tool doesn’t run on Windows 95 with 16 MB of RAM . . . . . . . . . . . 12
4.13 Tool crashes on Windows 11 . . . . . . . . . . . . . . . . . . . . . . . . 12
3
1 Information
1.4 sfConfig
Due to site changes, the Sketchfab plug-in is unable to extract the sfConfig value
automatically. Unfortunately, the latest (private) build of SketchfabPlugin is incompat-
ible with v1.18.0 beta 2 and there probably won’t ever be a ”next version”. For now, an
4
alternative solution is to use sfConfigGenerator and a batch file to get the latest value,
then to update it manually in SketchfabRipper.ini and set the file to read-only. An
alternative batch file which automates the whole process can be found here. Note:
sfConfigGenerator extracts some values from Sketchfab’s viewer and encrypts them
before printing the result. The generated string is not unique to any specific user, nor
is it usable by any third-party software. There is no risk in sharing the string publicly
(considering that anyone, even Sketchfab, can generate the same value by simply run-
ning sfConfigGenerator), yet for some reason posting it in the #sketchfab channel
may lead to a ban, so posting it there is discouraged.
5
2 Common issues
If your textures look similar to the example shown above, don’t bother reporting it.
This has been a known issue for several months, and there are currently no plans to
fix it. However, there are alternative manual methods for extracting them. One such
method involves using Spector.js. Several video tutorials have been provided in the
#sketchfab channel on Discord, such as [1], [2] and [3]. It’s also possible to use
Ninja Ripper with the Pale Moon browser. If you choose to use Ninja Ripper, keep
in mind that all the textures will need flipping - there’s a useful utility for that here,
just extract it to the folder containing DDS files and run convert.bat . There’s also
a recently-released Android application which is able to extract textures, but it shows
advertisements, requires an emulator to run on PC and doesn’t support password-
protected or restricted models. It’s also a very time-consuming process if the model
has many textures - Ninja Ripper is usually the best choice for such models. More
information here.
6
FAQ
1.
• Q: Can I skip downloading textures since they’re all broken?
• A: No.
2.
• Q: Is there an automated method to rename textures downloaded through
Spector.js to the names assigned by the ripper?
• A: No.
2.4 ”Newtonsoft.Json.JsonReaderException”
You need to update the sfConfig value in SketchfabRipper.ini . See section 1.4 for
more information. Make sure SketchfabRipper.ini is set to read-only after updating
the value, otherwise the tool will overwrite it.
7
2.5 Pasting (Ctrl+V) a link crashes the tool
Known issue which is probably caused by the obfuscation applied to SketchfabRipper.exe .
Whether this issue presents itself or not seems to vary between PCs. Workaround:
Right-click the text box and click ”Paste” instead of using Ctrl+V.
8
3.5 Empty model file when ripping from Sketchfab
Try the different modes listed in the ”Conversion” tab of the Options menu - some
models will only work in Static mode, while others only work in Rigged mode. If the
issue persists, try changing ”Send to start pose”. If that doesn’t fix the issue, the scripts
may not be able to convert that model. Buy the model or rip it using Ninja Ripper with
the Pale Moon browser instead.
3.10 System.ComponentModel.Win32Exception
You’ve probably downloaded a broken copy of the ripper, or your antivirus has deleted
some of its files. Re-download the ripper from the links in section 1.3 and make sure
your antivirus isn’t interfering with the tool or the extraction process.
9
3.11 Tool crashes on Windows 7
Is PresentationFramework.Aero2.dll in the same folder as SketchfabRipper.exe ?
The file was accidentally left out in v1.18.0 beta 2, so users who haven’t been updating
from older versions may be missing it. If the file is present, is it ~165 KB in size? The
file should be ~251 KB, if it’s not then you’ll need to re-download it. Download the file
here and place it next to SketchfabRipper.exe . You may also need to unblock the
file - right-click it in Explorer, select ”Properties” and tick the ”Unblock” box near the
bottom.
4 Retarded issues
10
4.2 3dcadbrowser.com & shapeways.com
Cloud-based viewers which deliver a sequence of images to your PC. Impossible to
rip from.
11
4.8 2D view not available for Sketchfab model
The 2D view isn’t necessary to extract textures, use the 3D view instead.
4.9 Tool stuck on ”Dumping .binz files...” and opens a Chrome window
You’re using an old version, probably 1.17.x. Update to 1.18.0 beta 2 - see section 1.4
for download links.
4.11 ”The tool isn’t downloading all the formats offered by Sketchfab!”
The ripper downloads content from the Sketchfab viewer, not from their model repos-
itory containing the original files. It’s possible to download the source files of free
content and assets that you’ve purchased or own by using the ”Sign in to Sketchfab”
feature, but if you don’t have access to them then the tool only downloads files which
Sketchfab provides to the viewer.
12