Berryworld

Berryworld is a rebooted attempt at combining rAthena and roBrowser into a mod-friendly MMORPG workspace with a web client and a reloadable server.

This repo starts from three hard constraints:

• copy and trim the legacy JS client instead of redesigning it
• do not build a thin compatibility shim around rAthena
• design the new server around live reload and in-session iteration

Current Status

The repo is past pure planning/bootstrap.

Current implemented baseline:

• copied donor web client boots locally
• PostgreSQL-backed login, character select/create, and map entry
• prt_monk home-base slice with one donor-grounded Kafra NPC
• walk, public chat, storage deposit/withdraw with reconnect persistence
• authored content compile/publish pipeline plus live content reload
• authored berry item effects with live post-reload behavior
• second-client verification for same-map peer appearance updates

The old failed attempt lives at ../berryworld-wreckage.

Initial Layout

• docs/: architecture decisions and phased execution plan
• docs/: canonical task list, architecture notes, and project rules learned the hard way
• legacy/: frozen donor code will be placed here
• runtime-assets/grf/: local GRF archives kept out of git

First Documents

• docs/non_negotiables.md
• docs/architecture.md
• docs/reboot_plan.md
• docs/todo.md
• docs/current_gaps.md

Donor Sources

Planned donor imports:

• legacy/rathena
• legacy/roBrowserLegacy

These should stay frozen as reference/oracle material. New work belongs outside donor trees.