Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Appearance settings

smlu/blender-sith

Open more actions menu

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

202 Commits
202 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🎮 Sith Engine Toolkit for Blender

Blender License Platform

Import/Export assets for classic LucasArts games

🚀 Installation📖 Usage Guide🔧 Troubleshooting


📑 Table of Contents


🕹️ Supported Games

  • Star Wars Jedi Knight: Dark Forces II
  • Star Wars Jedi Knight: Mysteries of the Sith
  • Star Wars: DroidWorks
  • Indiana Jones and the Infernal Machine
  • Grim Fandango (text format 3DO import only)

✨ Features


📦 3DO Models

  • ✅ Import/Export all versions (2.1, 2.2, 2.3)
  • 🎨 Full mesh hierarchy support
  • 🔧 Edit properties in Blender UI
  • 🎯 Vertex colors & UV mapping

🎬 KEY Animations

  • ✅ Import/Export mesh animations
  • 🎞️ Keyframe markers support
  • ⚙️ High-priority node configuration
  • 📊 Frame rate control (15-60 fps)

🖼️ MAT Textures

  • ✅ Import as Blender materials
  • 🎞️ Import all texture cells
  • 🎨 8-bit, 16-bit, 24-bit & 32-bit formats
  • 🔧 ColorMap (.cmp) support

🛠️ Advanced Editing

  • 🎛️ Per-face properties & flags
  • 🔦 Lighting & texture modes
  • 🎨 Extra light color support
  • ⚡ Multi-face batch editing

⚡ Quick Start

  1. Install: Download from Releases and install via Blender Extensions
  2. Import Model: File > Import > Sith Game Engine 3D Model (.3do)
  3. Import Textures: Use MAT Directory option or let auto-search find them
  4. Import Animation: File > Import > Sith Game Engine Animation (.key)
  5. Edit Properties: Use the 3DO Properties panels (see Usage Guide)
  6. Export: File > Export to save your modifications

📖 Detailed instructions: See the Usage Guide for complete documentation.


📋 Requirements

Blender 5.0+ is required for this version of the add-on.

🔗 Download Blender


🚀 Installation

Method 1: From Release (Recommended)

  1. 📥 Download the latest ZIP from the Releases page
  2. 🔧 Open Blender and go to Edit > Preferences > Add-ons
  3. 📂 Install: Click the dropdown menu (▼) at the top-right and select Install from Disk...
  4. 📁 Select the downloaded ZIP file
  5. Enable the add-on: Check the box next to Sith Game Engine Formats (.3do, .mat, .key)
  6. 🎉 Done! Import/export options appear in File > Import and File > Export menus

Method 2: From Source

# Clone or download the repository
git clone https://github.com/smlu/blender-sith.git

# ZIP the `sith` folder and install via Blender Preferences

💡 Note: In Blender 5.0, add-ons are managed through the Extensions system.


📖 Usage

For complete documentation on importing, exporting, and editing, see the Usage Guide.

Quick Reference

  • Import 3DO: File > Import > Sith Game Engine 3D Model (.3do)
  • Export 3DO: File > Export > Sith Game Engine 3D Model (.3do)
  • Import KEY: File > Import > Sith Game Engine Animation (.key)
  • Export KEY: File > Export > Sith Game Engine Animation (.key)
  • Import MAT: File > Import > Sith Game Engine Texture (.mat)
  • Edit Properties: Properties Panel > Object Properties > 3DO Properties
  • Edit Faces: Properties Panel > Data Properties > 3DO Mesh Face Properties (Edit Mode)

📖 See USAGE.md for detailed options, screenshots, and troubleshooting.


🤝 Contributing

Contributions are welcome! Feel free to:

  • 🐛 Report bugs via Issues
  • 💡 Suggest features or improvements
  • 🔧 Submit pull requests

Links


⭐ If you find this project useful, consider giving it a star!

Morty Proxy This is a proxified and sanitized view of the page, visit original site.