Polyfit 3D

Polyfit 3D is a real-time polycube puzzle race for 2 to 8 seats, every seat answering at once: the board game Ubongo 3D's idea, built in layers. Options: rounds 3-9 (6 by default); difficulty easy, normal, hard or extreme (normal by default); layers 2-4, the height of every puzzle (2 by default); round_seconds 10-30 (30 by default), the answer window of a round; players 2-8 (2 by default).

Every round each seat gets the same puzzle, cut from the set's seed. body.puzzle.region is the solid to fill: one list of row strings per layer, the bottom layer first, # a cube to fill and . not; every layer has the same footprint, so the solid is the footprint stacked layers high. body.puzzle.pieces lists {"id", "name", "cells"}, each cell [layer, row, col] from 0, the piece as the tray shows it. Pieces are polycubes of 3 to 5 cubes; the pieces fill the solid exactly, so every puzzle has a solution. Puzzles grow harder with the round: easy uses 3 to 5 pieces of 3 and 4 cubes, normal 4 to 7 of 4 and 5 cubes, hard 7 to 11 pieces, mostly of 5 cubes, extreme 16 to 28 pieces of 4 and 5 cubes with shapes repeated. Identical pieces have their own ids and are interchangeable.

A move is {"round": r, "placements": [{"piece": id, "cells": [[layer, row, col], ...]}, ...]} using every piece exactly once, or {"round": r, "pass": true}, where r is body.round. A placement lists the cubes the piece fills. They must be the piece's own shape turned any of the 24 ways a solid can turn, then moved: never its mirror image (a mirror-image pair such as H4L and H4R are two different pieces). A solution that does not fill the region exactly is an illegal move whose detail starts with the reason: missing_piece, duplicate_piece, unknown_piece (an id the puzzle lacks), wrong_shape (the cubes are not the piece turned), mirrored (they are its mirror image), outside_board, outside_region, overlap or uncovered (a move naming another round: wrong_round). It is rejected, your clock keeps running, and you may try again.

Round 1 opens when the game starts and every later round the moment the one before closes. A round's window is round_seconds from its opening (body.opened_ms; match.environment.t_ms is the server time now): an answer after it is accepted as late, unchecked, and scores nothing. Your answer takes you off move until the round closes; until then nobody else sees whether you solved or passed, only that you answered (body.done). The round closes when every seat still playing has answered or run out of clock; body.history then lists every round with its answers, times and gems.

Solvers rank by the order their solutions were accepted. Each round has a gem row, body.gem_row, of players + 3 gems in four colours (ruby, amber, jade, sapphire): the 1st solver takes the first 3 gems, the 2nd the next 2 and every later solver the next 1. A seat that passes, is late or does not solve takes nothing. body.gems counts each seat's gems by colour.

After the last round the most gems wins (reason most_gems). Equal totals go to the most gems of one colour (most_of_one_colour), then to the least total time (least_time: a solved round counts its solving time, any other round the whole window). Seats equal on all three share the place (reason tie; a draw with two seats).

A seat that runs out of clock is out: it plays no more rounds, keeps its gems and ranks below every seat still playing. When fewer than two seats are still playing the open round closes and the game ends (reason timeout), so with two seats a timeout loses. At a table of more than two a seat that misses its first move or resigns forfeits (body.forfeited): it ranks last and the others play on. Your clock is a bank for the whole game that runs only while you are on move: at least rounds x (round_seconds + 5) + 5 seconds (215 s by default, plus 1 s per answer), so a seat that answers within its windows never runs out.