v1.0.2

Bug fixes.

• Fixed ./pebble install failing to compile on Swift 6.2.x: smooth-lighting arithmetic in Mesher.swift (and a few other spots) overran the Swift type-checker and tripped Int-vs-Double inference, breaking the build partway through install. Broken into single-operation typed locals — Pebble now builds on every Swift 6.0–6.3 toolchain; worldgen and mesh output are unchanged. This completes the #1 fix that 1.0.1 only partially addressed. (Fixes #1)
• Fixed over-dark pits, holes and undersides: smooth lighting averaged in the zero skylight of solid neighbours, so a freshly-dug hole looked nearly black in daylight. Opaque neighbours now contribute the face light (standard vanilla smooth lighting); ambient occlusion still shades the corners.
• ./pebble install now checks your Swift version up front (needs 6.0+) and offers to install a current toolchain for you if you're below it, instead of failing partway through a build.

Update: cd pebble && git pull && ./pebble install

v1.0.1

Minor bug fixes.

• Fixed a build failure on newer toolchains (e.g. Swift 6.2.3 / Xcode 26.3, M-series): a literal-arithmetic expression in Mesher.swift overran the Swift type-checker, breaking ./pebble install. Hoisted into typed locals — worldgen and mesh output are byte-identical. (Fixes #1)
• Fixed entity facing: mobs and the third-person player were rendered rotated by -yaw instead of the (180° - yaw) convention, so they faced and walked backward. Render-side only.

Update: cd pebble && git pull && ./pebble install

v1.0.0

Pebble 1.0.0 — first public beta

The open-source alternative to Minecraft: Java Edition. A complete,
native macOS block-survival game built from scratch in Swift + Metal —
no game engine, no .xcodeproj, zero external dependencies.

== What ships ==

• ~45,000 lines of Swift across 82 files; the renderer is hand-written
  Metal (15+ passes, runtime-compiled MSL), the audio engine synthesizes
  every sound and all music in real time from oscillator recipes — zero
  audio files anywhere.
• Content: 879 blocks, 1,188 items, 63 biomes, 100 entity types (55+ mobs
  with goal-based AI and A* pathfinding), 19 structure types (30+
  variants), 39 enchantments; full brewing / enchanting / smithing /
  stonecutting / archaeology systems, advancements, raids, and villager
  trading.
• Three dimensions with working portals and full progression: overworld
  -> nether (fortresses, bastions) -> end (dragon fight, end cities,
  gateways), plus the Wither and the Warden.
• Worldgen: multi-noise climate sampling, spline terrain, 3D density
  caves, ravines, aquifers, vanilla-1.20 ore tables, snow lines, and cave
  biomes including the deep dark.
• Redstone: wire networks, repeaters with locking, comparators that read
  containers, pistons with quasi-connectivity, observers, hoppers, rails,
  sculk sensors.
• Vanilla-exact player physics, verified by independent derivations in the
  test suite (walk 4.317 b/s, sprint 5.612 b/s, jump apex 1.2522 blocks).
• Faithful 32x textures built in (third-party, fully credited, license
  included) plus a built-in "ultra" graphics pipeline: SSAO, volumetric
  god rays, Poisson soft shadows, ACES tonemapping.
• Persistence: a single SQLite database (WAL) holding worlds, chunks,
  players, and advancements.
• Fully deterministic: identical seeds produce identical worlds on any
  machine, across releases — pinned by 456 golden regression checks, all
  green. Warning-free build; 200+ fps at full fancy settings on an
  Apple-silicon MacBook Air; ~2-4 s world loads.

== Known limitations ==

• Singleplayer only, for now — there is no networking code in 1.0.0.
• Elytra flight omits vanilla's dive-redirect term; otherwise
  vanilla-derived.
• Armor trims show in tooltips but not yet on worn armor.
• No resource-pack or shader-pack loading — the Faithful art and the ultra
  pipeline are built in; user-supplied packs are not a feature.

== Install ==

git clone https://github.com/thebriangao/pebble.git && cd pebble
./pebble install

Requires macOS 14+ and the Xcode command-line tools. Apple silicon
recommended.

== Beta ==

This is a first public beta. The engine is golden-tested, but a game of
this scope certainly has bugs we haven't found yet. Issues and pull
requests are incredibly welcome:
https://github.com/thebriangao/pebble/issues

== Disclaimer ==

Pebble is an independent, original fan re-creation inspired by Minecraft:
Java Edition 1.20. It is NOT affiliated with, endorsed by, or connected to
Mojang Studios or Microsoft in any way, and contains no Mojang code or
assets. "Minecraft" is a trademark of Mojang Synergies AB / Microsoft.
Faithful 32x is the work of the Faithful team, bundled under its own
license. See README and LICENSE for the full statement.