Skip to content

README.md

Latest commit

 

History

History
118 lines (98 loc) · 5.98 KB

README.md

File metadata and controls

118 lines (98 loc) · 5.98 KB

🦊 KitsunePaint

KitsunePaint

A web-based custom paint pack creator for 7 Days to Die.
paint.kitsuneden.net

Download on Nexus Mods Live Tool 7 Days to Die V2.0+ License GitHub stars

Upload your textures, preview how they tile on a wall, download a ready-to-install modlet. No Unity installation required.

What it does

  1. Upload: drag and drop PNG/JPG textures in Simple mode (diffuse only) or PBR mode (diffuse + normal + specular)
  2. Preview: see exactly how your texture tiles on a simulated block wall before you commit
  3. Configure: name your paint, pick a group (Masonry, Wallpaper, Tiles etc), tweak tiling
  4. Download: get a complete .zip modlet with painting.xml, Localization.txt, ModInfo.xml, and all source textures
  5. Build bundles: run the included Python script to generate Atlas_XXX.unity3d asset bundles, one per paint, scales to 20+ paints

Bundle Builder

The web tool generates the modlet zip. To get textures rendering in-game you also need to run the Python bundle builder:

pip install UnityPy Pillow
python scripts/build_bundle.py "path/to/your/modlet/Resources"

This generates per-paint Unity asset bundles with proper mipmap data, DXTnm normals, and unique CAB names. No Unity installation needed.

Dependencies

  • OCBCustomTextures v0.8.0+ (must be installed on server and client)
  • EAC must be disabled on both server and client
  • 7 Days to Die V2.0+
  • Python + pip install UnityPy Pillow (for bundle builder only)

Tech Stack

  • Vite + React + TypeScript
  • Tailwind CSS
  • JSZip (modlet packaging)
  • UnityPy + Pillow (bundle builder)

Project Structure

src/
  components/       # TextureUploader, WallPreview, PaintTray, PackMeta
  pages/            # LandingPage, routed via App.tsx
  types/            # TypeScript type definitions
  utils/            # buildModlet.ts — zip generation
scripts/
  build_bundle.py   # Python bundle builder
  Atlas.template.unity3d  # Template bundle for injection
public/
  .htaccess         # SPA routing for Apache

Part of the Kitsune Ecosystem

  • KitsuneCommand: 7D2D server-management suite (RESTful API + web panel)
  • Kitsune7Den: Windows desktop dashboard for 7D2D dedicated servers
  • KitsunePaintUnlocked: breaks the 255 paint texture hard limit to 1023
  • KitsuneDen: unified home-server dashboard (Minecraft / 7D2D / Hytale)
  • KitsunePaint: custom paint pack creator ← you are here


Powered by the Skulk