Pearload

A lightweight chunk loader powered by entities.

📦 Overview

Pearload is a minimal, server-friendly mod that allows certain entities — such as Ender Pearls — to temporarily force-load the chunks they occupy. This ensures that projectiles or custom entities continue functioning properly even when no players are nearby.

By default, Ender Pearls act as force loaders, but you can configure additional entities or entire mods whose entities should load chunks automatically.

⚙️ Features

Entity-Based Chunk Loading: Entities marked as “force loaders” will keep their chunks loaded while they exist in the world.

Configurable Behavior (Optional): If the Jsonate library is present, a JSON config file will be generated:

ForceLoaders: list of specific entity IDs or mod IDs whose entities should load chunks.
InitializeAllTheProjectilesAsChunkLoader: make all projectiles force-load chunks (default: false).

No Hard Dependencies: Pearload works perfectly fine without Jsonate — it will just default to Ender Pearls as the only force loader.

Server-Side Only: Pearload can safely run on servers only. Clients don’t need to install it.

🛠 Example Configuration (with Jsonate)

{
  "ForceLoaders": [
    "minecraft:ender_pearl",
    "modid:custom_projectile"
  ],
  "InitializeAllTheProjectilesAsChunkLoader": false
}

🪄 Notes

Without Jsonate, configuration will not be available, but functionality remains intact.
Designed for performance and simplicity — no tick-heavy logic or complex scheduling.

💡 Use Cases

Keep Ender Pearls active in mid-flight even after players move away.
Allow custom projectile entities (like magic bolts or drones) to remain active.
Enable specific mobs or utility entities to manage chunk-loaded regions dynamically.

Pearload (Entity Chunk Loader)