Skip to content

pukmajster/funky

Repository files navigation

Funky

Funky is an open-source mods manager for Left 4 Dead 2, developed with Electron, Dexie, Svelte and Skeleton UI.

App

Initially inspired by Left 4 Dead 2's terrible in-game addons menu, I wanted something that gives me more functionality, like search and a better method of solving conflicts, but the scope has since gotten much broader with lots of other great features and improvements that are lacking in the in-game menu.

Please note that Funky is still in beta / early development. Future updates may or may not introduce breaking changes that may or may not break user configurations.

Insitallation

You can find the latest releases of Funky for Windows and Linux on the Releases page.

Features

  • Grid display with thumbnails and pagination
  • Search and filters
  • Automatic mod categorization based on mod contents
  • Much more detailed mod overview with useful actions
  • Conflict solving menu, showing you exactly which mods are conflicting
  • Playlists, letting you quickly hop between different setups
  • Shuffles, randomizing your mod selection every time you boot up the game
  • Batch selection of mods with various actions
  • Unsubscribing from mods via Steam Web API
  • VPK browser with extraction functionality

Planned improvements

  • Campaigns category
  • Improved shuffle dragging behaviour
  • Feedback UI for empty search query results
  • Playlist deletion
  • Shuffle option to allow no mod being chosen

Unplanned ideas

Here are some ideas or features that may or may not be considered in the future

  • List view of mods
  • Built-in custom config/autoexec editor
  • Local data backup
  • Online data backup
  • Collections
  • Vocalizer editor
  • Playlist duplication

Caveats

While I've found Funky to be extremly useful in organizing my ever growing library of mods, there's some things to keep in mind:

  • The game needs to be restarted before any changes made in Funky can take effect.
  • Newly subscribed-to Workshop mods will only be downloaded after you start the game.

So taking both of these points into account, if you've just subscribed to a new mod, you'll have to open up the game, wait for the game to download the mod, close the game, make any changes in Funky and then finally, run the game from within Funky in order for all changes to take effect. Quite clumbersome, but it is what it is.

Project Setup

Install dependencies

npm i

Development

npm run dev

Build

# For windows
npm run build:win

# For macOS
npm run build:mac

# For Linux
npm run build:linux