NOTE: Before starting any updates, after the closing of Moondust Editor and any other Moondust-related applications, please open the task manager and kill any "pge_editor.exe" and "smbx.exe" you will find in the processes list. It's there a bug that keeps crashed apps in the processes list that will prevent you from correctly updating it.
IMPORTANT NOTE 2022-2023: There is API version has been changed because of the integrational configuration packages system major rework. You may encounter several problems after the update. See the explanation at the bottom of this post on how to fix the work of Moondust Devkit after the update.
IMPORTANT NOTE 2024: Since the Beta5, the SMBX2 project starts to use the modified fork of the Moondust Devkit which is not maintained by the Official Moondust Team, and therefore, the Official Moondust Devkit will support the SMBX2 project up to Beta4.
SMBX X2 Beta4 - Automatical way (A small script will update Moondust Project in one run for you)
- Step 1. Open data/PGE folder in your file manager
- Step 2. Close Editor and other apps (such as Maintainer, Engine, MusPlayer, and Playable Calibrator) until start updating
- Step 3. Run the "update-pge.cmd" (or just "update-pge" if the extension showing is disabled) file: must appear the black console window with a greeting, and to start the update, just hit any key and wait update completing. On a UNIX-like operating system you are able to run this script with Wine CMD. Native Linux or Mac OS X Moondust Devkit build also can be used, but the LunaTester feature which is required for a current version of SMBX 2.0 will not work.
- Epilogue. In next time if you want to update Moondust Devkit, just run update-pge.cmd again.
Note: Be aware of antivirus false positives, they may detect wget and/or unzip executables as viruses. They are required by the update process.
SMBX X2 Beta4 - Manual way (When the script is not able to download anything, you can do everything yourself)
If you can't use automatize script, you are able to update Moondust Devkit manually:
- Download Moondust Devkit archive (let's call it as Archive1): https://builds.wohlsoft.ru/win32/bin-w64/_packed/pge-project-master-win64.zip
- Unpack contents of Archive1's "PGE_Project" folder into data/PGE folder and confirm replacing of all files in it
- Try to launch data/PGE/pge_editor.exe to be sure it starts with no errors and config pack status doesn't report any errored resources.
- Profit!
- SMBX2 Beta 3 manual
- SMBX X2 Beta3 - Automatical way
SMBX X2 Beta3 has no update script included, so, there is a possibility that you should obtain it manually:
Before to start the process, check the existence of data/PGE/update-pge.cmd file in your SMBX installation.
If it already exists, skip all 4 steps and begin the process from the Step 5.- Step 1. Download this archive https://wohlsoft.ru/projects/Moondust/_laboratory/PGE-Updater-For-SMBX-2.0.zip
- Step 2. Unpack contents of downloaded archive into data/PGE/ folder of your SMBX2 folder
- Step 3. Open data/PGE folder in your file manager
- Step 4. Close Editor and other apps (such as Maintainer, Engine, MusPlayer, and Playable Calibrator) until start updating
- Step 5. Run the "update-pge.cmd" (or just "update-pge" if the extension showing is disabled) file: must appear the black console window with a greeting, and to start the update, just hit any key and wait update completing. On a UNIX-like operating system you are able to run this script with Wine CMD. Native Linux or Mac OS X Moondust Devkit build also can be used, but the LunaTester feature which is required for a current version of SMBX 2.0 will not work.
- Epilogue. In next time if you want to update Moondust Devkit, just run update-pge.cmd again.
Note: Be aware of antivirus false positives, they may detect wget and/or unzip executables as viruses. They are required by the update process.
SMBX X2 Beta3 - Manual way
If you can't use automatize script, you are able to update Moondust Devkit manually:- Download Moondust Devkit archive (let's call it as Archive1): https://builds.wohlsoft.ru/win32/bin-w64/_packed/pge-project-master-win64.zip
- Download the special SMBX2-Integration config pack (let's call it Archive2): https://wohlsoft.ru/projects/Moondust/_laboratory ... packs/SMBX-2.0-Integration.zip
- Unpack contents of Archive1's "PGE_Project" folder into data/PGE folder and confirm replacing of all files in it
- Remove everything from the data/PGE/configs/ folder
- Unpack contents of Archive2 into data/PGE/configs/ folder
- Try to launch data/PGE/pge_editor.exe to be sure it starts with no errors and config pack status doesn't report any errored resources.
- Profit!
Resolve the post-update API version problem (2022).
After update running, you should perform additional steps to fix the runtime:
- Ensure that the data/PGE/configs/SMBX2 Integration/configure.js file does not exist at SMBX2 installation. If it exists, remove it.
- Edit the data/PGE/configs/SMBX2 Integration/main.ini file and change the "api-version=41" value into "api-version=42"
After you did these steps, Moondust Editor should work normally.
Good Luck!
P.S> To update the standalone package of the Moondust Project, just use the latest Online Installer!
- P.P.S. Archive of outdated notes
- There are outdated notes, archived for historiclal purposes:
IMPORTANT: Since May 13, 2019, to get LunaTester work, you need to have the LunaLoader-exec be placed into your SMBX2's "data" folder!
Otherwise, LunaTester WILL NOT WORK!
EDIT: LunaLoader-exec module is now pre-included with the latest Moondust Project toolchain, you are no longer required to install it manually.
