Мир пустоты как кастомное измерение датапаком и пересчёт координат между
мирами с разным масштабом.
Механизм масштаба — тот же, что у Незера: поле coordinate_scale в типе
измерения, а пересчёт при переходе равен делению масштаба источника на
масштаб назначения. Для пустоты нужно ровно 2.0, то есть один блок пустоты
на два блока оверворлда. Проверено на сервере: coord scale overworld=1.0
void=2.0.
Биом сделан своим (delta_void:void), а не переопределением ванильного
minecraft:the_void. Переопределение трогало бы данные Mojang и конфликтовало
с любыми другими датапаками. Отличия от ванильного — только цвета:
sky_color и fog_color в ноль, плюс выключенный туман и вода.
Что потребовалось по дороге, все три ошибки поймал сервер, а не я:
1. У типа измерения в 1.21.8 обязательное поле logical_height. Без него
сервер отказывается стартовать: "No key logical_height".
2. Файл измерения не принимает дискриминатор "type": "minecraft:dimension".
Кодек LevelStem читает поле type как ССЫЛКУ на тип измерения, и мой
дискриминатор уходил в неё как имя типа. Правильно — "type" со значением
delta_void:void.
3. getAllLevels() живёт на MinecraftServer, а не на DedicatedServer, который
отдаёт CraftServer#getHandle(). И dimensionType() в Paper уже разворачивает
Holder, так что .value() там не нужен и ломает компиляцию.
Отдельно: World#getCoordinateScale() в Paper УЖЕ есть, причём реализован
ровно так, как я собрался писать. Для чтения масштаба ядро менять не нужно.
А вот пересчёта координат в API нет ни в Paper, ни в Bukkit: Player#teleport
его не делает, потому что телепорт не портал. Добавлен default-метод
World#convertLocation с той же формулой, что и ванильная, и без изменения Y.
Хорошая новость про отказ сервера: на битый датапак он не стартует, а
падает в safeMode. Тихая загрузка сломанной генерации была бы хуже.
Диагностика частиц всё ещё в CraftWorld, снимается после проверки прицела.
Частицы не долетали дальше 32 блоков, при том что механика способностей бьёт
на 120. Игрок дальше 32 блоков не видел прицела вообще, но удар приходил.
Причина оказалась на стороне сервера, а не клиента. В ServerLevel есть
if (blockPos.closerToCenterThan(pos, longDistance ? 512.0 : 32.0))
где longDistance это параметр alwaysShow. По умолчанию он false, то есть 32
блока. Но Bukkit-API этот флаг не открывает: в CraftWorld.spawnParticle он
захардкожен в false, а параметр force уходит в overrideLimiter. То есть ни
один плагин на Paper не мог отправить частицу дальше 32 блоков.
Само поле alwaysShow сериализуется в ClientboundLevelParticlesPacket, поэтому
клиент со своей стороны отсечку тоже снимает — тем же механизмом, что и
ванильная команда /particle в режиме display.
Что сделано:
1. World#spawnParticleLongDistance(...) — default-метод, а не абстрактный.
Причина: абстрактный метод в интерфейсе World ломает бинарную совместимость
с любой сторонней реализацией. Фолбэк здесь ведёт себя как обычный
spawnParticle, то есть деградация — «слишком короткая дальность», а не
«частиц нет».
2. CraftWorld переопределяет его. Дистанция применяется фильтрацией списка
получателей ДО вызова ServerLevel, а не патчем самого ServerLevel:
sendParticlesSource принимает готовый receivers, поэтому достаточно отсечь
его самим. Ванильная проверка остаётся нетронутой. Это принципиально —
меньше правок в ванильных патчах, меньше риска конфликтов.
3. Конфиг extended-particle-distance перестал быть мёртвым. Раньше он был
объявлен в DeltaConfig и выводился в /delta, но нигде не читался при отправке
частиц, поэтому переключатель не делал ничего. Теперь он работает как
потолок: плагин запрашивает сколько нужно, сервер режет до 128.
extendedParticleDistanceEnabled=false возвращает стоковые 32.
Замер: /delta теперь показывает "extended distance 128.0 blocks" вместо "off".
0373806e2 and 0817a5706 were pushed but never built, so the server jar was
broken on main. Six compile errors, all in code that had never run:
- ClientboundSoundPacket takes Holder<SoundEvent> in 1.21, not SoundEvent.
- CraftWorld has no getServer(); the vanilla handle does.
- Server has no paperConfigurations()/registryAccess() - Configurations is
reachable through the console, and saveGlobalSection lives on Configurations
(GlobalConfiguration is a ConfigurationPart, i.e. the data, not the writer).
- ServerPlayer.server is private.
DeltaSound pumped delayed packets through BukkitScheduler, which requires a
live Plugin, and Delta as a core has none. It now uses GlobalRegionScheduler
with a null plugin, which exists precisely for core tasks. Delays are counted
in game ticks via Bukkit#getCurrentTick rather than System.nanoTime, so they
no longer stretch under lag. The pump cancels itself once the queue drains.
New DeltaDisplay holds the predictive-teleport policy (lead range, default,
application) and /delta displaylead tunes it. Honest about its scope:
Display#setTeleportDuration is already stock Bukkit, so Delta adds no new API
to plugins and breaks no compatibility - it centralises the policy and reports
it. The position shift itself is done by the plugin, per visual, along that
visual's own trajectory.
DeltaBuild now registers the existing features in the startup banner instead of
printing "no custom features registered". The banner is emitted from a static
initialiser before paper-global.yml is parsed, so the strings describe the
mechanism and point at /delta status for live values rather than printing
defaults as if they were the running configuration.
When converting to components:
- Remove enchantments with levels <= 0
- Remove the item name if it is not valid JSON
- Remove lore entries that are not valid JSON
The chunk system may not be responsive in a shutdown (i.e
watchdog timeout). Therefore, we should avoid interacting
with the chunk system to increase the odds of a graceful
shutdown.
The player teleport has been moved up in ThrownEnderpearl to prevent
endermite spawning in case of a cancelled teleport. This however placed
the player at the teleport destination prior to the endermite spawn
logic, creating the entity at the wrong location.
The commit stores the location of the player pre teleportation and uses
said location for spawning the endermite instead.
Co-authored-by: Helvetica Volubi <suisuroru@blue-millennium.fun>
Reviewed-in: https://github.com/PaperMC/Paper/pull/12912
SashegDev
Jason Penilla
Lulu13022002
Spottedleaf
Shane Freeder
Aeltumn
Strokkur24
Pedro
MC_XiaoHei
Warrior
Moulberry
Esophose
David
Emil
swim5678
Alejandro Nieto
Žiga Slatnar Štagar
Lumine1909
Emily
Bjarne Koll
Gero
Red
Kezz