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
  
  # 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.

Plugin Command Directory

Command Permission Short Description
No commands matched your query.