+
Skip to content

lvoxx/LSPotato

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

22 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🥔 Potato-LSCherry

Project Banner

A lightweight Blender add-on for potato-style automation 🍠 — simplify your workflow and focus on creativity.

GitHub Repo Stars    Total Downloads    Build for Blender    Python    License: MIT   


🚀 Prerequisites

Before getting started, ensure you have the following installed:

  • 🖌️ Blender4.x or above 👉 Download

  • 🐍 Python3.x or above (For developers) 👉 Download

Tip

Using the latest stable version is recommended for the best compatibility.


😨 I dont want to read potato code

Copy one of those to the terminal

  1. Build the addon, then checking \dist folder
potato package
  1. Build and install/uninstall the addon based on your Blender version, default 4.3
potato install 4.x
potato uninstall 4.x
  1. If you're a dev, "reload" is a combination of UnInstall + Clean + package + Install
potato reload

🚀 Features

  • 🔄 Automated mesh adjustments
  • 🎨 Quick material setup
  • 🧩 Custom utilities for Blender scripting
  • One-click run from Blender or terminal
  • 🛠 Extensible Python codebase

📦 Installation

1️⃣ Install as Blender Add-on

  1. Download the latest release ZIP from Releases.
  2. Open Blender → EditPreferencesAdd-onsInstall...
  3. Select the ZIP file → enable Potato-Blender.

2️⃣ Install via Source (Dev Mode)

git clone https://github.com/lvoxx/Potato-Blender.git
cd Potato-Blender

Developer Section

Quick Help

potato help

Potato Help

Project Architecture

graph TD
    %% Main Entry Point
    A[Blender Startup] --> B{Addon Installed?}
    B -->|No| C[Install Potato-LSCherry Addon]
    B -->|Yes| D[Load Addon Components]
    C --> D
    
    %% Core Components Loading
    D --> E[Initialize LSCherry Toon Shader]
    D --> F[Load Potato Utilities]
    D --> G[Register UI Panels]
    
    %% LSCherry Toon Shader System
    E --> H[Load Material Libraries]
    H --> I[Game-specific Presets]
    I --> J[HI3 Materials]
    I --> K[Genshin Impact Materials]
    I --> L[Honkai Star Rail Materials]
    I --> M[Other Game Materials]
    
    %% Potato Automation System
    F --> N[Mesh Automation Tools]
    F --> O[Material Setup Utilities]
    F --> P[Custom Scripting Tools]
    
    %% User Interface
    G --> Q[Shader Editor Panel]
    G --> R[Properties Panel]
    G --> S[Tools Panel]
    
    %% Main Workflow
    T[User Selects Object] --> U{Material Exists?}
    U -->|No| V[Create New Material]
    U -->|Yes| W[Edit Existing Material]
    
    V --> X[Apply LSCherry Base Shader]
    W --> X
    X --> Y[Configure Toon Parameters]
    Y --> Z[Select Game-specific Preset]
    Z --> AA[Fine-tune Settings]
    AA --> BB[Preview Result]
    BB --> CC{Satisfied?}
    CC -->|No| Y
    CC -->|Yes| DD[Apply Final Material]
    
    %% Advanced Features
    DD --> EE[Optional: Batch Processing]
    DD --> FF[Optional: Export Settings]
    DD --> GG[Optional: Save as Preset]
    
    %% Error Handling
    BB --> HH{Errors Detected?}
    HH -->|Yes| II[Show Error Messages]
    HH -->|No| CC
    II --> JJ[Suggest Fixes]
    JJ --> Y
    
    %% Background Processes
    subgraph "Background Systems"
        KK[Auto-reload Libraries]
        LL[Mesh Fairing]
        MM[Planar UV Mapping]
        NN[Material Validation]
    end
    
    %% CLI Tools
    subgraph "CLI Tools"
        OO[potato package]
        PP[potato install]
        QQ[potato uninstall]
        RR[potato reload]
    end
    
    style A fill:#e1f5fe
    style DD fill:#c8e6c9
    style HH fill:#ffcdd2
    style EE fill:#fff3e0
    style FF fill:#fff3e0
    style GG fill:#fff3e0
Loading
点击 这是indexloc提供的php浏览器服务,不要输入任何密码和下载