🐍 Phytlas

Really Real Geyser Converter

A project from

---

[!WARNING] This converter is free, and was only made in the purpose of helping DEMOCRAFT's developer converting their ressource pack. It has not been tested with complexe setups, like model engines or huge animated texture. Please note that we are working for free on Phytlas, and so updates & bug fixes are not mandatory. If you want paid support, please consider looking at my Ko-fi.

🚀 Introduction

Phytlas is a simple converter that turns Minecraft: Java Edition resource packs into Minecraft: Bedrock Edition resource packs. It uses mappings provided by Geyser to bridge differences between the two editions.

Phytlas is open source and driven by the community. If you'd like to support development, consider sponsoring us or donating through Ko-fi.

✨ Features

• 🐍 Pure Python — replaces the old Bash/jq script with a robust Python codebase.
• 🎨 2D Item Support — handles standard 2D items with custom model data (no fake 3D models).
• 🎲 3D Model Conversion — converts Java block/item models into Bedrock geometry and attachables.
• 📦 Custom Block Support — converts Java block textures and maps them to custom Bedrock variants.
• 🔎 Display Mapping — maps Java display settings (rotation, translation, scale) to Bedrock animations using a nested bone structure (root → x → y → z) to avoid gimbal lock and keep correct orientation.
• 🖌️ Atlas Generation — builds texture atlases automatically using Pillow (no Node.js required).
• 📝 Manifest Generation — creates valid manifest.json files for Behavior and Resource packs.

🔥 Requirements

• Python 3.8 or newer
• Pillow (pip install Pillow)
• Numpy (pip install numpy)

📚 Usage

1. Clone the repository on your PC using git
2. Install Python and the necessary extension(s) with pip : pip install Pillow and pip install numpy
3. Put your pack in the folder you just created by cloning the repo
4. Run the folowing command:

python3 converter.py <path_to_resource_pack.zip> [options]

Options

• -o, --output — Output directory (default: target)
• --attachable-material — Material used for attachables (default: entity_alphablend)
• --block-material — Material used for blocks (default: alpha_test)

📌 TODO / Known issues

• Use two processors depending on whether an item is 2D or 3D
• Fix 3D model height (floating models)
• Implement block mappings
• Add custom font support (by converting only compatible EX glyphs)
• Add minecraft sounds support
• Fix block mappings rejected by Geyser (note = 0)
• Fix 3D item icon rotation in inventory
• Fix 3D item icon rendering for blocks
• Add custom sounds support
• Add armor support (latest components only — not shaders)

🪄 If you liked Phytlas...

You might also be interested in these projects:

• BedrockAdder — a V2 mapping converter by Antwns (C)
• IAGeyser — a PHP CLI tool to convert ItemsAdder packs to Geyser-compatible resource packs