# 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.
MateEngine 2.5.0 – The Polishing Update
MateEngine 2.5.0 focuses entirely on refinement and user experience. Countless small bugs, jitters, and inconsistencies have been removed to make the overall experience smoother, more stable, and natural. This update introduces no new features but improves performance, responsiveness, and internal reliability across all systems.
**VRMLoader Update**
* Added full support for VRM files using the **Standard Shader**
* Added full support for VRM files using the **UniGLTF/UniUnlit Shader**
These changes ensure that more avatar types load correctly and consistently, both in Editor and Build mode.
**Performance Updates**
* Reworked **VRM SpringBone** logic — same visual quality, now with **50% less CPU load**
* Optimized MateEngine’s **component network**, reducing overhead by **25%**
* Refined **physics engine**, resulting in **15% lower CPU usage** during runtime
* Improved **caching system** across several core modules, providing smoother performance on low and mid-tier PCs
*(Note: This does not bypass minimum system requirements — hardware below spec will still experience reduced performance.)*
**Fixes and Improvements**
* Fixed#316: Avatar number slot being cut off due to window size or position
* Fixed#307: Language option not working correctly on the tutorial page
* Fixed#314: Certain idle animations playing too fast
* Fixed an issue where the avatar **“Lazuli”** had stockings clipping through shoes
* Fixed an issue where some VRM models appeared with closed eyes when sitting on windows or the taskbar
* Added an option to enable or disable mods during runtime.
*(Some mods may still require a restart to apply or unload correctly. Restarting MateEngine after installing new mods is recommended.)*
* Fixed a critical issue that completely broke the **Custom Dance Player** for the main avatar (“Zome”). This caused animations to freeze until MateEngine was restarted. The issue has been fully resolved.
**Window and Taskbar Sitting Improvements**
* Fixed/Improved #317: Avatars sitting on windows or the taskbar no longer glitch during vertical mouse movement. Movements are now smoother and more natural, making sitting interactions feel more stable and realistic.
**Internal Changes**
* Removed all warnings caused by missing scripts
* Cleaned and reorganized deprecated code and methods
* Improved internal consistency across multiple systems to make future updates faster and more stable
MateEngine 2.4.3 – Patch 3
**Changes:**
* Sliders now adapt their color to your selected Hue setting.
* The Settings menu can now be opened while the Dance Player is playing an MMD animation.
* You can now enter Big Screen Mode during MMD playback (experimental).
**Fixes:**
* Fixed an issue that caused mods to upload twice instead of once.
* Fixed event-based message mouth movements not working for custom models.
* Fixed headpat facial expressions not working for custom models.
* Fixed idle facial animations not working for custom models.
* Fixed CJK text rendering issues in the Dance Player.
**Dance Player Updates:**
* Dance trails are now visible when the avatar dances.
* Dance Player now uses legacy text rendering, allowing Korean, Chinese, and Japanese characters to display correctly in the mod list.
* Added “Force Stop Dance Player” to the system tray icon. This stops the dance animation if the avatar moves out of the camera view (common in wide-range dances). This is a temporary fix while improvements to camera and range handling are being developed.
**Performance Updates:**
* Improved CPU efficiency by reworking several core MateEngine scripts.
* Optimized performance when multiple mods are active in the Dance Player.
**Mods Notice:**
Installing too many custom models or mods can affect performance. Recommended limits for optimal stability:
* Dance Mods: up to 50
* General Mods: up to 20
* Custom Models: up to 10
**Developer Changes:**
* Removed deprecated Dance Player files.
MateEngine 2.4.3 – Patch 3
* Fixed an issue causing mods to upload twice instead of once.
* Fixed an issue where Event-Based Message mouth movements did not work on custom models.
* Fixed an issue where head-pat facial expressions did not work on custom models.
* Fixed an issue where idle facial animations did not work on custom models.
* Fixed an issue where CJK text was broken in the Dance Player.
Dance Player Updates:
* Dance Trails now appear when the avatar dances.
* The Dance Player now uses legacy text support, allowing Korean, Chinese, and Japanese characters to render correctly in the mod list.
