chore: add README.md

README.md

@@ -0,0 +1,83 @@
+# Multicraft Jar Configurations
+
+This repository contains the Multicraft jar configuration files that are used in conjunction with the [java-multi-version](https://git.jrdn.dev/jordanwalster/-/packages/container/java-multi-version/latest) docker image. 
+
+This allows Multicraft to utilise the built in docker feature whilst maintaining the ability to run different versions of Minecraft, since the `multicraft.conf` forces the selection of a single jdk image.
+
+## How to use
+
+The configurations from this repo can be used with a bare metal installation of Multicraft, but my preferred method is using Docker-in-Docker, allowing the entire minecraft stack to be containerised.
+
+1. Grab your key from Multicraft and store it in the root directory.
+
+2. Run Multicraft using the [multicraft-docker](https://git.jrdn.dev/jordanwalster/-/packages/container/multicraft-docker/latest) image and the accompanying `docker-compose.yml` & `.env` files.
+
+3. Navigate to the `install.php` file and complete the setup matching the values to the `.env` file.  
+
+4. Once setup is complete, navigate to Settings > Update Minecraft > Add or Remove Files
+    - In the JAR Filename, File URL and Conf URL fields, enter the chosen file: e.g.
+      - JAR Filename: `paper-1.21.4.jar`
+      - File URL: `https://mc-assets.jrdn.dev/jar/paper-1.21.4.jar`
+      - Conf URL: `https://mc-assets.jrdn.dev/conf/paper-1.21.4.jar.conf`
+
+All configuration files are in the <strong>/conf</strong> path, matching their corresponding `.jar` files in <strong>/jar</strong>, with the same name plus a `.conf` extension.
+
+
+### Docker compose and .env file
+
+#### docker-compose.yml
+
+```
+services:
+  multicraft:
+    image: git.jrdn.dev/jordanwalster/multicraft-docker:latest
+    ports:
+      - 80:80
+      - target: 21
+        published: 21
+        mode: host
+    volumes:
+      - ${BASE_DIR}/web-data:/var/www/html
+      - ${BASE_DIR}/multicraft/jar:/multicraft/jar
+      - ${BASE_DIR}/multicraft/servers:/multicraft/servers
+      - ${BASE_DIR}/multicraft/templates:/multicraft/templates
+      - ${BASE_DIR}/multicraft.key:/multicraft/multicraft.key
+      - /var/run/docker.sock:/var/run/docker.sock
+    environment:
+      - BASE_DIR=${BASE_DIR}
+      - SERVER_MEMORY=${SERVER_MEMORY}
+      - JDK_IMAGE=git.jrdn.dev/jordanwalster/java-multi-version:latest
+      - MYSQL_USER=${MYSQL_USER}
+      - MYSQL_DATABASE=${MYSQL_DATABASE}
+      - MYSQL_PASSWORD=${MYSQL_PASSWORD}
+    networks:
+      - multicraft
+    depends_on:
+      - db
+  db:
+    image: mariadb
+    volumes:
+      - ${BASE_DIR}/db:/var/lib/mysql
+    environment:
+      MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}
+      MYSQL_USER: ${MYSQL_USER}
+      MYSQL_PASSWORD: ${MYSQL_PASSWORD}
+      MYSQL_DATABASE: ${MYSQL_DATABASE}
+    networks:
+      - multicraft
+
+networks:
+  multicraft:
+    driver: bridge
+```
+
+#### .env
+
+```
+BASE_DIR=/path/to/data
+SERVER_MEMORY=2048
+MYSQL_USER=multicraft
+MYSQL_DATABASE=multicraft
+MYSQL_PASSWORD=changeme
+MYSQL_ROOT_PASSWORD=changeme
+```

paper/paper-1.12.2.jar.conf

@@ -2,7 +2,7 @@
 name = [Paper] Paper 1.12.2
 source = https://mc-assets.jrdn.dev/jar/paper/paper-1.12.2.jar
 configSource = https://mc-assets.jrdn.dev/conf/paper/paper-1.12.2.jar.conf
-category = Mods
+category = Paper
 
 ## Encoding used for strings sent to and received from the server
 [encoding]
@@ -11,4 +11,4 @@ decode = utf-8
 fileEncoding = latin-1
 
 [start]
-command = "/opt/java-1.8-openjdk/bin/java" -Xmx{MAX_MEMORY}M -Xms{START_MEMORY}M -Djline.terminal=jline.UnsupportedTerminal -jar "{JAR}" nogui
+command = "/usr/lib/jvm/java-1.8-openjdk/bin/java" -Xmx{MAX_MEMORY}M -Xms{START_MEMORY}M -Djline.terminal=jline.UnsupportedTerminal -jar "{JAR}" nogui

paper/paper-1.16.5.jar.conf

@@ -2,7 +2,7 @@
 name = [Paper] Paper 1.16.5
 source = https://mc-assets.jrdn.dev/jar/paper/paper-1.16.5.jar
 configSource = https://mc-assets.jrdn.dev/conf/paper/paper-1.16.5.jar.conf
-category = Mods
+category = Paper
 
 ## Encoding used for strings sent to and received from the server
 [encoding]
@@ -11,4 +11,4 @@ decode = utf-8
 fileEncoding = latin-1
 
 [start]
-command = "/opt/java-1.8-openjdk/bin/java" -Xmx{MAX_MEMORY}M -Xms{START_MEMORY}M -Djline.terminal=jline.UnsupportedTerminal -jar "{JAR}" nogui
+command = "/usr/lib/jvm/java-1.8-openjdk/bin/java" -Xmx{MAX_MEMORY}M -Xms{START_MEMORY}M -Djline.terminal=jline.UnsupportedTerminal -jar "{JAR}" nogui

paper/paper-1.19.4.jar.conf

@@ -2,7 +2,7 @@
 name = [Paper] Paper 1.19.4
 source = https://mc-assets.jrdn.dev/jar/paper/paper-1.19.4.jar
 configSource = https://mc-assets.jrdn.dev/conf/paper/paper-1.19.4.jar.conf
-category = Mods
+category = Paper
 
 ## Encoding used for strings sent to and received from the server
 [encoding]
@@ -11,4 +11,4 @@ decode = utf-8
 fileEncoding = latin-1
 
 [start]
-command = "/opt/java-17-openjdk/bin/java" -Xmx{MAX_MEMORY}M -Xms{START_MEMORY}M -Djline.terminal=jline.UnsupportedTerminal -jar "{JAR}" nogui
+command = "/usr/lib/jvm/java-17-openjdk/bin/java" -Xmx{MAX_MEMORY}M -Xms{START_MEMORY}M -Djline.terminal=jline.UnsupportedTerminal -jar "{JAR}" nogui

paper/paper-1.20.1.jar.conf

@@ -0,0 +1,14 @@
+[config]
+name = [Paper] Paper 1.20.1
+source = https://mc-assets.jrdn.dev/jar/paper/paper-1.20.1.jar
+configSource = https://mc-assets.jrdn.dev/conf/paper/paper-1.20.1.jar.conf
+category = Paper
+
+## Encoding used for strings sent to and received from the server
+[encoding]
+encode = utf-8
+decode = utf-8
+fileEncoding = latin-1
+
+[start]
+command = "/usr/lib/jvm/java-21-openjdk/bin/java" -Xmx{MAX_MEMORY}M -Xms{START_MEMORY}M -Djline.terminal=jline.UnsupportedTerminal -jar "{JAR}" nogui

paper/paper-1.20.6.jar.conf

@@ -2,7 +2,7 @@
 name = [Paper] Paper 1.20.6
 source = https://mc-assets.jrdn.dev/jar/paper/paper-1.20.6.jar
 configSource = https://mc-assets.jrdn.dev/conf/paper/paper-1.20.6.jar.conf
-category = Mods
+category = Paper
 
 ## Encoding used for strings sent to and received from the server
 [encoding]
@@ -11,4 +11,4 @@ decode = utf-8
 fileEncoding = latin-1
 
 [start]
-command = "/opt/java-17-openjdk/bin/java" -Xmx{MAX_MEMORY}M -Xms{START_MEMORY}M -Djline.terminal=jline.UnsupportedTerminal -jar "{JAR}" nogui
+command = "/usr/lib/jvm/java-21-openjdk/bin/java" -Xmx{MAX_MEMORY}M -Xms{START_MEMORY}M -Djline.terminal=jline.UnsupportedTerminal -jar "{JAR}" nogui

paper/paper-1.21.4.jar.conf

@@ -1,8 +1,8 @@
 [config]
 name = [Paper] Paper 1.21.4
-source = https://api.papermc.io/v2/projects/paper/versions/1.21.4/builds/138/downloads/paper-1.21.4-138.jar
+source = https://mc-assets.jrdn.dev/jar/paper/paper-1.21.4.jar
 configSource = https://mc-assets.jrdn.dev/conf/paper/paper-1.21.4.jar.conf
-category = Mods
+category = Paper
 
 ## Encoding used for strings sent to and received from the server
 [encoding]
@@ -11,4 +11,4 @@ decode = utf-8
 fileEncoding = latin-1
 
 [start]
-command = "/usr/lib/jvm/java-21-openjdk/bin/java" -verbose:class -Xmx{MAX_MEMORY}M -Xms{START_MEMORY}M -Djline.terminal=jline.UnsupportedTerminal -jar "{JAR}" nogui
+command = "/usr/lib/jvm/java-21-openjdk/bin/java" -Xmx{MAX_MEMORY}M -Xms{START_MEMORY}M -Djline.terminal=jline.UnsupportedTerminal -jar "{JAR}" nogui

paper/paper-1.9.4.jar.conf

@@ -2,7 +2,7 @@
 name = [Paper] Paper 1.9.4
 source = https://mc-assets.jrdn.dev/jar/paper/paper-1.9.4.jar
 configSource = https://mc-assets.jrdn.dev/conf/paper/paper-1.9.4.jar.conf
-category = Mods
+category = Paper
 
 ## Encoding used for strings sent to and received from the server
 [encoding]
@@ -11,4 +11,4 @@ decode = utf-8
 fileEncoding = latin-1
 
 [start]
-command = "/opt/java-1.8-openjdk/bin/java" -Xmx{MAX_MEMORY}M -Xms{START_MEMORY}M -Djline.terminal=jline.UnsupportedTerminal -jar "{JAR}" nogui
+command = "/usr/lib/jvm/java-1.8-openjdk/bin/java" -Xmx{MAX_MEMORY}M -Xms{START_MEMORY}M -Djline.terminal=jline.UnsupportedTerminal -jar "{JAR}" nogui