Skip to tool content
Toolioz logoToolioz

Minecraft Circle and Sphere Generator

A Minecraft circle generator maps each block whose center lies inside the chosen diameter. The same distance test in three axes builds a sphere. The math is pixel geometry and does not change when Minecraft receives a patch.

Quick Summary & Direct Answer
Minecraft

How does a Minecraft circle generator work?

A Minecraft circle generator includes a block when the distance from the origin to that block's center is at most half the diameter. Hollow circles keep an outer ring. Spheres apply the same test on X, Y, and Z and are shown one layer at a time.

Key Takeaways

  • Diameter is width in blocks. Radius used by WorldEdit is half of that diameter.
  • Odd diameters center on one block. Even diameters center between four blocks.
  • Thickness is ignored when the shape is filled.
  • Java and Bedrock use the same block grid, so the map matches both editions.

WorldEdit uses radius. A diameter 16 circle is //hcyl ~ 8 after picking a center. WorldEdit generation docs.

Blocks in circle

52

This layer52
Diameter16
CenterBetween 4 blocks

Frequently asked questions

Each block is included when the distance from the circle center to the center of that block is at most half the diameter. Hollow rings keep only the outer thickness. The test does not change with Minecraft patches.

Publisher notes · reviewed 29 October 2026

How this Minecraft circle generator decides which blocks to place

The map is a pixel disk on a block grid. A block is included when the distance from the circle origin to that block’s center is at most half the entered diameter. Hollow rings subtract an inner disk of radius diameter/2 minus thickness. The same test in three axes builds a sphere. Nothing here reads Minecraft version data.

Diameter, not radius

Builders usually talk in width. Diameter 16 is a 16-block-wide ring. WorldEdit //sphere and //hsphere take a radius, which is half that diameter. An odd diameter sits on one center block, drawn gold. An even diameter sits between four blocks, which is why some circles look slightly flattened on one axis at small sizes.

Filled mode keeps every block whose center is inside the radius. Thickness is ignored then. A thickness of 1 on a hollow circle is the usual wall. Thickness 2 is a walkable ring for a pixel-art track.

Spheres as stacked circles

Each Y layer of a sphere is itself a circle whose radius shrinks toward the poles. The layer control shows that slice so a dome can be built floor by floor in survival. Block count is the full 3D set, not the visible layer. Java and Bedrock share the same integer block grid, so the map matches both editions.

Worked examples

  • Diameter 1 and 3

    Diameter 1 is a single block. Diameter 3 filled is a 3×3 square because every block center is within 1.5 of the origin. Hollow thickness 1 at diameter 3 is the eight-block ring around the center.

  • WorldEdit radius

    A diameter-20 sphere on this page corresponds to //sphere <block> 10 at the same center. The generator does not run WorldEdit; it only prints the matching radius.

Limits of this page

  • Ellipses, ovals, and rotated circles are not generated.
  • Sphere diameter is capped at 64 blocks so the layer map stays usable in the browser.
  • Setblock command dumps are not emitted; copy coordinates or ASCII instead.

Sources