ServerPackCreator

For questions, you can always join my Discord server and talk to me there.

ServerPackCreator creates a server pack from any given Forge, Fabric, Quilt, LegacyFabric and NeoForge modpack.

Whenever you are working on an update to your modpack, you simply run ServerPackCreator and BAM! You’ve got yourself a server pack for your new modpack version.

ServerPackCreator is a passion project on which I am working in my spare time. It is also the main reason for why I got into programming in the first place. Patience with issues and support is appreciated!

I started getting into Java programming in February 2021, when I was working on an update for one of my Minecraft modpacks, Survive Create Prosper 4, and got tired and bored with manually creating a server pack everytime I wanted to update and test something, or just release a new server pack for the new modpack version.

The thought “There must be a way to automate this, or at least make it less tedious…” was the spark which sent me off into the world of programming. And here we are.

Disclaimer:

• ServerPackCreator is not a guarantee for working server packs. It helps you create them, but you must still test them!
• You are still expected to be knowledgeable about your modpack, server packs in general, server administration and managing your Java installations. ServerPackCreator is not intended to take all the work off your shoulders!
• When using alpha, beta or in-dev version of ServerPackCreator, it is advised to make a backup of your ServerPackCreator-directory in your home-directory.
• Things will break with alpha releases, stuff may break when using beta releases.
• If you distribute server packs generated with a pre-release (alpha, beta) of ServerPackCreator, you do so at your own risk.
• I will not be held responsible for errors in your server pack caused by you using a pre-release.
• I will not be held responsible for errors in your server pack in general. Test your server packs before you ship them!
• TL;DR: Don’t use test to ship to prod! Test before shipping!

Pre-Releases:

There are two kinds of pre-releases: Alphas and Betas

• Alphas: Missing features, incomplete features, almost guaranteed to have bugs / errors
• Betas: Feature complete, probably contains bugs / errors

Screenshots

CLI	GUI	WEB

Advantages/Disadvantages of CLI, GUI and WEB:

Each way of using ServerPackCreator has its advantages and disadvantages. Depending on your environment, it may be better to use one way over the other. This section highlights some of the advantages and disadvantages of each version to help you decide which way you are going to use. Note: All three ways are supported by the .jar-file. Which one is started depends on the CLI arguments used and your environment.

CLI:

GUI:

WEB:

1. Small feature overview

1. Exclude clientside-only mods
   • Automatically by letting ServerPackCreator scan the mods of your modpack for their sideness
   • Manually by configuring a list mods which ServerPackCreator will filter out according to your input and the chosen filter.
2. Add files and directories in your server pack.
   • Files and directories in your modpack
   • Files and directories from your computer
3. Add a server icon
   • Server icons are automatically scaled down, or up, to 64x64!
   • Specify a custom one, or use a default provided by ServerPackCreator.
     • Change the default to your liking if you intend on using the same icon across multiple server packs!
4. Add a server.properties
   • Ship your server pack with default settings!
   • Specify a custom one, or use a default provided by ServerPackCreator.
     • Change the default to your liking if you intend on using the same icon across multiple server packs!
5. Many modloaders supported
   • Forge
   • Fabric
   • LegacyFabric
   • Quilt
   • NeoForge
6. Use Minecraft snapshots and pre-releases
   • Per default, only regular releases enabled
7. Let ServerPackCreator install the modloader-server for your server pack, for immediate testing and debugging after generation!
8. Let ServerPackCreator generate a ZIP-archive, for immediate upload to places like CurseForge (after you’ve tested your server pack, of course 😉)
9. Configure commandline arguments with which to start the Minecraft server
   • Does your modpack require a lot of RAM? Well, tell ServerPackCreator to create the start scripts with -Xms8G -Xmx8G or similar values!
   • Aikars flags are available, too. If you like 'em, use 'em.
10. Create your own start-script templates
    • Add additional functionality to your servers start scripts
    • Use placeholders in your templates, to be replaced with custom values
      • Example: placeholder SPC_FLYNN_LIVES_SPC in the templates can be replaced with a value configured on a per-server pack basis, i.e Now that's a big door
11. Plugins!
    • ServerPackCreator allows you to use plugins to add new features in various places.
    • An example plugins is available with every release, and the source code for it can be found in this repository, at Example Plugin

2. Issues and help

• Report a bug / ask for a feature / ask for an improvement / request a documentation improvement:
  • https://github.com/Griefed/ServerPackCreator/issues/new/choose
• There’s a Wiki available which goes into further detail for many of ServerPackCreators available aspects:
  • https://help.serverpackcreator.de/help-topic.html
• The same as the Wiki, but as a file should you prefer it. 😊
  • HELP.md

3. How To

The first time you start ServerPackCreator, you will be asked whether you want to see a small step-by-step guide. Said guide will show you the most important parts in configuring your server pack.

Should you at any point want to revisit said guide, simply hit About -> Step-By-Step Guide in the menu at the top.

kreezxil has made a video showing a step-by-step video-tutorial for ServerPackCreator:

4. Java

Required:

• Using the JAR-file release requires Java 21.
• Working internet connection recommended.

The installers ship their own Java installations.

ATTENTION: I can not and will not guarantee that ServerPackCreator will work flawlessly with any other Java version other than version 21. Things may break at random, at any place, if a different Java version is used. You are welcome to try and use any other version, but do not report issues back to me if you do encounter problems when running ServerPackCreator with a more recent Java version.

5 Running

1. If you’ve used the installer to acquire ServerPackCreator, use the shortcut created by the installer to run ServerPackCreator. The installers provide their own Java runtime, so you do not need to install Java separately.
2. If you’ve downloaded the JAR-file, and depending on how your Java installation is set up, you may be able to simply run the JAR via double-click or other methods, or you may need to run it from the commandline.

There are a couple of arguments which may or may not be helpful for you, depending on how you plan on using ServerPackCreator:

5.1 Running ServerPackCreator as a webservice

DISCLAIMER

There is no publicly available instance of ServerPackCreators webservice due to security concerns with the ability to upload zip-archives. If you want to make use of the webservice, you will have to host your own instance. As such, you are advised to not make your instance of the webservice of ServerPackCreator publicly accessible.

ZIP-archives uploaded by anonymous people may contain illegal or otherwise dangerous data, which could corrupt your system or get you into legal trouble.

If you want to open your webservice-instance to the public, make sure to properly protect it by putting it behind required authorization.

5.1.1 JAR

1. Download the JAR-file from the latest release

2. Run it once, using the -web argument. ServerPackCreator will crash, complaining about JDBC-related things. This is expected, don’t worry.

3. Browser to the now generated ServerPackCreator home-directory

   1. Unsure where said home-directory is? Check the logs for Home directory set to:!

4. Install / setup / provide a MongoDB-database for ServerPackCreator. See MongoDB Installation Tutorial

5. Set the database-properties in the serverpackcreator.properties according to your database

   1. spring.data.mongodb.uri=
      • Example:mongodb\://<USER>:<PASSWORD>@localhost\:27017/serverpackcreatordb
      • If the username or password includes the following characters $ : / ? # [ ] @, those characters must be converted using percent encoding (https://datatracker.ietf.org/doc/html/rfc3986#section-2.1) : $ : / ? # [ ] @

6. Run ServerPackCreator, using the -web-argument, again

7. Browse to http://localhost:8080

5.1.1.1 Tweaking the webservice

You may edit the following properties inside the serverpackcreator.properties if you wish to change some parts of the webservice-behaviour:

5.1.2 Docker (recommended)

The recommended, and easiest, way to deploy ServerPackCreator as a webservice is via docker and docker-compose.

Available images can be viewed at https://hub.docker.com/r/griefed/serverpackcreator/tags

About Tags: The example below makes use of the latest-tag. However, using said tag is not recommended, as there may be breaking changes between versions. When setting up ServerPackCreator as a webservice for production, make sure to not use latest and instead use the tag corresponding to the, at this point, latest available release version available.

You must replace <DB_ROOT_USERNAME> and <DB_ROOT_PASSWORD> accordingly. Do note the - ./init-mongo.js:/docker-entrypoint-initdb.d/init.js:ro in the serverpackcreatorb-service. An example for this file is available at docker/docker/init-mongo.js. This init-script initializes the MongoDB with the required user, database and collection.

version: '3'
services:
  serverpackcreatordb:
    image: mongodb/mongodb-community-server:8.0.5-ubuntu2204
    container_name: serverpackcreatordb
    restart: unless-stopped
    environment:
      MONGO_INITDB_ROOT_USERNAME: <DB_ROOT_USERNAME>
      MONGO_INITDB_ROOT_PASSWORD: <DB_ROOT_PASSWORD>
      MONGO_INITDB_DATABASE: serverpackcreatordb
    volumes:
      - ./init-mongo.js:/docker-entrypoint-initdb.d/init.js:ro
      - spcdb-data:/data/db
      - spcdb-conf:/data/configdb

  serverpackcreator:
    container_name: serverpackcreator
    image: griefed/serverpackcreator:latest # For a list of available tags, see https://hub.docker.com/r/griefed/serverpackcreator/tags
    restart: unless-stopped
    depends_on:
      - serverpackcreatordb
    environment:
      - TZ=Europe/Berlin # Your timezone
      - PUID=1000 # Your user ID
      - PGID=1000 # Your group ID
      - SPC_DATABASE_PASSWORD=<DB_ROOT_PASSWORD> # $ : / ? # [ ] @ those characters must be converted using https://datatracker.ietf.org/doc/html/rfc3986#section-2.1
      - SPC_DATABASE_USERNAME=<DB_ROOT_USERNAME> # $ : / ? # [ ] @ those characters must be converted using https://datatracker.ietf.org/doc/html/rfc3986#section-2.1
      - SPC_DATABASE_HOST=serverpackcreatordb  # Do not change this unless you absolutely know what you are doing.
      - SPC_DATABASE_PORT=27017  # Do not change this unless you absolutely know what you are doing.
      - SPC_DATABASE_DB=serverpackcreatordb # Do not change this unless you absolutely know what you are doing.
    ports:
      - "8080:8080" # Port at which SPC will be available at on your host : Port of the webservice inside the container. Only change the left value, it at all.
    volumes:
      - ./modpacks:/app/serverpackcreator/modpacks # Path at which modpacks from the container will be stored at on your host : Path to the modpacks in the container. Only change the left value, if at all.
      - ./server-packs:/app/serverpackcreator/server-packs # Path at which server packs from the container will be stored at on your host : Path to the server packs in the container. Only change the left value, if at all.
      - ./logs:/app/serverpackcreator/logs # Path at which logs from the container will be stored at on your host : Path to the logs in the container. Only change the left value, if at all.

volumes:
  spcdb-data:
  spcdb-conf:

5.1.2.1 Tweaking the docker deployment

You may edit the following container-properties if you wish to change some parts of the webservice-behaviour:

6. API

ServerPackCreator’s API is available on maven for use in your own projects: https://central.sonatype.com/artifact/de.griefed.serverpackcreator/serverpackcreator-api

Note: The API does not include the REST-API of the webservice in the app. It is explicitly not part of the ServerPackCreator API.

Implementation

Replace $VERSION with the version you want to use.

Maven

<dependency>
    <groupId>de.griefed.serverpackcreator</groupId>
    <artifactId>serverpackcreator-api</artifactId>
    <version>$VERSION</version>
</dependency>

Gradle

implementation 'de.griefed.serverpackcreator:serverpackcreator-api:$VERSION'

Gradle Kotlin

implementation("de.griefed.serverpackcreator:serverpackcreator-api:$VERSION")

Example

Initialize the API with your properties file, containing some basic settings for the API to use. /path/to/file.properties represents the path to your properties-file.

Make sure to select a directory which doesn’t contain any vital data for the API, as the API will setup and create any and all required files in said directory. Best to give it its own directory all to itself.

For information about possible settings, see https://help.serverpackcreator.de/settings-and-configs.html#serverpackcreator-properties

val spcAPI = ApiWrapper.api(File("/path/to/file.properties"))

After initializing the API you can now access the ConfigurationHandler as well as the ServerPackHandler, among other things. Here’s a very basic example:

val packConfig = PackConfig()
val configCheck = spcAPI.configurationHandler.checkConfiguration(File("/path/to/serverpack-config.conf"), packConfig)

if (configCheck.allChecksPassed) {
    val serverPackGeneration = spcAPI.serverPackHandler.run(packConfig)

    if (serverPackGeneration.success) {
        println("Path to your server pack: ${serverPackGeneration.serverPack.absolutePath}")

        if (serverPackGeneration.serverPackZip.isPresent) {
            println("Path to your server pack ZIP: ${serverPackGeneration.serverPackZip.get().absolutePath}")
        }
        
    } else {
        
        println("Encountered the following errors during generation:")
        for (error in serverPackGeneration.errors) {
            println(error)
        }
        
    }
    
} else {
    
    println("There are errors in your server pack config:")
    for (error in configCheck.encounteredErrors) {
        println(error)
    }
    
}

7. Awesomesauce!

None of this would have been possible without the excellent IDEs by JetBrains. They have kindly provided this open source project with an All Products Pack license. Additionally, ej-Technologies has provided an open-source license for JProfiler and install4j for ServerPackCreator, which allows me to resolve performance bottlenecks, pin down memory leaks and understand threading issues, as well as generated fancy high-end installers. Huge shoutout and thank you!

JetBrains	IntelliJ IDEA	WebStorm	Writerside	YouTrack	JProfiler	install4j

Starting from version 6.x, ServerPackCreator will sport fancy new installers made possible by ej-technologies’ install4j.

✨ Thanks to all of my Supporters and Sponsors ✨

Sponsors

Contributors

Griefed	dependabot[bot]	whitebear60	LunarDev-git	dependabot-preview[bot]
Alistair1231	arthurbarret0	Antoniofo	trimclain	thrasos-dev
github-actions[bot]	myxxmikeyxx	xkmxz2503