
FernAPI
A JSON Based Permission API (WIP)
About this Mod
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
- Add Fern to your server.
- Run Server And Allow Fern To Generate Default Config Files.
- Stop The Server.
- Select a data type using the table below in config.json
- 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
How to Install FernAPI on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set fabric Loader
In the panel under "Egg", select the fabric loader and matching Minecraft version (1.21.10).
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
Minecraft Versions
1.21.10
Server-side
✓ RequiredRecommended 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.
Similar Mods
Rent Modded Server
Install FernAPI with just one click on your server.