Minecraft Circle Generator

A precise rule for an approximate curve

The center coordinate is (d − 1)/2 and the geometric radius is d/2. A block is included in the filled disk when its center satisfies (x − c)² + (z − c)² ≤ (d/2)². This rule is reproducible for both odd and even diameters.

Outline keeps an included block if at least one of its four side neighbors lies outside the disk. Ring excludes centers at or inside the inner radius only while that radius is positive. At inner radius zero it includes the whole disk, including an odd center block. Increasing thickness does not modify Outline.

Minecraft’s official coordinate documentation distinguishes world-relative coordinates from coordinates relative to the direction you face. Here rows advance along positive Z and columns along positive X. Rotating your view does not rotate the exported pattern.

From row segments to safe commands

The /fill command, described in the official fill-command reference, fills a region between two positions. A horizontal segment can therefore be represented by one command with matching Y and Z values, rather than one command per block.

The row table numbers columns from 1 for reading, while command offsets start at 0. Row 1 with X 2–4 becomes offsets ~1 through ~3 at Z ~. Stand at the intended north-west origin and do not move between relative commands; a command block uses its own execution origin.

These files are plans, not automatic world edits. Commands require appropriate permissions, and block identifiers or command rules can differ by edition and version. Test on a copy because fill replaces existing blocks. ClockTools is an independent utility, not an official Minecraft product.

Choose the footprint, not just a radius

Diameter means outer width in blocks, from 3 to 121, not the radius or circumference. Numeric changes are rounded to a whole number. Odd and even sizes use different center placement, so changing 31 to 32 is not simply adding a border around the same central block. Establish a bounding square and its north-west origin before building; retain the same orientation for every row.

Filled selects the disk, Outline keeps a four-neighbor boundary and Ring applies an inner-radius rule. Thickness only affects Ring and is clamped to 1–ceil(d/2). When the inner radius reaches zero the engine returns the filled disk, including an odd center block. Material changes preview color and exported identifiers, not geometry. Grid and Center Axes are guides, not additional blocks; at large diameters the preview omits fine grid lines to remain readable.

Build an entire small example from inclusive ranges

For Filled diameter 5, rows from north to south have widths 3,5,5,5,3, totaling 21. Row 1 occupies one-based X 2–4; rows 2–4 occupy 1–5; row 5 repeats 2–4. Start each row from the same left edge rather than from the previous row’s first selected block. Both endpoints count, so 2–4 means three blocks.

For Filled diameter 6, widths are 4,6,6,6,6,4, totaling 32, with center between four blocks. A hollow row can have two disjoint ranges: place both and leave the middle gap empty. Check the row count and left/right symmetry after laying the first half. The table and text map describe the exact selected cells, which is more useful than estimating a curved edge by eye.

Count materials and keep the right reference

The block count covers selected cells in one horizontal layer. Stack estimates use stacks of 64, not inventory-slot limits for every possible item. For 21 blocks you need less than one full stack; for repeated identical layers multiply the actual count, then separately account for entrances, foundations, lighting and waste. Ring thickness does not specify wall height, and no sphere or dome layers are generated.

Copy Rows gives readable ranges, Copy Map or a text download gives # for selected cells and . for gaps. Use monospace and preserve line breaks when viewing that map. PNG saves the current preview, including chosen guides and material appearance; if canvas fails, use rows or text. Share restores diameter, mode, effective thickness, material and guide choices, not a world, location or blocks already placed. Reset returns to diameter 31 and Outline.

Check the command origin before placing anything

The north-west first grid cell is offset X=0,Z=0, not the center. Row 1, X 2–4 becomes /fill ~1 ~ ~ ~3 ~ ~ minecraft:stone. The official axis reference identifies positive X as east and positive Z as south: columns run east, rows run south, on unchanged Y. Looking another direction does not rotate world-relative ~ offsets. Run the commands from the same location each time; a command block or other execution context has its own origin.

A command text file is not a function pack or automatic world import. It uses chat-style /fill segments, and destination syntax, permissions and material identifiers depend on edition/version. Test one segment in a disposable copy before a whole plan: fill can overwrite existing blocks and this page cannot undo that. An absolute-coordinate workflow requires your own careful conversion; no world coordinate selector is offered here.