Skip to content

Commit

Permalink
Merge remote-tracking branch 'origin/master'
Browse files Browse the repository at this point in the history
  • Loading branch information
Osiris-Team committed May 11, 2023
2 parents 386dd3b + ba48e5e commit 5445698
Showing 1 changed file with 32 additions and 13 deletions.
45 changes: 32 additions & 13 deletions docs/FAQ.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,17 +4,31 @@

---

### **What is AutoPlug Client?**
AutoPlug Client is a standalone, executable java program that runs in place of your Minecraft server.
### **What is it? Purpose?**
AutoPlug Client is a standalone, executable Java program that has multiple execution modes: Server-Wrapper, CLI-Tool, Background-Service.
Its main purpose is to automate updating of any sofware related to servers and simplify server maintenance in general.
While all server types are compatible, the majority of its features cater specifically to Minecraft,
which is renowned as the world's top-selling game and boasts an exceptionally extensive modding community.

### **What does AutoPlug Client do?**
The main purpose of AutoPlug Client is to automatically identify and update any plugins or mods you use with your Minecraft server.
### **How does it work? Server-Wrapper? CLI-Tool? Background-Service?**
AutoPlug performs all its tasks when your server is offline, thus its recommended
to run AutoPlug as a Server-Wrapper so that it can start/stop/restart your server.
In this case AutoPlug will start your server automatically when it launches and show its console output.

### **Is AutoPlug Client a plugin or mod?**
To achieve full automation the daily server restarter is used (enabled by default),
which restarts your server at specific times in the day. AutoPlug runs its tasks when your server restarts.

If you don't want AutoPlug to have access to your servers' console, you can install AutoPlug as CLI-Tool or Background-Service:
- CLI-Tool (command-line interface tool): Manually run the AutoPlug commands/tasks once in a while (remember that your server must be offline).
- Background-Service: Runs the tasks periodically but does not know if the server is offline, thus you would have to take care of that.

Note that these "execution modes" are nothing more that simple configuration presets.

### **Is it a plugin or mod?**
No! AutoPlug Client is neither a plugin nor mod and should not be treated as such.
It runs entirely independently of your Minecraft server.

### **What features does AutoPlug Client have?**
### **What are the features?**
AutoPlug Client currently has the following features:
- AutoPlug Client self-updating
- Standalone Java installation and updating
Expand All @@ -26,20 +40,22 @@ AutoPlug Client currently has the following features:

For a full list of features, please visit <https://autoplug.one/features>

### **Can AutoPlug Client update my paid/premium plugins?**
### **Can it update my paid/premium plugins?**
No. Due to the nature of how the paid plugins are hosted, as well as the hosts' API limitations and Terms of Service, AutoPlug Client will never contain functionality for downloading paid/premium plugins.

As an alternative, SPPU [[Link](https://github.com/Osiris-Team/SPPU)] may be better suited.
*It is highly advised to read the entire readme before using this tool.*

### **How do I install AutoPlug Client?**
### **How do I install it?**
Go to the AutoPlug Client [installer page](https://autoplug.one/installer) and follow the steps carefully.

### **Can I install AutoPlug Client on a server host?**
### **Can I install it on a server host?**
Yes! For instructions on how to do so, please read [How To - Install AutoPlug Client on a Server Host](How%20To%20-%20Install%20AP%20Client%20on%20a%20Server.md).

### **How do I change the settings?**
### **How do I change the settings? Live-Settings?**
All settings are kept in their own respective `.yml` config files that can be found in the `autoplug` folder in your Minecraft server directory.
Almost all settings can be changed without needing to restart AutoPlug to have effect (Live-Settings), since
related settings are freshly loaded before executing a task.

### **How do I know what some settings do?**
Every `.yml` config file has explanations with examples written both at the very top of the file and next to each setting.
Expand All @@ -53,14 +69,17 @@ Please make either a Github Issue or a post in the Discord's #help channel.

---

### **I just installed AutoPlug Client and it's taking forever to start!**
This is normal for first-time installations and can take up to 3 - 5 minutes depending on system resources, network availability, and number of plugins/mods.
### **Just installed and it's taking forever to start!**
By default backup creation is enabled, so before executing its tasks a backup will be created that
can take up to 3 - 5 minutes depending on system resources and size of the directory.
Besides that there may be many updates/files that have to be downloaded, so do not abort
this process to ensure a correct installation.

### **I get the message `Starting server: xxx.jar` but nothing happens!**
This usually means that something is wrong with your Java installation.
By default, AutoPlug Client installs its own standalone Java runtime in `./autoplug/system`.

To make AutoPlug Client reinstall Java:
To make AutoPlug-Client reinstall Java:
1. Delete the `system` directory in `./autoplug`.
2. In the Updater config (default: `./autoplug/updater.yml`), set `updater: java-updater: build-id:` to `0` and save the file.
3. Restart AutoPlug Client.
Expand Down

0 comments on commit 5445698

Please sign in to comment.