
KubeLoader
A mod that allows you to load the KubeJS Scripts from mod or "ContentPack"
About this Mod
KubeLoader - Next Generation KubeJS Development Framework
Overview
KubeLoader is not just another KubeJS addon—it's a future-ready modular development platform for KubeJS that revolutionizes how scripts are created, distributed, and managed.
KubeLoader introduces a revolutionary ContentPack system that redefines how KubeJS scripts are distributed and loaded, enabling scripts to be treated as first-class mod citizens.
This document provides an overview of KubeLoader's architecture, core components, and extension mechanisms for the KubeJS framework.
For detailed information about ContentPack structure and creation, please refer to the ContentPack documentation.
What is KubeLoader?
KubeLoader is the next-generation development framework for KubeJS. It provides a complete modular system—ContentPacks—that allows developers to build, integrate, and publish KubeJS functionality in a "mod-like" manner, completely eliminating the flat and coupled nature of traditional scripts.
Note: ContentPacks are not just script packages; they can simultaneously carry assets and data content, making them a superset of resource packs + data packs.
With KubeLoader, developers no longer just write scripts—they develop reusable functional modules. You can:
- Develop scripts like mods: Enjoy independent dependency management, namespaces, and lifecycle control.
- Load functionality like installing mods: Easily integrate ContentPacks developed by others to rapidly build complex projects.
- Share contentpacks like publishing mods: Export as .jar files with one click and publish directly to CurseForge or Modrinth as proper mods.
KubeLoader aims to become the "script operating system" for the KubeJS ecosystem—managing modules, coordinating dependencies, extending capabilities, and providing a unified development paradigm for the entire community.
With KubeLoader, you can approach script development with a modular mindset and develop/publish ContentPacks with the same rigor as developing mods.
Core Features
KubeLoader provides a suite of powerful features designed to enhance the KubeJS script development experience:
🚀 ContentPack System
- Multi-format Support: Read ContentPacks from folders, ZIP archives, and JAR files
- Rapid Development: Quickly create ContentPack projects and export them as JAR mods
- Modular Architecture: Treat scripts as independent, reusable modules
⚡ Enhanced Event System
- Extended Events: Add new Forge events to enhance script development capabilities
- Advanced Tooling: Additional utility classes to streamline KubeJS development
- Lifecycle Management: Comprehensive control over ContentPack initialization and execution
🔗 Dependency Management
- Smart Dependency Resolution: Automatic sorting and loading of ContentPack dependencies
- Cross-Pack Communication: Secure data sharing and communication between ContentPacks via API
- Version Compatibility: Robust handling of version requirements and conflicts
📦 Resource Integration
- Assets & Data Support: ContentPacks can include both assets and data resources
- Automatic Resource Pack Handling: Seamless integration with Minecraft's resource system
- Namespace Management: Proper namespace isolation and conflict prevention
🛠️ Developer Experience
- Command Integration:
/kl packand/kl modcommands for easy ContentPack management
wiki
More infomation in wiki
Available Versions
How to Install KubeLoader on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set forge Loader
In the panel under "Egg", select the forge loader and matching Minecraft version (1.21.1).
Install Mod
Open the mod browser in the dashboard and search for "KubeLoader". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.21.1, 1.20.6, 1.20.5 (+4 more)
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
KubeLoader server crashes on startup – what to do?
Most common cause: wrong forge version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.21.1). You can switch loaders with one click in the panel.
Is KubeLoader compatible with forge and neoforge?
KubeLoader officially supports forge, neoforge for Minecraft 1.21.1, 1.20.6, 1.20.5. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with KubeLoader – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if KubeLoader consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install KubeLoader with just one click on your server.