SkyGrid 26.1.2

SkyGrid 26.1.2 is a major compatibility update for modern Paper and Folia servers.

This release moves the plugin from Java 21 to Java 25, updates the Paper API target to 26.1.2, removes Bukkit/Spigot support, and rebuilds a lot of the internal scheduling and world handling.

Requirements

• Java 25
• Paper or Folia 26.1.2

Bukkit and Spigot are no longer supported in this build.

This lets SkyGrid use newer Paper/Folia APIs that are needed for safer region, entity, async, and world work.

Paper and Folia world handling

Paper servers still get separate SkyGrid worlds:

• skygridx_world
• skygridx_world_nether
• skygridx_world_the_end

This lets servers keep normal survival worlds while also running SkyGrid worlds.

Folia servers use the normal loaded worlds instead:

• world
• world_nether
• world_the_end

This is intentional. Folia does not support plugin-created worlds the same way Paper does, so SkyGrid uses base-world mode there.

SkyGrid can also fall back to base-world mode if the server does not allow plugin world creation.

First boot and generator setup

World generator setup now happens during plugin load instead of later during enable.

This fixes the first-boot issue where Paper could try to assign the SkyGrid generator to normal default worlds before the custom worlds were ready.

SkyGrid also clears inactive generator entries depending on the current world mode:

• Paper custom-world mode uses the skygridx_* worlds
• Folia/base-world mode uses the normal loaded worlds

Paper/Folia scheduler rewrite

The old custom async scheduler and Bukkit task usage were replaced with a shared SkyGridScheduler.

SkyGrid now routes work through the proper scheduler type:

• Global scheduler for global server work
• Region scheduler for chunk and block work
• Entity scheduler for player/entity work
• Async scheduler for file or background work

This affects world setup, chunk loading, mini regen, fog, resource packs, Eyes of Ender, random teleporting, portals, beds, anchors, and other delayed tasks.

Expanded grid-face material configs

SkyGrid block configs now support extra materials attached to the faces of a selected grid block.

Example:

distributions:
  custom_mushroom_fields:
    GRASS_BLOCK: 25
      top:
        SUGAR_CANE: 20
      east:
        WATER: 10

Supported fixed face keys:

top, up, bottom, down, east, west, north, south

Supported random face keys:

rends
rsides

rends picks one random top or bottom face.

rsides picks one random side face.

Old entries still work:

STONE: 50

The new parser supports the shorthand format shown above and also supports expanded valid YAML using chance, weight, or percentage.

Face attachments also run through the normal SkyGrid block handling, so configured chests, spawners, crops, leaves, portals, and similar special blocks still get their usual setup.

Multiverse and respawn compatibility

New settings were added:

compatibility:
  respawnIsolation: true
  multiverseWarnings: true

respawnIsolation controls whether SkyGrid keeps players inside the SkyGrid world set after dying in a SkyGrid world.

When enabled, SkyGrid uses its custom beds, respawn anchors, or SkyGrid spawn fallback.

When disabled, Multiverse, CMI, or another spawn plugin can fully control the respawn.

multiverseWarnings lets SkyGrid warn admins when Multiverse-Core is detected. The warning reminds admins to import or create SkyGrid worlds in Multiverse with the SkyGrid generator before new chunks are generated.

Beds, anchors, portals, and teleporting

Bed and respawn anchor handling now works with both Paper custom-world mode and Folia/base-world mode.

Anchor respawns no longer overwrite bed fallback behavior when no anchor exists.

Random teleporting now loads the target chunk asynchronously, checks for a safe block in the correct region, and uses async teleporting where possible.

Portal and End handling were updated for the new world-name system and region scheduler.

Mini regen

Mini regen now uses Paper/Folia region timers instead of the old custom delayed scheduler.

It also cancels scheduled tasks properly when entries are removed or when the plugin shuts down.

Custom chests and loot storage

Chest storage was reworked.

The chest database now uses a bounded write queue and a dedicated writer thread, which helps avoid large write spikes during generation.

The database also migrates chest records between skygridx_* world names and normal world names when switching between Paper custom-world mode and Folia/base-world mode.

Chest config loading was also cleaned up, and enchanted book handling now stores enchants on books correctly.

Resource packs, fog, and Eyes of Ender

Resource pack sending now uses the newer Paper/Adventure resource pack API.

Fog tracking now uses player UUIDs and the Paper/Folia scheduler.

Custom Eyes of Ender were moved to entity scheduler timing and still refund the eye after the custom portal-search animation.

Build and dependency cleanup

The build now targets Java 25.

The Paper API version is set to 26.1.2.

The Spigot dependency and repository were removed.

fastutil is now marked as provided, using the version already included with Minecraft/Paper instead of bundling fastutil into the SkyGrid jar.

The release jar was rebuilt as:

SkyGrid-26.1.2.jar

Upgrade notes

Back up your server before updating.

Make sure your server is running Java 25.

Use this build on Paper or Folia 26.1.2.

If you use Multiverse, import or create the SkyGrid worlds with generator SkyGrid before generating new chunks.

If you use CMI, Multiverse, or another respawn manager and want that plugin to control death respawns, set:

compatibility:
  respawnIsolation: false

Known warning

A lot changed in the plugin code for this version.

Please report bugs if you run into any issues, especially with:

• Java 25 startup
• Folia region behavior
• Multiverse or other world managers
• Death respawns
• Beds or respawn anchors
• Paper custom SkyGrid worlds
• Mini regen
• Custom chests