FoliaCore
PluginMIT

FoliaCore

A complete essentials suite rewrite designed explicitly for regionized servers. Runs warp, spawn, utility commands, and chat visual frameworks asynchronously.

495
Downloads
6
Followers
1 months ago
Updated
📦
10
Versions

📖About FoliaCore

FoliaCore v5.6 Blue Nightingale

FoliaCore is a Folia-first essentials and administration plugin for Minecraft servers that want one clean toolkit instead of many separate add-ons. It blends player convenience, staff utilities, teleports, moderation, visual polish, and permission control into a single package that feels intentionally built for regionalized servers.

Why server owners choose it

FoliaCore is made for servers that want the essentials experience without the usual clutter.

  • Built for Folia from the ground up.
  • Modern Paper command registration.
  • Modular feature toggles in config.yml.
  • Separate permission nodes for nearly every command.
  • Dynamic per-warp and per-kit access control.
  • A visually rich tab/sidebar blueprint in tab-sidebar.yml.
  • Modrinth update checks for easy release tracking.
  • No Vault economy layer, so the focus stays on gameplay, administration, and polish.

Why it feels better to use

The difference is not just technical. It is practical.

Players get fast access to homes, warps, kits, chat tools, mail, teleport requests, and small quality-of-life commands that reduce friction without turning the server into a plugin maze.

Staff get moderation, vanish, social spy, inventory tools, repair tools, time and weather control, anti-raid support, and clean access to the tools they actually need.

Developers and operators get something even more important: permission nodes that are easy to audit, easy to grant, and easy to document.

The new /foliacore help command also filters the command list by your permissions so staff and players can discover the tools they actually have.
The /foliacore reload command is included for operators who want to refresh configuration without restarting.

What is new in v5.6

This release updates the plugin branding to v5.6 Blue Nightingale and formalizes the permission tree in the plugin metadata. The result is a cleaner release story and a more complete server-side permission setup.

Notable changes:

  • Added a permission gate for /kit.
  • Added a permission-aware /foliacore help command and a /foliacore version command.
  • Added a /foliacore reload command for quick configuration refreshes.
  • Declared all core permission defaults in paper-plugin.yml.
  • Updated the runtime banner to v5.6.
  • Standardized the release version across the build files.
  • Reworked the docs so operators and developers can scan them quickly.

Installation

  1. Download the release jar.
  2. Put it in plugins/.
  3. Start the server once on Folia with Java 21.
  4. Edit plugins/FoliaCore/config.yml to enable or disable the systems you want.
  5. Edit plugins/FoliaCore/tab-sidebar.yml if you want the animated visual stack.
  6. Assign permissions per group or per player.

Permission design

The plugin follows a simple rule set.

  • Player-friendly commands default to true.
  • Staff, admin, destructive, or high-impact commands default to false.
  • Warp and kit access can be narrowed further with individual nodes.

Important patterns

  • /warp can be granted globally with foliacore.warp.all.
  • Specific warps can be granted with foliacore.warp.<warpname>.
  • /kit uses foliacore.kit.
  • Kits created by staff generate their own node, such as foliacore.kit.<kitname>.
  • Kit creation and deletion stay on foliacore.kit.admin.

Command and permission reference

Core and information

Command Permission node(s) Default
/foliacore, /foliacore help foliacore.help true
/foliacore reload foliacore.reload false
/foliacore version foliacore.version true

Social and chat

Command Permission node(s) Default
/msg foliacore.msg true
/reply foliacore.reply true
/mail foliacore.mail.send, foliacore.mail.read, foliacore.mail.clear mixed
/nick foliacore.nick, foliacore.nick.color mixed
/realname foliacore.realname true
/block foliacore.block true
/unblock foliacore.unblock true
/chat foliacore.chat.global, foliacore.chat.world, foliacore.chat.regional true
/mute foliacore.mute false
/unmute foliacore.unmute false
/socialspy foliacore.socialspy false
/staffchat, /sc foliacore.staffchat false

Teleport and travel

Command Permission node(s) Default
/sethome foliacore.sethome true
/home foliacore.home true
/homes foliacore.homes.list true
/delhome foliacore.delhome true
/tpa foliacore.tpa true
/tpahere foliacore.tpahere true
/tpaccept foliacore.tpaccept true
/tpdeny foliacore.tpdeny true
/spawn foliacore.spawn true
/back foliacore.back true
/warp foliacore.warp.all, foliacore.warp.<warpname> mixed
/warps foliacore.warps.list true
/setwarp foliacore.setwarp false
/delwarp foliacore.delwarp false
/setspawn foliacore.setspawn false
/setfirstspawn foliacore.setfirstspawn false
/tp foliacore.tp, foliacore.tp.others false
/tphere foliacore.tphere false
/gps foliacore.gps true

Teams and kits

Command Permission node(s) Default
/team foliacore.team.create, foliacore.team.disband, foliacore.team.invite, foliacore.team.accept, foliacore.team.leave, foliacore.team.kick true
/kit foliacore.kit true
/createkit foliacore.kit.admin false
/delkit foliacore.kit.admin false

Utility and staff tools

Command Permission node(s) Default
/calc foliacore.calc true
/trash, /dispose foliacore.trash true
/workbench, /wb foliacore.workbench true
/hat foliacore.hat true
/enderchest, /ec foliacore.enderchest, foliacore.enderchest.others mixed
/ping foliacore.ping, foliacore.ping.others mixed
/scoreboard, /sidebar foliacore.scoreboard.toggle true
/feed foliacore.feed, foliacore.feed.others mixed
/fly foliacore.fly, foliacore.fly.others mixed
/heal foliacore.heal, foliacore.heal.others mixed
/god foliacore.god, foliacore.god.others mixed
/repair foliacore.repair, foliacore.repair.all, foliacore.repair.others, foliacore.repair.others.all mixed
/give foliacore.give false
/clear foliacore.clear, foliacore.clear.others mixed
/invsee foliacore.invsee false
/gamemode, /gms, /gmc, /gma, /gmsp foliacore.gamemode, foliacore.gamemode.others mixed

Administration and control

Command Permission node(s) Default
/broadcast foliacore.broadcast false
/time foliacore.time false
/weather foliacore.weather false
/status foliacore.status false
/clearchat foliacore.clearchat, foliacore.clearchat.bypass mixed
/vanish foliacore.vanish false
/antiraid foliacore.admin.antiraid false
/ban foliacore.ban, foliacore.ban.exempt mixed
/tempban foliacore.tempban, foliacore.ban.exempt mixed
/unban foliacore.unban false
/kick foliacore.kick, foliacore.kick.exempt mixed
/mute foliacore.mute false
/unmute foliacore.unmute false
/marker foliacore.marker.set, foliacore.marker.delete, foliacore.marker.list false

Visual systems

tab-sidebar.yml is the optional visual blueprint for server owners who want more than plain text.

It covers:

  • Tab header and footer animation.
  • Sidebar layouts and line control.
  • Nametags, belowname, bossbars, and ping spoofing.
  • Fonts, sprites, placeholders, and output formatting.
  • Toggle persistence for per-player visual settings.

For developers and server admins

FoliaCore is clean to reason about because the code is split across clear surfaces:

  • FoliaCore.java handles registration.
  • Command classes enforce permission checks.
  • Managers handle persistence and runtime logic.
  • The plugin descriptor now publishes the permission defaults directly.

That makes the plugin easier to audit, easier to document, and easier to grant to the right people.

Sponsor & Contributor Help

TrueCloud Hosting sponsors FoliaCore.

  • Pricing: $0.50 per GB RAM.
  • Contact for more details: +8801989208751.
  • If someone wants to help as a contributor, send them here.

Final note

If you want a Folia-friendly essentials suite that is practical first and polished second, FoliaCore is built for exactly that space.

Enjoy the release, and shape the server around it.