Atlyss Emote Wheel

A mod that adds an emote wheel to Atlyss. Also adds custom emotes. Source code is at: https://github.com/Snivyxxy/AtlyssEmoteWheel/tree/main

Install Instructions:

Put the AtlyssEmotes folder into the Bepinex Plugins folder. Use the settings menu to set your emotes.

Making and Adding Custom Emotes:

Custom emote packs can be dragged and dropped in any folder named "EmotePackages" under ATLYSS/Bepinex/plugins.

To Create an emote:

• Decompile a copy of the game through AssetRipper. Select your ATLYSS folder in the program, and export it as a unity project.

• Find the racemesh[species] folders in your decompiled unity project, and drop them into a new Unity Project.

• Drop the AtlyssEmotes dll and the EasySettings dll into your Unity project, along with the dll files highlighted below. Also drop in everything from Bepinex's Core folder.

• Install git, and Install AssetBundle Browser using this git link: https://github.com/Unity-Technologies/AssetBundles-Browser.git

• Make your animations, using a player model from the base game, with the Animator on the object shown below.

Each emote bundle must include a EmotePackage data object named "_Package". This can be created through the right click create menu, under ScriptableObjects/Custom/EmotePackage

• To make an emote, create a scriptable emote through the right click menu, under ScriptableObjects/Custom/Emote. Adjust various details about the emote's crossfade between the intro and loop animation clips. You will need to create animation clips using the animator attached to the player model. This will require some Unity knowledge, so look up how to use Unity's animation system.

• To create the bundle file, open the AssetBundle Browser window through the Windows tab on the top of your project window, mark the emotes and package as in one asset bundle, and build through the AssetBundle Browser window. (Open with the Windows tab)

• To use it, create a mod with the following folder structure: plugins/EmotePackages/[WhateverPackageHere]

Additional Details:

• Emotes can be Loop Only, Loop with Intro, or Non Looping, depending on which animation clips are set. NonLooping animations don't have a good fade out system and I can't find a good solution to it.
• If the Is Vanilla bool is set, the emote will play the base emote state in the player's animator using the Emote ID field. Emote ID is not used for anything else.
• Unique icons and icon backgrounds can be set to give your emote pack its own distinct visual identity. Don't leave these blank.
• For scripts already on the player's animator gameObject in the base game, animation events should work.

If the mod breaks, contact me on discord (@snivyxxy) If you're stuck floating mid air, that's probably because of this mod.

Todo

• Add Chat Functionality to Custom Emotes
• Add controller support

Changelog

• 1.3.8: Fixed Bad Math with Crossfades.
• 1.3.7: Re-added plugins folder
• 1.3.6: Fixed a bug preventing emotes with init and loop from playing properly
• 1.3.5: Fixed a Single Broken Link in Readme (Literally Unplayable)
• 1.3.4: Added images to help people understand my incomprehensible documentation
• 1.3.3: Actually looks in Bepinex plugins folder.
• 1.3.2: Fixed text showing up in weird positions in certain scenarios.
• 1.3.1: Fixed Custom Emote Loading for those Darn Pesky Mod Managers
• 1.3.0: Fixed bugs that broke the mod for update 82025.a1
• 1.2.8: Edited readme to have additional instructions on setting up the project
• 1.2.7: Edited readme to include instructions on how to add custom emotes. Custom Emotes Directions.txt was removed.
• 1.2.6: Added the Nod Emote
• 1.2.5: Now has default emotes
• 1.2.4: Now Tells You to Set Your Emotes
• 1.2.3: Fixed Mod Loaders Hating My Style (reformatted the package)
• 1.2.2: Readded Custom Emote System
• 1.2.1: Removed Playing Custom Emotes due to Multiplayer Issues.
• 1.2.0: Added Custom Emote System.
• 1.1.1: Changed Internals of How Emotes Are Played
• 1.1.0: Updated for New Atlyss Update
• 1.0.4: Changed nothing. Added source code link to ReadMe
• 1.0.3: Emote Wheel No Longer Opens when Chat is Open, and L.M.R. setting can now be changed on title screen.
• 1.0.2: Added Live Mouth Reaction Toggle (Idea courtesy of u/LayZeeFox)
• 1.0.1: Removed Live Mouth Reaction (Thanks Reddit User ...u/Dickin-Mayass)
• 1.0.0: Initial Release