Download the PHP package aternos/curseforge-api without Composer

Aternos/php-curseforge-api

An API client for the CurseForge API written in PHP. This client is a combination of code generated by OpenAPI Generator using our openapi spec and some wrappers around it to improve the usability.

The generated code can be found in lib/Api and lib/Model. It is recommended to use the wrappers in lib/Client instead of the generated code.

Installation

Install the package via composer:

Usage

The main entry point for the API is the CurseForgeAPIClient class.

You need an API key to use this client. If you're a third party you can read more about how to get one here.

Paginated Lists

Most methods return a paginated list containing a list of results on the current page and methods to navigate to the next and previous page. The paginated list implements Iterator, ArrayAccess and Countable so you can use it like an array. It also has a getResults() method that returns the underlying array of results.

Games

The getGames method for example returns a paginated list of games.

You can also call getGame with the ID of a game to get a specific game. For example, 432 is the ID for Minecraft.

Game Versions

A game contains various different version types, you can fetch them like this:

Since this endpoint isn't paginated, it returns an array instead of a paginated list.

You can also fetch the versions of a specific version type:

For example: 68441 is the mod loader selection for Minecraft.

You can also get all versions for all version types of a game:

Game Categories

A Game on CurseForge has category classes and categories. Category classes are like "Modpacks" or "Plugins" and categories are like "World Generation" or "Chat". You can fetch them like this:

Note that this will return both, category classes AND categories.

If you want to get only the category classes you can set the parameter onlyClasses to true:

You can fetch categories in a class using the parameter classId:

Mods

You can search mods like this:

You can also get a list of featured mods for a game:

You can fetch an individual mod by its ID like this:

or multiple mods in bulk

You can also fetch the HTML for mod descriptions:

Mod Files

To fetch mod files use the method getFiles():

It optionally takes a ModFilesOptions object as a parameter:

There also is a method for this in the client, so you don't have to fetch the mod first:

In this case the options are not optional as the mod id is required.

Just like with mods, you can fetch files individually or in bulk:

Note that the bulk endpoint doesn't require a mod id.

File Download URLs

You can get the download URL for a file like this:

However, this will be null (in the first example) or a 403 error (in the second example) if the mod does not allow project distribution.

Fingerprints

You can search files on CurseForge by their fingerprint. For example, this can be used to find the download source for a mod that is installed on a server. CurseForge uses a variant of Murmur2 hashing with seed 1 for these fingerprints.

Obtaining fingerprints

From the API:

From a raw string using our CursedFingerprintHelper class:

From a local file using our helper class:

This will read the file in chunks and calculate the fingerprint from that.

From any source using our helper class:

Note that the length field has to exclude whitespaces (\x09, \x0a, \x0d, \x20). You can use the stripWhiteSpcaes or isWhiteSpaceCharacter methods to do that.

Obtaining matches

Minecraft

There are a few Minecraft specific API endpoints as well:

Updating the generated code

The generated code can be updated by installing the openapi generator running the following command: