FernAPI

FernAPI

A JSON Based Permission API (WIP)

by
118 Downloads
fabriclibrarymanagementutility
Rent Server with this Mod

About this Mod

Project Logo
Fern

Disclaimer!

- The project is not at all finished and is still in early development.

- Error Handling speed and other things are not yet implemented.

- Most things are guaranteed to change in future updates.

- Don't expect this to replace other permission systems yet.

Overview

Fern is a JSON based Permission System made to be easy to use and implement, with different data storage methoads.

This project does not include any commands or utilities to manage permissions, it is only the backend API to store and retrieve permissions. But some can be done by editing files directly.

Setup

  1. Add Fern to your server.
  2. Run Server And Allow Fern To Generate Default Config Files.
  3. Stop The Server.
  4. Select a data type using the table below in config.json
  5. Start The Server Again.

Data Storage Types

Type Description
0 Stores Data With Permissions In Player (Player {Assigned Perms})
1 Stores Data With Players In Permissions (Permission {Players Assigned})

And data does not port to new data type yet.

Usage

Build.Gradle

repositories {
    maven {
        url = "https://api.modrinth.com/maven"
    }
}

dependencies {
    modImplementation "maven.modrinth:fernapi:${fern_version}"
}

properties.gradle

fern_version=0.5.1

All versions below the latest may be unstable.

What's Next

  • Utility Mod
  • WIKI
  • Using Jackson for speed
  • Error Handling
  • Support for more platforms

Available Versions

0.4.2release
MC 1.21.10fabric
February 3, 2026

How to Install FernAPI on Your Server

1

Order Server

Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).

2

Set fabric Loader

In the panel under "Egg", select the fabric loader and matching Minecraft version (1.21.10).

3

Install Mod

Open the mod browser in the dashboard and search for "FernAPI". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.

Compatibility

Mod Loaders

fabric

Minecraft Versions

1.21.10

Server-side

Required

Recommended RAM

4 GB(min. 3 GB)

Frequently Asked Questions

FernAPI server crashes on startup – what to do?

Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.21.10). You can switch loaders with one click in the panel.

Is FernAPI compatible with fabric?

FernAPI officially supports fabric for Minecraft 1.21.10. The Mado dashboard automatically detects incompatible loader combinations.

Server lagging with FernAPI – how to optimize performance?

Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if FernAPI consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.

Rent Modded Server

Install FernAPI with just one click on your server.

Recommended RAM
4 GBab €8/mo
Min. 3 GB | +1 GB pro 8 Spieler
Create Server Now
1-Click Mod Install
NVMe SSD Storage
DDoS Protection included

Details

License
MIT License
Server-side
Required

Supported Versions

1.21.10