This guide outlines how to create, structure, and deploy plugins for Project Raco.
Click to view Plugin Architecture
Unlike standard Magisk Modules, Raco plugins have unique execution behaviors. A plugin can operate in two modes:
- Manual Execution
- Start on Boot
Warning
Syntax Requirement: All scripts (install.sh, service.sh, uninstall.sh) must be written in standard Shell Language.
Do not use Magisk Module-specific syntax or functions, as they will cause the plugin to fail.
Your plugin .zip file must follow this exact directory structure:
Raco Plugin.zip/
├── raco.prop
├── service.sh
├── webroot / (If you want to add WebUI (added in Raco 5.0)
├── uninstall.sh
├── install.sh
├── post-fs-data.sh
└── Logo.png (Optional) - Max 512x512
The raco.prop file is the heart of your plugin. You must define the following property for the plugin to be recognized by the system:
RacoPlugin=1
If this line is missing, the installation will fail.
| Resource | Description | Link |
|---|---|---|
| Plugin Example | A reference implementation (PingImp) | View Example |
| Plugin Template | Empty starter template | Download Template |