xcl [Mod][XCL] X-Change Life Mod Loader Utility

[togashikokujin]

View File

[XCL] X-Change Life Mod Loader Utility

---

This is the official utility that can be used for applying mods to the game X-Change Life. 

 

Find mod loader usage details here: https://gitgud.io/xchange-life/mod-loader/-/wikis/home

 

And a step-by-step guide for applying mods with this utility: https://x-change.life/wiki/docs/mods/

 

Developed by @togashikokujin who is a primary contributor to the X-Change Life project.

 

If you feel like buying me a coffee, https://ko-fi.com/togashikokujin. The mod loader will always stay free, though.

 

Starting with version 2.4.0, we had to up the Java version from 8 to 17. If you get the oh-so-helpful "A Java exception has occurred" when running the jar version, you will need to install a newer JRE. https://www.oracle.com/java/technologies/downloads/ is a good place for that if you don't already know what you're doing and have other preferences.

 

NOTE: If you're using the installable version of the mod loader, be sure to install it to a folder other than your XCL folder. It will delete everything in its folder when you install updates. We do not have control over this aspect of the installer.

---

• Submitter
  togashikokujin
• Submitted
  01/29/23
• Category
  Gameplay Utilities

 

[togashikokujin]

I'm the one who's done all the development of this utility so far, so feel free to post any questions or suggestions here.

[Kashked]

12 hours ago, togashikokujin said:

I'm the one who's done all the development of this utility so far, so feel free to post any questions or suggestions here.

 

How do you update mods to a new version? Just disable the old and enable the new one or is there more to it? Would that require a new game btw?

[l1lym]

1 hour ago, Kashked said:

 

How do you update mods to a new version? Just disable the old and enable the new one or is there more to it? Would that require a new game btw?

Good question - just disabling the old mod and installing the new one will do it. As long as you have the original X-Change Life.html untouched, the mod loader will re-apply the mods from scratch whenever you regenerate X-Change Life Mod.html.

 

@togashikokujin, feel free to correct that if it's not accurate... 

Edited February 3, 2023 by l1lym

[togashikokujin]

Yep, that's exactly right. As far as requiring a new game, that would only be if the mod did something to require it. Typically you can patch one in at pretty much any point.

[megaera]

putting some time aside to try to add either red fox or foxi di 9or both). can't find where i would need to change the initial flavour txt when you start the game.

[menatv]

A couple of questions.

 

What do you open the .jar file with?  I tried with Firefox and 7Zip.  And nothing seems to work -- though maybe don't have the right Java installed.

 

And it says leave the mods in zip form?  So...don't extract them and leave them as a zip to install them?

 

Thanks.

 

[togashikokujin]

You should be able to use Java to open the jar file, you can make sure you have the right version from the downloads at https://java.com. You will leave the mods zipped, the loader takes care of unzipping the files and putting them in the right places.

[kmcdac2]

Is it possible to play modded on mobile? I tried copying over my whole modded folder from PC, but booting up the html (either modded or unmodded) just throws a bunch of javascript errors whenever it tries to load any picture or icon

[metalhead_hr]

Not sure what I am doing wrong, but 1.1.4 launches and then immediately closes. I have tried uninstalling and reinstalling both JRE 8u391 and Open JDK 21. 
Running on Win 11.
1.1.3 runs correctly.
When I try running 1.1.4 from the download directory, but not the game directory it opens long enough to have me navigate to the base X-Change Life.html file and then promptly closes.

Edited October 18, 2023 by metalhead_hr
typo in version names

[togashikokujin]

15 hours ago, metalhead_hr said:

Not sure what I am doing wrong, but 1.1.4 launches and then immediately closes. I have tried uninstalling and reinstalling both JRE 8u391 and Open JDK 21. 
Running on Win 11.
1.1.3 runs correctly.
When I try running 1.1.4 from the download directory, but not the game directory it opens long enough to have me navigate to the base X-Change Life.html file and then promptly closes.

Sounds like an uncaught exception is crashing it, are you able to run it from command line instead of file explorer? That should give an error that we can track down.

[metalhead_hr]

3 hours ago, togashikokujin said:

Sounds like an uncaught exception is crashing it, are you able to run it from command line instead of file explorer? That should give an error that we can track down.

Here is the results of trying to run it in command line for both JRE 8u391 and OpenJDK 21.0.1

 

Using versions:

java version "1.8.0_391"

Java(TM) SE Runtime Environment (build 1.8.0_391-b13)
Java HotSpot(TM) 64-Bit Server VM (build 25.391-b13, mixed mode)

 

Here is the command line output:

PS D:\..\X-Change Life Combined> java -jar mod-loader-1.1.4.jar
Exception in thread "main" java.lang.IllegalArgumentException: MALFORMED
        at java.util.zip.ZipCoder.toString(Unknown Source)
        at java.util.zip.ZipFile.getZipEntry(Unknown Source)
        at java.util.zip.ZipFile.access$900(Unknown Source)
        at java.util.zip.ZipFile$ZipEntryIterator.next(Unknown Source)
        at java.util.zip.ZipFile$ZipEntryIterator.nextElement(Unknown Source)
        at java.util.zip.ZipFile$ZipEntryIterator.nextElement(Unknown Source)
        at kotlin.collections.CollectionsKt__IteratorsJVMKt$iterator$1.next(IteratorsJVM.kt:18)
        at life.xchange.model.mod.ZipMod$metadata$2.invoke(Mod.kt:62)
        at life.xchange.model.mod.ZipMod$metadata$2.invoke(Mod.kt:61)
        at kotlin.SynchronizedLazyImpl.getValue(LazyJVM.kt:74)
        at life.xchange.model.mod.ZipMod.getMetadata(Mod.kt:61)
        at life.xchange.FileTree.addModFiles(FileTree.kt:120)
        at life.xchange.FileTree.addModFiles$default(FileTree.kt:117)
        at life.xchange.FileTree.<init>(FileTree.kt:25)
        at life.xchange.GUI.<init>(GUI.kt:59)
        at life.xchange.GUI.<init>(GUI.kt:40)
        at life.xchange.MainKt.main(Main.kt:148)

 

Using versions:

openjdk version "21.0.1" 2023-10-17
OpenJDK Runtime Environment (build 21.0.1+12-29)
OpenJDK 64-Bit Server VM (build 21.0.1+12-29, mixed mode, sharing)

 

Here is the command line output:

PS D:\..\openjdk-21.0.1_windows-x64_bin\jdk-21.0.1\bin\java.exe -jar "D:\..\X-Change Life Combined\mod-loader-1.1.4.jar"
Exception in thread "main" java.util.zip.ZipException: invalid CEN header (bad entry name or comment)
        at java.base/java.util.zip.ZipFile$Source.zerror(ZipFile.java:1781)
        at java.base/java.util.zip.ZipFile$Source.checkAndAddEntry(ZipFile.java:1255)
        at java.base/java.util.zip.ZipFile$Source.initCEN(ZipFile.java:1720)
        at java.base/java.util.zip.ZipFile$Source.<init>(ZipFile.java:1495)
        at java.base/java.util.zip.ZipFile$Source.get(ZipFile.java:1458)
        at java.base/java.util.zip.ZipFile$CleanableResource.<init>(ZipFile.java:724)
        at java.base/java.util.zip.ZipFile.<init>(ZipFile.java:251)
        at java.base/java.util.zip.ZipFile.<init>(ZipFile.java:180)
        at java.base/java.util.zip.ZipFile.<init>(ZipFile.java:194)
        at life.xchange.model.mod.ZipMod.<init>(Mod.kt:60)
        at life.xchange.model.mod.ZipMod.<init>(Mod.kt)
        at life.xchange.model.mod.Mod$Companion.from-C8k3rzs(Mod.kt:15)
        at life.xchange.model.mod.Mod$Companion.from-C8k3rzs$default(Mod.kt:14)
        at life.xchange.FileTree.addModFiles(FileTree.kt:120)
        at life.xchange.FileTree.addModFiles$default(FileTree.kt:117)
        at life.xchange.FileTree.<init>(FileTree.kt:25)
        at life.xchange.GUI.<init>(GUI.kt:59)
        at life.xchange.GUI.<init>(GUI.kt:40)
        at life.xchange.MainKt.main(Main.kt:148)

Edited October 19, 2023 by metalhead_hr
Updated version info

[Youaregettingworse]

Can you release a .app version for the mod loader utility for the mac users ? The last supported utility was the 1.12 version.

 

[togashikokujin]

@metalhead_hr ok, looks like it thinks one of the zip mod files is corrupted. You can try moving those out and moving them back in one by one to see which it is. I'll get some safer handling around that logic for the next release so it opens and tells you which file it couldn't show.

 

@Youaregettingworse I'll have to figure out how we made that one for 1.1.2, but that should be 100% doable.

[metalhead_hr]

  

18 hours ago, togashikokujin said:

@metalhead_hr ok, looks like it thinks one of the zip mod files is corrupted. You can try moving those out and moving them back in one by one to see which it is. I'll get some safer handling around that logic for the next release so it opens and tells you which file it couldn't show.

 

 I am not sure which zip mod file is causing it but it was one of the disabled ones in the disabled folder. After renaming that folder the mod loader started without issue and is loading mods correctly but is not able to create the mod_results.txt file. In the spoiler are all of the zip mod files in my previous disabled folder. I know some of them are for X-Change Life v0.17b but that is why they were in the disabled area.

 

After running from File Explorer here is the results, it does not display the box showing mod conflicts. After running it through admin terminal it does show the conflicts box. Then running it again from File Explorer it again has the access denied result with no shown conflict box. I am running it from a standard directory that I use for downloads on my data drive. The entire X-Change Life directory is on the data drive, not the system drive or in the Users set of directories so it shouldn't have access issues, which version 1.1.2 and 1.1.3 didn't have any access issue from the same directory.

 

File Explorer results:

All done!
java.io.FileNotFoundException: mod_results.txt (Access is denied)
  at life.xchange.ModProcessor.loadMods(ModLoader.kt:354)
  at life.xchange.GUI$loadMods$1.invoke(GUI.kt:158)
  at life.xchange.GUI$loadMods$1.invoke(GUI.kt:157)
  at life.xchange.GUI$runWithConsole$1.invoke(GUI.kt:207)
  at life.xchange.GUI$runWithConsole$1.invoke(GUI.kt:203)

The mods-bug-reports channel of the official Discord may be able to help with this.
 

 

Spoiler

Achievement Mod 1.0.3 17b.zip

Achievement Mod 1.0.4 17b (1).zip

Achievement Mod 1.0.4 17b.zip

Achievement Mod 1.0.6 17b (1).zip

Achievement Mod 1.0.6 17b.zip

Achievement Mod 1.0.7 17b.zip

Achievement Mod 1.0.8 17b (1).zip

Achievement Mod 1.0.8 17b.zip

Achievement Mod 1.0.9 17b.zip

Achievements Mod 0.18a 1.1.0.zip

Achievements Mod 0.18a 1.1.1.zip

AppleJuicev1.1.1.zip

bardrug 1.3c.zip

bardrug 2.1.zip

bardrug 2.2.1.zip

bardrug 2.2.2 hq.zip

bardrug 2.2.zip

BarWhore1.6.4.zip

DangerZonev1.1.0.zip

littleBlondBigCity(Full)1.2.2.zip

Multiple characters 1.1.zip

Multiple characters 1.2.zip

Multiple characters 1.3.zip

Multiple characters.zip

Patches.zip

Pregmod 4.18a.zip

u666_forced_bar_v005.zip

XChangeBattles1.18.1.zip

XChangeBattles1.18.2.zip

 

Edited October 21, 2023 by metalhead_hr
Added quoted text

[xarvenius]

cant start the 1.1.4 version, i tell it to open and nothing happens.

using java 8 update 391 (64bit) on win10

the 1.1.3 version runs without probs.

Edited October 21, 2023 by xarvenius
typos

[metalhead_hr]

One additional thing, while it doesn't have write access rights for creating the file mod_results.txt, unless run through admin terminal, it does create a version of X-Change Life Mod.html.

 

After updating to patch 0.18a 10-18-2023 with the included mod-loader-1.1.4 it no longer shows any mod list issues on the title screen or menu screen. That included mod loader also has access rights issues. 

Edited October 22, 2023 by metalhead_hr
Title and Menu screen mod list issue resolved after updating to patch 0.18a 10-18-2023

[metalhead_hr]

On 10/21/2023 at 7:20 AM, xarvenius said:

cant start the 1.1.4 version, i tell it to open and nothing happens.

using java 8 update 391 (64bit) on win10

the 1.1.3 version runs without probs.

 

If you are still having the same issue that I was having getting it to open, then it could be an issue with one of the zip mod files. Try renaming your existing disabled folder in case the zip is located there. Otherwise try temporarily moving all your zip mod files to a temp folder and then individually restore them back to your game folder to see which one it is.

 

Also try updating to the version that is bundled with patch 0.18a 10-18-2023 at the X-Change download site: XCL 0.18a 18 Oct Patch.zip. Since renaming the disabled folder fixed that issue for me I can't say whether the updated patch version of the mod loader will still have the issue of not opening.

[xarvenius]

4 hours ago, metalhead_hr said:

 

If you are still having the same issue that I was having getting it to open, then it could be an issue with one of the zip mod files. Try renaming your existing disabled folder in case the zip is located there. Otherwise try temporarily moving all your zip mod files to a temp folder and then individually restore them back to your game folder to see which one it is.

 

Also try updating to the version that is bundled with patch 0.18a 10-18-2023 at the X-Change download site: XCL 0.18a 18 Oct Patch.zip. Since renaming the disabled folder fixed that issue for me I can't say whether the updated patch version of the mod loader will still have the issue of not opening.

 

i did even try the versio nhere on loverslab with no preexistign modstructure, so just the main xcl folder and the modloader and nothing else and it still didnt open. the one from the linked patch opens up.

are these 2 version so much different from another?

[metalhead_hr]

They may be very different or they may just have a few important differences, but they are different and if the newer one works that is what matters.

[xarvenius]

the 1.2.0 modloader seams to have a problem with the wonka mod, it allways says it cant find it and its needed

fo another mod while it is clearly choosen.

i dont kow on which end it is and i post this in both support threads, wonka and modloader.

[UsernameNotYourBeesWax]

Is this the same mod loader that comes with the official XCL download?

[l1lym]

On 11/10/2023 at 2:38 AM, UsernameNotYourBeesWax said:

Is this the same mod loader that comes with the official XCL download?

Yes it is. 

Also , here is a guide for anyone having issues running the mod loader utility: https://x-change.life/wiki/docs/running-the-mod-loader/

[belegost]

I am unable to disable mods in version 1.2.0 of mod loader. Attempting to do so returns a message that the file is being used by another process. This happens regardless if the game has been played or not and also happens on a fresh boot.

 

My current workaround is just deleting the game (bar saves and mod archives) and installing mods again, without the mods I initially wanted to disable. Very inconvenient.

Edited January 22, 2024 by belegost

[metalhead_hr]

The workaround that I have been using for the same issue is to open the 1.1.4 version and disable the mod and then go back into the the 1.2.0 version to correctly set mod order and install the new or updated mods.