THREAD-SAFE SERVER SUITE

NATIVE. ATOMIC.
ABSOLUTE.

Ditch the legacy sync blockages. FoliaCore is built natively for the multithreaded region loop, processing commands, teleports, and player data on isolated chunk threads.

Get FoliaCore Explore Tab HUD

CONCURRENCY BENCHMARKS

Optimizing server ticks with region-aware asynchronous algorithms.

⚡

Async Teleportation Loop

FoliaCore schedules chunk loading before relocating the player entity. By executing asynchronous thread checks, the main region thread remains responsive, preventing server-wide frame spikes.

⚙️

Atomic State Database

Uses Vault-compatible AtomicLong indices to register currency changes instantly across region cores, guaranteeing transaction safety even under heavy query loads.

Operation Legacy Plugins FoliaCore
Warp Loop Sync Thread Block Async teleportAsync
Balances File locks (Race condition) Thread-Safe Memory Arrays
Scheduling Global BukkitScheduler Region Schedulers

Visual Customizer Demo

FoliaCore handles advanced player scoreboards, tab designs, and ping spoofing. Test the rendering parameters below.

HUD Settings

Scoreboard HUD Preview
Java Edition 1.21
Online Players (Tablist)
Player_1 12 ms
Niloy
SERVER METRICS
Server Node: Paper-Spigot

Documentation Hub

Comprehensive setup guides, command parameters, and configuration files. Click on any command to expand details.

Installation & Setup

Requirements

  • Folia Server Software (or Paper/Spigot build 1.20+)
  • Java 21 Runtime Environment
  • Vault Plugin (optional, for economy hooks)

Step-by-step

  1. Download the latest release jar of FoliaCore.
  2. Place the jar into the /plugins directory.
  3. Restart the server node to generate configuration files.
  4. Edit plugins/FoliaCore/config.yml to customize settings.

Config.yml Reference

YAML Syntax 
# FoliaCore Configuration
# Central settings and module controls

# Module Toggles - Set to false to disable entire subsystems
modules:
  teleport: true
  kits: true
  chat: true
  markers: true
  teams: true
  staff: true
  system: true
  utility: true
  tab: true
  sidebar: true

# System Settings
system:
  # Maintenance Mode - Kicks players without foliacore.admin
  maintenance-mode: false
  maintenance-kick-message: "&cServer is in maintenance mode. Admins only."
  
  # First Spawn - Teleports new players to a configured location
  first-spawn-enabled: true
  
  # Entity Cleanup - Removes items and excess mobs when regional TPS drops
  entity-cleanup-enabled: true
  entity-cleanup-interval: 300
  minimum-tps-threshold: 16
  # Entities that should NEVER be cleaned up (case-insensitive types)
  ignored-entity-types:
    - VILLAGER
    - IRON_GOLEM
    - ARMOR_STAND
    - WANDERING_TRADER
  
  # Auto Broadcaster - Sends messages at intervals
  auto-broadcaster-enabled: true
  auto-broadcast-interval: 600

# --------------------------------------------------
# Display Visual Blueprint (tab-sidebar.yml config)
# --------------------------------------------------
animations:
  global-update-interval-ticks: 20
  tab-animation:
    enabled: true
    update-interval-ticks: 20
  sidebar-animation:
    enabled: true
    update-interval-ticks: 20

tablist:
  enabled: true
  global-playerlist: true
  sort:
    enabled: true
    type: WEIGHT # WEIGHT, PERMISSION, ALPHABETICAL
    weights:
      owner: 1
      admin: 2
      moderator: 3
      default: 10
  names:
    format: "[FoliaCore] %player_name%"
  header-footer:
    enabled: true
    header-method: "header_wave"
    footer-method: "footer_wave"

Module Capabilities & Folia Engine Integrations

teleport
Teleportation System

Decouples entity warp pipelines. Utilizes teleportAsync to pre-load destination chunks asynchronously on worker threads, resolving main-thread tick freeze locks during coordinates shift.

kits
Inventory Kits

Operates inventory edits within regional boundaries on current tick allocations. Enforces cooldown validations using thread-safe map structures to prevent item cloning exploits.

chat
Chat & Messages

Decouples text formatting, Hex colors parsing, and block list validations. Channels chats through async pipelines directly into target player packet loops without main thread strain.

markers
GPS & Markers

Tracks user locations relative to active destination vectors. Calculates waypoint offsets dynamically without triggering region-synchronized database read bottlenecks.

teams
Team Routing

Handles scoreboard registers asynchronously, preventing lock contention when players across different coordinate threads interact with global team indices concurrently.

staff
Staff Operations

Decouples vanish visibilities by stripping packet tags at netty pipeline level, and operates safe multithreaded player inventory inspections using transaction keys.

system
System Monitor

Toggles maintenance restrictions, processes new player logins, and executes regional mob cleanses automatically when local TPS indices drop beneath limits.

utility
General Utilities

Offers gameplay actions (/heal, /fly, /workbench, /trash) locked to individual region threads to prevent coordinates-sync discrepancies.

tab / sidebar
Display Visuals

Distributes animated tablist formats and sidebars dynamically using the visual blueprint system to handle updates without server ticks drop.

Config Editor Suite

Live Visual Config Editors for all FoliaCore setting files

Reactive YAML Engine

Subsystem Module Toggles

System Settings

Maintenance Mode

Restricts player join permissions

TPS Entity Cleanup

Auto-cull entities during lag spikes

Auto Broadcaster

Periodic server announcements

Database & Connection Pool

Use MySQL Database

Display Features

Tablist Animations
Sidebar Animations
Objective Slot Type

Broadcaster Customization

Kits Settings

Enable Starter Kit

Security Settings

Anti-VPN Check Gate
Country Join Whitelist 

# FoliaCore Generated Configuration
# Upgrade: v6.0-RAGNAROK (Regional Async Gateway Network And Resource Optimizer Kernel)

modules:
  teleport: 
  kits: 
  chat: 
  markers: 
  teams: 
  staff: 
  system: 
  utility: 
  tab: 
  sidebar: 

system:
  maintenance-mode: 
  maintenance-kick-message: "&cServer is in maintenance mode. Admins only."
  first-spawn-enabled: 
  entity-cleanup-enabled: 
  entity-cleanup-interval: 
  minimum-tps-threshold: 16
  ignored-entity-types:
    - VILLAGER
    - IRON_GOLEM
    - ARMOR_STAND
    - WANDERING_TRADER
  auto-broadcaster-enabled: 
  auto-broadcast-interval: 
# FoliaCore tab-sidebar.yml configuration
version: "v6.0-Ragnarok"

database:
  mysql-enabled: 
  host: ""
  port: 3306
  database: ""
  username: ""
  password: "change-me"
  use-ssl: false
  pool-size: 8

settings:
  debug-level: 
  save-user-toggles: 
  use-placeholderapi: 
  use-mini-message: 

animations:
  global-update-interval-ticks: 20
  tab-animation:
    enabled: 
    update-interval-ticks: 
  sidebar-animation:
    enabled: 
    update-interval-ticks: 

tablist:
  enabled: true
  global-playerlist: true
  objective:
    enabled: true
    type: 
  names:
    format: "[FoliaCore] %player_name%"
# FoliaCore autobroadcasts.yml configuration
enabled: 
interval: 
prefix: ""
messages:

# FoliaCore kits.yml configuration
kits:
  starter:
    enabled: 
    cooldown: 
    items:

# FoliaCore security.yml configuration
security:
  anti-vpn:
    enabled: 
    api-key: ""
  country-block:
    enabled: 
    blocked-countries:

Subsystem Modules Configuration

Modular YAMLs

FoliaCore breaks down all control settings into separate config files in the /plugins/FoliaCore/modules/ directory. Each module can be completely turned off to optimize server threads or avoid resource duplication.

Economy Module Settings

# economy.yml configuration
enabled: true
vault-hook: true
initial-balance: 100.0
tax-rate: 0.02
enable-pay-confirmations: true

Teleport Module Settings

# teleport.yml configuration
enabled: true
cooldown-seconds: 3
warmup-seconds: 5
particle-effects: true
safe-tp-lookup: true

Jails Module Settings

# jails.yml configuration
enabled: true
prevent-block-break: true
prevent-commands:
  - msg
  - tpa
  - spawn

Chat Module Settings

# chat.yml configuration
enabled: true
format: "&7[%group%] &f%player%: &7%message%"
shout-range: 150
anti-spam-seconds: 1

Discord Module Settings

# discord.yml configuration
enabled: true
bot-token: "INSERT_TOKEN"
channel-id: "INSERT_CHANNEL"
sync-chat: true

Live Telemetry & Analytics

bStats ID 28430

We track high-performance parameters to ensure all region threads operate correctly without locking. View live global telemetry charts below.

Servers Using FoliaCore

bStats Servers Chart

bStats Global Stats

Public metrics active on bStats

Interactive data dashboards detailing OS runtimes, regional player counts, and JVM versions.

Plugin Command Directory

Command Permission Short Description
No commands matched your query.