You are viewing a potentially older version of this package. View all versions.
zerp-MelSkin-1.18.0 icon

MelSkin

Hades II mod allowing you to select a dress for Melinoe from one of Arachne's boons and some custom skins. Includes updated portraits for each Arachne dress. Options to add favorites and randomize dress on run start. Includes support for the co-op mod.

Date uploaded a month ago
Version 1.18.0
Download link zerp-MelSkin-1.18.0.zip
Downloads 384
Dependency string zerp-MelSkin-1.18.0

This mod requires the following mods to function

Hell2Modding-Hell2Modding-1.0.98 icon
Hell2Modding-Hell2Modding

Lua Mod Loader for Hades 2

Preferred version: 1.0.98
LuaENVY-ENVY-1.2.0 icon
LuaENVY-ENVY

A plugin to allow ReturnOfModding plugins greater control of their environment.

Preferred version: 1.2.0
SGG_Modding-Chalk-2.1.1 icon
SGG_Modding-Chalk

System for handling config files in ReturnOfModding

Preferred version: 2.1.1
SGG_Modding-ReLoad-1.0.2 icon
SGG_Modding-ReLoad

Provides helpers for managing hot reloading and waiting for the right time to load

Preferred version: 1.0.2
SGG_Modding-SJSON-1.0.0 icon
SGG_Modding-SJSON

A plugin for handling .sjson files in ReturnOfModding.

Preferred version: 1.0.0
SGG_Modding-ModUtil-4.0.1 icon
SGG_Modding-ModUtil

Utility mod for mod interactions within lua for SGG's games

Preferred version: 4.0.1
zerp-MelSkinHelper-0.2.0 icon
zerp-MelSkinHelper

Helper mod for MelSkin. Does nothing on its own.

Preferred version: 0.2.0

README

Mel Skin Selector

Hades II mod allowing you to select a dress for Melinoe from one of Arachne's boons and some custom skins by burn and Aunuch.

Includes portrait replacements for the Arachne dresses with support for optional custom skin related portraits.

Options to pick favorites and randomize dresses on run start.

Installation

Use r2modman by ebkr from Thunderstore or GitHub.

While the mod has been tested decently well it is recommended to backup your save from %USERPROFILE%\Saved Games\Hades II\Profile*.sav in case there are issues.

Usage

NEW: The menu can now also be opened from Crossroads by interacting with Arachne's silk stand in the training grounds or the shelf/cabinet in Melinoe's tent.

ShelfInteract ArachneInteract

Use the Imgui menu (default toggle keybind: INSERT) or PonyMenu(new submenu in inventory) to select the dress.

Favorites are only available through the ingame menu.

PonyDressList ImguiSubmenu

PonyInv PonyInv

Skins

Lavender Azure Emerald Onyx Fuchsia
Lavender Azure Emerald Onyx Fuchsia
Gilded Moonlight Crimson DarkSide Alternate Time by burn (Updated by Aunuch)
Gilded Moonlight Crimson DarkSide Alternate Time
Murderrrrr by burn Chaos by jarlulsfark Visage by zerp
Murderrrrr Chaos Visage

Color selector

A color selector to allow setting any* dress and hair color. Only works with the ImGui menu (default toggle keybind: INSERT).

To activate, select Custom in the Dress drop-down and edit dress/hair colors and hit Apply. You can also use this menu to save/load presets.

Note: If the ImGui interface is unresponsive, try disabling vsync and setting a framerate cap though the ingame settings menu.

1 2

Includes support for selecting a random preset on run start. Custom should be favorited in the PonyMenu UI if there are other favorites selected.

3 4

Co-op Support

The mod also supports the Co-op mod by TheNormalnij. It'll only work if the co-op mod is loaded through the Hell2Modding ASI loader and the game is launched modded from r2modman/tsmm. Having both Hell2Modding and an addititonal ASI loader will break both mods.

The active player can be switched by using the Gift/Reroll button.

ImGui menu is not supprted for applying co-op skins, either use PonyMenu or Arachne's silk stand in the Crossroads.

Co-op

Some known issues

  • Random skin can sometimes apply the same skin over both players.
  • Color selector skin cannot be different for both players.

Contributing skins to this mod

Open a PR with this template https://github.com/adi1998/MelSkin/pull/10

Adding skins to your own mod

Sample mod for adding a skin https://github.com/adi1998/MelSkin_Example

Contributors

Issues

Report any issues here or on Discord

CHANGELOG

Changelog

Unreleased

1.18.1 - 2026-06-07

  • Adjust Visage boon portrait
  • Fix Custom skins not working after 1.18.0

1.18.0 - 2026-05-30

  • Add Visage skin
  • Add outline to Dark Side

1.17.0 - 2026-05-23

  • Add Co-op mod support

1.16.2 - 2026-05-03

  • Provoking the Fates compat, the provocation screen will now show custom portrait if available

1.16.1 - 2026-05-02

  • Re-enabled Custom skins(recolors).

1.16.0 - 2026-04-25

  • Using the Dark Side spell now switches to the correct laurel cinders and arm glow animations.
  • Temporariliy disables Custom skins(recolors) due to incompatibility.

1.15.2 - 2026-04-18

  • Update Chaos portraits

1.15.1 - 2026-04-18

  • Update readme preview for Chaos

1.15.0 - 2026-04-17

  • Add custom Chaos skin and portraits by @jarlulsfark on Discord
  • Add support for portrait overlay modifications
  • Add LaurelCinderSpawner hue shift support for unique custom skins
  • Add custom arm glow color support for unique custom skins
  • Custom boon select screen portraits now have fade in/out animations

1.14.0 - 2026-04-13

  • Adds interactable objects in the Crossroads for a more immersive dress changing UX
  • KB/M users can now exit the ingame menu using the Esc key
  • PonyMenu is now optional for ingame menu
  • Dress selection menu now has Melinoe slowly rotate in place

1.13.0 - 2026-04-08

  • Ghost Melinoe in Zagreus' Journey now uses custom portraits if available

1.12.0 - 2026-04-05

  • Fix shimmering for custom skin by using CG3H instead of deppth2 for texture packing

1.11.0 - 2026-03-15

  • Dualshock 4 and Dualsense controllers will now show the dress color in their light bars

1.10.1 - 2026-02-11

  • Fix imgui random dress button
  • Fix for random dress mode breaking if no presets and only custom is favorited.

1.10.0 - 2026-01-13

  • Add option to save color presets
  • Add support for loading lower resolution player textures
  • Add initial random dress support for color presets

1.9.0 - 2026-01-11

  • Add ghost arm slider
  • Disable arm glow for Alternate Time
  • Zoom during imgui menu
  • Dev: move exe to helper mod

1.8.0 - 2026-01-07

  • Add color slider for dress and hair

1.7.1 - 2025-12-19

  • Remove excessive logging during sjson hook

1.7.0 - 2025-12-15

  • Add Alternate Time(replaced with ending young Mel) and DarkSide costume for Rivals Typhon.
  • Replace young Mel portrait with the ending one for Alternate Time

1.6.1 - 2025-12-15

  • Update Dress menu background

1.6.0 - 2025-12-06

  • Updates to Alternate Time by @Aunuch
  • Basic support for adding dresses through other mods

1.5.0 - 2025-12-04

  • Add option to favorite dress for randomization.
  • Add a preview window for Mel.

1.4.0 - 2025-12-01

  • Add upgrade menu portrait
  • Update dialogue portraits for Lavender, Moonlight and Fuchsia

1.3.0 - 2025-11-29

  • Add option to randomize dress at run start

1.2.1 - 2025-11-27

  • Add Murderrrrr skin by burn

1.2.0 - 2025-11-27

  • Add portraits based on Arachne dresses by punishedmat

1.1.2 - 2025-11-25

  • bugfix

1.1.1 - 2025-11-24

  • bugfix

1.1.0 - 2025-11-24

  • Add Alternate Time skin by burn

1.0.2 - 2025-11-24

  • Readme changes

1.0.1 - 2025-11-24

1.0.0 - 2025-11-24

  • PonyMenu integration
  • minor bug fixes

0.0.2 - 2025-11-22

Added

  • Nightmare form now available.

Fixed

  • Skin now instantly changes on menu selection.
  • Handle Hecate/Chronos transform curse.

0.0.1 - 2025-11-22

Added

  • First version of the mod!