8000 GitHub - SmokesBowls/MythTech: godot .tres-codex-markdown-extracture please leave fedback
[go: up one dir, main page]
More Web Proxy on the site http://driver.im/
Skip to content

SmokesBowls/MythTech

Repository files navigation

# 🧠  MythTech Codex Toolkit

A modular pipeline for extracting, validating, and exporting structured Codex data from Markdown-based game lore. Outputs clean `.json` entries and generates `.tres` resource files for Godot 3.5+.

---

## 📂 Project
5DBC
 Structure

```
Mythtech/
├── codex_json/              # Extracted .json entries
│   └── last_unknown_entry.json
├── godot_scripts/
│   └── codex_entries/       # Godot .tres output
├── mythtech_archive/        # Source .md lore files
├── tres_converter.py        # JSON to .tres converter
├── codex_extractor_codexmode_v3.py  # Markdown to JSON extractor
├── mythtech_validate.py       # Symbol balance & metadata check
├── MythTechControlCenter.py # GUI launcher
├── README.md
└── requirements.txt
```

---

## 🧰 Features

- ✅ **Validate**: Checks for syntax, metadata tags, and symbol mismatches in Markdown lore.
- 📤 **Extract Codex**: Parses lore files and outputs JSON between `[BEGIN JSON]` and `[END JSON]`.
- 📦 **Export `.tres`**: Converts valid `.json` files into Godot resource entries.
- ⚠️ **Unknown Logging**: Warns of missing `@id`, `@title`, or `@category`.
- 🎛️ **GUI Frontend**: Simple tkinter interface to control all tools.

---

## ⚙️ Setup Instructions

```bash
# 1 create directory
# Create only the necessary folder structure
mkdir -p godot/scripts/
mkdir -p mythtech/
mkdir -p codex_json/

# 2. Clone or extract the toolset
cd ~/Mythtech

# 3. (Recommended) Create virtual environment
python3 -m venv clean_env
source clean_env/bin/activate

# 4. Install required packages
pip install -r requirements.txt
```

---

## 🖥️ Run the GUI

```bash
python3 MythTechControlCenter.py
```

---

## 💾 Workflow

1. Run **Validate Lore (.md)** to lint a file.
2. Run **Extract Codex (.json)** and copy the JSON inside `[BEGIN JSON]... [END JSON]`.
3. Paste into a new `.json` file **in the same folder as your `.md` file**.
4. Run **Export to .tres** to generate `.tres` for Godot.

---

## 🧠 Notes

- Do **not** copy the `[BEGIN JSON]` or `[END JSON]` lines themselves.
- Unknown entries will still export, but appear as `unknown_entry.tres` and logged separately.
- Godot 3.5+ compatible (`.tres` format 3).
```

---

## 📦 `requirements.txt`

```text
altgraph==0.17.4
packaging==24.2
pyasn1==0.6.1
pyinstaller==6.12.0
pyinstaller-hooks-contrib==2025.2
pyperclip==1.9.0
pyttsx3==2.98
rsa==4.9
setuptools==78.1.0
pyperclip==1.9.0

```

---

About

godot .tres-codex-markdown-extracture please leave fedback

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published
0