For the complete documentation index, see llms.txt. This page is also available as Markdown.

โฌ†๏ธUpgrading from 1.0.8

Moving a live server from UltimateOneBlock 1.0.8 to Modern OneBlock 26.1.0

What changed

โ€‹
Before
Now

Minecraft

1.21.x

26.1+

Java

21

25

Plugin name

OneBlock

ModernOneBlock

Data folder

plugins/OneBlock/

plugins/ModernOneBlock/

Jar

UltimateOneBlock-2.0.0.jar

ModernOneBlock-26.1.0.jar

Folia

not supported

supported

Your data folder is moved for you

On first start the plugin looks for plugins/OneBlock/ and moves it to plugins/ModernOneBlock/, carrying your configuration, your edited language files and the H2 island database with it. If the new folder already exists it is left alone. If the move fails, the plugin copies instead and tells you in the console โ€” the old folder is never deleted.

VoidGen is no longer required

The islands world is generated by a bundled void generator. You can uninstall VoidGen.

What deliberately did not change

Servers depend on these, so they were left alone:

  • Permission nodes are still oneblock.*.

  • The islands world is still islands.

  • /is, /ob and /oneblock are unchanged.

  • Generator items keep their oneblock: data keys โ€” existing placed generators still work.

Version numbering

Versions are now <mc-major>.<mc-drop>.<release>. The first two segments are the oldest Minecraft drop a build supports, so 26.1.0 is the first release for Minecraft 26.1. A build that required 26.2 would be 26.2.0.

New config files

Three additions appear on first start. Existing files are never overwritten.

  • worth.yml โ€” item sell prices and block worth for island value.

  • upgrades.yml โ€” island upgrade tiers and costs.

  • New sections in config.yml: island-flags, tops.holograms, text-format.

New permissions

All default to true:

oneblock.bank, oneblock.shop, oneblock.upgrades, oneblock.flags, oneblock.sethome, oneblock.warp, oneblock.top.

Every oneblock.* node is now declared in plugin.yml, so permission plugins can finally see them.

Known limitations

  • Island value is incremental. It counts blocks placed and broken while the plugin is running, so blocks already standing before a worth.yml entry existed are not counted.

  • The hopper limit is per chunk, not per island.

  • On Folia the mob limit is skipped when an island's bounding box spans regions.

  • On Folia, island holograms are not removed at shutdown. The bundled provider's holograms are non-persistent and do not survive the restart either way.

Last updated