Modboy Help

A Wiki


  • Amendment Info regarding archive type support has been updated to reflect the recent support of RAR5 archives.
RAR5 Info 4mo
  • Addition Suggestions about breaking variants into multiple archives.
Added info about mod variants 6mo

Where can I find Modboy?

What operating systems can Modboy be run on?

The current version of Modboy (v3.3) can run on Windows 7 or higher.

What is the Modboy URL scheme?

Modboy uses a custom URL scheme of modboy://<submission_type>,<submission_id>,<file_id> where <submission_type> is something like Skin or Map.

What games are supported?

You can see a full list of games that are supported here.

Help, it says "Failed to execute crucial installation command." What do I do?

First of, try checking a few things:
  • Is your game installed in something other than the default folder?
    • If so, please ensure that you've selected the proper folder when prompted for path to your game's directory. Ex. For TF2, the correct folder is the tf folder inside of the Team Fortress 2 directory, not the Team Fortress 2 folder itself.
  • Does the mod archive you're trying to download include multiple mods at once?
    • If more than one of the mods are for the same skin, that can potentially cause issues because Modboy won't be able to determine which skin you want to use from those. Encourage the mod creator to split skins for the same slot into multiple archives on the same submission instead, as those can be downloaded individually by Modboy.

Help, it says "Modboy doesn't know how to install this submission type." What do I do?

This error occurs when that type of submission, e.g. Gamefile/GUI/etc. is not yet supported by the configuration for a particular game. Here's the deal: Modboy works by reading configuration files from this site that tell it how to find files for specific submission types on a per-game basis. The configuration also has to be able to describe where to put the mod files in that game's folder. The error will present itself in a few different situations:

  • If no instructions are available for that mod type (such as GUIs for Team Fortress 2 currently) based on the configuration itself.
  • If no applicable files are found in the archive that match the instructions in the game's configuration - e.g. It's a sound submission, but all that's inside the archive are pictures, then it's possible this message might show up, though it's less likely to occur in the first place

Why aren't my mods showing up in-game?

This usually will happen if the mod submitter did not create the folder structures correctly in the archive they uploaded.

Are you a mod submitter? Note that putting random folders in at different points in the hierarchy can lead to the game not reading those files. The exception is that folder levels above the important part of the path are okay. For example: having a /MYCOOLMOD/models/materials/p225/<vtx, vtf, mdl, etc files go here> is fine, but having /models/materials/MYCOOLMOD/p225/<vtx, vtf, mdl, etc files go here> is not. Not sure if you've done it correctly? Feel free to PM me.

I have variants for my mod, how should I set up my archive(s)?

Having multiple skins for the same weapon, for example, in the same archive will cause Modboy to fail to install the mod properly. This is because generally speaking, it performs the task of copying over the files and backing up the old ones. It's encouraged for mod authors to break their variants into multiple archives so they can be installed separately for this reason.

Why aren't my M.U.G.E.N. mods working?

Unfortunately, M.U.G.E.N. requires one additional step of editing a configuration file that hasn't been figured out for the M.U.G.E.N. configuration yet.

Is there some way I can export a list of my mods?

Not at the moment, but it is an idea I've been toying around with. I believe the easiest format for exporting the list of mods would be to write a list of Modoby scheme URLs out to somewhere, such as the clipboard, a file, or PM. If this is something you'd like to see, let me know!

Modboy says it's unable to open a particular archive, what's the deal?

Recently, Modboy has been update to support RAR5 as well. If the archive is some other format and is unable to open it, but the latest version of 7-Zip is able to, please send me information and links to said submission, and I will investigate. Otherwise, please report on the original submission that the archive can't be opened.

What languages are supported?

Currently 5 languages are supported:
  • English
  • Portuguese (PT-BR)
  • Spanish
  • Russian
  • Ukrainian

Other Questions?

Please ask below and I will update this page with the answers.


Add information about clearing the buffer manually Try out Modboy v3.5 installer again.


1-10 of 27
Go to page:
  • MilkGB avatar
    MilkGB Joined 6mo ago
    none of my mods work anymore and every mod i've tried to install says the file type isn't supported even though i've installed mods with the same file type like zip files.

    what happened?
  • Hi just downloaded modboy and everything's running fine but when i try to verify a mod it just says "verification unsuccessful, mod is either corrupted or not installed" HELP

  • LuckyLoly avatar
    LuckyLoly Joined 1mo ago
    So I'm new and have no idea how this works. I have installed ModBoy but when I go to a skin I want for example,
    and click the 1-click install button nothing happens.
  • Terasaur avatar
    Terasaur Joined 1mo ago
    it wont work for me i can download them and the path to the app is there but they dont apply in game
  • Everytime i try to download a skin or sound or mod it  stays at executing instillation all the time and it just stays there, is there anyway to fix this?

  • johnonion97 avatar
    johnonion97 Joined 2mo ago
    I'm install a few CS:S WiPs mods failed,sometimes work,sometimes does't work,how can I do
  • Pyro2018 avatar
    Pyro2018 Joined 3mo ago
    I don't know what happened ,but modboy won't even download mods.
  • I need help. I have NO idea how to use this. I am completely new and have just now downloaded ModBoy.Please help!

    BAN(ana) HAMMER
  • MilkGB avatar
    MilkGB Joined 6mo ago
    I have installed a mod and it won't finish downloading.
    I have gotten rid of other things from the queue, and I have tried canceling the download but nothing will work.
    is there any way I can fix this?
  • Northern3D avatar
    Northern3D username pic Joined 3y ago
    US Games Flag Affiliation: US Games
    913 points Ranked 5666th
    19 medals 2 rare
    • 10 submissions featured Medal icon
    • Returned 1000 times Medal icon
    • Became a Club Leader Medal icon
    • One month a member Medal icon
    • 6 months a member Medal icon
    • 1 year a member Medal icon
    Will there be a way for a mod to be downloaded to multiple games at once, say, a certain Alyx skin that works with all three hl2 games?
    Cool! avatar


AoM avatar
AoM username pic Joined 12y ago
Ripe Supporter AC:NL Manager UT2k4 Manager SN Manager Admin
Likely Asleep
36,090 points Ranked 114th
39 medals 5 legendary 8 rare
  • 10 years a member Medal icon
  • Created a Mod Installer Medal icon
  • Achieved Admin clearance Medal icon
  • 15+ Entries! GameBanana’s Christmas Giveaway 2017 Medal icon
  • Became a Ripe Supporter Medal icon
  • 6 years a member Medal icon

AoM avatar
Sign up to access this!



  • Share on Reddit
  • Share on Twitter
  • Share on Facebook
  • Share on Google+


  • 133 Posts
  • 3y Submitted
  • 4mo Modified
  • 4mo Updated tracking pixel