Public Release x3.2.0

MateEngine X3.2 – Community Update

This update focuses on community suggestions and reported bugs.

Timer Update (User Request #363)

You can now add unlimited timers to MateEngine—perfect for reminders like your pizza timer.
Open the Alarm menu via the radial menu and click the new “Add Timer” button next to “Add Alarm.”
Set any duration up to 24 hours and 59 minutes, and add a custom message for each timer.

Dance Player Update (User Request #321)

• Added a Shuffle button to play random dance songs instead of following a fixed order.
• Added a Loop button to repeat your favorite song and dance indefinitely.

Window Sitting Adjustment (User Request #368)

• Expanded the Y Offset Slider range for finer control over avatar height on windows or taskbars.
  Ideal for models that appear too small or too large.

Random Avatar on Startup (User Request #371)

• Added a new toggle under Steam DLCs: “Start With Random Avatar.”
  When enabled, MateEngine will launch with a random avatar from your Workshop Library.

Steam-Free Startup and DLC Support (User Request #329)

• MateEngine can now start completely without Steam—just run MateEngine.exe.
• The “Start with System” feature also works without Steam.
• All Steam DLCs and features can now be used while offline.

Note: You must start MateEngine through Steam at least once every 30 days to refresh your offline token. This prevents piracy of the Steam version.

VoicePack / VoiceMods Update (Developers Only)

• Added support to change headpat sounds while the avatar is sitting.
• Added support to change the pixel speech sound used by the Minecraft integration.

Bug Fixes

• Fixed #341: “Avatar Always On” not persisting after restart or window sit.
• Fixed an issue where food sound volume didn’t respond to the Pet Volume slider.

Full Changelog: Public-Release-X3.1.0...Public-Release-X3.2.0

Public Release x3.1.0

MateEngine X3.1

Screenshot Feature

• You can now take high-quality screenshots of your avatar directly from the MateEngine System Tray by clicking “Take Screenshot.”
  Images are saved with a transparent background, ideal for creating banners or editing photos.
  Saved under: Pictures/MateScreenshots

System Tray

• Added a Resize Window option. This helps users on high-resolution displays (such as 4K monitors) adjust the app size between three preset scales if it appears too small on first startup.

Window Sitting & Taskbar

• Fixed a minor animation issue in one of the sitting poses.
• Reworked and re-added three old sitting animations for full compatibility with the new sitting system.

Food System

• Added four new cakes (sound effects pending).
• Fixed rendering issues with smoothies.

Note: The Food System is currently in Alpha. Bugs are known and do not require reports until the feature is officially released.

Bug Fixes

• Fixed an issue preventing the avatar from sitting on the macaron when the Window Sitting feature was disabled. It now works correctly regardless of that setting.

Public Release X3.0.0-1

MateEngine X3.0-1 Patch

• Fixed an issue where the avatar could clip into the taskbar when moved sideways quickly before sitting.
• Fixed an issue where the avatar could clip into windows when moved sideways quickly before sitting.
• Fixed an issue where the avatar could sink into windows or the taskbar when switching sitting positions rapidly.
• Fixed an issue causing the MateEngine startup sound to play with a long delay.

Public Release X3.0.0

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) - STEAM ONLY!

• 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 - STEAM ONLY!

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 - Github ONLY!

• 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.
• Fixed an issue where VoicePacks didn't replace the Startup Sound

Internal Changes

• Removed unused code to reduce missing script warnings.
• General cleanup and small performance adjustments.

Public Release 2.7.0

MateEngine 2.7.0

Fixes and Improvements:

• Fixed an issue where the avatar could be dragged beyond window edges, causing visual glitches.
• #268 The avatar no longer reacts to mouse movement when “Avatar Always in Front” is disabled.
• #288 Added a “Reset Blendshapes” button to the Blendshape Menu.

Changes:

• #149 Headpats now require circular or back-and-forth mouse movement on the avatar’s head to trigger the animation.
• Reduced the “Hand Hold” detection area to prevent accidental activation during headpats.

New Cosmetics:

• Added a new cosmetic item “ERROR!” under Steam DLCs, featuring an animated pixel-style face overlay.

New Dance Trails:

• Added a dropdown in Dance Settings allowing you to select from multiple dance trail styles to match your preference.

Face Expressions:

• The avatar now uses the “>_<” expression when dragged by the mouse (requires proper setup on custom models).
• Female avatars now display the “>_<” expression when the mouse hovers over sensitive areas.
• In BigScreen mode, the avatar closes its eyes and relaxes when receiving headpats.

AI Chat Update:

• The avatar now moves its mouth while speaking through AI Chat.

Alarm Update:

• The Alarm system is now located in the Circle Menu instead of the Settings Menu.
• Clicking the Alarm icon opens the new Alarm Menu, which supports unlimited alarms.
• Each alarm can now be configured for specific weekdays.
• If no days are selected, the alarm triggers daily at the set time.
• To enable alarms on specific days (e.g., Monday and Friday), press the “MON.” and “FRI.” buttons.

Language Update:

• Updated translations for Korean, Chinese (Traditional and Simplified), Kazakh, Ukrainian, German, Polish, Japanese, Spanish, Turkish, and French.

Full Changelog: Public-Release-2.6.0-GM...Public-Release-2.7.0

Public Release 2.6.0-GM

MateEngine 2.6.0 – Modding Update

UI Updates

• Languages are now preloaded, removing visual glitches when opening the Settings Menu
• The Settings Menu UI has been fully redesigned, with all settings organized into clear categories for easier navigation
• Overall UI loading speed has been improved
• The Tutorial Page now matches the new UI design for a consistent look
• Changed the spacing between each letter to make the UI more compact

Model Updates

• Adjusted Ayrina’s breast physics for more natural movement (they were a bit too exaggerated before)

Tooltips

Tooltips have been added to several options to explain their functions. This helps users better understand each setting and makes MateEngine more accessible to everyone.

Language Updates (90%)

Traditional and Simplified Chinese have been added so that Chinese users can fully understand and enjoy the app.
All existing translations have been updated and refined. Thanks to the community for helping translate MateEngine.

Fixes and Improvements

• Startup speed restored to match older versions
• Boot time improved by 20% compared to previous releases
• Fixed a memory leak when switching avatars frequently
• Fixed the issue where the model “Ayrina” didn’t blink when giving headpats
• Fixed a distortion issue with the dropdown menu on the Tutorial Page
• Reduced Ram Usage by -75,00 MB

Steam Workshop Update

• Unsubscribed mods now disappear automatically; manual removal is no longer needed
• Mods can now be installed during runtime and used immediately without restarting MateEngine (some mods may still require a restart)
• Author and description are now automatically displayed when set in MateSDK

New Workshop Tags

• Dance
• Animation
• Sound
• Particle
• Mod
• Misc

Sound Pack Mods

You can now create Sound Packs for MateEngine using the MateSDK on GitHub.
Basic Unity knowledge is enough to get started. Open the MateEngine project and locate the "VOICE_PACK_MOD_EXAMPLE" object.
Add your custom sounds, then export your mod file. You can import it into the Mod Menu or publish it directly on Steam Workshop.

When exporting, select Mod Type: “Sound”.
This feature lets you replace every sound in MateEngine with your own.

Supported formats: .ogg, .mp3, .wav
(Recommended: .ogg or .wav)

Dance Mods

You can now create custom Dance Mods for the Dance Player.
With basic Unity knowledge, you can create or convert existing VMD (MMD dances) into .ME (MateEngine Dance Mods).

For modding please read the documentation here:
https://github.com/shinyflvre/Mate-Engine/wiki
https://github.com/shinyflvre/Mate-Engine/wiki/Create-a-Dance-Mod
https://github.com/shinyflvre/Mate-Engine/wiki/Create-a-Sound-Pack-Mod

Full Changelog: Public-Release-2.5.0-2...Public-Release-2.6.0-GM

Public Release 2.5.0-2

MateEngine 2.5.0-2 – The Finishing Update

Performance Update

• Fixed an issue that caused slow boot times on the Steam version.
• Improved startup speed by up to 2×, allowing MateEngine to launch much faster.
• Added automatic mesh data optimization to reduce GPU usage. Note: User-generated content such as Workshop avatars may still perform worse than MateEngine’s original avatars.

VRMLoader Update

• Added managed RAM allocation to minimize memory leaks when switching models frequently.
• Reduced overall RAM usage to improve system stability.

Dance Player Update

• Added smooth transitions between dances and animation states, including idle.
• Improved transitions when switching dances for a more natural and fluid experience.
  Note: A brief lag may still occur when switching dances, as audio and animation are loaded and unloaded from mod files to conserve memory.
• Dance Player is no longer available during the intro animation and becomes active only once the avatar enters the idle state.

Internal Changes

• Reduced total script usage.
• Removed redundant code to improve stability and overall performance.

Public Release 2.5.0

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

Public Release 2.4.8

MateEngine 2.4.8

Fixes and Improvements:

• Fixed an issue where .ME Dance Mods were not synced across multiple instances.
• Fixed an issue where regular .ME Mods appeared in the Dance Player list.
• Improved Sync Dance between instances; synchronization should now be precise, with only rare desyncs of up to 0.5 seconds.
• Fixed an issue where facial expressions could become stuck during dances.
• Songs now preload on all instances. This may delay playback by 1–2 seconds after pressing Play, which is intentional to ensure synchronized starts.
• Added a feature that limits playback to songs in your favorites list when the favorites filter is active.
• Added a Sync toggle button to the Dance Player. When enabled, dances sync across all instances; when disabled, each instance plays independently.
• Added 6 more instance slots, allowing up to 9 avatars simultaneously on your desktop.

Full Changelog: Public-Release-2.4.5...Public-Release-2.4.8

Public Release 2.4.6

change this to non markdown:

MateEngine 2.4.6

Dance Player Updates

• Added automatic MMD-to-VRM facial expression conversion for avatars without MMD Blendshapes. Models must include standard VRM Blendshapes; otherwise, no facial expressions will appear.
• Added the ability to favorite songs in the Dance Mods list.
• Added a Favorite Filter: click the heart icon to display only favorited songs.
• Added Song Search to quickly find songs by title.
• Improved visuals with smoother fade-in and fade-out transitions.
• Added Sync Dances: when multiple MateEngine instances run (via Instance Feature), all avatars can dance simultaneously. This is experimental and may have up to a 0.5-second offset between instances due to timing limits.

Changes

• Dance Trails can now be toggled on or off in the main settings menu via the icon with three balls. This also affects trails in the native Dance Feature.

Fixes

• Fixed mixed VRM and MMD facial expressions during dances that caused morph glitches and clipping.
• Fixed an issue where the last item in the Mod List was blocked by UI buttons, preventing deletion when the list was long.

Full Changelog: Public-Release-2.4.4...Public-Release-2.4.6