Get started

Installing

1
Get the jar
Download RPEngine.jarhttps://cdn.resourcepack.ai/RPEngine.jar
That link is always the current release and never moves, so it works in a startup script or a Docker build too.
2
Drop it in
RPEngine.jar into plugins/, then start the server. It needs Paper or Spigot 1.19.4 or newer, on Java 17 or newer.

Look at what it made

plugins/RPEngine/
  config.yml
  content/      ← yours
  output/       ← the built packs, rebuilt on every reload

Everything works, and on an older server a few things are reduced

RP Engine runs on 1.19.4 and up, and everything it does works on a current server. Below 1.21.4 a handful of things are reduced — one pack at a time below 1.20.3, no per-item stack sizes below 1.20.5, no custom armour art below 1.21.4.

You do not have to look any of that up. The plugin checks your version at startup and prints exactly what it cannot do and what you get instead. Minecraft versions is the same list, written down.

You do not set the pack format

pack.format used to be a number in config.yml that had to match your game version by hand, and getting it wrong showed every player a "made for a different version" warning with nothing in the log to say why. The plugin now reads your server's version and writes the right number itself. The key is still there, commented out, for the one case that needs it — see Minecraft versions.

Your first item#

Make a pack

content/mypack/
  pack.yml
  items/gems.yml
  assets/textures/item/ruby.png

pack.yml can be as short as a name:

name: My Pack

2
Describe the item
items/gems.yml:
ruby: material: DIAMOND name: "&cRuby"
That is mypack:ruby. The folder name is the namespace, the key is the ID, and the texture path falls out of the ID — assets/textures/item/ruby.png with nothing pointing at it.
3
Reload and take one
/rp reload /rp give mypack:ruby

If the item is a purple-and-black square, the texture is not where the ID says it should be — /rp reload names every missing file in the console.

Where to go next#

The content folder

Everything a pack can contain, and where it goes.

Items

3D models, borrowed models, and gating one by permission.