Minecraft Circle Generator

Start here

How to use the Minecraft Circle Generator

1. Choose Circle or Ellipse.

   A circle keeps width and depth linked. An ellipse lets you set them independently for an oval footprint.

2. Enter the footprint size.

   Use whole numbers from 1 through 512. The default 15-block outline appears immediately, so there is no Generate button to find.

3. Select Outline or Filled.

   For an outline, choose a ring thickness from 1 to 8 blocks. If no inner space remains, the tool tells you that the plan is effectively solid.

4. Check the blueprint and material total.

   Each colored square is one block to place. The total is the number of occupied cells—not the mathematical circumference or area.

5. Open Build mode.

   Follow the highlighted row, mark individual blocks or the entire row complete, and move forward or back without losing earlier work.

6. Save or export the plan.

   Your current project autosaves in this browser. Export Project JSON for a portable backup, or download PNG, JPG, SVG, and CSV versions.

Circle vs. ellipse: which shape should you choose?

Choose a circle when the north–south depth should equal the east–west width. Choose an ellipse when those dimensions should differ. The ellipse control is useful for oval arenas, long courtyards, racetracks, pools, foundations, and other stretched footprints.

The corrected ellipse raster uses separate half-cell-aware radii for width and depth. That prevents a tall ellipse from being treated like a stretched circle after generation and creates smoother mirrored poles at both ends.

Odd and even Minecraft circle centers

The footprint center in block-index notation is:

((width - 1) / 2, (depth - 1) / 2)

An odd dimension has a center on one block index. A 15×15 footprint centers on column 7, row 7 when counting from zero. An even dimension has a center between indices: a 16×16 footprint centers on 7.5, 7.5.

A half-integer center does not create half blocks or decimal world coordinates. It only describes the symmetry point between the middle rows or columns. Every generated cell and every coordinate instruction still uses integers.

Outline circles, filled circles, and ring thickness

A filled plan contains every occupied block cell inside the rasterized footprint. An outline plan starts with that filled mask and removes inner layers. This makes the outline a true subset of the matching filled plan.

Ring thickness is measured in block layers, not in mathematical units. For each thickness step, the engine removes cells that have occupied neighbors on all four faces. The visible ring is what remains after one to eight erosion passes.

• Increasing thickness keeps every block from the thinner ring.
• A one-block-wide axis is handled deliberately as a line.
• If the inner mask is exhausted, the outline becomes the filled footprint and the interface displays a notice.
• Thin stair-step curves may touch diagonally. Eight-direction connectivity is validated, but every outline is not promised to be face-connected.

How to read the block blueprint and Build Sheet

North is at the top of the canvas and east is on the right. Each occupied cell corresponds to one block index. Grid lines, center guides, the orange northwest-origin crosshair, the selected-cell outline, current-row highlight, and completed pattern make different states readable without relying only on color.

A real 15×15 outline example

With the current geometry version, a 15×15 one-block outline contains 40 placed blocks. Its first four rows are:

Those gaps matter. The Build Sheet creates separate contiguous runs and never converts an outline row into one filled span. A 16×16 one-block outline uses the same convention and contains 44 placed blocks.

Resuming a larger build

Build mode is a manual checklist intended for a phone or second screen. Select any occupied block to toggle it, or mark the highlighted row complete. Previous, Next, Undo, and Redo let you revisit work. Changing the selected row does not mark the old row complete, and dragging in Pan mode does not complete cells.

Completion is not live detection. GamerCubic does not connect to your world, server, save file, or account.

Using world coordinates with the circle plan

Open Advanced: world coordinates when you want the Build Sheet to map grid cells to Minecraft coordinates. Enter the northwest grid-corner block as the origin. That corner can be empty for a curved outline; it still anchors the rectangular footprint.

worldX = originX + column
worldY = originY
worldZ = originZ + row

The first release places the plan horizontally on the X/Z plane at one fixed Y level. +X points east and +Z points south. Negative origins work normally.

Coordinate example

If the origin is X=100, Y=64, Z=-112, a run on grid row 3 from columns 1 through 5 becomes:

At Y=64, Z=-109, place blocks from X=101 through X=105.

The selected-cell readout also shows its grid index and, when enabled, its integer world X/Y/Z location. Coordinates are excluded from normal share links unless you explicitly choose to include them.

Choosing a useful circle or oval size

There is no universally correct size. Start with the footprint required by your build, then check the blueprint’s proportions before gathering materials. The presets are shortcuts, not recommendations for specific structures.

Block counts, stacks, and gathering materials

The displayed total is the exact number of occupied cells in the current generated mask. The tool also divides that total into full stacks of 64 plus remaining blocks. This conversion assumes you are using building blocks that stack to 64; it does not assert that every Minecraft item has that stack size.

Changing the width, depth, fill style, or thickness changes the mask and may change the material count substantially. Counts, row runs, completed totals, remaining totals, and exports all read from the same cell collection, so there is no separate circumference estimate behind the interface.

Java Edition and Bedrock Edition use

The generator is edition-neutral because it produces a manual block footprint rather than version-specific commands. You can follow the same row plan in Java Edition or Bedrock Edition as long as you can place blocks on the chosen horizontal layer.

This release does not create WorldEdit commands, terrain, wall height, spheres, domes, or structure files. If you want a vertical wall, use the generated footprint as the base and decide the height inside your build. The block count shown here covers only the one-layer plan.

Saving projects, exports, and privacy

Named projects are stored with IndexedDB in the current browser. They include dimensions, shape, fill style, thickness, optional origin, geometry version, completed cells, current row, and relevant view settings. There is no GamerCubic account or cloud synchronization.

Saved in this browser. Export your project to back it up or move devices.

• PNG or JPG: a bounded blueprint image, with a white-background option.
• SVG: a scalable plan derived from the same occupied cells.
• CSV: row runs, grid indices, counts, and optional coordinate ranges.
• Print / Save as PDF: a browser print layout with readable row instructions.
• Project JSON: a versioned backup containing project settings and progress.
• Design link: validated shape parameters without the project name or completed-cell list.

Geometry, counts, instructions, and exports run locally without an external generation API or AI request. If browser storage is unavailable, the interface labels the project as an unsaved session and keeps JSON export available.

Transparent method

Accuracy, rasterization, and known limits

Minecraft circles are block-grid approximations. A mathematical circle contains infinitely many curve points, while a build plan must choose a finite set of square cells. Two tools can therefore produce different but symmetric and usable results.

Geometry version gc-ellipse-half-cell-v2 uses the footprint center ((W−1)/2,(H−1)/2) and half-cell-aware radii W/2 and H/2. An integer cell index belongs to the filled plan when its normalized ellipse value is at most one. This convention explicitly supports odd sizes, even sizes, rectangles, 1×N lines, and two-block cases.

Automated checks cover exact bounds, unique cells, horizontal and vertical symmetry, quarter-turn circle symmetry, eight-neighbor connectivity, thickness monotonicity, outline-subset behavior, row-run totals, negative world origins, project round trips, hostile inputs, and dimensions through 512. These checks establish internal consistency; they do not make one raster convention uniquely correct for every builder’s visual preference.