AppearancePlus

AppearancePlus

2024-12-02

Customization mod to edit character sliders, player textures & dynamic bones(jiggle).

Requirements

BepInEx-BepInExPack-5.4.2100 icon

BepInEx-BepInExPack

BepInEx pack designed for Mono Unity games, preconfigured and ready for immediate use.

Preferred version: 5.4.2100

Readme

If you'd like to donate, I have left my job due to health issues and have dedicated a significant amount of my time to developing this mod. Any contribution would be greatly appreciated, but please only donate if you are able and willing.

FOR MOD SUPPORT (Feature Requests & Bugs):

I am most active in the 18+ Atlyss community in this dedicated post.

Currently, this plugin allows you to:

  • Swap Textures for the Player & NPCs (including Eyes & Mouths). Place textures in the CustomTextures folder.
  • Configure the range of sliders for each race, with both max and min values to uncap model proportions. Edit or swap the AppearancePlus_Config.txt in the plugin's folder.
  • Uncapped proportions work in multiplayer with this mod, provided the host has the same or higher cap in the config. Your slider ranges will apply to other players; otherwise, they will be capped. Ensure your Host has the mod as well.
  • Configure the dynamic bones for each part of the player model (ear, tail, chest, etc.) through a text file. Edit the AppearancePlus_Config.txt in the plugin's folder.
  • Reload config & textures in-game using chat commands. Use /reload sliders, /reload dbones, and /reload textures.
  • Edit with chat commands like /size <value> or /zoom <value>.
  • In-game console to view errors immediately. (This can be disabled.)
  • Uncapped zoom with a new property in the config.
  • Next Up: Emotes!!!

This plugin aims to become a general-purpose player modification tool, so please request features.

Most of the usage is described in "AppearancePlus_Config.txt". This config file contains DEFAULT VALUES. Remember to copy-paste the values from one of the included presets or edit them yourself.

Install:

Requirement: BepInEx: Latest Official - Thunderstore Version

  • Ideally, install through r2modman or Thunderstore for automated installation.
  • Currently: Only a fork of r2modman has the Atlyss community. The fork I know of is available in this server (18+) here.
  • If you are installing MANUALLY and do not have BepInEx installed yet:
    • Extract the archive into a folder. Do not extract into the game folder.
    • Move the contents of the BepInEx or BepInExPack folder (depending on which version you downloaded) into the game folder (where the game executable is located).
    • Run the game. To verify that BepInEx was installed correctly, activate its console in ATLYSS/BepInEx/config/BepInEx.cfg. Under [Logging.Console], change Enabled=false to true.
  • Unzip the Mod inside ATLYSS/BepInEx/plugins.
  • Create a folder for the mod if it doesn't exist, ideally named AppearancePlus.
  • Ensure your AppearancePlus_Config.txt file and CustomTextures directory are directly next to the plugin: AppearancePlus.dll.

Notes:

  • You can host multiplayer lobbies, though sometimes the game may disallow modded versions. Here's a mod (Atlyss Server) to circumvent that.
  • /reload dbones: Refreshes all Dynamic Bones present with the values in your config.
  • /reload sliders: Refreshes all the sliders' min & max values with the values in your config.
  • /reload textures: Reloads the textures inside CustomTextures and refreshes player & NPC textures.
  • /print dbones: Print all the current dbones values in the chatbox.
  • For Texture Swapping: Place the files in a CustomTextures folder inside the plugin's folder. Ensure the files are named exactly as they are in-game or in resources.asset (use Unity Asset Bundle Editor to view).
  • If you change slider ranges, ensure that you have Limit Proportions OFF in your settings.
  • Feel free to share presets for the AppearancePlus_Config.txt. More properties are being added and can be finely tweaked. You could, for example, post a snippet with Extra Bouncy or Hyper Sliders.
  • When modifying the file, ensure to follow the rules indicated within the text file.