{"id":437,"date":"2022-11-15T10:07:25","date_gmt":"2022-11-15T10:07:25","guid":{"rendered":"https:\/\/x-change.life\/wiki\/?post_type=docs&#038;p=437"},"modified":"2026-03-21T18:33:44","modified_gmt":"2026-03-21T18:33:44","slug":"mods","status":"publish","type":"docs","link":"https:\/\/x-change.life\/wiki\/docs\/mods\/","title":{"rendered":"Installing and Running Mods"},"content":{"rendered":"\n<p>X-Change Life is now moddable! You will need the <strong><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-vivid-cyan-blue-color\"><a href=\"https:\/\/x-change.life\/wiki\/docs\/downloading-x-change-life\/\" data-type=\"docs\" data-id=\"342\">downloadable version<\/a> <\/mark><\/strong>of the game in order to add mods. <\/p>\n\n\n\n<p>Download the latest mod loader here (or from the pinned file at LoversLab): <a href=\"https:\/\/gitgud.io\/xchange-life\/mod-loader\/-\/releases\">https:\/\/gitgud.io\/xchange-life\/mod-loader\/-\/releases<\/a>.<\/p>\n\n\n\n<p>And here is a list of available mods on LoversLab: <a href=\"https:\/\/www.loverslab.com\/files\/category\/319-x-change-life\/\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/www.loverslab.com\/files\/category\/319-x-change-life\/<\/a><\/p>\n\n\n\n<p><strong>A note on Lover&#8217;s Lab:<\/strong> Scrolling down the main page and clicking &#8220;X-Change Life&#8221; takes you to the forum, not the files section. The key difference with the above link is sorting. The forum is sorted by thread interaction, which can be anything from a bug report to just someone saying hello. The files section, on the other hand, is sorted by recently updated by default and includes filters and categories. And if you are unsure of the mod&#8217;s update status, there is an information block directly beneath the download button. If the author has included requirements and\/or incompatibilities, those fields will also be present in the information block.<\/p>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-full is-resized\"><img fetchpriority=\"high\" decoding=\"async\" width=\"398\" height=\"678\" src=\"https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2025\/08\/Untitled.jpg\" alt=\"\" class=\"wp-image-1541\" style=\"width:174px;height:auto\" srcset=\"https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2025\/08\/Untitled.jpg 398w, https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2025\/08\/Untitled-176x300.jpg 176w, https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2025\/08\/Untitled-301x512.jpg 301w\" sizes=\"(max-width: 398px) 100vw, 398px\" \/><figcaption class=\"wp-element-caption\">Information block on a mod&#8217;s download page<\/figcaption><\/figure><\/div>\n\n\n<p>More technical information for the mod loader is available on the official <strong><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-vivid-cyan-blue-color\"><a href=\"https:\/\/gitgud.io\/xchange-life\/mod-loader\/-\/wikis\/Usage\" data-type=\"URL\" data-id=\"https:\/\/gitgud.io\/xchange-life\/mod-loader\/-\/wikis\/Usage\">Usage<\/a> <\/mark><\/strong>page. The below guide is meant to be as beginner-friendly and foolproof as possible. There is a troubleshooting guide and FAQ at the bottom of this page as well.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Step-by-step Modding Guide<\/strong> (.exe version)<\/h2>\n\n\n\n<p>Once you have downloaded the .exe and gone through the installation process, proceed through these steps.<\/p>\n\n\n\n<p>1. Open Mod Loader from installation location (or shortcut).<\/p>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-large\"><img decoding=\"async\" width=\"1024\" height=\"324\" src=\"https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2026\/02\/mod-loader-exe-1024x324.jpg\" alt=\"\" class=\"wp-image-1763\" srcset=\"https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2026\/02\/mod-loader-exe-1024x324.jpg 1024w, https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2026\/02\/mod-loader-exe-300x95.jpg 300w, https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2026\/02\/mod-loader-exe-768x243.jpg 768w, https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2026\/02\/mod-loader-exe-360x114.jpg 360w, https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2026\/02\/mod-loader-exe.jpg 1288w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><figcaption class=\"wp-element-caption\">Application located in separate instillation folder from the downloaded installer<\/figcaption><\/figure><\/div>\n\n\n<p>2. Download the mods you want from LoversLab. They can be either .zip files, .xcl files, or .twee files. These are the supported mod types. Mods that include images \/ videos will be .zip or .xcl files. Do NOT extract them \u2013 the mod loader will handle it.<\/p>\n\n\n\n<p>3. Click the &#8220;Add&#8221; Button<\/p>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-full is-resized\"><img decoding=\"async\" width=\"300\" height=\"604\" src=\"https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2026\/02\/add-button-2.jpg\" alt=\"\" class=\"wp-image-1766\" style=\"width:142px;height:auto\" srcset=\"https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2026\/02\/add-button-2.jpg 300w, https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2026\/02\/add-button-2-149x300.jpg 149w, https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2026\/02\/add-button-2-254x512.jpg 254w\" sizes=\"(max-width: 300px) 100vw, 300px\" \/><figcaption class=\"wp-element-caption\">Add button location<\/figcaption><\/figure><\/div>\n\n\n<p>4. Select the mod file(s) you want to install. Once again, it can be either .zip, .xcl, or .twee format. But mods with images need to be kept as a .zip (or xcl).<\/p>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-full is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"892\" height=\"545\" src=\"https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2026\/02\/add-menu.jpg\" alt=\"\" class=\"wp-image-1767\" style=\"width:537px;height:auto\" srcset=\"https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2026\/02\/add-menu.jpg 892w, https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2026\/02\/add-menu-300x183.jpg 300w, https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2026\/02\/add-menu-768x469.jpg 768w, https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2026\/02\/add-menu-360x220.jpg 360w\" sizes=\"(max-width: 892px) 100vw, 892px\" \/><figcaption class=\"wp-element-caption\">Add Mods window<\/figcaption><\/figure><\/div>\n\n\n<p>5. Once you press \u201cOpen\u201d, the mod loader will extract the mod files. You should see a message that says \u201cAll done!\u201d if it was successful.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"964\" height=\"161\" src=\"https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2026\/02\/add-mod-finish.jpg\" alt=\"\" class=\"wp-image-1768\" srcset=\"https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2026\/02\/add-mod-finish.jpg 964w, https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2026\/02\/add-mod-finish-300x50.jpg 300w, https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2026\/02\/add-mod-finish-768x128.jpg 768w, https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2026\/02\/add-mod-finish-360x60.jpg 360w\" sizes=\"(max-width: 964px) 100vw, 964px\" \/><figcaption class=\"wp-element-caption\">Mod has been added successfully<\/figcaption><\/figure>\n\n\n\n<p>6. You can repeat steps 3-5 for any other mods you want to load, then continue on once you have everything added. The mod loader will load everything together.<\/p>\n\n\n\n<p>7. Choose \u201cLoad\u201d or &#8220;Run&#8221;. Which one is entirely up to you. Most users will not need the Validate or Rebuild options.<\/p>\n\n\n\n<ul>\n<li>Load (Mods) compiles the base game html and mod files into a new game version.<\/li>\n\n\n\n<li>Run (Server) runs an http server that hosts your modded game, without having to go through the load process. Tradeoff is that you have to have the server running while you play. This option can be a solution to those whose OS has issues with symlinks (causing mod media to be broken).<\/li>\n<\/ul>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-full is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"540\" height=\"551\" src=\"https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2026\/02\/load-or-run.jpg\" alt=\"\" class=\"wp-image-1770\" style=\"width:156px;height:auto\" srcset=\"https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2026\/02\/load-or-run.jpg 540w, https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2026\/02\/load-or-run-294x300.jpg 294w, https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2026\/02\/load-or-run-360x367.jpg 360w\" sizes=\"(max-width: 540px) 100vw, 540px\" \/><figcaption class=\"wp-element-caption\">Choose Load or Run<\/figcaption><\/figure><\/div>\n\n\n<p>8a. If you choose &#8220;Load&#8221;, the mod loader will apply code changes, as well as move any new media files as needed. You\u2019ll see the following confirmation in the log window:<\/p>\n\n\n\n<figure class=\"wp-block-image size-large is-resized\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"88\" src=\"https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2026\/02\/loaded-mods-1-1024x88.jpg\" alt=\"\" class=\"wp-image-1772\" style=\"width:840px;height:auto\" srcset=\"https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2026\/02\/loaded-mods-1-1024x88.jpg 1024w, https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2026\/02\/loaded-mods-1-300x26.jpg 300w, https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2026\/02\/loaded-mods-1-768x66.jpg 768w, https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2026\/02\/loaded-mods-1-360x31.jpg 360w, https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2026\/02\/loaded-mods-1.jpg 1030w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><figcaption class=\"wp-element-caption\">Important: Let the Loader run until it says &#8220;Done!&#8221;<\/figcaption><\/figure>\n\n\n\n<p>9a. In your game directory, a folder titled &#8220;modded&#8221; will be created that houses the modded game. The game must be launched from the modded folder to use mods. The html in the game directory is the original game only.<\/p>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"927\" height=\"141\" src=\"https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2026\/02\/modded-folder.jpg\" alt=\"\" class=\"wp-image-1773\" srcset=\"https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2026\/02\/modded-folder.jpg 927w, https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2026\/02\/modded-folder-300x46.jpg 300w, https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2026\/02\/modded-folder-768x117.jpg 768w, https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2026\/02\/modded-folder-360x55.jpg 360w\" sizes=\"(max-width: 927px) 100vw, 927px\" \/><figcaption class=\"wp-element-caption\">If the folder is not present, the process may have been interrupted<\/figcaption><\/figure>\n\n\n\n<p>8b. If you chose &#8220;Run&#8221;, it will start up a local server to host your modded game. A window will pop up confirming the server is active. The server must remain active while you play.<\/p>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"549\" height=\"166\" src=\"https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2026\/02\/running-server.jpg\" alt=\"\" class=\"wp-image-1775\" srcset=\"https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2026\/02\/running-server.jpg 549w, https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2026\/02\/running-server-300x91.jpg 300w, https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2026\/02\/running-server-360x109.jpg 360w\" sizes=\"(max-width: 549px) 100vw, 549px\" \/><figcaption class=\"wp-element-caption\">Click the http link, do NOT click the OK button until you are finished playing<\/figcaption><\/figure><\/div>\n\n\n<p>10. When you run X-Change Life.html, and mods have loaded successfully, you&#8217;ll see something similar in the bottom-right corner of the game screen: <\/p>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"540\" height=\"192\" src=\"https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2026\/02\/modded-game.jpg\" alt=\"\" class=\"wp-image-1774\" srcset=\"https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2026\/02\/modded-game.jpg 540w, https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2026\/02\/modded-game-300x107.jpg 300w, https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2026\/02\/modded-game-360x128.jpg 360w\" sizes=\"(max-width: 540px) 100vw, 540px\" \/><figcaption class=\"wp-element-caption\">If it does not say (MODDED), you are running the wrong html<\/figcaption><\/figure><\/div>\n\n\n<h2 class=\"wp-block-heading\">Step-by-step Modding Guide (.jar version)<\/h2>\n\n\n\n<p>Okay, so you have the mod loader, and the offline version of X-Change Life. You&#8217;ve got some mods downloaded. Here&#8217;s how to apply them: <\/p>\n\n\n\n<p>1. Open the <strong>mod-loader.jar<\/strong> &#8211; it should be in the same folder as X-Change Life.html. (if it doesn\u2019t work, make sure <a href=\"https:\/\/www.java.com\/en\/download\/\">Java 17 or higher<\/a><strong><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-vivid-cyan-blue-color\"> <\/mark><\/strong>is installed on your computer). <\/p>\n\n\n\n<p>Once you click mod-loader.jar, be aware that it may take several minutes for the window to actually open on your computer. This is different behavior than previous versions of the mod loader. Please be patient.<\/p>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"160\" height=\"132\" src=\"https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2024\/10\/mod-loader-jar.png\" alt=\"\" class=\"wp-image-857\"\/><figcaption class=\"wp-element-caption\">mod-loader.jar<\/figcaption><\/figure><\/div>\n\n\n<p>2. Download the mods you want from this<strong><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-vivid-cyan-blue-color\"> <a href=\"https:\/\/gitgud.io\/xchange-life\/mod-loader\/-\/wikis\/List-of-Mods\" data-type=\"URL\" data-id=\"https:\/\/gitgud.io\/xchange-life\/mod-loader\/-\/wikis\/List-of-Mods\">list<\/a><\/mark><\/strong>. Put them in your game directory for ease of finding them. They can be either .zip files, .xcl files, or .twee files. These are the supported mod types. Mods that include images \/ videos will be .zip or .xcl files. Do NOT extract them &#8211; the mod loader will handle it. <\/p>\n\n\n\n<p>3. For each mod you want to add, click the <strong>Add mods<\/strong> button. <\/p>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"322\" height=\"84\" src=\"https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2024\/10\/ml-addmods.png\" alt=\"\" class=\"wp-image-859\" srcset=\"https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2024\/10\/ml-addmods.png 322w, https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2024\/10\/ml-addmods-300x78.png 300w\" sizes=\"(max-width: 322px) 100vw, 322px\" \/><figcaption class=\"wp-element-caption\">Add mods button &#8211; this will only prepare the mod &#8211; you will still need to Load mods later<\/figcaption><\/figure><\/div>\n\n\n<p>4. Select the mod file you want to install<strong>. Once again, it can be either .zip, .xcl, or .twee format<\/strong>. But mods with images need to be kept as a .zip (or xcl). You can select more than one file to load at once by holding shift.<\/p>\n\n\n\n<p>In this screenshot, <strong>BR.Aspen.code1.twee<\/strong> and <strong>BR.Aspen.Media.xcl<\/strong> are files from the same mod that can be loaded. Other mods might use a .zip, like <strong>Charlotte 1.0.zip<\/strong> below.<\/p>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"595\" height=\"368\" src=\"https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2024\/10\/ml-loadmods.png\" alt=\"\" class=\"wp-image-861\" srcset=\"https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2024\/10\/ml-loadmods.png 595w, https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2024\/10\/ml-loadmods-300x186.png 300w, https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2024\/10\/ml-loadmods-360x223.png 360w\" sizes=\"(max-width: 595px) 100vw, 595px\" \/><figcaption class=\"wp-element-caption\">Examples of different mod files that can be loaded.<\/figcaption><\/figure><\/div>\n\n\n<p>5. Once you press &#8220;Open&#8221;, the mod loader will extract the mod files. You should see a message that says &#8220;All done!&#8221; if it was successful.<\/p>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"429\" height=\"329\" src=\"https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2024\/10\/ml-loadmods2.png\" alt=\"\" class=\"wp-image-862\" srcset=\"https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2024\/10\/ml-loadmods2.png 429w, https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2024\/10\/ml-loadmods2-300x230.png 300w, https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2024\/10\/ml-loadmods2-360x276.png 360w\" sizes=\"(max-width: 429px) 100vw, 429px\" \/><figcaption class=\"wp-element-caption\">The mod files have now been extracted- you will still need to load them using the Load Mods button.<\/figcaption><\/figure><\/div>\n\n\n<p>6. You can repeat steps 3-5 for any other mods you want to load, then continue on once you have everything added. The mod loader will load everything together. <\/p>\n\n\n\n<p>7. Click &#8220;Load mods&#8221;. <\/p>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"351\" height=\"90\" src=\"https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2024\/10\/ml-loadmods3.png\" alt=\"\" class=\"wp-image-863\" srcset=\"https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2024\/10\/ml-loadmods3.png 351w, https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2024\/10\/ml-loadmods3-300x77.png 300w\" sizes=\"(max-width: 351px) 100vw, 351px\" \/><figcaption class=\"wp-element-caption\">Click Load mods<\/figcaption><\/figure><\/div>\n\n\n<p>8. The mod loader will apply code changes, as well as move any new media files to the game. You\u2019ll see the following log of applied changes:<\/p>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"372\" height=\"314\" src=\"https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2024\/10\/ml-loadmods4.png\" alt=\"\" class=\"wp-image-864\" srcset=\"https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2024\/10\/ml-loadmods4.png 372w, https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2024\/10\/ml-loadmods4-300x253.png 300w, https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2024\/10\/ml-loadmods4-360x304.png 360w\" sizes=\"(max-width: 372px) 100vw, 372px\" \/><figcaption class=\"wp-element-caption\">Log showing the code areas modified, and any new images as well.<\/figcaption><\/figure><\/div>\n\n\n<p>9. Success! Now, the modded version of the game has been created. Look for a folder called &#8220;<strong>modded<\/strong>&#8220;<\/p>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"180\" height=\"108\" src=\"https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2024\/10\/ml-modded.png\" alt=\"\" class=\"wp-image-865\"\/><figcaption class=\"wp-element-caption\">Modded version of the game.<\/figcaption><\/figure><\/div>\n\n\n<p>10. Inside this folder you should have the modified game files, you will want to launch <strong>X-Change Life.html<\/strong>. <\/p>\n\n\n\n<p>** If you used a previous version of mod loader before 2.0, you are used to looking for an <em>X-Change Life Mod.html<\/em> file. This is no longer the process.<\/p>\n\n\n\n<p>If you ever want to play the original (non-modded) version, leave the modded folder and launch the other X-Change Life.html file from the main game directory.<\/p>\n\n\n\n<p>11. When you run X-Change Life.html, and mods have loaded successfully, you&#8217;ll see something similar in the bottom-right corner of the game screen: <\/p>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"427\" height=\"146\" src=\"https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2024\/10\/ml-moddedgameload.png\" alt=\"\" class=\"wp-image-866\" srcset=\"https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2024\/10\/ml-moddedgameload.png 427w, https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2024\/10\/ml-moddedgameload-300x103.png 300w, https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2024\/10\/ml-moddedgameload-360x123.png 360w\" sizes=\"(max-width: 427px) 100vw, 427px\" \/><figcaption class=\"wp-element-caption\">If it says MODDED, you&#8217;re on the modded version.<\/figcaption><\/figure><\/div>\n\n\n<h2 class=\"wp-block-heading\">Disabling mods<\/h2>\n\n\n\n<p>Disabling mods is easy. Just uncheck the checkbox next to the mod in the mod-loader. This will disable the mod. Then just click &#8220;Load mods&#8221; to regenerate the modded files, without the disabled mod. <\/p>\n\n\n<div class=\"wp-block-image\">\n<figure class=\"aligncenter size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"397\" height=\"188\" src=\"https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2024\/10\/Untitled-1.jpg\" alt=\"\" class=\"wp-image-867\" srcset=\"https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2024\/10\/Untitled-1.jpg 397w, https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2024\/10\/Untitled-1-300x142.jpg 300w, https:\/\/x-change.life\/wiki\/wp-content\/uploads\/2024\/10\/Untitled-1-360x170.jpg 360w\" sizes=\"(max-width: 397px) 100vw, 397px\" \/><\/figure><\/div>\n\n\n<p>In the same way, you can re-enable mods in the disabled folder by re-checking the box, and then pressing &#8220;Load mods&#8221; again: <\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Updating the game<\/h2>\n\n\n\n<p>X-Change Life is still in development, and will have new updates with more features regularly. If you&#8217;d like to use mods with an updated version of the game, all you need to do is update your game as normal and then follow the steps under the Step-by-step Modding Guide section again to generate a new modded folder.<\/p>\n\n\n\n<p><strong>WARNING:<\/strong> New updates to X-Change Life can bring incompatibilities with older mods. Make sure to check which version of the original X-Change Life game each mod was previously tested with before installing. If your favorite mod has not been updated for the latest release, you can reach out to the developer on the Discord.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Troubleshooting<\/h2>\n\n\n\n<p>If you get weird errors running a modded version of the game, it&#8217;s most likely a conflict between an older mod and a newer version of the game, or between two incompatible mods. This is unavoidable, as mods might edit a code area in the game that has changed, or two mods might try to edit the same code. Try disabling certain mods to figure out which one is causing the problem &#8211; we have a channel on the Discord to discuss mod bugs, so feel free to join and report them there. <\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Creating your own mods<\/h2>\n\n\n\n<p>Modding X-Change Life is very easy, and it can be a great way to dip your toe into game development, since the game&#8217;s codebase is fairly simple. I&#8217;d advise you hop on the Discord, we have channels to help get modders up and running. <\/p>\n\n\n\n<p>Also take a look at: <strong><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-vivid-cyan-blue-color\">&#8220;<a href=\"https:\/\/gitgud.io\/xchange-life\/mod-loader\/-\/wikis\/Authoring%20Mod%20Files\" data-type=\"URL\" data-id=\"https:\/\/gitgud.io\/xchange-life\/mod-loader\/-\/wikis\/Authoring%20Mod%20Files\">Authoring mod files<\/a>&#8220;<\/mark><\/strong>. <\/p>\n\n\n\n<p>You can check out the <strong>#feature-suggestions<\/strong> channel on Discord, there might be an interesting idea for the game that you&#8217;d want to implement yourself. <\/p>\n\n\n\n<p>Mods can be posted and found here on LoversLab: <a href=\"https:\/\/www.loverslab.com\/files\/category\/319-x-change-life\/\" target=\"_blank\" rel=\"noreferrer noopener\">https:\/\/www.loverslab.com\/files\/category\/319-x-change-life\/<\/a><\/p>\n\n\n\n<h1 class=\"wp-block-heading\">Troubleshooting FAQ<\/h1>\n\n\n\n<h2 class=\"wp-block-heading\">Installation and Startup Issues<\/h2>\n\n\n\n<h4 class=\"wp-block-heading\">Q: The mod loader won&#8217;t start or gives Java-related errors. What should I do?<\/h4>\n\n\n\n<p><strong>A:<\/strong> Make sure you have Java 8 or later installed correctly on your system. If you&#8217;re having issues:<\/p>\n\n\n\n<ol>\n<li>Completely uninstall Java from your system<\/li>\n\n\n\n<li>Download and install Java 17 again from the official source<\/li>\n\n\n\n<li>Make sure the .jar file is associated with Java and not other programs like WinRAR<\/li>\n<\/ol>\n\n\n\n<h4 class=\"wp-block-heading\">Q: The mod loader takes a very long time to start (5+ minutes). Is this normal?<\/h4>\n\n\n\n<p><strong>A:<\/strong> Yes, this is expected behavior with version 2.x of the mod loader. The initial startup can take several minutes as it indexes all files in the game directory. Be patient and let it complete the process.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">File System and Location Issues<\/h2>\n\n\n\n<h4 class=\"wp-block-heading\">Q: I&#8217;m getting a &#8220;LinksUnsupportedException: File links are not supported on this filesystem&#8221; error. How do I fix this?<\/h4>\n\n\n\n<p><strong>A:<\/strong> This error occurs when running the mod loader on drives with incompatible file systems (like FAT32 or exFAT). You have three options:<\/p>\n\n\n\n<ol>\n<li>Convert your drive to NTFS format (requires backing up data first)<\/li>\n\n\n\n<li>Move the game to a different drive that uses NTFS<\/li>\n\n\n\n<li>Use the &#8220;Copy files instead of creating links&#8221; option in the mod loader settings<\/li>\n<\/ol>\n\n\n\n<h4 class=\"wp-block-heading\">Q: I&#8217;m getting access denied errors or the mod loader won&#8217;t start properly. What&#8217;s wrong?<\/h4>\n\n\n\n<p><strong>A:<\/strong> This commonly occurs when the game is installed in protected Windows directories. To fix this:<\/p>\n\n\n\n<ol>\n<li>Move your game directory outside of &#8220;Program Files&#8221; or &#8220;Program Files (x86)&#8221;<\/li>\n\n\n\n<li>Place it in a location where you have full read\/write permissions (e.g., Documents folder)<\/li>\n<\/ol>\n\n\n\n<h2 class=\"wp-block-heading\">Loading and Running Mods<\/h2>\n\n\n\n<h4 class=\"wp-block-heading\">Q: After loading mods, there are no images or audio in the game. What&#8217;s wrong?<\/h4>\n\n\n\n<p><strong>A:<\/strong> This usually indicates one of two issues:<\/p>\n\n\n\n<ol>\n<li>The mod loader couldn&#8217;t create proper file links (see file system issues above)<\/li>\n\n\n\n<li>You&#8217;re not running the correct version of the game. Make sure to:\n<ul>\n<li>Look for the new &#8220;modded&#8221; folder created by the mod loader<\/li>\n\n\n\n<li>Run X-Change Life.html from inside the &#8220;modded&#8221; folder<\/li>\n\n\n\n<li>Check that it says &#8220;MODDED&#8221; in the bottom-right corner when running<\/li>\n<\/ul>\n<\/li>\n<\/ol>\n\n\n\n<h4 class=\"wp-block-heading\">Q: How do I update mods to a newer version?<\/h4>\n\n\n\n<ol>\n<li>Use the &#8220;Add mods&#8221; button to add the updated file<\/li>\n\n\n\n<li>If the mod has metadata, you&#8217;ll be prompted to overwrite the existing version<\/li>\n\n\n\n<li>For mods without metadata, you may need to manually disable or remove the old version<\/li>\n<\/ol>\n\n\n\n<h4 class=\"wp-block-heading\">Q: The mod loader shows &#8220;All done!&#8221; but some mods aren&#8217;t working. Why?<\/h4>\n\n\n\n<p><strong>A:<\/strong> Common causes include:<\/p>\n\n\n\n<ul>\n<li>Mod incompatibility with your game version<\/li>\n\n\n\n<li>Conflicts between multiple mods<\/li>\n\n\n\n<li>Not completing both steps: &#8220;Add mods&#8221; AND &#8220;Load mods&#8221;<\/li>\n\n\n\n<li>Running the wrong version of the game file (must use the one in the &#8220;modded&#8221; folder)<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Common Error Messages<\/h2>\n\n\n\n<h4 class=\"wp-block-heading\">Q: What does &#8220;Incorrect function&#8221; error mean?<\/h4>\n\n\n\n<p><strong>A:<\/strong> This typically relates to file system compatibility issues. See the file system solutions above.<\/p>\n\n\n\n<h4 class=\"wp-block-heading\">Q: What if I get &#8220;Could not find the main class&#8221; error?<\/h4>\n\n\n\n<p><strong>A:<\/strong> This usually means Java isn&#8217;t properly installed or configured. Try:<\/p>\n\n\n\n<ol>\n<li>Reinstalling Java<\/li>\n\n\n\n<li>Making sure you&#8217;re using Java17 or later<\/li>\n\n\n\n<li>Ensuring the mod loader .jar file is associated with Java<\/li>\n<\/ol>\n\n\n\n<h2 class=\"wp-block-heading\">Performance and Behavior<\/h2>\n\n\n\n<h4 class=\"wp-block-heading\">Q: My mods disappeared after updating the game. What happened?<\/h4>\n\n\n\n<p><strong>A:<\/strong> This is normal. After updating the base game, you need to:<\/p>\n\n\n\n<ol>\n<li>Run the mod loader again<\/li>\n\n\n\n<li>Re-enable your mods<\/li>\n\n\n\n<li>Click &#8220;Load mods&#8221; to generate a new modded version<\/li>\n<\/ol>\n\n\n\n<h4 class=\"wp-block-heading\">Q: Will older mods work with newer game versions?<\/h4>\n\n\n\n<p><strong>A:<\/strong> Not always. Check:<\/p>\n\n\n\n<ul>\n<li>The mod&#8217;s compatibility information<\/li>\n\n\n\n<li>Which game version it was designed for<\/li>\n\n\n\n<li>The mod creator&#8217;s page for updates<\/li>\n\n\n\n<li>The Discord server for compatibility reports<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Best Practices<\/h2>\n\n\n\n<ol>\n<li>Always backup your game directory before applying mods<\/li>\n\n\n\n<li>Install the game on an NTFS-formatted drive<\/li>\n\n\n\n<li>Keep the game files outside of protected Windows directories<\/li>\n\n\n\n<li>Check mod compatibility with your game version <strong>BEFORE <\/strong>installing<\/li>\n\n\n\n<li>Complete both steps: &#8220;Add mods&#8221; AND &#8220;Load mods&#8221;<\/li>\n\n\n\n<li>Run the game from the &#8220;modded&#8221; folder after loading mods<\/li>\n\n\n\n<li>Join the Discord server for additional support and troubleshooting<\/li>\n<\/ol>\n\n\n\n<p>For additional support or issues not covered here, join the official Discord server and check the<strong><em> #mod-loader<\/em><\/strong> channel.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>X-Change Life is now moddable! You will need the downloadable version of the game in order to add mods. Download the latest mod loader here (or from the pinned file at LoversLab): https:\/\/gitgud.io\/xchange-life\/mod-loader\/-\/releases. And here is a list of available mods on LoversLab: https:\/\/www.loverslab.com\/files\/category\/319-x-change-life\/ A note on Lover&#8217;s Lab: Scrolling down the main page and [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":[],"doc_category":[16],"doc_tag":[],"_links":{"self":[{"href":"https:\/\/x-change.life\/wiki\/wp-json\/wp\/v2\/docs\/437"}],"collection":[{"href":"https:\/\/x-change.life\/wiki\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/x-change.life\/wiki\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/x-change.life\/wiki\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/x-change.life\/wiki\/wp-json\/wp\/v2\/comments?post=437"}],"version-history":[{"count":24,"href":"https:\/\/x-change.life\/wiki\/wp-json\/wp\/v2\/docs\/437\/revisions"}],"predecessor-version":[{"id":1785,"href":"https:\/\/x-change.life\/wiki\/wp-json\/wp\/v2\/docs\/437\/revisions\/1785"}],"wp:attachment":[{"href":"https:\/\/x-change.life\/wiki\/wp-json\/wp\/v2\/media?parent=437"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/x-change.life\/wiki\/wp-json\/wp\/v2\/doc_category?post=437"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/x-change.life\/wiki\/wp-json\/wp\/v2\/doc_tag?post=437"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}