171 lines
7.1 KiB
Markdown
171 lines
7.1 KiB
Markdown
# ComputerCraft Package Tool (CCPT)
|
|
|
|
|
|
[](https://github.com/PentagonLP/ccpt/blob/main/LICENSE)
|
|
[](https://github.com/PentagonLP/ccpt/issues)<br>
|
|
[](https://github.com/PentagonLP/ccpt/graphs/contributors)
|
|
[](https://github.com/PentagonLP/ccpt/commits/main)
|
|
[](https://github.com/PentagonLP/ccpt/commits/main)<br>
|
|
|
|
|
|
<br>
|
|
|
|
Package Tool for the Minecraft mod **ComputerCraft/CC: Tweaked**
|
|
|
|
## Features
|
|
The package tool is built after the Linux package tool '[apt/apt-get](https://salsa.debian.org/apt-team/apt)'. It has simular features as apt-get, but for ComputerCraft. You can **install a default set of packages** from online sources, or **register your own packages**. It deals with **dependencies** *(eg. Package A is dependend on package B, so if you install package A the tool will also install package B)* and it automaticly **checks for updates**; If updates are availible, you can **install them with one command**.<br>
|
|
|
|
At the moment, the list of default packages is very small. **If you are a developer and you want to register your own program, please read the '[How to apply for the default package list for one of your packages](https://github.com/PentagonLP/ccpt/wiki/How-to-apply-for-the-default-package-list-for-one-of-your-packages)' wiki article.**
|
|
## How to install
|
|
The installer is hosted on [pastebin.com](https://pastebin.com). Therefore, you can install the tool with one command:
|
|
```
|
|
pastebin run syAUmLaF
|
|
```
|
|
**Attention:** The default 'pastebin'-program does no longer work reliably on **1.7.10 or older**! You can fix the issue by downloading and installing [this](https://github.com/SquidDev-CC/FAQBot-CC/raw/786214ba08d8ccc7cbd11eb1d921e82327dee9a8/etc/cc-pastebin-fix.zip) resourcepack, or, if you are playing on a server, ask your admin to install it in the server directory. **You have to restart your game/server for it to work!**
|
|
|
|
Alternativly, you can manually download the [ccptinstall.lua](https://github.com/PentagonLP/ccpt/blob/main/ccptinstall.lua)-file, put it in your computers working directory and execute it.
|
|
## How to use
|
|
This program is a one-command-program. To use it, type:
|
|
```
|
|
ccpt <action>
|
|
```
|
|
The following actions are possible:
|
|
|
|
### **1. Reload package data and search for updates**
|
|
```
|
|
ccpt update
|
|
```
|
|
This fetches the list of default packages and properties of all packages, local packages included, from the internet and stores them localy.
|
|
|
|
|
|
*The Output should look something like this:*
|
|
<br><img
|
|
alt="missing image :("
|
|
src="https://raw.githubusercontent.com/PentagonLP/ccpt/main/img/ccpt_update.png"
|
|
/><br>
|
|
|
|
### **2. Install a package**
|
|
```
|
|
ccpt install <packageid>
|
|
```
|
|
This installes the package with the id <packageid>, including all the packages it depends on.
|
|
|
|
|
|
*The Output should look something like this:*
|
|
<br><img
|
|
alt="missing image :("
|
|
src="https://raw.githubusercontent.com/PentagonLP/ccpt/main/img/ccpt_install.png"
|
|
/><br>
|
|
|
|
### **3. Update all packages**
|
|
```
|
|
ccpt upgrade
|
|
```
|
|
This updates all packages. If a package needs a new dependency after an update or an updated version of a dependency, the package it depends on will be installed or updated.
|
|
|
|
|
|
*The Output should look something like this:*
|
|
<br><img
|
|
alt="missing image :("
|
|
src="https://raw.githubusercontent.com/PentagonLP/ccpt/main/img/ccpt_upgrade.png"
|
|
/><br>
|
|
|
|
### **4. Uninstall a package**
|
|
```
|
|
ccpt uninstall <packageid>
|
|
```
|
|
This uninstalles the package with the given ID and all packages that depend on said package.
|
|
|
|
|
|
*The Output should look something like this:*
|
|
<br><img
|
|
alt="missing image :("
|
|
src="https://raw.githubusercontent.com/PentagonLP/ccpt/main/img/ccpt_uninstall.png"
|
|
/><br>
|
|
|
|
### **5. Add a local/custom package**
|
|
```
|
|
ccpt add <packageid> <packageinfoURL>
|
|
```
|
|
This adds a custom package to the local list. You have to run 'ccpt update' though for it to be able to be installed/changed.
|
|
|
|
|
|
*The Output should look something like this:*
|
|
<br><img
|
|
alt="missing image :("
|
|
src="https://raw.githubusercontent.com/PentagonLP/ccpt/main/img/ccpt_add.png"
|
|
/><br>
|
|
|
|
### **6. Remove a local/custom package**
|
|
```
|
|
ccpt remove <packageid>
|
|
```
|
|
This removes a custom package from the local list. You have to run 'ccpt update' though for it to be removed from the 'able to update/remove'-list.
|
|
|
|
|
|
*The Output should look something like this:*
|
|
<br><img
|
|
alt="missing image :("
|
|
src="https://raw.githubusercontent.com/PentagonLP/ccpt/main/img/ccpt_remove.png"
|
|
/><br>
|
|
|
|
### **7. List all installed and able to install packages**
|
|
```
|
|
ccpt list
|
|
```
|
|
This lists name, their install status and wether they have availible updates of all installed and able to install packages.
|
|
|
|
|
|
*The Output should look something like this:*
|
|
<br><img
|
|
alt="missing image :("
|
|
src="https://raw.githubusercontent.com/PentagonLP/ccpt/main/img/ccpt_list.png"
|
|
/><br>
|
|
|
|
### **8. Get info about a specific package**
|
|
```
|
|
ccpt info <packageid>
|
|
```
|
|
This prints name, author, description, website (if given), installation type, installed and newest version of a given package.
|
|
|
|
|
|
*The Output should look something like this:*
|
|
<br><img
|
|
alt="missing image :("
|
|
src="https://raw.githubusercontent.com/PentagonLP/ccpt/main/img/ccpt_info.png"
|
|
/><br>
|
|
|
|
### **9. Display help**
|
|
```
|
|
ccpt help
|
|
```
|
|
This prints all availible actions for the 'ccpt' command.
|
|
|
|
*The Output should look something like this:*
|
|
<br><img
|
|
alt="missing image :("
|
|
src="https://raw.githubusercontent.com/PentagonLP/ccpt/main/img/ccpt_help.png"
|
|
/><br>
|
|
|
|
### **10. Display current 'ccpt'-version**
|
|
```
|
|
ccpt version
|
|
```
|
|
This prints the installed version of ccpt.
|
|
|
|
*The Output should look something like this:*
|
|
<br><img
|
|
alt="missing image :("
|
|
src="https://raw.githubusercontent.com/PentagonLP/ccpt/main/img/ccpt_version.png"
|
|
/><br>
|
|
## How to create your own package
|
|
Take a look in our Wiki: [How to create your own package](https://github.com/PentagonLP/ccpt/wiki/Create-your-own-package)
|
|
## Changelog
|
|
Nothing here yet, we are still on 1.0 :)
|
|
## Last words
|
|
Well, that's about it! Thanks for using this package tool. It would be awsome if we could build a useful collection of packages over time.
|
|
As always, please keep in mind that my first language is not english. There are defnitly some spelling/language-related mistakes in this repository. If you find one, please create an issue so I can fix them.
|
|
Also, I'm still very new to Github. If you find anything I can do better, and there definitly is as I don't know all the features of Github yet, please do also create an issue.
|
|
Anyways, thanks for reading all this!
|
|
~PentagonLP
|