Skip to content
FunkyByte1Public

About

Decky Loader plugin for browsing, installing, and managing game mods on Steam Deck without leaving Game Mode.

Topics

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

Moddy

Moddy

A Decky Loader plugin for one-click mod installation and management on Steam Deck, directly in Game Mode.

Project status

Important

Moddy has limited maintenance. Because of life circumstances, I won't have much time for Moddy going forward. I'll do my best to keep it working, but updates, bug fixes, and replies to issues will be slow and infrequent.

Anyone who wants to pick up the project is welcome to. Fork it and run with it, or open an issue or PR if you'd like to help maintain it here. It's licensed under the GPL-3.0, so you're free to build on it. CONTRIBUTING.md covers the dev setup and how games get added.

Install

Moddy isn't in the Decky store yet, so install it from its URL:

  1. Make sure Decky Loader is installed.
  2. In the Decky panel, open the settings (the ⚙️ icon) and enable Developer mode.
  3. Use Install from URL and enter get.moddy.gg.

That's it. Moddy appears in the Decky panel. It's alpha software, so expect bugs and report them if you like. Mods are third-party software and run with full access to your system. Please read the Disclaimer before installing anything.

Features

  • Browse and install mods without leaving Game Mode
  • One-click install of entire Nexus collections
  • Mod loader installation and management (MelonLoader, BepInEx, Lovely, REFramework, SMAPI, UE4SS, and more)
  • Version selection with rollback support
  • Dependency resolution and cascade disable/uninstall
  • Update checking for mods and mod loaders
  • Controller-native UI with d-pad navigation

Supported Games

Moddy installs mods from several sources. What you need to do depends on where a game's mods come from.

Thunderstore

No setup. Moddy installs from Thunderstore automatically.

  • Among Us
  • ATLYSS
  • Bomb Rush Cyberfunk
  • Bopl Battle
  • Content Warning
  • Crab Game
  • Cult of the Lamb
  • Dyson Sphere Program
  • Enter the Gungeon
  • Gamble With Your Friends
  • GTFO
  • Inscryption
  • Lethal Company
  • Megabonk
  • Muck
  • Nine Sols
  • Outward
  • PEAK
  • R.E.P.O.
  • Risk of Rain 2
  • ROUNDS
  • Shadows of Doubt
  • Sons of the Forest
  • Stacklands
  • Techtonica
  • Totally Accurate Battle Simulator
  • Trombone Champ
  • ULTRAKILL
  • V Rising
  • Valheim
  • Void Crew

Nexus Mods

Sign in with your Nexus Mods account (Settings → Nexus Mods account). Premium is required for downloads.

  • Devil May Cry 5
  • Monster Hunter Rise
  • Monster Hunter World
  • No Man's Sky
  • Palworld
  • Resident Evil 2
  • Resident Evil 3
  • Resident Evil 4
  • Resident Evil 7
  • Resident Evil Village
  • Slime Rancher 2
  • Stardew Valley
  • Subnautica
  • Subnautica: Below Zero

Steam Workshop

No setup. Moddy subscribes the mods through Steam.

  • BattleBlock Theater
  • Brotato
  • Castle Crashers
  • Cities: Skylines
  • Crusader Kings II
  • Crusader Kings III
  • Darkest Dungeon
  • Dead Cells
  • Divinity: Original Sin 2
  • Don't Starve Together
  • Dwarf Fortress
  • Euro Truck Simulator 2
  • Europa Universalis IV
  • Garry's Mod
  • Hand of Fate 2
  • Haste
  • Hearts of Iron IV
  • Kenshi
  • Killing Floor 2
  • Left 4 Dead 2
  • Oxygen Not Included
  • Portal 2
  • Project Zomboid
  • RimWorld
  • Rivals of Aether
  • Sid Meier's Civilization V
  • Sid Meier's Civilization VI
  • Slay the Spire
  • Stellaris
  • Tabletop Simulator
  • The Binding of Isaac: Rebirth
  • Total War: Three Kingdoms
  • Total War: Warhammer II
  • Total War: Warhammer III
  • XCOM 2

Other

Mod Sources

Moddy downloads mods and mod loaders directly from their original publishers — GitHub, Thunderstore, the Balatro Mod Index, Nexus Mods, ficsit.app, and the Steam Workshop — the same way other mod managers do. It does not host, redistribute, or modify any mod content; each mod's license is set by its author.

Nexus access uses the official API with OAuth sign-in (you log in with your own Nexus Mods account — Moddy never asks for an API key). Downloads currently require a Premium account (free accounts can browse, but Nexus only returns download links to Premium members).

Reporting issues

Moddy is in alpha. There are plenty of bugs, and I'm well aware. You don't need to report every rough edge yet, but if you hit something and feel like flagging it, you're completely welcome to open an issue on the GitHub issue tracker. Given the project status, I may be slow to respond. If you do open one, please include:

  • What game and mod you were installing
  • What you expected vs. what happened
  • A log bundle (see below)

Exporting logs: open the Decky panel → Moddy → Diagnostics → Export logs. This saves a moddy-logs-<timestamp>.zip to your Steam Deck's Desktop. Switch to Desktop Mode and attach it to your issue (drag it into the GitHub upload box). The bundle contains Moddy's log files and basic version info; your Nexus credentials are not included.

Disclaimer

Mods installed through Moddy are third-party software not authored, audited, or endorsed by this project. They are downloaded from their original publishers and run with the same privileges as your user account. They are not sandboxed or isolated from the rest of your system.

Use Moddy and any mods you install at your own risk. The author accepts no responsibility or liability for any damage arising from their use, including but not limited to corrupted or lost save data, broken or unbootable game installations, system instability, exposure to malicious code, or bans from anti-cheat systems or online services. Modifying a game may violate its terms of service, and online/multiplayer titles in particular may detect mods and penalize your account.

Review the source and author before installing anything you don't recognize. Moddy is provided "AS IS", without warranty of any kind. See the License below for the full warranty disclaimer.

Acknowledgements

  • The Balatro Mod Index (catalog data) is by the Balatro Mod Manager project, © 2025 Efe, licensed under the MIT License. Moddy uses only the index data, but none of that project's source code.

Support these projects, not me

Moddy is mostly glue. The real work behind every install is done by the projects below. Please send your support their way before mine. The best ways to help any of them: star the repo, report bugs, and contribute. Where a project shows a Sponsor button, consider donating.

Moddy runs on:

  • Decky Loader — the homebrew loader that makes Moddy, and the entire Steam Deck plugin scene, possible.

Mods are loaded by:

Catalogs are curated by:

And above all, the many developers of the frameworks and mods you actually install. Moddy is nothing without what they make. Find them on Thunderstore, Nexus Mods, and their own pages, and support them directly.

AI Disclosure

A large portion of this codebase was made with the help of AI. I'm a single person working on this in the small amounts of free time I get. AI is a tool that lets me ship this at all. I know some people are against the use of AI, so I'd rather be upfront about its use than pretend otherwise.

Development

pnpm i
pnpm run build

See CONTRIBUTING.md for the full setup — requirements, deploying a build to a Steam Deck, running the backend tests, and how games get added (many are pure JSON; some need backend code).

License

Copyright (C) 2026 FunkyByte1

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

About

Decky Loader plugin for browsing, installing, and managing game mods on Steam Deck without leaving Game Mode.

Topics

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages