MateEngine news & patch notes

Hello Silly Goobers!

You may think, “Oh, there hasn’t been an update for a month.” Sometimes we humans need a vacation and a break from certain things in life, and that’s exactly what I did. The break is over, and I’ll soon be working on updates that mainly focus on fixing reported bugs.

After those smaller bug-fix updates, I’ll introduce two new features I’ve been working on secretly in the background. I can’t wait to share them, and I thank you all for the bug reports, feature requests, and feedback.

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.

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.

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.

MATEENGINE X3.0

First of all, thank you so much for using MateEngine, especially to everyone who purchased it and supports me as a solo developer.

MateEngine has reached a new milestone. We’ve fixed many bugs and added three major features and core changes to the app.

You may have noticed a lot of recent updates. That’s because I’ve seen incredible support on Discord and here on the Steam page. It truly motivates me, and as an indie dev, I’m having even more fun working on this project. My goal is to make MateEngine the best desktop mascot experience possible.

We’ve changed and improved so much already, and this is just the beginning. I plan to keep updating the app over the next few months, and I hope you enjoy every new feature that comes your way.

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 it is a nice to have. Note: You might wonder why the avatar isn’t holding the smoothie. This can be done for the main avatar but not for custom models. Each custom avatar has a different bone setup and size, making it impossible to attach props directly. We created a workaround that works best for everyone instead.

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 or Fabric 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

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.

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. • 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.

Oh no! A zombie!

Yes, you see that right — we’re bringing Minecraft into MateEngine! We’re developing both a Forge mod and a Fabric mod for Minecraft 1.21.X.

This integration enables cross-interaction between MateEngine and Minecraft: Java Edition. Right now, we’re building a system where your avatar warns you when certain mobs are nearby. We’ve all been there: a creeper sneaks up, and suddenly—boom—you’re gone.

Not anymore. This time, your favorite avatar will help keep you safe during your Minecraft sessions, warning you whenever danger approaches. Soon!

Improved Taskbar and Window Sitting

We are currently rewriting the sitting mechanics for taskbar and window sitting. This update will allow avatars to sit on windows and the taskbar in a more natural and visually appealing way. It uses special layering methods so that legs appear in front of a window while hair and other parts render behind it, creating a more realistic look.

Developing this feature is challenging, as MateEngine is designed to stay lightweight and highly performant. While we cannot guarantee its final inclusion, we want to share what might be possible in the future. Our goal is to make it work for all custom models created by the community.

The hardest part is ensuring compatibility with custom VRM and ME avatars, since their size and bone structures vary. We are actively researching solutions to address this remaining issue. In the meantime, we will continue delivering quality updates for MateEngine and hope to bring this feature to life soon. Another example: (Please ignore the grey box it is there for debugging)

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 that allows resetting all blendshape values to default.

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 in a retro arcade design.

New Dance Trails:

• Added a dropdown menu in Dance Settings where you can select from multiple trail effects to match your style and 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 while receiving headpats.

AI Chat Update:

• The avatar now moves its mouth in sync while speaking through AI Chat for more natural interactions.

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, allowing you to create unlimited alarms.

• Each alarm can be configured for specific weekdays.

• If no days are selected, the alarm will trigger daily at the set time.

• To enable alarms only on selected days (for example Monday and Friday), press the MON and FRI buttons.

Language Update:

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

MateEngine 2.6.0-2 – Performance Update

A new toggle called "Memory Optimization" has been added in the Debugging section (Open Settings and scroll down). When enabled, it reduces RAM usage by up to 60%. If you notice bugs, issues, or strange behavior, it’s recommended to turn this feature off. This option is mainly intended for systems with 8 GB of RAM or less. Users with 16 GB or more generally don’t need to enable it.

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 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

Modding Update

An update is coming in a few days that opens more modding in MateEngine. This post walks you through what is new and how you can join in. MateEngine was built for the community and I have been reading your wishes on Discord and the GitHub request hub. Let us make cute things together.

What is coming

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.

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.8 - 8 Avatars At Once! + Dance Player / Sync Improvements

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.

Ongoing:

• Added a visual indicator showing which song is currently playing in the list.

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.

• Stability fixes.

• Some other minor fixes.

MateEngine 2.4.4 - Patch 4

Changes:

• Major performance boost when multiple mods are installed

• Improved performance when handling many chatbot messages

• Slight performance gain for Dance Player

• Reworked internal code for overall optimization

• Updated color theme options for better consistency

• Fixed several issues with old color theme sliders that caused UI color glitches

• Fixed performance issues on high-end PCs

• Fixed loading issues with mods

• Reduced load time for custom dances

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.2 - Patch 2

- Added Volume Slider to Dance Player

- Mod List is now scrollable

MateEngine 2.4.1 – Patch 1

* Fixed memory overload issues with Mods and Dance Mods

* Fixed face distortion caused by MMD blendshapes in the Dance Player

* Songs now automatically play the next track when the current one finishes

MateEngine 2.4.0 – Custom Dance & Husbando Update

Two major features are here: Custom Dances and Husbando Mode.

Custom Dances (MMD-like) A new Circle Menu entry has been added. Open the menu and select Play to access the new Media Player, which lets you load and play modded dance files with synced music and animation. You can now upload and share custom dances via the Steam Workshop. These are not native .VMD or .PMX files. To create a dance mod, convert your MMD/VMD animation into a Unity FBX Animation. Full documentation and sample projects will be released soon, including several ready-to-try example dances on the Workshop.

Husbando Mode This update adds male animation sets to MateEngine. Activate it in Options → Husbando Mode. When enabled, avatars use masculine Idle and Dragging animations, and headpats are disabled. Husbando Mode also includes exclusive male dance animations distinct from the female ones.

Important This is a global toggle, not per-avatar. It affects all characters, including modded avatars, until you disable it.

Note Husbando Mode is experimental. MateEngine will continue to focus on Waifu-based content, while this feature remains a community-requested addition with limited future expansion.

Thank you for your continued support. Note:// Keep in mind both features are in early stages! report bugs if you find them! feedback is also welcome!

MateEngine 2.2.5

New

• Dragging Physics: Avatars now respond with realistic body motion when dragged. Moving the avatar in any direction causes slight counter-rotation and limb sway for more natural movement.

• Added a transition layer between Dragging Physics and all animation states to eliminate visual glitches during transitions.

Changes

• The avatar no longer attempts to hold the mouse cursor during dragging. This was removed because it could cause arm distortion in certain states.

Logo Update

• The MateEngine logo is now Pink and Blue.

Improvements

• Custom avatars now trigger automatic garbage collection roughly every 30 minutes, reducing RAM allocation over time and improving memory stability when avatars are not frequently changed.

• CPU usage reduced by approximately 3 percent.

• GPU usage reduced by approximately 5 percent.

• When dragging the avatar after holding its hand, the hand now smoothly returns to the body instead of snapping back. This provides a more natural and realistic transition.

• Reduced skirt clipping on MateEngine official models. This does not apply to custom avatars.

Dynamic Bones Support

• MateEngine now supports DynamicBones. If you create an .ME model and prefer not to use SpringBones, you can use DynamicBones for skirts, hair, and other physics-based elements.

Windows 10 Support

• Official testing on Windows 10 has been discontinued due to Microsoft’s end of support.

• MateEngine will continue to run normally on Windows 10, but future updates may include untested features.

• Functionality should remain unaffected, as Windows 10 and 11 share the same .NET and library base.

MateEngine 2.2.4-2 – Debugging Update

Debug Menu

Added a Debug Menu (open with F8) that displays nearly all internal parameters, including bools, ints, floats, and strings. Includes advanced developer options to modify internal AI behavior and hidden engine variables. Use with caution — intended for modders and developers only.

Examples of what can be changed using Debug Settings:

• Rotate the avatar

• Scale the avatar beyond normal limits

• Adjust individual X, Y, Z scale axes

• Rotate along X, Y, Z axes

• Modify texts and colors

• Manipulate any component at runtime

• Essentially, control almost everything normally locked from user access

You can enable auto-start for debugging to automatically load your saved Debug Settings profile. Warning: Misuse may cause instability or break the software. If that happens, delete the MEValueChanger folder in AppData/LocalLow/Shinymoon to reset.

Fixes and Improvements

Fixed typo: “Context Lenght” → “Context Length” Slightly improved AI streaming performance Reduced AI response latency Added partial integration of a custom Dynamic Bones build for future use in correcting skirt clipping on .ME models

MateEngine 2.2.0

Huge AI Update

• Switched from the local LLM "Qwen 3 4B" to "Llama 3.2 3B" by Meta Platforms Inc. We found that Llama 3.2 3B fits much better for casual conversation, and the previously known "Loop" text issue has been fully resolved.

• Conversations now feel more natural and coherent.

• The Chat Bot no longer repeats or rephrases the same answer.

• Markdown rendering has been improved for better formatting and readability.

• The new model is more lightweight and performs faster on mid-range GPUs.

• VRAM usage has been reduced from approximately 6.5 GB to 4.5 GB on average.

• Added a Context Length setting that lets you choose between 2K, 4K, 8K, 16K, and 32K. Keep in mind that higher context sizes require more VRAM and power. The default value is 4K, which runs well on low- and mid-range GPUs. For the best performance, we recommend 8K or 16K.

• Overall chat streaming speed has been greatly improved.

• The total build size of MateEngine is now 500 MB smaller.

Built with Llama 3.2 — © Meta Platforms Inc. Not affiliated with or endorsed by Meta. Not an official Meta product.

MateEngine 2.1.4

**AI Changes**

We implemented Semi-Markdown Text Support.

These are the formats that are Supported

- # Heading 1

- ## Heading 2

- ### Heading 3

- **Bold**

- *Italics*

- ***Italics Bold***

It does not support Code Blocks.

- AI Streams a little faster its responses however this may only apply to PCs with RTX4XXX and RTX5XXX Cards but not below or any AMD GPU

- Markdown Text Color Changes based on your color settings in the Main Menus so it does not look out of place

**VRMLoader Changes**

The VRM Loader should now load models slightly faster than before. However if you use a High End PC you will not notice any difference this is only noticable on Lowend and Mid End PCs

MateEngine 2.1.2

Avatar Settings Soft Reset The first time you start version 2.1.2, your last used avatar may not load automatically. This is because the system for saving and loading avatar settings has been updated. Simply select your favorite avatar again after updating, and everything will return to normal.

Multi Avatar Support You can now have up to three avatars active on your desktop at the same time. To add another avatar, open the Settings Menu and click the Head Icon next to the "MateEngine" title between the "Bug" and "X" icons. Two buttons will appear in the lower left corner of the menu labeled "Open Avatar 1" and "Open Avatar 2". Each button opens a new MateEngine instance with its own model and independent settings. For example, if you assign "Ayrina" to Avatar 1, it will always load that model with its saved configuration.

Note: This feature is still a work in progress. The AI Chat function works across all instances but shares the same chat content. It is recommended to use AI Chat only in the main instance.

Mouth Movement Avatars now move their mouths when speaking during Event Based Messages, making them appear more natural.

MateEngine 2.1.0

Why is this version 2.1.0 already and not 2.0.1? The reason is we updated the whole engine backend. We updated from Unity 6 to Unity 6.2, which is a major change to the engine that runs MateEngine.

Event Based Messages When your Avatar is dragged, dances, gets headpats, sits on a window, or rests on the soft macaroon, it will now randomly make comments! To use this feature, go to Options → Steam DLCs → Event Based Messages. (Available for Steam users only.)

Engine Update We updated from Unity 6 to Unity 6.2. This may break some older mods — please test them! If your mod or model is affected, rebuild it in Unity 6.2.

Language Updates

• Added Ukrainian

• Added Kazakh

• Added Polish

• Added Turkish

• Updated German

• Updated Korean

• Updated Japanese

• Updated Chinese

• Updated Spanish

• Updated France

• Updated English

Thanks to: Alchemistake, Azey, Beeswax, Before your eyes, Błodzimierrz Wiały, BORDO, C1PH3R, Cluxy, darkzy, DREMKA., julausrie, Merdondria, Micmic1107(Kaze Simp), naitbird, Potatoo, Pyxis(WindSekirun), Red-Teto, Rice :ear_of_rice:, Sigtryggr With Whiskers, Thelvaën, Tsugato, Yohu, a^•^=^Amika^•^=^a, もり Mori — for the translations!

Fixes

• Chat window position when sitting could clip messages or fade them out.

System Tray

• Added “Move To Main Monitor” button. If the avatar is on a second monitor or not visible, you can reset its position. This mostly happens when using a multi-monitor setup and unplugging one monitor while the pet is still on that screen.

Quality Changes

• Graphic Preset “Ultra”: Unlimited bone weights → most realistic bone movement, but very high CPU and GPU usage.

• Graphic Presets “Very High” and “High”: Use 4 bone weights → smooth animation and mesh deformation with moderate resource usage.

• All other presets: Use 2 bone weights.

• “Low” Preset: Only 1 bone weight per vertex → very lightweight but with rigid animations.

MateEngine 2.0.0

Thank you so much for using MateEngine, whether it’s the free version on GitHub or the donated version on Steam. I’m so grateful to every single person who supports this little open source project.

Version 2.0.0 is a really big update with lots of love poured into it. It brings new AI chat features, fresh sounds, and cute little cosmetics. All of this only exists because of your feedback. Without you, MateEngine wouldn’t be where it is right now.

And this is only the start. I’ll keep supporting the app in the future whenever you or I come up with new ideas to make it even better.

Right now MateEngine is the strongest 3D desktop mascot on Steam, with full control, tons of settings, custom avatars, custom file formats, modding and more.

Thank you thank you thank you!

AI Updates

• Added scrolling for AI conversations. You can now move up and down through the last 50 messages. (This limit ensures performance and keeps MateEngine lightweight.)

• Improved AI Chat UI to match the new overall MateEngine design. Messages now smoothly fade in and out when scrolling, creating a cleaner and more modern look.

• AI Chat bubbles now feature subtle animations and a gradient fade effect for improved visual appeal.

• Updated the Qwen 3 b4 model for greater accuracy in responses.

• Local AI received new training data that is more up-to-date and responds more naturally depending on your system prompt.

• Fixed flickering/glitching visuals when the AI generates a message bubble. It should now be smooth.

• You can now change the system prompt within the Options menu of MateEngine instead of editing the .txt file in LocalLow. The prompt updates immediately, but a restart is recommended.

Animations

• Adjusted state transitions to be more lively and smooth.

• Simplified some parameters (this should not break any mods).

A Little Thank You

• Added "Sakura" Color Edition of the Steam Halo.

• Added "Retro" Color Edition of the Steam Halo.

• These are free variants of the "Steam Halo" accessory for Steam buyers as a thank you. More accessories may come as DLCs or gifts in the future.

Sounds

• Updated sounds for sliders.

• Updated sounds for button clicks/presses.

• Updated sounds for checkmarks.

• Updated sounds for submenu open/close.

• Updated sounds for MateEngine startup.

• Updated sound when dragging avatars.

• Updated sound when placing avatars.

Steam Workshop

• Downloaded Workshop avatars are now instantly available in MateEngine without restarting.

• Only model owners can upload. Downloaded Workshop items will not show an "Upload" button to prevent duplicates.

• New "Owner" parameter: importing a local VRM/ME file marks you as the owner, allowing uploads.

• After uploading a model, the "Upload" button becomes "Update". To update, replace the original file with the new version (same name and path), then hold "Update" for 5 seconds to replace it on Steam Workshop.

Community Requests

• System Start implemented in 1.9.8.

• System Tray implemented in 1.9.0.

• Scrollable AI Chat.

• Improved AI Chat.

• System Prompt Customizations.

Fixes / Patches

• Fixed blendshape menu not moving correctly when the avatar was on the right screen side.

• Fixed Steam startup issue where MateEngine tried to re-download all Steam content unnecessarily.

• Improved scrolling performance in several menus.

• Fixed issue where the avatar couldn’t sit on the Taskbar in Windows 10.

• Fixed issue where the avatar didn’t sit correctly on Windows in Windows 10.

• Cleaned up unneeded log types for better debugging.

• Removed unnecessary files inside the project.

• General code cleanup and sorting for MateSDK.

MateEngine 1.9.8

New Features Animations

• Added 2 new Sitting Animations

• Added 2 new BigScreen Animations

System Start Option

• New “Start with Windows” checkbox in the Options menu

• When enabled, the app will auto-launch on PC boot

• Default: disabled (can be toggled anytime)

Blendshape Settings (Experimental)

• Allows adjusting mesh features on most avatars (e.g., hair length, chest size, legs, face shapes, expressions)

• Works with existing Steam Workshop avatars

• Reset settings anytime by deleting the corresponding .json file in: AppData/Local/Shinymoon/Blendshapes/

• Added shortcut button in Circle Menu (right-click avatar → slider icon → Blendshape Menu)

UI Updates Main Menu

• Slight reshade for a more modern look

Circle Menu

• Added UI particles to match the Main Menu style

• Reshade applied for consistency with Main Menu

• Icons updated to appear sharper and less pixelated

Fixes Scrolling Bug

• Fixed issue where scrolling speed increased with larger avatar/modding lists

MateEngine 1.9.6 Patch

New

• Added clothing options for the official model Ayrina. You can now toggle certain accessories on and off.

• Added 4 new cute animations to Big Screen Mode for more dynamic and natural movement.

Fixes

• Fixed an issue where the official model Ayrina’s face animations did not work. She can now blink and use facial gestures.

• Fixed an issue where the animation cycle could break when changing the transition time.

• Fixed an issue where some models (only built-in / DLCs) could not be loaded.