# MateEngine X3.0
## Windows and Taskbar Sitting Rewrite
* Avatars sit more naturally on windows and the taskbar. Legs render in front while hair renders behind for a seamless look.
* Transitions between dragging and sitting are smoother.
* Alignment with windows and the taskbar improved. If a model looks off adjust **Y Offset** in settings. Some models may need minor manual tweaks due to different bone rigs.
* You can give headpats while the avatar sits. The avatar closes its eyes and shows sparkling particles. More headpat animations will be added later.
* The avatar no longer jumps off the taskbar when the Windows Start Menu or Search opens.
* You must hold the avatar for at least one second before it will sit to prevent accidental sits during fast moves.
## Feed System (Alpha)
* Avatars can drink. Press the middle mouse button to open the Food Radial menu. Spawn smoothies and bring them to the avatar to feed. This is an early access feature.
* When Spawning a Smoothie it will always spawn a Random smoothie! Keep in mind this feature is new and not perfect but i think it is a nice to have!
## Drag Smoothing
* Dragging the avatar feels smoother and more stable.
* A light smoothing effect was added to make dragging natural without noticeable delay.
## Taskbar Sitting Changes
* The circle menu is disabled while the avatar sits on the taskbar, showing only **Jump Off**.
* This prevents visual overlap from other UI while sitting.
* Moving the menu up while sitting increases cost, so it remains off for taskbar sitting but works normally on window sitting.
## Animation Changes
* Minor rotation adjustments to dragging animations.
* Improved transition timing for intimate animation for smoother flow.
## Minecraft Integration
MateEngine reacts to Minecraft events in real time. The avatar comments on gameplay, warns about danger, and celebrates victories.
### How it works
* Install the **MateSignal Forge mod** in Minecraft and run **MateEngine** on the same device or local network.
* MateSignal forwards in-game events to MateEngine so the avatar can display messages or play animations.
* Intended for singleplayer and private multiplayer use. Avoid competitive or official servers where live alerts could be an unfair advantage.
### Examples of reactions
* Day start: cheerful wake-up
* Night start: reminder to stay safe
* Nearby mobs: instant warnings for creepers, zombies, etc.
* Low health or hunger: worried or encouraging lines
* Crafting: excited comments
* Weather: reactions when rain starts
* Death: sad or comforting messages
* Biome discovery: happy or curious reactions
* Eating: cheering during meals
* Killing mobs: victory reactions
### Requirements
* Minecraft 1.21.10
* Forge Mod Loader
* MateSignal installed and integration enabled in MateEngine
## Dance Player Update
* Added **Lock Mode (Experimental)**. Enables camera tracking for dances that move the avatar far left or right so the window follows their motion.
## Hand Tracking Changes
* Hand tracking is more accurate to the mouse position.
* Reduced activation zone to prevent unwanted tracking on smaller avatars.
## Buy Option
* Added a buy button to the Minecraft Integration and Steam DLC categories. These buttons appear when running the free GitHub build.
## Bug Fixes
* Avatars no longer attach to windows or the taskbar while custom dances are active.
* Fixed avatar disappearing after sitting on minimized windows.
* Fixed incorrect positioning when a window closes.
* Fixed teleport when a window is maximized.
## Internal Changes
* Removed unused code to reduce missing script warnings.
* General cleanup and small performance adjustments.
**Changelog 1.5.0-GM**
**GM** stands for **"Golden Master Release"** — a stable milestone equivalent to a “1.0.0” release. While considered production-ready, minor issues may still exist.
---
### Fixes & Improvements
- **Added EXPERIMENTAL "Window Sitting" Feature!**
This must be manually enabled in **Options**. When active, dragging the pet onto the top of a window will cause it to "snap" and sit on it.
**Warning:** This feature can trigger anti-cheat software in certain games. Use at your own risk — I recommend leaving it off unless you know what you're doing. This is a light version of the highly requested functionality and may not be perfect, but it works well enough for casual use.
- **VRM stats** in the top-left corner now correctly reset when clicking the **Reset** button.
- Fixed an issue where **particles followed the pet’s head** during headpats. They now stay in proper **world space**.
- Fixed a bug where **particles disappeared** when rapidly headpatting.
Particles now **spawn and despawn with a slight delay**, improving visual smoothness.
- Adjusted **particle lifetime and color scheme** to better match the app's overall aesthetic.
- Particles now appear **more vibrant in Bloom mode**.
- Fixed a bug where **particles stopped spawning** after switching from a custom VRM back to the default Zome model.
- Fixed an issue where the **Reset** button failed to fully reset all settings.
---
### Known Issues (Not Fixed Yet)
- AI Chat window is not scrollable.
- There's a small gap between the **Taskbar and Desktop** that prevents the pet from dancing.
- The app may crash after 8–12+ hours of runtime, likely due to an issue with the **NAudio** library (still under investigation).
---
### Big Update:
### **The `.me` File Format**
**(Enhanced Custom Avatars & Modding Support)**
The new `.me` format is a **Unity AssetBundle-based avatar system** that supports **fully customized 3D models**, beyond the limits of standard `.vrm` files. While `.vrm` files were restricted to MToon shaders and VRM constraints, `.me` opens the door to true Unity-native customization.
#### What can you do with it?
- Use **any shader** (LilToon, Poiyomi, etc.)
- Add **custom lights**, effects, and animation setups
- Integrate complex avatars just like in **VRChat**
- Retain full support for VRM rigs and humanoid structures
We’re also building a **conversion SDK** to help you migrate existing `.vrm` or VRChat avatars to the `.me` format.
- If you already have a `.vrm`, converting it will be quick and easy.
- If not, we’ll provide a simple guide to get you started.
---
### Bonus: `.me` Modding Support
You can now inject **prefabs and assets** into your avatar — as long as they don’t include compiled code (`.dll` or custom C# scripts).
Want a floating **Minion**, **Pokémon**, or any Unity prefab following your pet? Go for it.
**Note:** Audio and video files are not supported *yet* — but they’re on the roadmap.
