lip uninstall
Uninstall packages from the workspace.
Synopsis
lip uninstall <PACKAGES>... [-n | --dry-run] [-h | --help]Description
lip uninstall uninstalls the installed packages that <PACKAGES> name, as one workspace operation.
Each of <PACKAGES> names installed packages by the first of these rules that matches any installed package:
- By identity. The operand equals the identity that
lip listshows without the version, such asgithub.com/LiteLDev/LegacyScriptEngine#lua. - By source. The operand, read as a package argument, equals the source the package was installed from, such as
github.com/user/repo@branch:mainor./package.zip. Repository names are compared ignoring case. An operand without a variant matches every variant, and an operand without a ref matches every ref.
A name without /, such as LeviLamina, is a repository of LiteLDev, as for lip install.
What it does:
- The named packages stop being explicitly installed.
- Every package that no remaining explicitly installed package needs is uninstalled: its
pre_uninstallhooks run, the files it owns are deleted except those itspreservekeeps, the paths of itspurgeare deleted, and itspost_uninstallhooks run. - A named package that another explicitly installed package still needs stays installed, as a dependency package.
What it refuses, before anything changes:
- An operand that names no installed package.
- A named package that is not explicitly installed. Uninstall the package that needs it instead.
The game and the loader are uninstalled like any other package. A workspace whose game is uninstalled has no game: set it up again with lip setup before you install mods or run the server. Uninstalling the game keeps server.properties, allowlist.json and permissions.json; see The server files.
Options
| Option | Description |
|---|---|
-n, --dry-run | A dry run. The messages name the packages that would be uninstalled or marked no longer explicitly installed. Nothing is changed. |
-h, --help | Write the help and exit. |
Output
lip uninstall has no result: it writes nothing to standard output. Progress and the final line are messages on standard error.
Exit status
| Code | Meaning |
|---|---|
0 | The packages were uninstalled, or the dry run finished. |
not 0 | A usage error, or the command failed. An operation that failed is undone. |
Examples
Uninstall a package by its identity:
lip uninstall github.com/LiteLDev/LegacyScriptEngine#luaSee what uninstalling two packages would remove:
lip uninstall github.com/user/repo github.com/user/other --dry-runUninstall a package that was installed from a local ZIP file:
lip uninstall ./package.zipSee also
- Managing packages
- Mods: uninstalling mods in the interface.
lip list,lip install,lip setup