KaiCore

This plugin is in beta. Please report bugs via a Discord ticket (Plugin Support).

A comprehensive server management plugin for Minecraft 1.20+ servers, built for server owners who want full control over their gameplay experience. Everything is managed through an easy-to-use in-game GUI — no config file editing required.

---

Installation

1. Download the latest KaiCore.jar release
2. (Optional) Install optional dependencies:
   • PacketEvents (Required for Armor/Stat Spoofer & advanced Mod Detector sign checks)
   • WorldGuard (Required for Combat Safezones)
3. Place KaiCore.jar in your server's plugins folder
4. Restart your server
5. Run /KaiCore gui (or /kc gui) to open the main menu

Note: Some features (such as Anti-Xray) require Paper or a Paper fork (Pufferfish, Purpur, etc.). Features utilizing packet rewriting or region barriers require PacketEvents and WorldGuard. See the compatibility table below.

---

Features

Item Restrictions & Bans

Custom Item Bans & Stack Limits

Feature	Description
Item Banlist	Search for any item directly via in-game chat and toggle craft, place, interact, drop, pickup, or hold restrictions
Item Limiter	Enforce maximum stack limits per player inventory for any vanilla item, custom potion, enchantment, or held custom item
Netherite Ban	Permanently disable netherite items with granular sub-toggles for armor, weapons/tools, ingots/scraps, debris, and smithing templates

Explosives & Combat Mechanics Restrictions

Feature	Description
TNT Minecarts	Ban TNT-filled minecarts from spawning, being placed, or moving
Crystal PvP	Disable End Crystal placing and explosions on obsidian/bedrock to prevent crystal PvP metas
Ender Pearl Ban	Disable ender pearls from being thrown to prevent glitching and instant escapes
String Dupers	Re-enable the classic tripwire hook string duplication exploit for farm-friendly string gathering

Entity & Weapon Controls

Feature	Description
Villager Killing	Block players from hurting or killing villagers (with an option to protect only employed villagers)
Mob Disabler	Prevent specific mob types from spawning across your worlds
Mace Controls	Enforce one-time craft limitations, disable smash attacks, or completely ban maces

Potions & Alchemy

Longer Potions System - Code from longer-potion-duration

Feature	Description
Longer Potions	100% GUI-based custom potion duration editor (/kc gui -> Page 2 -> Slot 13). Supports all 24 potion types (Tier I, Tier II, and 1.21 trial potions) across drinkable, splash, and lingering variants with synchronized brewing stand outcome tooltips and master toggles

Potion Restrictions

Feature	Description
Potion Banlist	Ban specific potion types from being brewed, splashed, or consumed on the server

Combat & PvP Mechanics

Combat System & Safezones

Feature	Description
Combat System	Combat tagging — locks players in combat upon taking or dealing damage, displaying an action bar countdown, blocking pearls, and punishing combat loggers with instant death
Combat Grace Period	Server-wide PvP protection with an animated countdown boss bar (/kc grace <duration|stop>)
Combat Safezones	WorldGuard region integration that blocks combat-tagged players from fleeing into safezones using dynamic client-side red glass barriers
PvP Toggle	Master toggle in the GUI to instantly enable or disable server-wide player versus player damage

Weapon & Item Cooldowns

Feature	Description
Spear Cooldowns	Separate, independent stun cooldowns for Spear Melee strikes and Spear Lunge attacks
Mace Cooldown	Stun cooldown after landing smash attacks
Shield Cooldown	Stun / raise cooldown after blocking
Ender Pearl Cooldown	Cooldown timer between throwing ender pearls
Wind Charge Cooldown	Cooldown timer between firing wind charges
Riptide Cooldown	Stun cooldown after launching with a Riptide trident
Chorus Fruit Cooldown	Cooldown timer between eating chorus fruit
Enchanted Golden Apple Cooldown	Cooldown timer between consuming enchanted golden apples

Damage Limiters & Stealth

Feature	Description
Damage Limiters	Cap the maximum single-hit damage dealt by Maces, Spears, TNT Minecarts, TNT, End Crystals, Arrows, and Dripstone to eliminate one-shot cheeses
Invisibility QOL	Conceals player armor, enchantment glint, and name tags while invisible

Anti-Cheat & Security

Client & Mod Detection

Feature	Description
Mod Detector	Analyzes client brand handshakes and Fabric/Forge channel registrations on join
Sign Packet Verification	Advanced client probing via PacketEvents to detect hidden or stealth cheat clients
Mod Banlist	In-game GUI to ban blacklisted mods (e.g. Freecam, ChestESP, Baritone, X-Ray) and automatically kick offenders
Player Mod Inspector	Run /kc mods [player] to view the connected client brand and loaded mods of any player in real time

Packet Obfuscation & Exploits

Feature	Description
Armor & Stat Spoofer	Packet-level obfuscation via PacketEvents to hide armor durability, armor enchantments, health indicators, and stack counts from hacked clients
Minimap Blocker	Block Xaero's Minimap or enforce fair-play mode (disables radar and cave maps) via handshake packet control
Anti-Xray	Built-in Paper engine Anti-Xray management (Engine Mode 1 & 2) toggleable directly in-game (Paper required)
Enchant Limit	Enforce custom maximum level caps for any enchantment at enchanting tables and anvils

World & Gameplay

Spawn & Teleportation

Feature	Description
Custom Spawn	Set the server spawn point with /setcustomspawn and let players teleport there with /spawn
Custom Respawn	Set where players respawn upon death with /setcustomrespawn
Bed Spawn Override	Toggle whether player beds or the custom respawn point takes priority upon death

Automated Harvesters

Feature	Description
Vein Miner	Sneak-mine any ore to instantly break the entire connected vein with tool durability safety
Tree Miner	Sneak-chop any log to fell the entire tree in a single hit and accelerate leaf decay

World Mechanics & Building

Feature	Description
Block Decay	Automatically decay and remove player-placed blocks after a customizable countdown (ideal for bridging and arenas)
One-Player Sleep	Skips the night when any single player sleeps in a bed
Dimensions	Independently toggle access to The Nether and The End
Infinite Restock	Villager workstations immediately restock trades indefinitely
Locator Bar	Compass in the action bar pointing to world spawn (Requires 1.21.7+)
Happy Ghast	Adjust flight and movement speeds for Ghasts

Crafting & Recipes

Feature	Description
Custom Recipes Editor	Visual in-game 3x3 crafting grid editor to design, register, and manage custom shaped and shapeless recipes
Easy Recipes	Simplified toggleable crafting recipes for Notch Golden Apples and Cobwebs

Server Administration & Utilities

Player Inventory Inspection

Feature	Description
Inventory Inspector (/invsee <player>)	View and edit any online or offline player's inventory, armor, and offhand with live sync, cursor safety, and offline persistence. Displays online/offline status in the title
Ender Chest Inspector (/endersee <player>)	View and edit any online or offline player's ender chest with live sync and offline persistence

Developer & Runtime Utilities

Feature	Description
Java Extensions System	Hot-reloading runtime Java extension system powered by ECJ — drop .java scripts into plugins/KaiCore/extensions/ and load them instantly without restarting or requiring a JDK
Server Log Uploader (/kc logs)	One-command server log upload to mclo.gs with automatic IP and auth token redaction
Hand Glow (/glow)	Toggle enchantment glint on held items on demand without modifying enchants
The End Control (/end open / /end close)	Open or close The End dimension portal on demand

---

Commands

Command	Aliases	Description	Permission
/KaiCore gui	/kaicore gui, /kc gui	Open the main 3-page KaiCore management GUI	kaicore.use
/KaiCore logs	/kc logs	Upload server logs to mclo.gs with sensitive data redacted	kaicore.logs
/KaiCore grace <time|stop>	/kc grace	Start or stop a server-wide PvP grace period with a boss bar	kaicore.grace
/KaiCore ext <reload|unload|list>	/kc ext	Manage runtime Java extensions	kaicore.extensions
/KaiCore mods [player]	/kc mods	Inspect detected client brand and active mods for a player	kaicore.moddetector.notify
/spawn	—	Teleport to the server's custom spawn location	kaicore.spawn.use
/setcustomspawn	—	Set the custom server spawn point to your location	kaicore.spawn.admin
/setcustomrespawn	—	Set the custom player respawn point to your location	kaicore.spawn.admin
/invsee <player>	/inventorysee, /openinv	View and edit an online or offline player's inventory and armor	kaicore.invsee
/endersee <player>	/ecsee, /enderchestsee, /enderinvsee	View and edit an online or offline player's ender chest	kaicore.endersee
/glow	—	Toggle enchantment glint on the item currently held in your hand	kaicore.glow
/end open	—	Open The End portal dimension	antiend.use
/end close	—	Close The End portal dimension	antiend.use

---

GUI Overview

The main KaiCore menu is an intuitive 54-slot inventory divided across pages:

• Page 1 (General & Restrictions): Item restrictions, bans, dupers, easy recipes, sleep, dimensions, restock, vein/tree miner, block decay, and locator bar.
• Page 2 (Advanced Systems): Mod Detector & Banned Mods, Damage Limiters, Spawn & Respawn options, and Longer Potions duration editor.
• Page 3 (Combat & Cooldowns): Stun cooldown timers for spears, maces, shields, pearls, wind charges, riptide, chorus fruit, and golden apples.

Controls:

• Left-click — Toggle options on/off or increase a value
• Right-click — Open sub-menus, configure fine-grained settings, or decrease a value
• Arrow buttons — Navigate seamlessly between pages

---

Permissions

Permission	Default	Description
kaicore.use	OP	Access to the main KaiCore GUI and core commands
kaicore.spawn.admin	OP	Set custom spawn and respawn points via /setcustomspawn and /setcustomrespawn
kaicore.spawn.use	true	Use the /spawn command
kaicore.invsee	OP	View and edit online or offline inventories with /invsee
kaicore.endersee	OP	View and edit online or offline ender chests with /endersee
kaicore.logs	OP	Upload server logs to mclo.gs via /kc logs
kaicore.grace	OP	Control PvP grace periods via /kc grace
kaicore.extensions	OP	Compile and manage Java extensions via /kc ext
kaicore.glow	OP	Toggle enchantment glint via /glow
antiend.use	OP	Open and close The End dimension via /end
kaicore.veinminer	true	Use Vein Miner when the feature is enabled
kaicore.treeminer	true	Use Tree Miner when the feature is enabled
kaicore.moddetector.notify	OP	Receive client/mod join notifications and inspect players with /kc mods
kaicore.moddetector.bypass	false	Bypass client mod bans and detector kicks
kaicore.spoof.bypass	false	Bypass the Spoofer to see real durability, health, and stack counts
kaicore.bypass	false	Bypass all KaiCore item and potion restrictions
kaicore.bypass.safezone	false	Enter combat safezones while combat-tagged
xaero.ignoredisable	false	Bypass the Xaero's Minimap disable packet
xaero.ignorefair	false	Bypass the Xaero's Minimap fair mode restriction

---

Recommended Server Software & Dependencies

Feature / Dependency	Requirement	Note
Core Features	Spigot, Paper, or any 1.20+ fork	Base plugin requirement
Anti-Xray	Paper or Paper fork (Pufferfish, Purpur, etc.)	Uses native Paper raytracing engine
Armor & Stat Spoofer	PacketEvents (Soft dependency)	Required for client-side packet rewriting
Mod Detector (Sign Probing)	PacketEvents (Soft dependency)	Enhances mod detection accuracy
Combat Safezones	WorldGuard (Soft dependency)	Required for safezone region barrier boundaries
Locator Bar	Minecraft 1.21.7+	Action bar compass locator

---

Terms of Service

• You may NOT claim this plugin as your own
• You may NOT resell or republish this plugin
• You may NOT modify this plugin at all

Made for server owners who want full control without touching config files.