Hearthhold

A low-poly 3D colony-management RTS that runs in your browser, built with Three.js.
Grow a medieval settlement, manage wood / stone / food / gold, and survive ever-stronger bandit raids.

Public project on CodeRook: <https://coderook.com/batty-251/3d-game-project-claude> —
release v1.0 can be browsed or downloaded from there. Licensed MIT.

How to play

Double-click Play.bat. It downloads Three.js into vendor/ the first time (it uses the curl
that ships with Windows), starts a small local web server with the built-in PowerShell, and opens the
game in your default browser. Closing that window stops the server.

If the game does not appear, open <http://localhost:8765/> yourself. If port 8765 is already in use,
edit PORT at the top of Play.bat (and the port in the printed URL).

There is nothing else to install. The game must be served over http:// (not opened as a file://
path) because it uses ES modules.

Controls

Click a building to open its panel: train villagers or guards, queue units, set a rally point by
right-clicking the ground, or trade goods at the Market.

The economy

• Wood from trees, stone from rock piles, gold from glittering ore, food from berry bushes and Farms.
• Villagers carry up to 10 of a resource, then walk it to the nearest drop-off (the Town Hall, or a Lumber Mill / Stone Quarry, which are closer to the work).
• Every villager and guard eats 1 food every 25 seconds. If food runs out your people starve and slowly lose health — build Farms and keep farmers working.
• Population is capped by the Town Hall plus each House (+5). Units being trained also occupy a slot, so you may need another House before the Barracks can keep going.
• Villagers remember their last job: after a drop-off they head back to the same kind of resource, and pressing H puts idle villagers back to work.

Buildings

Select villagers and right-click a site to build it faster — several villagers work together. You can
also right-click a damaged building to repair it.

Raids

The first raid arrives 5 minutes in, then roughly every 3 minutes, and each one is bigger and tougher
than the last (they scale with the raid number). Bandits come from a random edge of the map, attack
guards and villagers on sight and head for your buildings, prioritising the Town Hall. Bandits can
cross the bridges, so block the crossings with Walls and Watchtowers. A few villagers can also be
sent to fight, but Guards are far better. If the Town Hall is destroyed you lose.

Raid timing is shown at the top of the screen; watch it before expanding far from home.

Project layout

Play.bat          launcher: fetch Three.js, start server, open browser
server.ps1        tiny static web server (PowerShell, no dependencies)
index.html        page and HUD markup
css/style.css     HUD styling
vendor/           three.module.js (downloaded on first run)
js/config.js      tunable constants and all building/unit definitions
js/state.js       shared game state, resource helpers, grid helpers
js/models.js      low-poly meshes generated in code (no art assets)
js/world.js       terrain, water, bridges, resource nodes, A* pathfinding
js/camera.js      RTS camera
js/units.js       villagers / guards / bandits: states, movement, combat
js/buildings.js   placement, construction, training, towers, arrows
js/raids.js       food upkeep and bandit waves
js/input.js       selection, box-select, commands, build placement
js/ui.js          resource bar, build menu, selection panel, minimap
js/main.js        renderer, lighting, day/night cycle, main loop

Tuning is centralised in js/config.js — resource amounts, gather rates, building costs and HP,
raid timings and day length are all there.