[{"data":1,"prerenderedAt":173},["ShallowReactive",2],{"docs-\u002Fgetting-started\u002Fversioning":3},{"id":4,"title":5,"body":6,"description":163,"extension":164,"meta":165,"navTitle":166,"navigation":167,"path":168,"rawbody":169,"seo":170,"stem":171,"__hash__":172},"docs\u002Fgetting-started\u002Fversioning.md","Versioning",{"type":7,"value":8,"toc":157},"minimark",[9,13,18,22,33,68,78,96,124,128,143,149],[10,11,5],"h1",{"id":12},"versioning",[14,15,17],"h2",{"id":16},"artifact-coordinates-per-minecraft-version","Artifact coordinates per Minecraft version",[19,20,21],"p",{},"MagicUtils publishes one Maven version per supported Minecraft branch, so each\nbranch keeps its own metadata, Java level, and transitive dependencies. The\nversion is Fabric-style, with the Minecraft branch baked into the version string\nitself (not a Maven classifier):",[23,24,29],"pre",{"className":25,"code":27,"language":28},[26],"language-text","dev.ua.theroer:\u003Cmodule>:\u003Cbase>+\u003Cminecraft>\n","text",[30,31,27],"code",{"__ignoreMap":32},"",[34,35,36,47],"ul",{},[37,38,39,42,43,46],"li",{},[30,40,41],{},"\u003Cbase>"," is the MagicUtils version (for example ",[30,44,45],{},"1.27.1",").",[37,48,49,52,53,56,57,56,60,63,64,67],{},[30,50,51],{},"+\u003Cminecraft>"," is the library branch this build targets (for example\n",[30,54,55],{},"+1.20.1",", ",[30,58,59],{},"+1.21.10",[30,61,62],{},"+26.2","). It follows the target's ",[30,65,66],{},"library_minecraft",",\nwhich can differ from the runtime Minecraft version.",[19,69,70,71,74,75,77],{},"So the Bukkit module for Minecraft 1.20.x is\n",[30,72,73],{},"dev.ua.theroer:magicutils-bukkit:1.27.1+1.20.1",". A whole Minecraft branch\nshares one coordinate: everything in 1.20.x resolves the ",[30,76,55],{}," build, even a\nserver running 1.20.6.",[19,79,80,81,84,85,56,88,91,92,95],{},"The main jar has no classifier. Classifiers are reserved for genuinely different\njars of the same coordinate: ",[30,82,83],{},"all"," (shaded fat jar), ",[30,86,87],{},"dev",[30,89,90],{},"sources",", and\n",[30,93,94],{},"javadoc",".",[97,98,100],"callout",{"type":99},"tip",[19,101,102,103,106,107,110,111,113,114,116,117,119,120,123],{},"If you build with the MagicUtils ",[30,104,105],{},"consumer-*"," Gradle plugins you never write the\nsuffix by hand: pass the bare ",[30,108,109],{},"magicutils_version"," (",[30,112,45],{},") and the active\nbuild target appends ",[30,115,51],{},". The default branch is also published under\nthe bare ",[30,118,41],{}," version, which is why the quick-install snippets can show\n",[30,121,122],{},"magicutils-bukkit:1.27.1"," without a suffix.",[14,125,127],{"id":126},"documentation-versions","Documentation versions",[19,129,130,131,134,135,138,139,142],{},"The docs for the current MagicUtils release live at the site root. When a new\nminor line ships, the previous one is archived under a ",[30,132,133],{},"\u002Fv\u003Cminor>\u002F"," prefix (for\nexample ",[30,136,137],{},"\u002Fv1.21\u002F...",") and the version selector in the header switches between\nthem; the latest is always the default and archived versions are marked as such.\nOnly the current line (",[30,140,141],{},"1.22",") is published so far, so there are no archived\nversions yet.",[19,144,145,146,148],{},"The version numbers shown in examples (like ",[30,147,45],{},") track the active docs\nversion and are bumped in git automatically when a newer MagicUtils release is\npublished, so the docs always match a real release.",[19,150,151,152,95],{},"Archiving a version and bumping the docs is a maintainer task — see\n",[153,154,156],"a",{"href":155},"\u002Fcontributing#versioned-docs-maintainers","Contributing",{"title":32,"searchDepth":158,"depth":158,"links":159},3,[160,162],{"id":16,"depth":161,"text":17},2,{"id":126,"depth":161,"text":127},"How MagicUtils versions map to Minecraft releases, what the version number means, and how to pin an exact MagicUtils artifact version in your build.","md",{},null,true,"\u002Fgetting-started\u002Fversioning","---\ntitle: Versioning\ndescription: How MagicUtils versions map to Minecraft releases, what the version number means, and how to pin an exact MagicUtils artifact version in your build.\n---\n\n# Versioning\n\n## Artifact coordinates per Minecraft version\n\nMagicUtils publishes one Maven version per supported Minecraft branch, so each\nbranch keeps its own metadata, Java level, and transitive dependencies. The\nversion is Fabric-style, with the Minecraft branch baked into the version string\nitself (not a Maven classifier):\n\n```\ndev.ua.theroer:\u003Cmodule>:\u003Cbase>+\u003Cminecraft>\n```\n\n- `\u003Cbase>` is the MagicUtils version (for example `1.27.1`).\n- `+\u003Cminecraft>` is the library branch this build targets (for example\n  `+1.20.1`, `+1.21.10`, `+26.2`). It follows the target's `library_minecraft`,\n  which can differ from the runtime Minecraft version.\n\nSo the Bukkit module for Minecraft 1.20.x is\n`dev.ua.theroer:magicutils-bukkit:1.27.1+1.20.1`. A whole Minecraft branch\nshares one coordinate: everything in 1.20.x resolves the `+1.20.1` build, even a\nserver running 1.20.6.\n\nThe main jar has no classifier. Classifiers are reserved for genuinely different\njars of the same coordinate: `all` (shaded fat jar), `dev`, `sources`, and\n`javadoc`.\n\n::callout{type=\"tip\"}\nIf you build with the MagicUtils `consumer-*` Gradle plugins you never write the\nsuffix by hand: pass the bare `magicutils_version` (`1.27.1`) and the active\nbuild target appends `+\u003Cminecraft>`. The default branch is also published under\nthe bare `\u003Cbase>` version, which is why the quick-install snippets can show\n`magicutils-bukkit:1.27.1` without a suffix.\n::\n\n## Documentation versions\n\nThe docs for the current MagicUtils release live at the site root. When a new\nminor line ships, the previous one is archived under a `\u002Fv\u003Cminor>\u002F` prefix (for\nexample `\u002Fv1.21\u002F...`) and the version selector in the header switches between\nthem; the latest is always the default and archived versions are marked as such.\nOnly the current line (`1.22`) is published so far, so there are no archived\nversions yet.\n\nThe version numbers shown in examples (like `1.27.1`) track the active docs\nversion and are bumped in git automatically when a newer MagicUtils release is\npublished, so the docs always match a real release.\n\nArchiving a version and bumping the docs is a maintainer task — see\n[Contributing](\u002Fcontributing#versioned-docs-maintainers).\n",{"title":5,"description":163},"getting-started\u002Fversioning","zU2o2bdVlZtd6e4XHLz7XYvwFqv7SDIS22EdvePQoYA",1783944487254]