Skip to content

Developer Build and Release

beeboee edited this page Aug 20, 2026 · 2 revisions

Developer, Build, and Release Notes

This page is for Biblio contributors and release maintainers. User-facing installation instructions are in Installation and Requirements.

Source layout

Path Purpose
manifest.json.gz.b64 Compressed base work manifest
books/ Additional literature and author-specific source definitions
tools/ Source acquisition, formatting, catalog, tag, runtime, and validation pipeline
src/main/java/io/github/beeboee/biblio/ NeoForge commands, menu, saved settings, loot functions, and modifiers
generated/Famous_Books_1.21.1_Full_Text/ Expanded generated inspection tree
dist/ Built mod and retained legacy datapack artifacts
CATALOG.md Generated human-readable catalog

Source manifests and build tools are authoritative. Generated output is retained for inspection and release artifacts.

Build requirements

  • Java 21
  • Python with packages from requirements.txt
  • Network access for public-domain source retrieval when content is not cached

Recreate the decoded base manifest, install dependencies, and run the complete build:

python - <<'PY'
import base64, gzip
from pathlib import Path

Path('manifest.json').write_bytes(
    gzip.decompress(base64.b64decode(Path('manifest.json.gz.b64').read_text()))
)
PY
pip install -r requirements.txt
python tools/build_full.py

The complete build regenerates the catalog, expanded data tree, compatibility ZIP, command index, work-tag metadata where enabled, and NeoForge JAR. Gradle targets Java 21 and NeoForge 21.1.211 for Minecraft 1.21.1.

Clone this wiki locally