From 0220cc3752b4ba389654d6ff15949a9cc15a2793 Mon Sep 17 00:00:00 2001 From: Telesphoreo Date: Sun, 1 Dec 2024 22:25:41 -0600 Subject: [PATCH] Improvements to compiling and Redis instructions --- docs/compiling.mdx | 36 ++++++++++++++++++------------------ docs/{redis.md => redis.mdx} | 24 ++++++++++++++++++++++-- 2 files changed, 40 insertions(+), 20 deletions(-) rename docs/{redis.md => redis.mdx} (88%) diff --git a/docs/compiling.mdx b/docs/compiling.mdx index eb11eae..69b51bd 100644 --- a/docs/compiling.mdx +++ b/docs/compiling.mdx @@ -10,8 +10,8 @@ import TabItem from '@theme/TabItem'; Compiling Plex is straightforward as there are no dependencies that need to be added manually. Plex uses Gradle as the build system. All compiling instructions are in the ```build.gradle.kts``` file. Note that you can download an already compiled version of Plex from the [CI Server](https://ci.plex.us.org). ## Prerequisites -Please ensure that you have Java 17 installed on your computer, as Plex requires JDK 17 to compile. You will get an error if you try to use an older version. -If you have Java 17 installed, it may not be set in your path. If you do not already have Java installed, the recommended place to get Java is from [Adoptium](https://adoptium.net/). In the installer, there is an option to set JDK 17 to your path. **You must select that option if it is not already selected by default.** +Please ensure that you have Java 21 installed on your computer, as Plex requires JDK 21 to compile. You will get an error if you try to use an older version. +If you have Java 21 installed, it may not be set in your path. If you do not already have Java installed, the recommended place to get Java is from [Adoptium](https://adoptium.net/). In the installer, there is an option to set JDK 21 to your path. **You must select that option if it is not already selected by default.** Plex does not require, but recommends having Git installed on your computer. If you do not want to install Git, you may download the source code manually. Git for Windows can be downloaded [here](https://git-scm.com). macOS and Linux users should already have Git installed by default. ## Using the command line @@ -32,32 +32,32 @@ cd Plex-master Gradle is already included in the folder with Plex. Run the following command below based on your operating system to compile Plex. - + -```bash -./gradlew build -``` + ```bash + ./gradlew build + ``` - - + + -```bash -gradlew.bat build -``` + ```bash + gradlew.bat build + ``` - - + + -```bash -./gradlew build -``` + ```bash + ./gradlew build + ``` - + You should receive a message indicating the compilation was successful. The JAR files for the Server and Proxy are located in the `build/libs` folder. -Plex has no external dependencies and can be used right away after compilation. Plex works on Minecraft 1.19 to 1.20.4. You also must be running Java 17 on the server itself. +Plex has no external dependencies and can be used right away after compilation. See [Versions](./versions.md) to see what the compatibility for Plex is. You also must be running Java 21 on the server itself. ## Troubleshooting If you receive an error that says Permission denied, run `chmod a+x gradlew`. Note that this only applies to macOS / Linux users. diff --git a/docs/redis.md b/docs/redis.mdx similarity index 88% rename from docs/redis.md rename to docs/redis.mdx index b3a9572..5ae1efe 100644 --- a/docs/redis.md +++ b/docs/redis.mdx @@ -3,6 +3,9 @@ id: redis title: Configuring Redis --- +import Tabs from '@theme/Tabs'; +import TabItem from '@theme/TabItem'; + # Redis This page will show you how to setup and configure Redis for Plex. This tutorial assumes a moderate amount of computer knowledge. Please note that setting up Redis is optional. It offers many performance improvements, but can be dangerous if improperly configured. @@ -10,7 +13,7 @@ This page will show you how to setup and configure Redis for Plex. This tutorial If you are using Pterodactyl, setting up Redis is easy. You will need to download and add the Redis egg, which requires administrator privileges. If you are not an administrator, you may request an administrator to set up Redis for you. ### Setup the Redis egg -Right click on [this link](https://docs.plex.us.org/egg-redis-7.json) and click "Save As". Please ensure that the filename ends in .json +Right-click on [this link](@site/static/egg-redis-7.json) and click "Save As". Please ensure that the filename ends in .json On your Pterodactyl admin page, click on the "Nests" from the sidebar. Click the blue "Create New" button and enter "Databases" for the name. Then, click on the green "Import Egg" button. Import the `egg-redis-7.json` file you just downloaded and make sure the "Associated Nest" is set to "Databases". @@ -81,5 +84,22 @@ side: Replace `your_secure_password_here` with the password you made for Redis. Now, Plex will use Redis for storing punishment data. Note that the JSON files are still made as a backup no matter what. -### Firewall Configuraton +### Firewall Configuration If you are using a firewall, you may have to allow port `6380`. It is safe to allow connections from anywhere provided you have followed the documentation correctly. + + + + ```bash + ufw allow 6380 + ``` + + + + + ```bash + iptables -A INPUT -p tcp --dport 6380 -j ACCEPT + iptables -A OUTPUT -p tcp --dport 6380 -j ACCEPT + ``` + + + \ No newline at end of file