Skip to content

Blolol's community Minecraft mod packs

License

Notifications You must be signed in to change notification settings

blolol/minecraft-mod-packs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Blolol Minecraft Mod Packs

A collection of mod packs used on Blolol's Minecraft servers.

Creating a mod pack

Each subdirectory of packs contains a packwiz mod pack definition. packwiz is a command line tool for creating Minecraft mod packs.

To create a new mod pack, create a new subdirectory of packs, change directory into it, and run packwiz init per packwiz's getting started guide. packwiz will prompt you for several details, like the pack's name, maintainer, version, and desired Minecraft and mod loader versions.

Adding and updating mods

To add mods to the pack, use packwiz's install commands. For example, to add Create Fabric to a pack from Modrinth:

# Add the latest compatible version
packwiz mr add create-fabric # Search by mod name
packwiz mr add https://modrinth.com/mod/create-fabric # Or use its URL

# Add (or switch to) a specific version
packwiz mr add https://modrinth.com/mod/create-fabric/version/0.5.1-d-build.1161+mc1.20.1

# Update to the latest compatible version
packwiz update create-fabric

# packwiz also supports other Modrinth resources like resource and shader packs
packwiz add https://modrinth.com/shader/complementary-reimagined

Releasing a mod pack

To build and release a mod pack version, push a tag named like perkpack/1.0.0 to GitHub, where perkpack matches the name of a mod pack in the packs directory (the pack's "slug"), and 1.0.0 is the mod pack version.

The GitHub Actions workflow defined in .github/workflows/release.yml will draft a release on the GitHub repository, to which release notes should be added and published.

Once the release is published, .github/workflows/notify.yml will post in the #minecraft channel on irc.blolol.com.

Distributing a mod pack

You can create a self-updating Prism Launcher instance using packwiz-installer-bootstrap and a pre-launch command like $INST_JAVA -jar packwiz-installer-bootstrap.jar https://raw.githubusercontent.com/blolol/minecraft-mod-packs/main/packs/$SLUG/pack.toml, where $SLUG is the name of a directory under packs/.

You can use rake prism[$SLUG] to generate packs/$SLUG/prism-instance.zip. It assumes the existence of packs/$SLUG/prism-instance/manifest.txt containing a list of file paths, relative to packs/$SLUG/prism-instance/, to be included in the zip file. Normally, this would include .minecraft/packwiz-installer-bootstrap.jar, instance.cfg, mmc-pack.json, and an instance icon. See the existing packs for examples.

The default release notes generated by GitHub Actions include a link to https://github.com/blolol/minecraft-mod-packs/raw/refs/heads/main/packs/$SLUG/prism-instance.zip. It's up to you to ensure that file exists in Git.

License

The scripts and tools created for this repository are licensed under the MIT license. (See LICENSE for the full license text.) Minecraft, and the Minecraft mods referenced by, but not distributed with, the contents of this repository may be subject to different license terms.