Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
121 changes: 61 additions & 60 deletions Readme.MD
Original file line number Diff line number Diff line change
@@ -1,60 +1,61 @@
# Fabulous Ripper - Sketchfab Model & Texture Ripper

**Author:** Risk

## Installation Guide (Google Chrome)

To use these Tampermonkey scripts, follow the steps below:

### Step 1: Install Tampermonkey
[Download Tampermonkey from the Chrome Web Store](https://chromewebstore.google.com/detail/tampermonkey/dhdgffkkebhmkfjojejmpbldmpobfkfo?hl=en&pli=1)

### Step 2: Enable Developer Mode
1. Click the **Extensions** button in Chrome.
2. Click **Manage Extensions**.
3. At the top right of the page, enable the **Developer Mode** toggle.

### Step 3: Add the Scripts
1. Open a new tab and click the **Tampermonkey** extension icon.
2. In the dropdown menu, select **Create a new script**.
3. Open the `Sketchfab Model Ripper V5+.js` file using **VS Code** or **Notepad++**.
- If you don’t have Notepad++, [Download it here](https://github.com/notepad-plus-plus/notepad-plus-plus/releases/download/v8.7.7/npp.8.7.7.Installer.x64.exe).
4. Copy **all** the content from the script file.
5. Paste the copied data into the Tampermonkey script editor.
6. In the top left of the page, go to **File > Save**.

### Step 4: Repeat for Texture Dumper
Follow the same steps as above to install the `Texture Dumper.js` script.

### Step 5: Enable the Scripts
1. Open the **Tampermonkey Dashboard**.
2. Navigate to the **Installed Userscripts** tab.
3. Locate both scripts and toggle them to **Enabled**.

---

## How to Use

### Step 1: Navigate to the Model Page
1. Go to [Sketchfab](https://sketchfab.com/).
2. Open the page of the **model you want to download**.
3. **Wait** for the model to fully load.

#### **Model Loading Indicator**
- If the model is **not fully loaded**, it will look like this:
![Not Fully Loaded](https://raw.githubusercontent.com/gamedev44/Fabulous-Ripper/main/Pictures/FullyLoaded.png)
**Do not proceed yet. Wait until it fully loads.**

- Once the model is **fully loaded**, you will see the download buttons appear.

### Step 2: Downloading the Model
1. After the model fully loads, the **download buttons** will appear.
2. You will see two options:
- **Red Button (Recommended):** Use this whenever it is available for your model [it will show at top right of model viewer].
- **White Button (Alternative):** Use this if the red button does not appear for you [it will show at top left of model viewer].

![Download Buttons](https://raw.githubusercontent.com/gamedev44/Fabulous-Ripper/main/Pictures/DownloadButtons.png)

3. Click the button to start the download.

Once completed, the model and textures should be saved to your computer! 🚀
# Fabulous Ripper - Sketchfab Model & Texture Ripper

**Author:** Risk

## Installation Guide (Google Chrome)

To use this Tampermonkey script, follow the steps below:

### Step 1: Install Tampermonkey
[Download Tampermonkey from the Chrome Web Store](https://chromewebstore.google.com/detail/tampermonkey/dhdgffkkebhmkfjojejmpbldmpobfkfo?hl=en&pli=1)

### Step 2: Enable Developer Mode
1. Click the **Extensions** button in Chrome.
2. Click **Manage Extensions**.
3. At the top right of the page, enable the **Developer Mode** toggle.

### Step 3: Add the Script
1. Open a new tab and click the **Tampermonkey** extension icon.
2. In the dropdown menu, select **Create a new script**.
3. Open the `SketchfabModelRipper.js` file using **VS Code** or **Notepad++**.
- If you don't have Notepad++, [Download it here](https://github.com/notepad-plus-plus/notepad-plus-plus/releases/download/v8.7.7/npp.8.7.7.Installer.x64.exe).
4. Copy **all** the content from the script file.
5. Paste the copied data into the Tampermonkey script editor.
6. In the top left of the page, go to **File > Save**.

### Step 4: Enable the Script
1. Open the **Tampermonkey Dashboard**.
2. Navigate to the **Installed Userscripts** tab.
3. Locate the script and toggle it to **Enabled**.

---

## How to Use

### Step 1: Navigate to the Model Page
1. Go to [Sketchfab](https://sketchfab.com/).
2. Open the page of the **model you want to download**.
3. **Wait** for the model to fully load.

#### **Model Loading Indicator**
- If the model is **not fully loaded**, it will look like this:
![Not Fully Loaded](https://raw.githubusercontent.com/gamedev44/Fabulous-Ripper/main/Pictures/FullyLoaded.png)
**Do not proceed yet. Wait until it fully loads.**

- Once the model is **fully loaded**, you will see the download buttons appear.

### Step 2: Downloading the Model
1. After the model fully loads, the **download buttons** will appear.
2. You will see two options:
- **Red Button (Recommended):** Use this whenever it is available for your model [it will show at top right of model viewer].
- **White Button (Alternative):** Use this if the red button does not appear for you [it will show at top left of model viewer].

![Download Buttons](https://raw.githubusercontent.com/gamedev44/Fabulous-Ripper/main/Pictures/DownloadButtons.png)

3. Click the button to start the download.

### Step 3: Texture Fallback (if textures are missing)
1. Click the **TEXTURES** button to open the embed viewer.
2. Click **DOWNLOAD TEXTURES** to add them to the zip.

Once completed, the model and textures should be saved to your computer!
Loading