Setup¶
Restoring Printer to Factory Settings (Required for Mod Installation)¶
- Uninstall KlipperMod if previously installed.
- Reset the printer to default settings.
- Format a USB drive to FAT/FAT16/FAT32(MBR).
-
Copy the appropriate file from the Native firmware to the USB root directory:
- Adventurer5M-3.1.9-2.2.3-20250807-Factory.tgz for FF5M
- Adventurer5MPro-3.1.3-2.2.3-20250107-Factory.tgz for FF5M Pro
- AD5X-1.1.7-1.1.0-3.0.6-20250912-Factory.tgz for AD5X
- Creator5-1.9.9-1.3.0-20260907.tgz for Creator 5
- Creator5Pro-1.9.9-1.3.0-20260907.tgz for Creator 5 Pro
Important: Do not unpack the files!
-
Power off the printer.
- Insert the USB drive into the printer.
- Power on the printer.
- Wait for the stock firmware installation to complete. If it takes too long or does not install at all, use a different flash drive.
- Configure Wi-Fi or LAN new beaver
- Perform the initial calibrations.
- Get the latest printer updates or install firmware 1.1.7 for AD5X, or 3.2.3 for AD5M/AD5M Pro if you don't want the printer to measure the bed center before each print
Installing the Mod¶
- Restore the printer to factory settings. AD5X Warning
- Format a USB drive to FAT/FAT16/FAT32(MBR).
-
Copy the mod file to the USB root directory:
- For FF5M: Adventurer5M-zmod-*.tgz
- For FF5M Pro: Adventurer5MPro-zmod-*.tgz
- For AD5X: AD5X-zmod-*.tgz
- For Creator 5: Creator5-zmod-*.tgz
- For Creator 5 Pro: Creator5Pro-zmod-*.tgz
Even better: put all 5 files on the flash drive — the printer will pick the right one itself.
Important: Do not unpack the files!
-
Power off the printer.
- Insert the USB drive.
- Power on the printer.
- Wait for the mod installation to complete.


Installation on the AD5X/Creator 5/Creator 5 Pro can take up to 40 minutes. If it takes too long or does not install at all, use a different flash drive.
If you missed the window with the green check mark and the printer rebooted automatically, the standard printer screen will load; in this case you can go straight to step 11.
- Remove the USB drive.
- Power off the printer.
- Power on the printer.
-
Open the printer's IP address in the browser

If the web interface doesn't open, the stock firmware has disabled the mod. To enable it, copy the file:
-
Translate the mod into your language.

Or type in the console:
LANG LANG=en
Set your timezone:
SET_TIMEZONE ZONE=Europe/London(runSET_TIMEZONEwithout parameters to list zones). Details -
Configure the mod

This shows parameters used at print start, print end, and global settings. It is recommended to just review the settings — do not change them unless necessary. The description for each parameter can be found here.

You must proceed to the last screen and press
OkorReboot. If you skip this, the window will appear on every boot.
To display this window again later, type in the console:
GLOBAL -
Go to
Settings→Firmware Updates - Click
Check for Updates, and wait until the check completes -
Click Update and update all components.

If many errors appear — this is normal. Plugins are not part of the firmware and are downloaded separately. Click
Check for Updatesagain, then restore and update each module individually. The printer will reboot during the process.
-
Enable the recommendations plugin

Or enter in the console:
ENABLE_PLUGIN name=recommend
-
Send Files via "Octo/Klipper" for Printing
You need to switch to the Octo/Klipper protocol:
- Host Type:
Octo/Klipper - Printer Agent:
Moonraker
For Creator 5 / Creator 5 Pro / AD5X:
- Hostname:
IP_printer

For FF5M / FF5M Pro:
- Hostname:
IP_printer:7125 - Device UI:
IP_printerorIP_printer:80

- Host Type:
-
The entire start code should be replaced with this:
START_PRINT EXTRUDER_TEMP=[nozzle_temperature_initial_layer] BED_TEMP=[bed_temperature_initial_layer_single] M190 S[bed_temperature_initial_layer_single] M104 S[nozzle_temperature_initial_layer] T{single_extruder_multi_material ? 0 : initial_extruder} SET_PRINT_STATS_INFO TOTAL_LAYER=[total_layer_count]START_PRINT EXTRUDER_TEMP=... BED_TEMP=...should be written on one lineThe end code should be this:
END_PRINT
Code for before changing the layer to this one:
SET_PRINT_STATS_INFO CURRENT_LAYER={layer_num + 1}
-

- Read the FAQ
- Calibrate the printer
- Read the specifics of AD5X and Creator 5 Pro
AD5X Warning¶
After installing the Native Firmware, the print head may not be correctly positioned against the filament receiver (the receiver shutter may not be fully closed, filament may be pushed onto the table, etc.).
Via the engineering menu on the stock firmware
If you encounter this issue, you need to calibrate the print head position using the following algorithm:
- Download the Set.XY.Offset.zip archive and unzip it to the root of a flash drive.
- Insert the flash drive into the turned-off printer and turn it on.
- The calibration interface will appear on the printer screen. Press Reset.
- Use the control arrows to position the print head against the receiver so that the print head presses the shutter lever firmly, the nozzle is behind the movable shutter, and the shutter itself is flush with the front surface of the receiver.
- Press the Set button to confirm the calibration result.
- Remove the flash drive and reboot the printer.
Updating the Mod¶
If the mod displays Update Z-Mod via USB, you must update via USB, even if you updated recently.
Updating via USB preserves all data.
Simplest method: Use the ZFLASH macro. Insert the USB drive, reboot the printer, and run ZFLASH. The macro will:
- Check for the latest version.
- Download the latest release for your printer model.
- Verify checksums.
- Reboot the printer.
- Automatically install the update (keep the USB drive inserted for future updates).
After installation:
- Go to Fluidd/Mainsail →
Settings→Software Update. - Click
Check Updatesand install the latest Z-Mod updates.

If it shows a lot of errors, that's normal.
Plugins aren't included in the firmware and are downloaded separately.
Click Check for updates. Then restore and update all modules one by one. The printer will reboot during this process.

Version Compatibility:
- The OS version (under
System→Distribution) must match the first two digits of the Z-Mod version (Settings→Updates→Z-Mod). - Mismatched versions cause instability.
Manual USB Update:
- Format a USB drive to FAT/FAT16/FAT32(MBR).
- Copy the mod file to the USB root.
- Power off the printer.
- Insert the USB drive.
- Power on the printer.
- Wait for the printer to reboot (do not remove the USB drive).
- Wait for the mod installation to complete and for the printer to report success.
- Remove the USB drive.
- Power cycle the printer.
- Go to Fluidd/Mainsail →
Settings→Software Update, clickCheck Updatesand install the latest Z-Mod updates.
Removing or Temporarily Disabling the Mod¶
- SKIP_ZMOD: Reboots without starting Moonraker/Fluidd.
- REMOVE_ZMOD: Fully uninstalls the mod.
Recommended method: Use the REMOVE_ZMOD macro. Use USB removal only if macros are unavailable (after USB removal the Z-Mod boot logo may remain).
Attention!
- If you are using Klipper 13, you must run
UPDATE_MCU. This will prevent the MCU and Klipper from being different versions. - If you have enabled plugins, you must first disable them using
DISABLE_PLUGIN name=g28_tenz
To remove the mod completely: REMOVE_ZMOD FULL=1
USB Removal:
- Format a USB drive to FAT/FAT16/FAT32(MBR).
- Copy flashforge_init.sh to the USB root.
- Power off the printer.
- Insert the USB drive.
- Power on the printer.
- Wait for three reboots.
- Remove the USB drive and use the stock firmware.
Updating Stock Firmware¶
-
Disable all active plugins except
recommend,timelapse,notify, andtelegram_notify:DISABLE_PLUGIN name=plugin_name -
If you are using Klipper 13, run
UPDATE_MCUbefore updating the stock firmware. This prevents version mismatch issues between the MCU and Klipper. - Enable Chinese cloud services (if you wish to update via the stock touchscreen):
SAVE_ZMOD_DATA CHINA_CLOUD=1
If the native screen does not find updates:
- Your serial number has not yet been included in the update rollout
- Install the stock firmware update from a USB drive
For AD5X/Creator 5/Creator 5 Pro, Z-Mod activation from a USB drive after updating the stock firmware:
If the update came through the native screen, then after it says the device needs to be rebooted, run the RESET_PASSWD macro: it activates the mod automatically.
Boot Recovery¶
Guide by @darksimpson, Alexander, @Ikaros413, @SoloMen88
Symptoms: Printer freezes on boot screen and is unreachable via LAN.


Try restoring the firmware by installing a full firmware:
Steps:
- Unplug the printer.
- Prepare a 3.3V UART/USB converter (ensure jumper is set to 3.3V).

- Open the printer’s rear panel.
- Connect to the UART pins (RX, TX, GND — do NOT connect 3.3V).

WARNING: The converter must be 3.3 V. If you apply 5 V, the CPU will burn out and you will have to replace the motherboard! If your converter has a jumper, MAKE SURE to move it from 5V to 3.3V.
-
Connect the converter crosswise:
- Converter RX → Printer TX
- Converter TX → Printer RX
- Converter GND → Printer GND

- Identify the new COM port in your OS.

-
Open PuTTY:
- Connection type: Serial
- Speed: 115200
- COM port: (e.g., COM6)
-
Power on the printer.
-
When
Hit any key to stop autobootappears, press Enter. -
In U-Boot, run:
setenv init /bin/sh boot -
After Linux boots, remount the filesystem as writable:
mount -t proc proc /proc mount -o remount,rw / -
Fix what is broken, e.g. delete a faulty script, or the camera script if boot fails because of the camera:
rm -f /etc/init.d/S01bad_script rm -f /usr/data/zmod/zmod/.shell/S98camera -
Save changes and reboot:
sync reboot
Support Mod Development¶

BTC 17wXTd9BqYp1K3zCLTxVyGLEXUDjf7XNLL
Support via Boosty (international Visa/Mastercard)
