SkinsRestorer LogoSkinsRestorer

Installation on NeoForge

Learn how to install the SkinsRestorer mod on NeoForge-based Minecraft servers.

Before you start, read the main installation page.

The NeoForge mod supports only the latest Minecraft release. It does not support older versions.

On a supported version, the NeoForge mod works like the Bukkit plugin. It uses the same features and configuration.

Install the mod

These steps also apply to Forge forks that can load NeoForge mods.

Install NeoForge

Download the latest NeoForge installer from neoforged.net. Install it for the newest Minecraft version.

Create or update the mods folder

Run the generated run.bat or run.sh file once. NeoForge creates its folders, including mods.

If NeoForge is already installed, update it to the latest build.

Add SkinsRestorer

Download the latest SkinsRestorer mod from Modrinth. Put it in the server's mods folder.

Start the server

Start the server. Read the console for errors or missing dependencies.

Make sure that the mod works

Run /skinsrestorer status or /sr status in the game or server console.

Configure SkinsRestorer

Edit the files in config/SkinsRestorer/. The configuration guide explains each option.

Need help?

If you need help, send the latest server log on our Discord server.

How is this guide?

Last updated on

On this page