Files
claudeandClaude Opus 5.5 487ff6ec48
test / test (push) Successful in 1m42s
Finite worlds with oceans at the edges
New setting strata_world_size: small, medium (default) or large (2000,
3200 or 4200 columns) or infinite. The size is fixed when a world is
created and kept in mod storage; worlds made before this (they already
have env_meta.txt) stay infinite.

- Past |x| = half every plane cell is strata_core:world_edge, an
  invisible, walkable, undiggable wall. is_protected refuses cells past
  it and creatures don't spawn there.
- The last 220 columns are the ocean biome: land eases to a sand beach,
  then the sea floor falls to y = -17 (still the surface layer). Sea
  water fills to SEA_LEVEL only past the beach, so it is held in and
  doesn't flow when woken.
- mg.set_world_size, mg.in_world, mg.ocean_t for other systems and tests.

Tests: 3 new cases in tests/world_size.lua (the stored size, the edge,
beach and sea shape in every size, and a generated shore that stays at
rest, with reach refused past the edge). The test world runs infinite.
106/106 pass, no ERROR lines. A probe server confirmed new worlds get
medium, keep it across restarts, and older worlds stay infinite.

Closes #23

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-15 01:29:33 -05:00

74 lines
3.9 KiB
Markdown

# Strata
A Terraria-inspired 2D side-view sandbox adventure for [Luanti](https://www.luanti.org/)
(formerly Minetest). Dig, build, craft and fight in a world seen from the side.
> **Status: v0.2 "Core Feel".** Playable, rough, and evolving. See [the roadmap](docs/ROADMAP.md),
> the [changelog](CHANGELOG.md) and the issue tracker.
## Features (v0.2)
* **True side view** in stock Luanti 5.10+, using an attached camera rig
* **2D world generator** with rolling hills, forest, desert, snow and jungle biomes, three kinds of tree, dirt and stone layers, tunnels, caverns, and copper and iron ore
* **Four depth layers** (in development for v0.3): surface, underground, slate caverns and a basalt underworld over a bedrock floor, about 1000 blocks down
* **Finite worlds** (in development for v0.3): small, medium or large, with an ocean and an invisible wall at each side, or infinite (setting `strata_world_size`)
* **Cavern biomes** (in development for v0.3): glimmer groves with giant glowing mushrooms, prism galleries and drowned grottos, lit by their own glowing flora
* **Background walls** on their own layer, removed with a hammer
* **Daylight that fades with depth**, so torches matter underground
* **Terraria-style movement:** variable-height jumps, auto-step, and fall damage
* **Station crafting:** no grid. Craftable recipes are listed based on your items and nearby Work Bench, Furnace or Anvil
* **Tools that never break:** pickaxes, axes, hammers, broadswords and shortsword, in wood, copper and iron tiers
* **Doors and chests:** 3-tall wooden doors that open with right-click or when you walk into them, and 40-slot wooden chests
* **One-way platforms** you can jump up through, stand on, and drop through with S
* **Green slimes** that hop at you by day and drop gel for torches
* **Feedback:** dig, break, place and footstep sounds per material, block-break dust, and a red flash and sound when you or a creature is hit
* **Inventory helpers:** the best tool is picked automatically while you dig (toggle on the inventory screen), plus Quick stack to nearby chests and Sort
* **Item magnet:** dropped items stay on the plane and fly to you from about 3 blocks away
## Install
```bash
git clone https://gitea.eom.dev/Gaming/luanti_game_strata.git ~/.minetest/games/strata
```
Start Luanti, select **Strata**, create a new world (the mapgen is forced to
`singlenode`; Strata generates the world itself), and play.
## Controls
| Key | Action |
|---|---|
| A / D | Walk left / right |
| Space | Jump (hold to jump higher) |
| S | Drop down through a platform |
| Mouse | Pan the view a little to aim the crosshair |
| Left click | Dig / attack |
| Right click | Place; open doors and chests |
| I | Inventory and crafting |
You can dig and place within about 5 blocks of your character.
Stay in first-person view. Luanti 5.12+ locks this for you; on 5.10 and 5.11,
if you press C by accident, keep pressing it until the view returns. If the
camera motion bothers you, turn off **Smooth camera follow** in the game's
settings (`strata_smooth_camera`).
## Getting started
1. Chop trees with the copper axe to get **Wood**.
2. Craft a **Work Bench** (10 wood) and place it.
3. Kill slimes for **Gel**, then craft **Torches** (1 gel + 1 wood → 3).
4. Mine stone and build a **Furnace** at the work bench. Smelt copper and iron ore into bars.
5. Make an **Iron Anvil** (5 iron bars) and forge better gear.
## Development
* Design notes and how the 2D illusion works: [docs/DESIGN.md](docs/DESIGN.md)
* To regenerate placeholder textures: `python3 tools/gen_textures.py` (needs Pillow)
* To regenerate placeholder sounds: `tools/gen_sounds.py` (needs `oggenc`)
* Headless tests: `tests/run.sh` (see [tests/README.md](tests/README.md)); lint: `luacheck .`. Both run in Gitea Actions on every push.
## License
Code: LGPL-2.1-or-later (see `LICENSE.txt`). Textures: CC BY-SA 4.0. Sounds: CC0 1.0. See [CREDITS.md](CREDITS.md).