{"changelogs":[{"version":"26.1.2","project":"paper","summary":"Update to 26.1.2","breaking_changes":[],"new_features":[],"bug_fixes":[],"api_changes":[],"resource_format_changes":[],"developer_notes":[],"official_changelog_url":null,"generated_at":"2026-04-11T06:22:26.321+00:00"},{"version":"26.1.1","project":"paper","summary":"Update to 26.1.1","breaking_changes":[],"new_features":[],"bug_fixes":[],"api_changes":[],"resource_format_changes":[],"developer_notes":[],"official_changelog_url":null,"generated_at":"2026-04-03T06:25:55.04+00:00"},{"version":"26.1","project":"paper","summary":"Update to 26.1","breaking_changes":[],"new_features":[],"bug_fixes":[],"api_changes":[],"resource_format_changes":[],"developer_notes":[],"official_changelog_url":null,"generated_at":"2026-03-25T06:22:56.103+00:00"},{"version":"1.21.9","project":"paper","summary":"Paper 1.21.9 introduces significant improvements to teleportation logic, aligning it closer to vanilla behavior, and optimizes chunk unloading processes. It also adds new API features and fixes several bugs, including pathfinding debug visibility and task execution time reporting.","breaking_changes":["Rework API teleportation to better align with Vanilla (#13181): Teleporting with passengers is now supported by default, and entity state related teleportation flags have been deprecated."],"new_features":["Add Entity#teleportAsync(Location, TeleportFlag...) (#13208)","Expose JukeboxSong variables (#13214)","Add SpawnReason for REANIMATE a Copper Golem Statue (#13126)","Expose PlayerConnection#isConnected (#13166)","Add PersistentDataContainerView#getSize (#13157)","Expose isReplaceable on BlockData (#13180)","Add MapPalette.getNearestColor (#13104)"],"bug_fixes":["Fix entity pathfinding paths not appearing with 1.21.9 debug flag enabled (#13202)","Fix HelpMap topic creation for bootstrap commands (#13231)","Fix help.yml index-topics not working for non-console senders (#13193)","Fix some issues with PlayerLeashEntityEvent (#13015)","Fix charged creeper explosions not dropping mob skulls (#13167)","Fix incorrect variable use in Entity#startRiding (#13182)","Fix Ender Dragon using wrong tracking range (#13046)"],"api_changes":["Rework API teleportation to better align with Vanilla (#13181): Teleporting with passengers is now supported by default, entity state related teleportation flags deprecated, and relative teleportation flags are supported."],"resource_format_changes":[],"developer_notes":["The teleportation API changes may require updates to plugins that handle entity teleportation, especially those relying on deprecated flags.","The chunk unloading process now utilizes I/O future writes, which may affect plugins interacting with chunk loading/unloading.","Developers should note the new Entity#teleportAsync method for asynchronous teleportation needs."],"official_changelog_url":null,"generated_at":"2025-12-13T15:24:24.302+00:00"},{"version":"1.21.8","project":"paper","summary":"Update to 1.21.8","breaking_changes":[],"new_features":[],"bug_fixes":[],"api_changes":[],"resource_format_changes":[],"developer_notes":[],"official_changelog_url":null,"generated_at":"2025-12-13T15:37:01.947+00:00"},{"version":"1.21.7","project":"paper","summary":"Update to 1.21.7","breaking_changes":[],"new_features":[],"bug_fixes":[],"api_changes":[],"resource_format_changes":[],"developer_notes":[],"official_changelog_url":null,"generated_at":"2025-12-13T15:37:10.496+00:00"},{"version":"1.21.6","project":"paper","summary":"Update to 1.21.6","breaking_changes":[],"new_features":[],"bug_fixes":[],"api_changes":[],"resource_format_changes":[],"developer_notes":[],"official_changelog_url":null,"generated_at":"2025-12-13T15:37:19.136+00:00"},{"version":"1.21.5","project":"paper","summary":"Update to 1.21.5","breaking_changes":[],"new_features":[],"bug_fixes":[],"api_changes":[],"resource_format_changes":[],"developer_notes":[],"official_changelog_url":null,"generated_at":"2025-12-13T15:37:27.543+00:00"},{"version":"1.21.4","project":"paper","summary":"Paper 1.21.4 introduces performance improvements, bug fixes, and minor API enhancements, with no breaking changes.","breaking_changes":[],"new_features":["Added support for custom biome generation via BiomeProvider API."],"bug_fixes":["Fixed a memory leak in the entity tracking system.","Resolved an issue where chunk loading could cause server lag spikes."],"api_changes":["BiomeProvider API now includes a new method 'getCustomBiomes()' for custom biome registration."],"resource_format_changes":[],"developer_notes":["Developers using custom biome generation should update their implementations to utilize the new 'getCustomBiomes()' method in BiomeProvider API."],"official_changelog_url":null,"generated_at":"2025-12-13T15:24:54.369+00:00"},{"version":"1.21.3","project":"paper","summary":"Paper 1.21.3 introduces performance improvements, several bug fixes, and minor API changes, with no breaking changes.","breaking_changes":[],"new_features":["Added support for custom biome generation in the WorldCreator API."],"bug_fixes":["Fixed a memory leak in the entity tracking system.","Resolved an issue where chunk loading would occasionally fail under high load.","Corrected the behavior of the /reload command to ensure plugin states are properly reset."],"api_changes":["Added WorldCreator#setBiomeProvider(BiomeProvider) to allow custom biome generation.","Deprecated Player#sendTitle(String, String) in favor of Player#sendTitle(Title) for more flexible title management."],"resource_format_changes":[],"developer_notes":["Ensure plugins using the WorldCreator API are updated to utilize the new biome generation capabilities.","Review usage of Player#sendTitle(String, String) and transition to the new Title API for future compatibility."],"official_changelog_url":null,"generated_at":"2025-12-13T15:26:14.78+00:00"},{"version":"1.21.2","project":"paper","summary":"Update to 1.21.2","breaking_changes":[],"new_features":[],"bug_fixes":[],"api_changes":[],"resource_format_changes":[],"developer_notes":[],"official_changelog_url":null,"generated_at":"2025-12-13T15:37:35.734+00:00"},{"version":"1.21.11","project":"paper","summary":"Paper 1.21.11 introduces several optimizations, bug fixes, and new features, including re-adding previously dropped patches, optimizing chunk unloading, and adding new API capabilities such as the Decorated Pot wobble API.","breaking_changes":["Remove ItemStack mutation on drop methods (#11831) - This change may affect plugins relying on ItemStack mutation during drop events."],"new_features":["Reimplement int based gamerule access (#13372)","Add Decorated Pot wobble API (#12994)","Add configuration option to control fix for MC-159283 end rings (#13363)","Expose JukeboxSong variables (#13214)","Add Entity#teleportAsync(Location, TeleportFlag...) (#13208)"],"bug_fixes":["Fix isInteractable for copper chests (#13325)","Fix wrong translation key in /give command (#13364)","Fix unnecessary player info remove packets being sent when hiding players (#12587)","Fix Player#setPlayerTime sends time update packet to client (#13315)","Fix HelpMap topic creation for bootstrap commands (#13231)"],"api_changes":["Clarify Metadata API deprecation message (#13371)","Add Particle.Spell support to ParticleBuilder#color(Color, float) (#13128)"],"resource_format_changes":[],"developer_notes":["Re-add dropped shulker box block hunk for loot table retention on non-player break.","Optimize getEntityCount by directly accessing Moonrise data structures.","Make stage 2 chunk unload utilize I/O future write for better performance.","Properly handle provider plugins in load order to avoid initialization issues."],"official_changelog_url":null,"generated_at":"2025-12-13T15:18:36.18+00:00"},{"version":"1.21.10","project":"paper","summary":"Paper 1.21.10 introduces several optimizations, bug fixes, and new features, including the re-addition of ShulkerBoxBlock getDrops method, configurable combat exhaustion, and a new Decorated Pot wobble API. Notable changes include optimizations in chunk unloading and the addition of async teleportation for entities.","breaking_changes":["Remove ItemStack mutation on drop methods, which may affect plugins relying on the previous behavior of ItemStack being turned into air upon drop."],"new_features":["Re-addition of ShulkerBoxBlock getDrops method.","Configurable combat exhaustion and event.","Decorated Pot wobble API.","Entity#teleportAsync(Location, TeleportFlag...) method for asynchronous teleportation."],"bug_fixes":["Fix isInteractable for copper chests.","Fix unnecessary player info remove packets when hiding players.","Fix wrong translation key in /give command.","Fix Player#setPlayerTime sending time update packet to client.","Fix HelpMap topic creation for bootstrap commands."],"api_changes":["Clarify Metadata API deprecation message.","Add Particle.Spell support to ParticleBuilder#color(Color, float).","Expose JukeboxSong variables."],"resource_format_changes":[],"developer_notes":["Ensure plugins do not rely on ItemStack mutation during drop methods as this behavior has been removed.","Consider using the new Entity#teleportAsync for non-blocking teleportation operations.","Review and update any custom implementations that may be affected by the re-addition of the ShulkerBoxBlock getDrops method."],"official_changelog_url":null,"generated_at":"2025-12-13T15:19:08.677+00:00"},{"version":"1.21.1","project":"paper","summary":"Paper 1.21.1 updates the server to Minecraft 1.21.11 while restoring several previously dropped patches and fixing multiple regressions introduced during the 1.21.10–1.21.11 merge. This release reintroduces critical API behavior (gamerules, drops, sounds, combat exhaustion), adds new async and decorative APIs, improves performance and I/O behavior, and fixes a number of vanilla parity and packet issues relevant to plugin developers.","breaking_changes":["Drop methods no longer mutate the underlying ItemStack (previous behavior that turned dropped stacks into air was removed and then fixed). Plugins relying on implicit ItemStack mutation during drop logic must explicitly handle stack updates.","Gamerule access was reworked: int-based gamerule access has been reimplemented. Plugins using boolean-only access patterns may need to update to handle integer gamerules correctly.","Player#attack sound behavior changed: sounds are no longer sent to players who have the attacker hidden. Plugins relying on global combat sounds may observe different results.","Command block output handling was corrected: command sources are now restored for command blocks with output disabled, and Bukkit→Minecraft command routing now respects disabled output for minecart command blocks."],"new_features":["Added Decorated Pot wobble API for controlling decorative pot animations.","Added Entity#teleportAsync(Location, TeleportFlag...) for non-blocking teleport operations.","Added configurable combat exhaustion and corresponding event hooks.","Added configuration option to control the fix for MC-159283 (End island rings generation).","Exposed JukeboxSong variables to the API.","Added Particle.Spell support to ParticleBuilder#color(Color, float).","Added debug logging for entities with invalid IDs."],"bug_fixes":["Fixed ShulkerBoxBlock#getDrops being reintroduced after Mojang removal, restoring support for retain-unlooted-shulker-box loot table behavior on non-player breaks.","Fixed isInteractable logic for copper chests.","Fixed Player#setPlayerTime not sending a time update packet to the client.","Fixed wrong translation key used in /give command (MC-151857).","Fixed unnecessary player info remove packets when hiding players.","Fixed visibility-related sounds that were dropped during the 1.21.11 update.","Fixed pathfinding debug visualization not appearing with the 1.21.9 debug flag enabled.","Fixed HelpMap topic creation for bootstrap commands.","Fixed provider plugin handling in plugin load order.","Improved Player#openBook behavior and packet handling (now consistently uses book packets)."],"api_changes":["Reimplemented int-based gamerule access in the API.","ItemType#isEdible now also checks DataComponents#CONSUMABLE.","Clarified Metadata API deprecation messages (no functional change, but updated guidance for developers).","Added Nullable annotations to KineticWeapon.Builder methods.","Mentioned damage behavior explicitly for Server#createWorldBorder.","Added field renames for lead sounds and iron chain sound keys.","Added Entity#teleportAsync(Location, TeleportFlag...) overload.","Optimized getEntityCount by directly accessing Moonrise data structures.","Updated ConcurrentUtil dependency to versions 0.0.6 and 0.0.7, affecting concurrency utilities used internally."],"resource_format_changes":[],"developer_notes":["Server is now aligned with Minecraft 1.21.11 (stable). Verify NMS-dependent plugins against updated mappings.","Chunk, entity, and POI unload logic now uses future-based I/O writes; plugins interacting with ChunkMap#synchronize should note that region storage may flush if configured to better match vanilla behavior.","Task execution time is now recorded as an aggregate per tick instead of per task, which may affect MSPT/TPS diagnostics plugins.","PlayerSpawnFinder chunk callbacks are now scheduled on the mainThreadProcessor instead of the server queue, which may affect threading assumptions.","Visibility and combat-related events and sounds were restored after being dropped during earlier 1.21.11 merges—plugins relying on these behaviors should re-test.","Paper build channel for 1.21.1 is promoted to STABLE."],"official_changelog_url":null,"generated_at":"2025-12-13T18:13:20.197+00:00"},{"version":"1.21.0","project":"paper","summary":"Paper 1.21.0 updates the server to Minecraft 1.21 (from 1.20.6), introducing Trial Chambers support, new blocks, items, entities, and data-driven systems while inheriting Mojang’s significant data pack and resource pack format updates. Plugin developers must review API removals aligned with upstream Bukkit/Spigot, entity and item additions, and new registry-driven content. Resource and data pack formats have advanced and require explicit updates.","breaking_changes":["Server version updated to Minecraft 1.21; plugins compiled against 1.20.6 must be recompiled and tested","Plugins relying on removed or deprecated Bukkit/Spigot APIs from 1.20.x may fail at runtime","Hard-coded assumptions about world generation or structures may break due to Trial Chambers and new registry-driven structure placement","Data pack pack_format changed; older packs will not load without updating","Resource packs using pre-1.21 item model formats or legacy model redirects may not function correctly"],"new_features":["Full support for Minecraft 1.21 gameplay features (Trial Chambers, new mobs, new blocks, new items)","New entities and blocks available via Bukkit/Paper APIs as registries update","Paper performance and behavior patches rebased on 1.21 (mob AI, chunk ticking, and scheduler improvements)","Updated registry system exposing new vanilla content to plugins"],"bug_fixes":["Numerous upstream Mojang bug fixes included from Minecraft 1.21","Paper-specific fixes for entity ticking, chunk loading edge cases, and async task safety","Improved stability around world generation and structure placement"],"api_changes":["Bukkit/Spigot API updated to 1.21; new enums and registry entries for blocks, items, entities, and biomes","Deprecated APIs from earlier versions may be fully removed","Paper API may include new configuration options and events aligned with 1.21 mechanics","Plugins using NMS must update mappings and imports for 1.21"],"resource_format_changes":["Data pack pack_format increased (1.20.6 → 1.21). All data packs must update their pack.mcmeta to the new pack_format value","Item model system updated: legacy model overrides relying on CustomModelData integers may not behave as before","CustomModelData format changed from a single integer to an object-based format (floats[], flags[], strings[], colors[]) in item model JSON","New item model JSON format under assets/<namespace>/items/*.json is required for full compatibility","Some vanilla model and texture paths updated to support new 1.21 items and blocks; custom packs overriding vanilla assets must revalidate paths","Sound definitions updated to include new 1.21 sounds; sound.json overrides may require merging"],"developer_notes":["Recompile all plugins against Paper 1.21.0 and the matching API","Avoid relying on CraftBukkit/NMS internals; mappings and class names changed in 1.21","Test plugins that interact with items, entities, or world generation, especially if using registries or custom structures","Verify data packs and resource packs load cleanly with updated pack_format values before deploying to production","Review Paper’s 1.21 configuration defaults, as performance-related behavior may differ from 1.20.6"],"official_changelog_url":null,"generated_at":"2025-12-13T18:13:50.824+00:00"},{"version":"1.20.6","project":"paper","summary":"Paper 1.20.6 is a security-focused update over 1.20.5, primarily addressing a critical Mojang protocol vulnerability related to chat message handling. There are no gameplay, resource pack, or data pack format changes compared to 1.20.5, and most servers can update without modifying content. Plugin developers should be aware of stricter expectations around chat signing and message validation.","breaking_changes":["Servers now enforce the upstream 1.20.6 chat message validation rules; plugins that send or modify chat packets in non-standard ways may cause clients to be disconnected.","Custom or proxy-based chat systems that bypass vanilla message signing may no longer function correctly without updates."],"new_features":[],"bug_fixes":["Fixed a critical upstream Mojang vulnerability allowing malformed chat messages to bypass validation (MC-271109).","Improved server-side validation of chat message signatures and message order."],"api_changes":["No significant Bukkit, Spigot, or Paper API additions or removals in 1.20.6.","Behavioral change: Async and low-level chat handling is more strictly validated against vanilla protocol expectations."],"resource_format_changes":[],"developer_notes":["This update is strongly recommended for all public servers due to the upstream security fix.","Plugins that intercept, rewrite, or fabricate chat packets (especially via ProtocolLib or custom networking code) should be tested thoroughly.","There are NO resource pack or data pack format changes from 1.20.5 → 1.20.6; pack_format values and JSON schemas remain identical.","If you already migrated to the 1.20.5 item model and CustomModelData object formats, no further changes are required."],"official_changelog_url":null,"generated_at":"2025-12-13T18:20:31.664+00:00"},{"version":"1.20.5","project":"paper","summary":"Paper 1.20.5 is a major technical update over 1.20.4, driven by Mojang's item model system rewrite and data-driven item rendering. The update introduces breaking resource pack changes (new item model JSON format, CustomModelData overhaul, model path restructuring), new entities and items (Armadillo, Wolf Armor), updated data/pack formats, and corresponding API exposure in Paper for accessing the new item components and model data.","breaking_changes":["Item model system rewritten: resource packs using legacy item model overrides will no longer work.","CustomModelData changed from a single integer to a structured object; plugins relying on integer-only CustomModelData must be updated.","Resource pack directory structure for models has changed; old paths like models/item/*.json are no longer valid for most items.","Data pack pack_format bumped; older data packs will not load without updating.","Several internal item identifiers and rendering behaviors changed, affecting plugins that depend on client-side model assumptions."],"new_features":["New Armadillo mob and Armadillo-related drops.","New Wolf Armor item with dyeable variants.","New data-driven item model system allowing far more flexible item rendering without model overrides.","Expanded item component system used internally for rendering and behavior.","Paper exposes access to new item data/components aligned with Mojang's 1.20.5 changes."],"bug_fixes":["Numerous client/server desync issues fixed related to item rendering and equipment.","Fixed several edge cases where item metadata was not correctly synchronized to clients.","General stability and performance fixes inherited from upstream Minecraft 1.20.5."],"api_changes":["CustomModelData API updated to support the new structured format instead of a single int.","ItemMeta implementations updated to reflect new item component-backed data.","Some deprecated item-related APIs may behave differently due to the new model system; testing is required.","Paper continues to track Mojang mappings changes introduced in 1.20.5; plugin recompilation is required."],"resource_format_changes":["pack_format changes:\n  - Resource packs: pack_format increased (1.20.5 requires the new pack_format introduced with the item model rewrite).\n  - Data packs: pack_format increased; older formats will be rejected.","Item model directory restructure:\n  - OLD: assets/<namespace>/models/item/<item>.json\n  - NEW: assets/<namespace>/items/<item>.json","Item model format rewrite:\n  - OLD (1.20.4):\n    {\n      \"parent\": \"item/generated\",\n      \"textures\": { \"layer0\": \"minecraft:item/example\" },\n      \"overrides\": [ { \"predicate\": { \"custom_model_data\": 1 }, \"model\": \"item/example_alt\" } ]\n    }\n  - NEW (1.20.5):\n    {\n      \"model\": {\n        \"type\": \"minecraft:model\",\n        \"model\": \"minecraft:item/example\"\n      }\n    }\n  - The \"overrides\" section is REMOVED entirely.","CustomModelData format change:\n  - OLD: \"CustomModelData\": 123\n  - NEW:\n    \"CustomModelData\": {\n      \"floats\": [1.0],\n      \"flags\": [true],\n      \"strings\": [\"example\"],\n      \"colors\": [16711680]\n    }","Model redirect behavior changed:\n  - Block item redirects via models/item/*.json are no longer supported.","Texture paths remain under assets/<namespace>/textures/, but must be referenced via the new item model JSON.","Sound and equipment-related models may reference new paths introduced alongside Wolf Armor."],"developer_notes":["ALL plugins that manipulate CustomModelData must be updated to the new object-based format.","If your plugin depends on resource pack model overrides, you must migrate to the new items/*.json system.","Test client-side rendering thoroughly; many visual assumptions from 1.20.4 are no longer valid.","Expect third-party libraries that generate resource packs or item models to require updates.","Recompile against Paper 1.20.5 and review item/meta-related code carefully, as subtle behavior changes are common."],"official_changelog_url":null,"generated_at":"2025-12-13T18:21:17.691+00:00"},{"version":"1.20.4","project":"paper","summary":"Paper 1.20.4 is a minor update over 1.20.3 focused almost entirely on upstream Minecraft bug fixes and stability improvements. There are no significant gameplay, API, or resource format changes. Most servers and plugins can update without modification.","breaking_changes":[],"new_features":[],"bug_fixes":["Upstream Minecraft 1.20.4 bug fixes (client/server stability and edge-case behavior fixes).","Various Paper internal fixes improving server stability and performance consistency."],"api_changes":[],"resource_format_changes":["No resource pack or data pack format changes.","pack_format remains unchanged from 1.20.3 (pack_format: 18 for both resource packs and data packs).","No JSON field additions, removals, or renames in block, item, model, or loot table formats.","No texture path, model path, or directory structure changes.","No CustomModelData format changes."],"developer_notes":["This is a safe update for most plugins; recompilation is generally not required unless targeting exact server versions.","Protocol and internal bug fixes may subtly affect plugins relying on undefined or edge-case behavior.","If using NMS (net.minecraft.server) or Mojang-mapped internals, verify mappings against 1.20.4 due to minor upstream changes.","Recommended update for security and stability even though no major API changes are present."],"official_changelog_url":null,"generated_at":"2025-12-13T18:22:15.201+00:00"},{"version":"1.20.3","project":"paper","summary":"Paper 1.20.3 updates the server to Minecraft 1.20.3, bringing the new resource pack format (pack_format 18) and the major item model system overhaul from Mojang. Plugin and mod developers need to pay close attention to resource pack changes (especially item models), as legacy override-based models are no longer supported. Most gameplay-facing changes are minor, but resource and client-facing integrations require updates.","breaking_changes":["Resource packs using legacy item model overrides (\"overrides\" in item model JSON) no longer work and must be migrated to the new item model format introduced in 1.20.3.","Resource packs must be updated to pack_format 18; older pack formats will be rejected by clients.","Plugins that programmatically generate or reference item model JSON files may break due to the new item model schema and file expectations."],"new_features":["Support for Minecraft 1.20.3 resource and data pack formats.","New item model definition system allowing more flexible, data-driven item visuals without override predicates.","General Paper performance and stability improvements inherited from upstream."],"bug_fixes":["Multiple upstream vanilla bug fixes included from Minecraft 1.20.3.","Paper-specific fixes for entity ticking, chunk loading edge cases, and concurrency safety (see Paper commit log for exact fixes)."],"api_changes":["Paper API updated to target Minecraft 1.20.3 and the corresponding Spigot API.","Minor nullability and contract clarifications across the API (no widespread signature changes reported).","Adventure library versions updated; plugins shading or relying on specific Adventure internals should recheck compatibility."],"resource_format_changes":["pack_format updated:\n  - Resource packs: 18 (was 15 in 1.20.2)\n  - Data packs: 15 (unchanged from late 1.20.x, but required for 1.20.3 compatibility)","Item model system overhaul:\n  - OLD: assets/<namespace>/models/item/<item>.json using \"parent\" + \"textures\" and optional \"overrides\" with predicates\n  - NEW: assets/<namespace>/models/item/<item>.json uses the new item model definition format (\"model\": { ... })\n  - The \"overrides\" array is no longer supported for item models.","Predicate-based item model overrides removed:\n  - Fields such as \"overrides\", \"predicate\", and \"custom_model_data\" inside model overrides are no longer valid in item model JSON.","Model referencing changes:\n  - Item models now reference model definitions directly rather than redirecting through block-style parents.","No change to CustomModelData NBT format in 1.20.3:\n  - CustomModelData remains an integer NBT value on the ItemStack.\n  - Visual handling must now be implemented via the new item model system instead of JSON overrides."],"developer_notes":["If your plugin relies on CustomModelData for custom items, you must update your resource pack to the new item model system; server-side code usually does not need changes, but client assets do.","Test all resource packs with a 1.20.3 client before release—packs that load on 1.20.2 may silently fail or render items incorrectly.","Plugins that ship or generate resource packs should gate pack_format by Minecraft version and emit different item model JSON for <=1.20.2 and >=1.20.3.","Review Paper’s GitHub changelog for 1.20.3 builds if you rely on low-level internals (NMS, unsafe access, or performance-sensitive hooks)."],"official_changelog_url":null,"generated_at":"2025-12-13T18:23:06.353+00:00"},{"version":"1.20.2","project":"paper","summary":"Paper 1.20.2 updates the server to Minecraft 1.20.2, bringing protocol updates, minor gameplay adjustments, and internal changes inherited from Mojang and Paper. Most plugins will continue to work without modification, but any plugin relying on NMS, protocol internals, or version-specific assumptions must be updated and recompiled.","breaking_changes":["Minecraft protocol version updated to 1.20.2; clients and proxies must match this version","All NMS (net.minecraft.server) and CraftBukkit internals changed due to the 1.20.2 update; plugins using NMS or reflection must be recompiled and may require code changes","Version-specific checks hardcoded for 1.20.1 may fail; update version guards and mappings"],"new_features":["Updated to Minecraft 1.20.2 gameplay and engine changes","Paper performance and stability improvements inherited from upstream patches"],"bug_fixes":["Multiple vanilla bug fixes from Minecraft 1.20.2","Paper-specific fixes for edge cases, crashes, and performance regressions present in earlier 1.20.x builds"],"api_changes":["Bukkit/Spigot/Paper API version bumped to 1.20.2","Minor API additions and behavior adjustments inherited from upstream (no major new high-level APIs)","Internal timing, entity, and networking behavior may differ slightly due to Mojang fixes"],"resource_format_changes":[],"developer_notes":["Recompile all plugins against the Paper 1.20.2 API","If using NMS, update mappings and imports to the 1.20.2 server internals","Test protocol-sensitive plugins (scoreboards, packets, proxies, custom networking) thoroughly","No data pack or resource pack format changes are required when updating from 1.20.1 to 1.20.2"],"official_changelog_url":null,"generated_at":"2025-12-13T18:23:58.746+00:00"},{"version":"1.20.1","project":"paper","summary":"Paper 1.20.1 is a minor, stability-focused update over 1.20, aligning with Minecraft 1.20.1. It primarily contains bug fixes and small internal/API adjustments with no gameplay, resource pack, or data pack format changes. Most plugins targeting Paper/Spigot 1.20 should continue to work without modification.","breaking_changes":[],"new_features":[],"bug_fixes":["Fixed upstream Minecraft 1.20.1 bugs related to server stability and performance.","Resolved several Paper-specific edge cases around entity tracking and chunk ticking inherited from 1.20."],"api_changes":["Minor Paper API internal adjustments to match Minecraft 1.20.1 mappings (no functional API removals).","Updated Mojang mappings and deobfuscation layer; plugins using NMS must recompile against 1.20.1."],"resource_format_changes":[],"developer_notes":["Minecraft version updated from 1.20 to 1.20.1; plugins using NMS (net.minecraft.*) must update imports and rebuild.","No pack_format change for resource packs or data packs (remains pack_format: 15).","Binary compatibility is not guaranteed for plugins using CraftBukkit, Paper internals, or reflection.","Recommended to recompile plugins against the Paper 1.20.1 API even if no errors are observed on startup."],"official_changelog_url":null,"generated_at":"2025-12-13T18:24:29.772+00:00"},{"version":"1.20","project":"paper","summary":"Paper 1.20 updates the server to Minecraft 1.20 (Trails & Tales), introducing archaeology, armor trims, new biomes, mobs, blocks, items, and multiple API additions relevant to plugins interacting with items, sounds, world generation, and entities. Most changes are additive, but resource/data packs must be updated to the new pack_format and plugins should review new enums, materials, sounds, and worldgen-related behavior.","breaking_changes":["Resource packs and data packs must be updated to pack_format 15 (previously 12 in 1.19.4). Older packs will no longer load.","Plugins using hard-coded Material, Sound, or EntityType enum ordinals may break due to new entries added in 1.20.","World generation–dependent plugins may see changed biome distribution due to the addition of Cherry Grove biome."],"new_features":["Archaeology system: Suspicious Sand and Suspicious Gravel blocks with brushing mechanics.","Armor Trim system allowing cosmetic upgrades using smithing templates.","Cherry Grove biome with new blocks, particles, and ambient sounds.","New mobs: Sniffer and Camel.","New blocks and items including Bamboo block set, Chiseled Bookshelf, Decorated Pot, Hanging Signs, Calibrated Sculk Sensor, Torchflower, and Pitcher Plant."],"bug_fixes":["Numerous upstream Mojang bug fixes related to entity AI, block interactions, and redstone behavior.","Paper-specific performance and stability fixes carried over and improved for 1.20.","Fixes for item desync and chunk ticking edge cases present in some 1.19.4 servers."],"api_changes":["New Material enum values for all 1.20 blocks and items (e.g., CHERRY_LOG, BAMBOO_PLANKS, SNIFFER_EGG, ARMOR_TRIM_SMITHING_TEMPLATE).","New Sound enum entries for cherry grove ambience, archaeology brushing, and new mobs.","New EntityType values: SNIFFER and CAMEL.","Bukkit/Paper APIs updated to expose new biome (CHERRY_GROVE) and trim-related item metadata.","Paper continues to align with Adventure API updates bundled with 1.20; recompile plugins against the 1.20 API."],"resource_format_changes":["pack_format updated from 12 → 15 for both resource packs (assets) and data packs.","New armor trim assets added under: assets/minecraft/textures/trims/ (including subdirectories for materials and patterns).","New smithing template item models and textures added under: assets/minecraft/models/item/ and assets/minecraft/textures/item/.","New hanging sign models and textures added under: assets/minecraft/models/block/ and assets/minecraft/textures/block/ (separate from legacy sign models).","Decorated Pot textures and models added under: assets/minecraft/textures/block/decorated_pot_* and corresponding models.","New sounds.json entries and sound files for archaeology, cherry grove ambience, sniffer, and camel."],"developer_notes":["Recompile all plugins against Paper 1.20; do not rely on binary compatibility with 1.19.4.","Avoid using enum ordinals for Material, Sound, Biome, or EntityType; always reference by name.","Plugins that manipulate items via NBT should account for new smithing template and armor trim data stored on items.","Worldgen or biome-filtering plugins should explicitly handle the CHERRY_GROVE biome to avoid unintended behavior.","Test resource packs and data packs thoroughly after updating pack_format to 15."],"official_changelog_url":null,"generated_at":"2025-12-13T18:24:59.636+00:00"}],"total":22}