Geometry

Auto-generated from src/stdlib/geometry.mcrs — do not edit manually.

API

• midpoint
• aabb_contains
• sphere_contains
• cylinder_contains
• parabola_y
• parabola_x
• parabola_land_t
• tile_of
• tile_center
• angle_normalize
• angle_diff
• mc_day_angle
• in_cylinder
• in_cone
• in_sector_2d

---

midpoint v1.0.0

Compute the integer midpoint of two coordinates.

fn midpoint(a: int, b: int): int

Parameters

Parameter	Description
a	First coordinate (any unit)
b	Second coordinate (any unit)

Returns: (a + b) / 2 (integer truncation)

Example

let m: int = midpoint(100, 300)  // result: 200

---

aabb_contains v1.0.0

Test whether a 3D point is inside an axis-aligned bounding box (AABB).

fn aabb_contains(px: int, py: int, pz: int, minx: int, miny: int, minz: int, maxx: int, maxy: int, maxz: int): int

Parameters

Parameter	Description
px	Point X coordinate
py	Point Y coordinate
pz	Point Z coordinate
minx	AABB minimum X (inclusive)
miny	AABB minimum Y (inclusive)
minz	AABB minimum Z (inclusive)
maxx	AABB maximum X (inclusive)
maxy	AABB maximum Y (inclusive)
maxz	AABB maximum Z (inclusive)

Returns: 1 if point is inside or on the boundary of the AABB, 0 otherwise

Example

let inside: int = aabb_contains(50, 64, 50, 0, 60, 0, 100, 70, 100)

---

sphere_contains v1.0.0

Test whether a 3D point is inside a sphere (using squared distance, avoids sqrt).

fn sphere_contains(px: int, py: int, pz: int, cx: int, cy: int, cz: int, r: int): int

Parameters

Parameter	Description
px	Point X
py	Point Y
pz	Point Z
cx	Sphere center X
cy	Sphere center Y
cz	Sphere center Z
r	Sphere radius (same unit as coordinates)

Returns: 1 if point is within the sphere, 0 otherwise

Example

let hit: int = sphere_contains(10, 64, 10, 0, 64, 0, 15)

---

cylinder_contains v1.0.0

Test whether a 2D point (XZ plane) is inside a vertical cylinder (ignores Y).

fn cylinder_contains(px: int, pz: int, cx: int, cz: int, r: int): int

Parameters

Parameter	Description
px	Point X
pz	Point Z
cx	Cylinder center X
cz	Cylinder center Z
r	Cylinder radius

Returns: 1 if (px, pz) is within the cylinder's cross-section, 0 otherwise

Example

let in_zone: int = cylinder_contains(5, 5, 0, 0, 8)

---

parabola_y v1.0.0

Compute Y position of a projectile along a parabolic arc at tick t.

fn parabola_y(y0: int, vy0: int, t: int): int

Parameters

Parameter	Description
y0	Initial Y ×100
vy0	Initial Y velocity ×100 (blocks/tick × 100)
t	Tick index

Returns: y0 + vy0t - 5t²/2 (gravity = 5 units/tick² = 0.05 blocks/tick²×100)

Example

let y: int = parabola_y(6400, 100, 10)  // at tick 10, v0=1 block/tick

---

parabola_x v1.0.0

Compute horizontal X position along a parabolic path (constant velocity).

fn parabola_x(x0: int, vx0: int, t: int): int

Parameters

Parameter	Description
x0	Initial X ×100
vx0	Horizontal X velocity ×100
t	Tick index

Returns: x0 + vx0*t

Example

let x: int = parabola_x(0, 50, 10)  // 0 + 50*10 = 500

---

parabola_land_t v1.0.0

Estimate the tick when a projectile launched upward returns to Y=0.

fn parabola_land_t(vy0: int): int

Parameters

Parameter	Description
vy0	Initial upward Y velocity ×100

Returns: Approximate landing tick: 2 * vy0 / 5

Example

let land: int = parabola_land_t(100)  // tick when projectile lands

---

tile_of v1.0.0

Compute which tile a coordinate falls in (floor division, handles negatives).

fn tile_of(coord: int, tile_size: int): int

Parameters

Parameter	Description
coord	Coordinate value (any unit)
tile_size	Size of each tile in the same unit

Returns: Floor-divided tile index (correct for negative coordinates)

Example

let tile: int = tile_of(250, 100)  // result: 2 (tile index 2)

---

tile_center v1.0.0

Compute the center coordinate of a tile.

fn tile_center(tile: int, tile_size: int): int

Parameters

Parameter	Description
tile	Tile index
tile_size	Size of each tile

Returns: tile * tile_size + tile_size / 2

Example

let c: int = tile_center(2, 100)  // result: 250 (center of tile 2)

---

angle_normalize v1.0.0

Normalize an angle (degrees ×10000) to the range [0, 3600000).

fn angle_normalize(deg: int): int

Parameters

Parameter	Description
deg	Angle in degrees ×10000 (may be negative or >= 360°)

Returns: Equivalent angle in [0, 3600000)

Example

let a: int = angle_normalize(-900000)  // result: 2700000 (270°)

---

angle_diff v1.0.0

Compute the signed shortest angular difference between two angles (degrees ×10000).

fn angle_diff(a: int, b: int): int

Parameters

Parameter	Description
a	Starting angle ×10000
b	Target angle ×10000

Returns: Signed difference in (-1800000, 1800000] (shortest arc b - a)

Example

let diff: int = angle_diff(3500000, 100000)  // ≈ -3400000 → wraps to short arc

---

mc_day_angle v1.0.0

Convert Minecraft daytime ticks to sun angle in degrees ×10000.

fn mc_day_angle(daytime: int): int

Parameters

Parameter	Description
daytime	/time query daytime value (0-23999; 0=dawn, 6000=noon)

Returns: Sun angle in [0, 3600000) degrees ×10000

Example

let sun: int = mc_day_angle(6000)  // noon → 1800000 (180°)

---

in_cylinder v1.0.0

Test whether a point is inside a vertical cylinder (XZ circle with Y bounds).

fn in_cylinder(px: int, py: int, pz: int, cx: int, cz: int, radius: int, y_lo: int, y_hi: int): int

Parameters

Parameter	Description
px	Point X ×10000
py	Point Y ×10000
pz	Point Z ×10000
cx	Cylinder center X ×10000
cz	Cylinder center Z ×10000
radius	Cylinder radius ×10000 (keep ≤ 46340 to avoid overflow)
y_lo	Y lower bound ×10000 (inclusive)
y_hi	Y upper bound ×10000 (inclusive)

Returns: 1 if point is inside the cylinder, 0 otherwise

Example

let hit: int = in_cylinder(100000, 640000, 100000, 0, 0, 80000, 600000, 800000)

---

in_cone v1.0.0

Test whether a point is inside an upright cone (axis along +Y or -Y from apex).

fn in_cone(px: int, py: int, pz: int, apex_x: int, apex_y: int, apex_z: int, dir_y: int, half_angle_tan: int, height: int): int

Parameters

Parameter	Description
px	Point X ×10000
py	Point Y ×10000
pz	Point Z ×10000
apex_x	Cone apex X ×10000
apex_y	Cone apex Y ×10000
apex_z	Cone apex Z ×10000
dir_y	Cone direction: positive = upward, negative = downward
half_angle_tan	tan(half-angle) ×10000 (45° = 10000, 30° = 5773)
height	Cone height ×10000

Returns: 1 if point is inside the cone, 0 otherwise

Example

let hit: int = in_cone(px, py, pz, apex_x, apex_y, apex_z, 1, 10000, 50000)

---

in_sector_2d v1.0.0

Test whether a 2D point is inside a sector (pie-slice) in the XZ plane.

fn in_sector_2d(px: int, pz: int, cx: int, cz: int, dir_angle: int, half_angle: int, radius: int): int

Parameters

Parameter	Description
px	Point X ×10000
pz	Point Z ×10000
cx	Sector center X ×10000
cz	Sector center Z ×10000
dir_angle	Sector center direction in ×10000 radians (0 = +X, 628318 = 2π)
half_angle	Half-width of sector in ×10000 radians
radius	Maximum radius (same units as px, pz)

Returns: 1 if point is within the sector, 0 otherwise

Example

let hit: int = in_sector_2d(px, pz, 0, 0, 0, 157079, 100000)  // quarter-circle facing +X

---