vib-MC
vibed into existence — a Minecraft server made entirely by AI, one prompt at a time.
Minecraft 1.8 → 26.1.2 — excluding 1.16, 1.16.1 and 1.19.3
vib-MC is a Minecraft Java Edition server implementation built from scratch through AI-assisted/vibecoded development — no vanilla code, no Bukkit fork, just prompts, one at a time. It started as an experiment in "can this even connect", and it is now a real, playable server: clients from Minecraft 1.8 through 26.1.2 (excluding 1.16, 1.16.1 and 1.19.3) can join the same server, walk around persistent procedurally generated worlds, and — as of v0.0.7 — actually play survival.
The project focuses on experimenting with Minecraft server internals, custom world generation, persistence, multiplayer, plugins, and making the server easy to extend.
vib-MC is a hobby/experimental project and is not intended to replace mature server software such as Paper or Vanilla. Development is rapid and early: world and player-data formats may, while unlikely, change without migration, and resets could be required at any time.
Releases
vib-MC ships as a rolling release. There are no fixed version releases any more: every push to main rebuilds and republishes a single latest release, so the download link never changes:
https://github.com/vib-studios/vib-MC/releases/latest/download/vib-mc.jar
Grab vib-mc.jar from the latest release. The vX.Y.Z tags further down are kept as history from before the switch.
Current build — the survival release
v0.0.7 is where vib-MC stops being a world you look at and becomes one you can play. Blocks drop what you break, tools wear out, sand and gravel fall, water and lava flow, leaves decay, and ore generates in veins. You can starve, drown, suffocate, burn and fall — and heal again when you are fed. Crafting works in your inventory and at a crafting table, furnaces smelt, chests keep 27 slots across restarts, armour reduces damage, and PvP hits back with knockback. Blocks, damage and deaths finally make sounds.
No mobs yet, and no item entities — drops go straight into your inventory. vib-MC is not a Vanilla or Paper replacement, and not every Minecraft mechanic is implemented, but the survival loop is real.
Multi-version support
vib-MC accepts Minecraft Java Edition clients from 1.8 through 26.1.2, over PacketEvents-based multi-version networking on top of Netty.
Explicitly not supported: 1.16, 1.16.1 and 1.19.3 — those three are rejected at handshake (see Protocol version model for why).
Previous Release — v0.0.6
v0.0.6 - Add PacketEvents-based protocol handling, player storage, world persistence and generation, structure resources, updated tests, and supporting development tools.
World persistence
- Persistent
world/ directory
- Persistent
level.dat
- Persistent world seed
- Persistent chunk storage under
world/region/
- UUID-keyed player state under
playerdata/ (dimension, position, health, food, game mode, flight, selected slot, and complete inventory item NBT)
- Gzipped chunk data
- Chunks load from disk when already saved
- New chunks are generated only when they do not already exist
- Incremental saving — unchanged chunks are not rewritten
/save-all actually saves changed chunks and reports how many were written- Automatic saving through
autosave-interval-ticks
- Runtime
/save-on and /save-off control; /save-all always forces a save
- Corrupt/truncated chunk files are detected and regenerated
- Chunk writes use temporary files before replacement to reduce partial-write corruption
Configuration
autosave-interval-ticks=6000
Set autosave-interval-ticks=0 to disable automatic saving.
New-world seeds
The default is now seed=. A blank seed chooses a random 64-bit seed once, writes it to the new world's level.dat, and restores that same seed on every restart. Existing server.properties files are never rewritten, and an existing saved world's seed always wins.
Authentication and proxies
online-mode=true uses the Minecraft 1.12.2 RSA/AES login handshake and Mojang session-server verification.- Authenticated UUIDs and signed skin properties are forwarded to clients.
proxy-mode=legacy accepts trusted BungeeCord forwarding and Velocity's 1.12.2-compatible legacy forwarding mode.- Set
proxy-trusted-address to the proxy's backend-facing address. Direct connections are rejected in proxy mode.
- Velocity modern forwarding cannot exist on protocol 340 because Login Plugin Request was added after Minecraft 1.12.2; configure Velocity with
player-info-forwarding-mode = "legacy" for this server.
online-mode=true
proxy-mode=none
proxy-trusted-address=127.0.0.1
shutdown-message=Server closed
World layout
world/
├── level.dat seed, time, weather, and world metadata
├── containers.dat chest and furnace contents
└── region/
└── r.<x>.<z>.chunk gzipped chunk data
For an existing world, the seed stored in level.dat takes priority over the configured seed so an existing world cannot silently change its terrain generation seed.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
