Pluginy v Z-Modu¶
Každý uživatel může vytvořit a připojit svůj vlastní plugin do Z-Mod.
Pluginy obsažené v Z-Mod:
- Recommend - Nastavení doporučená ihned po instalaci modu.
- G28_tenz – Parkování osy Z pomocí tenzometrů.
- Nopoop - Maximální snížení odpadu od ninjamida.
- TimeLapse - Moonraker Timelapse.
- Notify - Oznámení v Telegramu a ve více než 100 dalších službách.
Externí pluginy, které nevyvíjí autor Z-Mod:
- Bambufy - Kompatibilní s Bambu Studio, vylepšuje správu čisticí věže, poskytuje přesné odhady doby tisku a spotřeby materiálu, snižuje odpad, podporuje Mainsail, rychlé změny barev a pokročilé tiskařské funkce. NELZE POUŽÍT S NATIVNÍ OBRAZOVKOU.
- lessWaste - fork pluginu Bambufy.
- Dryer - Sušení filamentu pomocí vyhřívané podložky
- IFS Jacker – Doplněk pro podporu hardwarového modu IFS Jacker, který umožňuje automatickou detekci počtu dostupných kanálů a integraci ventilátorů, LED a senzorů připojených přes IFS Jacker do Klipperu.
- HelixScreen – alternativní implementace obrazovky
- QuickSwap - Plugin pro rychlejší změnu barev na AD5X
- Flook32 - Plugin pro připojení sušičky Flook32 En
- Print Handy - Bambu Handy pro každou tiskárnu: vložte odkaz na model do Discordu, Telegramu nebo Matrixu a Print Handy ho naslicuje, přiřadí cívky ze Spoolmanu, před tiskem se zeptá, hlídá kameru kvůli špagetám a vtipkuje o vašem modelu.
- ~~Zmod AFC Lite~~ - odstraněn a nahrazen vestavěnou podporou AFC.
Chcete-li povolit repozitář externích pluginů, spusťte příkaz PLUGINS.
Správa pluginů¶
Povolit plugin:
ENABLE_PLUGIN name=g28_tenz
Zakázat plugin:
DISABLE_PLUGIN name=g28_tenz
PLUGINS¶
Zobrazí nabídku správy pluginů.

V této nabídce můžete zapínat, vypínat a úplně odstraňovat doplňkové pluginy.
- Levý sloupec (aktivace): kliknutím plugin zapnete nebo vypnete.
- Zelené tlačítko — plugin je aktivní.
- Šedé tlačítko — plugin je vypnutý.
- Pravý sloupec (aktualizace): zapíná nebo vypíná automatické aktualizace přes Moonraker.
- UPDATE: ON — aktualizace jsou zapnuté.
- UPDATE: OFF — aktualizace jsou vypnuté.
Jak plugin úplně odstranit:
Pokud plugin již nepotřebujete, přepněte obě jeho tlačítka na šedou (vypněte samotný plugin i jeho aktualizace), stiskněte SAVE (MOONRAKER RESTART) a poté restartujte tiskárnu. Systém automaticky smaže jeho složku z mod_data/plugins/.
Instalace klasických pluginů Klipperu s moduly Pythonu¶
Pro klasické pluginy Klipperu, které pracují s moduly Pythonu (např. klipper-led_effect), je vyžadován speciální instalační proces, který zahrnuje vytvoření symbolického odkazu na modul Klipperu.
Příklad: Instalace led_effect¶
led_effect je plugin pro ovládání RGB LED pásků WS2812 přes Klipper.
Krok 1: Klonujte repozitář
Spusťte tyto příkazy v prostředí chroot:
# Pro AD5M:
chroot /data/.mod/.zmod/
# Pro AD5X:
chroot /usr/data/.mod/.zmod/
# Společné pro všechny modely:
cd /opt/config/mod_data/plugins/
git clone https://github.com/julianschill/klipper-led_effect.git
Krok 2: Přidejte záznam do konfigurace Moonrakeru
Do souboru mod_data/user.moonraker.conf přidejte následující sekci:
[update_manager led_effect]
type: git_repo
channel: stable
path: /opt/config/mod_data/plugins/klipper-led_effect
origin: https://github.com/julianschill/klipper-led_effect.git
is_system_service: False
primary_branch: master
Krok 3: Vytvořte symbolický odkaz na modul Klipperu
Vytvořte symbolický odkaz pro připojení modulu ke Klipperu:
exit
# Native Klipper
ln -s /opt/config/mod_data/plugins/klipper-led_effect/src/led_effect.py /usr/prog/klipper/klippy/extras/led_effect.py
# Klipper 13
ln -s /opt/config/mod_data/plugins/klipper-led_effect/src/led_effect.py /usr/data/zmod/klipper/klippy/extras/led_effect.py
Nahraďte:
klipper-led_effectnázvem složky vašeho pluginuled_effect.pynázvem modulu (může se lišit v závislosti na pluginu)
Krok 4: Restartujte Klipper
Po vytvoření symbolického odkazu musíte restartovat Klipper pomocí tlačítka pro restart ve webovém rozhraní Fluidd/Mainsail.
Důležité poznámky¶
Modul musí být kompatibilní s vaší verzí Klipperu Ujistěte se, že verze pluginu je kompatibilní s vaší nainstalovanou verzí Klipperu.
Vytvoření vlastního pluginu¶
Příklad pluginu: https://github.com/ghzserg/g28_tenz
(Ve všech níže uvedených příkladech se používá název g28_tenz — nahraďte jej názvem vašeho pluginu.)
Přidání pluginu¶
Do souboru mod_data/user.moonraker.conf přidejte následující sekci:
[update_manager g28_tenz]
type: git_repo
channel: dev
path: /root/printer_data/config/mod_data/plugins/g28_tenz
origin: https://github.com/ghzserg/g28_tenz.git
is_system_service: False
primary_branch: main
- Cesta k pluginu:
/root/printer_data/config/mod_data/plugins/g28_tenz - Zdroj:
https://github.com/ghzserg/g28_tenz.git
Stabilní pluginy mohou být zahrnuty v distribuci Z-Mod, ale jsou aktualizovány a udržovány jejich příslušnými autory.
Instalační skript¶
Po volání ENABLE_PLUGIN se automaticky spustí soubor install.sh.
Po volání DISABLE_PLUGIN se automaticky spustí soubor uninstall.sh.
Skript aktualizace¶
Když správce aktualizací aktualizuje plugin, soubor update.sh se automaticky spustí, pokud existuje.
Plugin s jedním jazykem¶
Musí obsahovat soubor:
g28_tenz.cfg
Plugin s více jazyky¶
Soubory jsou umístěny v podadresářích specifických pro daný jazyk:
en/g28_tenz.cfg
ru/g28_tenz.cfg
de/g28_tenz.cfg
...
Všechny výstupní řetězce musí být escapovány, například:
RESPOND PREFIX="info" MSG="===Řežu filament==="
Překlad¶
Překlady jsou uloženy v adresáři translate/ v souborech jako de.csv:
Cutting the filament;Filament schneiden
Formát:
Anglická fráze;Překlad do cílového jazyka
Pro vygenerování jazykových souborů spusťte:
./Make.sh
.cfg soubory.