JumPHP engine extension: big game data streamed from the playground (jumphp/externals)
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
David Nurdin d138866492 externals: blocks asked with the file's version (?v=<etag>): the playground marks them immutable, the browser's HTTP cache keeps them between sessions
On disk, outside the engine's memory (IndexedDB lives in memory in the browser): a game with
big files can keep persist: false and still not download them twice.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
2026-11-14 19:26:04 +01:00
doc externals: blocks asked with the file's version (?v=<etag>): the playground marks them immutable, the browser's HTTP cache keeps them between sessions 2026-11-14 19:26:04 +01:00
src externals: blocks asked with the file's version (?v=<etag>): the playground marks them immutable, the browser's HTTP cache keeps them between sessions 2026-11-14 19:26:04 +01:00
AGENTS.md Externals extension (jumphp/externals): game data streamed by blocks from the playground 2026-11-14 15:51:55 +01:00
composer.json Externals: the server URL in the browser is /<project id>/play/externals/ (url: auto) 2026-11-14 16:20:19 +01:00
LICENSE Externals extension (jumphp/externals): game data streamed by blocks from the playground 2026-11-14 15:51:55 +01:00
README.md Externals extension (jumphp/externals): game data streamed by blocks from the playground 2026-11-14 15:51:55 +01:00

jumphp/externals

A JumPHP engine extension: big game data streamed from the playground. The administrator shares folders of the server's externals/ with chosen games; a game lists them, searches them and reads files like a disk: only the 64 KB blocks it reads are downloaded (HTTP Range), cached in memory and in the player's storage. On the desktop and in tests, local folders stand in for the server.

bin/jumphp composer mygame require jumphp/externals
$this->externals->open('mygame/data/level1.bin')->then(
    fn (\JumPHP\Externals\RemoteFile $f) => $f->read(1024, 64)->then(fn (string $bytes) => ...));

Documentation: doc/index.md; tutorial: doc/tutorial.md; samples: doc/samples/; example game: games/externals-demo. MIT licence.