SnChunkLoader changelog

Changes

• SnSuperiorSkyblock is now OPTIONAL. The jar previously refused to load without it (UnknownDependencyException: Unknown/missing dependency plugins: [SnSuperiorSkyblock]). It is a soft dependency now: install it and every island rule applies exactly as before, leave it out and the same plugin runs as a plain chunk loader.
• Standalone mode: loaders can be placed anywhere the server lets you place a block, and the per-player limit is the only placement rule left. Lifetime, stacking, floating displays, the menu, block protection, breaking, returns and owed deliveries all work unchanged.
• Island rules are skipped, not evaluated, when the island plugin is absent - membership, protected-area placement, the per-island limit and the membership returns.
• A loader placed in standalone mode is stored as unbound. Adding SuperiorSkyblock to the server later leaves those loaders alone: the reconciliation sweep never confiscates them.
• Placement on an island server whose island plugin is momentarily reloading is still REFUSED, never accepted as an unbound loader.
• config.yml, lang/messages_en.yml and plugin.yml now state which rules need the island plugin. The shipped item lore is island-neutral; existing values are preserved on update.

Requires SnLib. SuperiorSkyblock, DecentHolograms and PlaceholderAPI are optional.

Changes

• /chunkloader give now reports exactly one outcome to each side. When the target's inventory is full the loader is queued, and both the admin and the player used to be told that immediately afterwards, contradicting the notice they had just received. The success lines are now on the delivered branch only, and the queued line carries the same size and remaining time the success line does.
• Shutdown no longer scales its wait with the number of owed loaders. The teardown that re-owes in-flight deliveries spent its bounded wait once per entry; it now spends one budget across the whole loop, so a stop with several owed items costs the same as a stop with one.

Neither issue could destroy, duplicate or lose a loader. An owed loader was always durable and is still handed over on the next join.

Install

• SnLib.jar must be present in plugins/ (com.sn:snlib 1.24.1 or newer).
• SnSuperiorSkyblock is required.
• Existing config.yml, lang/messages_en.yml and guis/loader.yml are preserved. The reworded messages.given-queued line applies to fresh installs; an existing language file keeps your value, which stays correct without the new {size} and {time} placeholders.

Requirements: Java 21+, Paper 1.21.8

Full documentation: https://github.com/ValentinTarnovsky/Sn-Releases/tree/main/docs/gitbook/snchunkloader

Placeable chunk loaders for SnSuperiorSkyblock islands. Each loader keeps an odd N x N square of chunks loaded and ticking, centered on its own chunk, and carries its own stored lifetime. Size 1 keeps 1 chunk, 3 keeps 9, 5 keeps 25, 7 keeps 49.

The lifetime counts down only while a loader is on and actually holding its chunks. At zero the loader turns itself off and stays where it is: nothing is deleted, and a player can feed it more time and switch it back on. A loader minted with the duration -1 never expires at all.

Chunk loading uses Paper plugin chunk tickets with the plugin's own per-chunk reference count, so two overlapping loaders share their chunks and a chunk is only released when the last loader covering it is gone. Loaded chunks tick redstone, hoppers, crops and generators without a player nearby. They do not spawn mobs, which is a vanilla rule rather than a plugin one.

Commands

Root is /chunkloader, aliases /scl and /snchunkloader. Every subcommand is administrative: players never type a command, they place, break and right-click the loader itself.

snchunkloader.use (default true) is the player-facing gate: placing a loader, breaking one, and right-clicking one to add time or open its menu.

Configuration

Aliases for /chunkloader live in command.aliases and are re-read on /chunkloader reload.

Notes

• A loader never hits the ground. Breaking one hands it back with its remaining time to the player who broke it, and the island membership gate lets any member of the island be that player. Membership loss, a disband and the reconciliation sweep return it to the owner instead. If the receiving inventory is full or that player is offline, it is queued in the database and handed over on their next join.
• Placed loaders are protected. Only a player breaking one removes it. Explosions skip it, fire and block decay cannot take it, endermen and falling blocks cannot change it, and a piston that would push or pull a loader does not move at all.
• Stacking feeds a placed loader with another loader item of the same size, consuming one item. Mismatched sizes, an empty item and a loader already at the ceiling are all refused, and a refused attempt consumes nothing. An infinite item is not bound by the ceiling: it makes the loader permanent whatever max-stack-seconds says.
• Membership loss covers kicks, quits, bans and island disbands. A periodic reconciliation sweep is the safety net for removals that fire no event at all, such as a WorldEdit paste or an island regen.
• The size range governs minting only. Narrowing it stops you selling a size, it never confiscates loaders already placed or items already handed out. The two limits keys work the same way: they are checked at placement and never again, so lowering one blocks new placements and leaves standing loaders alone.
• hologram.provider and hologram.offset-y apply to displays created after the change. A display keeps the backend and the height it was created with, so those two keys need a restart rather than a reload.
• Chunk tickets do not survive a restart, so the plugin re-applies them on boot. The re-apply is spread across ticks, so a server with many loaders does not freeze while it starts.
• Remaining time renders as Nd Nh Nm. Zero components are omitted and seconds are never shown.
• Runtime debug output traces placement decisions, ticket application and release, the countdown, and every return and delivery.

Install

• SnLib.jar must be present in plugins/ (com.sn:snlib 1.24.1 or newer).
• SnSuperiorSkyblock is required: it owns the island model the plugin is built on.
• The plugin generates its own config.yml, lang/messages_en.yml and guis/loader.yml on first boot.
• Licensed in bundle mode: paste your key into plugins/.Sn-License/license.yml. One key unlocks every bundled Sn plugin on the server. The key is validated at every startup through an outbound HTTPS call to sn-license-server.okimc-dev.workers.dev, so allow that host through your firewall. The jar hash is part of the check, and a repacked jar fails it.
• Optional: DecentHolograms as an alternative display backend, PlaceholderAPI to resolve PAPI tokens written into the shipped files.

Requirements: Java 21+, Paper 1.21.8

Full documentation: https://github.com/ValentinTarnovsky/Sn-Releases/tree/main/docs/gitbook/snchunkloader