# Flok Engine
\n### Performance-First Server Scripting for Modern Minecraft<\/p>\n
Flok is a lightweight, high-performance scripting engine for Paper and Spigot servers (1.21+). Designed as a modern, safety-conscious alternative to traditional scripting plugins, Flok allows you to create custom mechanics, commands, and event handlers using a natural, easy-to-read syntax\u2014without the overhead or server-freeze risks.<\/p>\n
## Why Choose Flok?<\/p>\n
* **World-Class Performance:** Benchmarked at an average tick rate of **2.076ms** under load.
\n* **Crash-Proof Safety:** Includes a built-in **50,000 op-limit** per script execution, preventing infinite loops from ever freezing your server thread.
\n* **Smart Throttling:** The `on player-move` event is natively throttled to once per second per player, providing a massive TPS safety net.
\n* **Persistent Data:** A global, human-readable storage system (`flok_data.yml`) that survives restarts and force-stops.
\n* **Modern Java:** Built on Java 21 to leverage the latest JVM optimizations.<\/p>\n
## Key Features<\/p>\n
* **Asynchronous Delays:** Fully functional `wait` effect for non-blocking script delays.
\n* **Event Cancellation:** Full control over event flow with `cancel` and `uncancel` support.
\n* **Custom Commands:** Register commands with custom permissions, aliases, and descriptions on the fly.
\n* **Addon API:** A stable Java API for developers to register custom effects and fire custom events.
\n* **Zero Restarts:** Use `\/flok reload` to update your scripts instantly without a server reboot.<\/p>\n
## Quick Start<\/p>\n
1. Drop **Flok-1.0.jar** into your `plugins` folder.
\n2. Restart the server to generate the `\/plugins\/Flok\/scripts\/` directory.
\n3. Create a `.fk` file and start scripting!<\/p>\n
“`fk
\non player-join:
\n send “&aWelcome to the server, %player-name%!”
\n if %first-join% is true:
\n broadcast “&e%player-name% joined for the first time!”# \ud83d\udc3a Flok Engine<\/p>\n
“`
\n### Performance-First Server Scripting for Modern Minecraft<\/p>\n
Flok is a lightweight, high-performance scripting engine for Paper and Spigot servers (1.21+). Designed as a modern, safety-conscious alternative to traditional scripting plugins, Flok allows you to create custom mechanics, commands, and event handlers using a natural, easy-to-read syntax\u2014without the overhead or server-freeze risks.<\/p>\n
## Why Choose Flok?<\/p>\n
* **World-Class Performance:** Benchmarked at an average tick rate of **2.076ms** under load.
\n* **Crash-Proof Safety:** Includes a built-in **50,000 op-limit** per script execution, preventing infinite loops from ever freezing your server thread.
\n* **Smart Throttling:** The `on player-move` event is natively throttled to once per second per player, providing a massive TPS safety net.
\n* **Persistent Data:** A global, human-readable storage system (`flok_data.yml`) that survives restarts and force-stops.
\n* **Modern Java:** Built on Java 21 to leverage the latest JVM optimizations.<\/p>\n
## Key Features<\/p>\n
* **Asynchronous Delays:** Fully functional `wait` effect for non-blocking script delays.
\n* **Event Cancellation:** Full control over event flow with `cancel` and `uncancel` support.
\n* **Custom Commands:** Register commands with custom permissions, aliases, and descriptions on the fly.
\n* **Addon API:** A stable Java API for developers to register custom effects and fire custom events.
\n* **Zero Restarts:** Use `\/flok reload` to update your scripts instantly without a server reboot.<\/p>\n
## Quick Start<\/p>\n
1. Drop **Flok-1.0.jar** into your `plugins` folder.
\n2. Restart the server to generate the `\/plugins\/Flok\/scripts\/` directory.
\n3. Create a `.fk` file and start scripting!<\/p>\n
“`fk
\non player-join:
\n send “&aWelcome to the server, %player-name%!”
\n if %first-join% is true:
\n broadcast “&e%player-name% joined for the first time!”<\/p>\n
“`<\/p>\n
Documentation: https:\/\/flokdev-dev.github.io\/flok\/
\nSource Code: https:\/\/github.com\/FlokDev-dev\/flok<\/p>\n","protected":false},"excerpt":{"rendered":"
Flok is a fast, lightweight scripting plugin for Paper\/Spigot servers. You write plain .fk files; no Java, no compile step, no restarts for most changes. Drop a script in, run \/flok reload, and it’s live.<\/p>\n","protected":false},"featured_media":71149,"template":"","meta":{"_minecraft_slug":"flok","_minecraft_project_id":"NvqNLxbf","_minecraft_author":"cloudwynn","_minecraft_license":"MIT","_minecraft_downloads":28,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"flok.zip","_minecraft_size_bytes":117774,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T22:14:11.241577Z","_minecraft_date_created":"2026-03-02T20:27:46.506952Z","_minecraft_date_modified":"2026-02-25T21:17:22.100265Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/flok","_minecraft_icon_attachment_id":71149,"_minecraft_imported_at":"2026-06-04T01:04:35+00:00","_minecraft_import_hash":"b31ce635d2831d399f4a69bc40c30268","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,89,873,126,90,127,129],"mod_loader":[130,132,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-71148","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-game-mechanics","mod_category-library","mod_category-management","mod_category-optimization","mod_category-paper","mod_category-spigot","mod_loader-bukkit","mod_loader-paper","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n