feat: proper hytale renders (#133)

Co-authored-by: James Ross <james@jross.me>

Author: mja00

.env.example

@@ -0,0 +1,21 @@
+# Upload method configuration
+# Options: "http" (default) or "s3"
+# http: Uses the HTTP endpoint (requires running wrangler dev)
+# s3: Uses S3-compatible protocol to upload directly to R2
+UPLOAD_METHOD=s3
+
+# HTTP endpoint configuration (used when UPLOAD_METHOD=http)
+# Default is http://localhost:8787/upload-asset
+UPLOAD_ENDPOINT=http://localhost:8787/upload-asset
+
+# S3/R2 configuration (required when UPLOAD_METHOD=s3)
+# Get these values from your Cloudflare R2 dashboard
+R2_ENDPOINT=https://<your-account-id>.r2.cloudflarestorage.com
+R2_ACCESS_KEY_ID=your-access-key-id
+R2_SECRET_ACCESS_KEY=your-secret-access-key
+R2_BUCKET=hytale-assets
+
+# Optional: Prefix to prepend to all S3 keys
+# Example: Set to "assets/" to upload files as "assets/Common/Characters/skin.png"
+# Leave empty to upload files directly at the bucket root
+R2_KEY_PREFIX=

.eslintignore

@@ -1,4 +1,4 @@
 dist
 node_modules
 target
-pkg
+pkg

.gitignore

@@ -11,3 +11,8 @@ node_modules/
 .idea
 .wrangler/
 dist/
+src/hytale-skin-renderer/target/
+.env
+
+# Localflare generated files
+.localflare/

Cargo.lock

@@ -13,6 +13,9 @@ cfg-if = "1.0"
 wasm-bindgen = "0.2"
 js-sys = "0.3.77"
 imageproc = { version = "0.25.0", default-features = false }
+hytale-skin-renderer = { path = "./src/hytale-skin-renderer", default-features = false, features = [
+	"wasm",
+] }
 
 # The `console_error_panic_hook` crate provides better debugging of panics by
 # logging them with `console.error`. This is great for development, but requires

Cargo.toml

@@ -0,0 +1,47 @@
+# Assets
+
+This directory contains extracted game assets used by Crafthead.
+
+## Hytale Assets
+
+To extract Hytale assets, use the `extract-hytale-assets.ts` script.
+
+### Prerequisites
+
+- Node.js 24 or higher
+- Hytale Assets.zip file
+
+### Extraction Methods
+
+#### Method 1: Place zip file in assets folder (Recommended)
+
+1. Place `Hytale Assets.zip` in the `assets/` folder
+2. Run the extraction script:
+   ```bash
+   npm run extract-hytale-assets
+   ```
+
+#### Method 2: Automatic Windows detection
+
+On Windows, the script will automatically detect if Hytale is installed and use the Assets.zip from the default installation location:
+- `%APPDATA%\Hytale\install\release\package\game\latest\Assets.zip`
+
+Simply run:
+```bash
+npm run extract-hytale-assets
+```
+
+### Configuring Extraction Patterns
+
+The script extracts files based on glob patterns defined in `scripts/extract-hytale-assets.ts`. To modify which files are extracted, edit the `GLOB_PATTERNS` array in that file.
+
+Current patterns extract:
+- Character Creator JSON files
+- Blocky model files (`.blockymodel`)
+- Character PNG textures
+- Cosmetics PNG textures
+- Tint gradient PNG files
+
+### Output
+
+Extracted files are placed in `assets/hytale/` preserving the original directory structure from the zip file.

assets/README.md

@@ -0,0 +1 @@
+Common/

assets/hytale/.gitignore

@@ -0,0 +1,17 @@
+[
+  {
+    "Id": "Default",
+    "Model": "Characters/Player.blockymodel",
+    "Name": "avatarCustomization.bodyCharacteristics.Default.name",
+    "GradientSet": "Skin",
+    "GreyscaleTexture": "Characters/Player_Textures/Player_Greyscale.png",
+    "IsDefaultAsset": true
+  },
+  {
+    "Id": "Muscular",
+    "Model": "Characters/Player.blockymodel",
+    "Name": "avatarCustomization.bodyCharacteristics.Muscular.name",
+    "GradientSet": "Skin",
+    "GreyscaleTexture": "Characters/Player_Textures/Player_Muscular_Greyscale.png"
+  }
+]