{"id":22270341,"url":"https://github.com/jifish/babel","last_synced_at":"2025-09-09T22:33:07.440Z","repository":{"id":43181355,"uuid":"264689330","full_name":"JiFish/babel","owner":"JiFish","description":"A customisable pre-written book loot datapack for Minecraft","archived":false,"fork":false,"pushed_at":"2024-06-22T21:02:12.000Z","size":6947,"stargazers_count":6,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-06-23T17:34:06.680Z","etag":null,"topics":["minecraft","minecraft-datapack"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/JiFish.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-05-17T14:47:09.000Z","updated_at":"2024-06-22T20:53:53.000Z","dependencies_parsed_at":"2024-10-26T20:52:18.315Z","dependency_job_id":null,"html_url":"https://github.com/JiFish/babel","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JiFish%2Fbabel","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JiFish%2Fbabel/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JiFish%2Fbabel/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JiFish%2Fbabel/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/JiFish","download_url":"https://codeload.github.com/JiFish/babel/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":227914253,"owners_count":17839245,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["minecraft","minecraft-datapack"],"created_at":"2024-12-03T12:08:08.418Z","updated_at":"2025-07-28T13:32:09.071Z","avatar_url":"https://github.com/JiFish.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Babel Book Loot v2.2\n\n![Logo](readme_images/logo.png)\n\nBabel Book Loot is a customizable Minecraft data pack that adds over 160 pre-written lore books to various loot tables. You can expand the library by adding your own books.\n\nThe pack is compatible with Minecraft 1.21.5 and likely works with older versions.\n\n![Demo](readme_images/babel_demo.webp)\n\n## Quick Start\n1. **Download the Data Pack**: [Download babel_v2.2.zip](https://github.com/JiFish/babel/releases/download/v2.2/babel_v2.2.zip).\n2. **Install**: Place the downloaded `.zip` file in your Minecraft world's `datapacks` directory.\n\n## Gameplay Features\n- **Book Sources**: Find books in village and stronghold chests, woodland mansions, fish them up, or get them from a librarian as a raid reward. The pack also introduces a new structure, the Lost Library, filled with book-related loot.\n- **Books to be found**: Includes lore, mechanics, fiction, and more, written by \"in-universe\" authors.\n- **Book Rarity**: You'll normally find books that are a \"copy of a copy.\" But you'll rarely find books of other types.\n\n## Pre-Customized Versions\nAdditional variations of the pack offer tweaked mechanics:\n- **[babel-bookish-zombies_v2.2.zip](https://github.com/JiFish/babel/releases/download/v2.2/babel-bookish-zombies_v2.2.zip)**: Zombies can drop books when killed by a player.\n- **[babel-only-chests_v2.2.zip](https://github.com/JiFish/babel/releases/download/v2.2/babel-only-chests_v2.2.zip)**: Books are chest-exclusive (no fishing or raid reward).\n- **[babel-no-libraries_2.1.zip](https://github.com/JiFish/babel/releases/download/v2.2/babel-no-libraries_v2.2.zip)**: Removes Lost Libraries.\n- **[babel-fairytales_2.1.zip](https://github.com/JiFish/babel/releases/download/v2.2/babel-fairytales_v2.2.zip)**: Replaces lore books with public domain fairy tales.\n- **[babel-recipe_v2.2.zip](https://github.com/JiFish/babel/releases/download/v2.2/babel-recipe_v2.2.zip)**: Adds the below crafting recipe for random books.\n\n![Using: 1 Book and Quill, 1 Soul Sand Block, 1 Chest, and 1 Emerald.](readme_images/optional_recipe.png)\n\n## Advanced Customization with Babel Builder\nThe Babel Builder tool lets you customize your pack further:\n\n1. **Download the Tool**:\n   - [babel-builder-windows_v2.2.zip](https://github.com/JiFish/babel/releases) (Windows)\n   - [babel-builder-python_v2.2.zip](https://github.com/JiFish/babel/releases) (Python)\n2. **Run the Tool**:\n   - Windows: `babel.exe`\n   - Python: `python babel.py`\n3. **Install Output**: Place the generated `babel.zip` in your Minecraft world's `datapacks` directory.\n\n### Customizing Books\nBooks are stored in the `lore_books` directory, which can be changed via the `books-path` setting in the configuration file.\n\nBooks can be written in JSON or YAML formats. For example:\n\n#### YAML Example\n```yaml\ntitle: Sample Book\nauthor: Some Author\npages:\n  - This is page one.\n  - This is page two.\n  - This is page three.\n```\n\n#### JSON Example\n```json\n{\n  \"title\": \"Sample Book\",\n  \"author\": \"Some Author\",\n  \"pages\": [\n    \"This is page one.\",\n    \"This is page two.\",\n    \"This is page three.\"\n  ]\n}\n```\n\nMinecraft accepts slightly non-standard JSON, and Babel does its best to handle these formats. To ensure proper formatting, write pages directly in Minecraft or use tools like [Text2Book](https://thewilley.github.io/Text2Book/).\n\n### Optional Book Attributes\nBooks can include additional attributes:\n- **`weight`**: Affects selection probability (default: `1`).\n- **`lore`**: Adds lore text, similar to `pages`.\n- **`custom_data`**: Adds custom NBT tags.\n\nExample with optional parameters:\n```json\n{\n  \"title\": \"Another Sample Book\",\n  \"author\": \"Some Author\",\n  \"pages\": [\"Hello World!\"],\n  \"weight\": 2,\n  \"lore\": [[{\"text\":\"Lore line 1\",\"color\":\"blue\"}], \"Lore line 2\"],\n  \"custom_data\": {\"foo\": \"bar\", \"number\": 16}\n}\n```\n\n### Configurable Settings\nEdit `config.yaml` to:\n- Disable specific loot drops.\n- Adjust generation chances.\n- Modify other pack settings.\n\n### Full Command Options\n```\nusage: babel.py [-h] [-v] [-i] [-t] [-a] [-c] [filename]\n\npositional arguments:\n  filename              Optional config filename. (default: config.yaml)\n\noptions:\n  -h, --help            show this help message and exit\n  -v, --version         show program's version number and exit\n  -i, --indent          Indent output json files. Overrides config field.\n  -m, -t, --metabox     Add test loot tables. Overrides config field.\n  -a, --append-version  Append babel version number to output filename.\n  -c, --chance-calc     Calculate real chances of various book generations and exit.\n```\n\n## Using with Other Data Packs\n### Integrating Books into Other Packs\nAdd books to custom loot tables using:\n```json\n{\n  \"type\": \"minecraft:loot_table\",\n  \"value\": \"babel:books\"\n}\n```\n\nIf you just want to generate the loot table without the surrounding files, try running:\n\n```bash\npython build_loottable.py config.yaml \u003e books.json\n```\n\n## Contributions\n- Submit issues or suggestions on GitHub.\n- Reach out via Mastodon: [@joe@social.jifish.co.uk](https://social.jifish.co.uk/@joe).\n\n## Licensing\n- Loot tables you generate with text you own are yours to use freely. A credit is appreciated but not required.\n- Public domain books are sourced from [Project Gutenberg](https://www.gutenberg.org/).\n- Babel tool and data pack are copyright Joseph Fowler.\n\n## Disclaimer\nSoftware is provided \"as is,\" without warranty or liability. Use at your own risk.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjifish%2Fbabel","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjifish%2Fbabel","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjifish%2Fbabel/lists"}