Skip to content

v1.0.0

Choose a tag to compare

View all tags
@thebriangao thebriangao released this 13 Jun 02:05
· 2 commits to main since this release
v1.0.0
b4d2025

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.

Assets 2
Loading