KaiCore

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

---

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

---

Recommended Server Software & Dependencies

---

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.