RefineryCore

A modern Paper plugin framework providing annotation-driven commands, GUIs, and configuration — built for the Refinery Team.

Which Minecraft do you have?

Every version of the game needs its own build. Pick yours, then download — the wrong build installs fine and then does nothing in the game. This mod is built for Paper only.

Minecraft 1.21.11Newest
Minecraft 1.20–1.20.6

⬇ Download for 1.21.11 ⬇ Download for 1.20–1.20.6

I don't know my version or loader

Open the Minecraft launcher and look at the profile you play on — it names both, like fabric-loader-1.21.4. The version also shows in the bottom-right corner of the game's main menu.

No loader in the profile name? Then it's plain Minecraft, and these mods won't run — you need Fabric or NeoForge installed first.

Open in MCModsHub Get it on Google Play →

RefineryCore

A modern framework for developing Paper plugins with annotation-driven commands, GUIs, configuration, scoreboards, database utilities, and more.

📖 Full documentation: https://wiki.refineryteam.xyz

Installation

Maven

<repository>
    <id>reaudacity-releases</id>
    <url>https://repository.reaudacity.online/releases</url>
</repository>

<dependency>
    <groupId>xyz.refineryteam</groupId>
    <artifactId>refinerycore</artifactId>
    <version>VERSION</version>
    <scope>provided</scope>
</dependency>

Gradle (Kotlin)

repositories {
    maven("https://repository.reaudacity.online/releases")
}

dependencies {
    compileOnly("xyz.refineryteam:refinerycore:VERSION")
}

Gradle (Groovy)

repositories {
    maven { url "https://repository.reaudacity.online/releases" }
}

dependencies {
    compileOnly "xyz.refineryteam:refinerycore:VERSION"
}

[!IMPORTANT] If your plugin depends on RefineryCore at runtime, add it to the dependencies section of your plugin.yml.

Requirements

Java 21+
Paper 1.21+

Documentation

Everything else is covered in the wiki, including:

Getting Started
Commands
GUIs
Configuration
Scoreboards
Database
Event Bus
ItemBuilder
Plugin API
Scheduler
Server Implementation
Storage

➡️ Wiki: https://wiki.refineryteam.xyz

Support

Documentation: https://wiki.refineryteam.xyz
Issues: https://github.com/RefineryTeam/RefineryCore/issues

License

Licensed under the MIT license.

Verified by MCModsHub

Ships as refinerycore-0.0.8.jar — drop this file into the mods folder
Download size: 131 KB
Download link checked 9 Aug 2026 — working

These come from our own check of the pack file, not from the source page.

Explore more

All Mods for Java All Minecraft Java mods Java mods for 1.20