Modboy Help

A Wiki


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

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.

Modboy appears to be stuck trying to install mod, what do I do?

Go to AppData/Roaming/Modboy in your account's folder and then delete Buffer.dat.

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.

Sign up to access this!


Try out Modboy v3.5 installer again.
1-10 of 34
Go to page:
  • yotemedaddy avatar
    yotemedaddy Joined 15d ago
    modboy won't even start the installation when i try i checked history and it says i haven't even tried since the 30th
    URL to post:
  • EnriElite avatar
    EnriElite Joined 2y ago
    104 points Ranked 31005th
    I have this weird problem where when I try to download any mod it would basically get "stuck" during the download phase and after a while it would just say "Task [Install] for mod [(Name of Mod)] failed"

    The weird thing about this is, that it sometimes works and other times it doesn't (even for mods I have installed before) and after it happens once I am unable to open Modboy as soon as I close it unless I restart my PC.

    Btw I tried to reinstall Modboy and I also tried deleting Buffer.dat multiple times without any effect.
    URL to post:
  • YellowJello avatar
    YellowJello username pic Joined 14y ago
    CS1.6 Manager TF2 Manager Moderator
    Not Jiggling
    89,015 points Ranked 37th
    36 medals 3 legendary 7 rare
    • 10 years a member Medal icon
    • Submitted 200 Threads Medal icon
    • Submitted 50 Maps Medal icon
    • Reached 75,000 Points Medal icon
    • 6 years a member Medal icon
    • Submitted 100 Threads Medal icon
    3mo 3mo
    I had a weird issue when uninstalling Modboy. I ran the uninstaller and I was left with this in the Modboy folder.

    Ultimately deleting it all manually and reinstalling did fix the issue, I still think this is a little odd. When reinstalling, I did put it on a different drive than the one pictured, if that's anything of note.
    Jiggle Jiggle avatar
    Jiggle Jiggle
    URL to post:
  • Since one mod wasn't working, I was going to delete it, but it has been stuck for hours now with no way to stop it. I have tried cancelling the uninstall, but it just keeps going.
    Medics need more love
    URL to post:
  • RNSMP avatar
    RNSMP Joined 3mo ago
    3mo 3mo
    "Failed to execute crucial installation command. The task cannot continue" 

    Which file is required for HL2 to work? Neither Half-Life 2 nor hl2 folder works, halp.
    URL to post:
  • JoshtheFox05 avatar
    JoshtheFox05 Joined 2y ago
    160 points Ranked 23490th
    I have double clicked on Modboy so many times on my desktop, and it just won't start. It doesn't give me an error message or anything, I just refuses to open. Help?
    URL to post:
  • Modboy don't work and say "modboy doesn't know how to install" can some body help me,  

    link I try to download :
    URL to post:
  • MilkGB avatar
    MilkGB Joined 10mo 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?
    URL to post:
  • 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

    URL to post:
  • LuckyLoly avatar
    LuckyLoly Joined 5mo 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.
    URL to post:


AoM avatar
AoM username pic Joined 12y ago
Ripe Supporter AC:NL Manager UT2k4 Manager SN Manager Admin
Likely Asleep
44,186 points Ranked 93rd
43 medals 5 legendary 10 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+
  • 152 Posts
  • 3ySubmitted
  • 3moModified
  • 8moUpdated

More Modboy Wikis tracking pixel