From 8b7d4fccc5c418067878891556fa45118df6371b Mon Sep 17 00:00:00 2001
From: ghoulslash <41651341+ghoulslash@users.noreply.github.com>
Date: Mon, 19 Jun 2023 13:09:51 -0600
Subject: [PATCH] Created Converting to FR Tilesets (markdown)

---
 Converting-to-FR-Tilesets.md | 40 ++++++++++++++++++++++++++++++++++++
 1 file changed, 40 insertions(+)
 create mode 100644 Converting-to-FR-Tilesets.md

diff --git a/Converting-to-FR-Tilesets.md b/Converting-to-FR-Tilesets.md
new file mode 100644
index 0000000..7994f71
--- /dev/null
+++ b/Converting-to-FR-Tilesets.md
@@ -0,0 +1,40 @@
+## Converting Emerald tilesets to Fire Red
+
+credit to ghoulslash
+
+It's common to want the replace emerald's graphics with FR styled ones, including tilesets. This tnutorial goes over the process of how to convert pokeemerald's tilesets with those from Fire Red/pokefirered
+
+This tutorial explains how to copy a tileset from pokefirered over to pokeemerald and convert it to the correct metatile_attributes size.
+
+### 1. Open include/fieldmap.h
+
+Copy the defines at the top from the file in pokefirered like so:
+```c
+#define NUM_TILES_IN_PRIMARY 640
+#define NUM_TILES_TOTAL 1024
+#define NUM_METATILES_IN_PRIMARY 640
+#define NUM_METATILES_TOTAL 1024
+#define NUM_PALS_IN_PRIMARY 7
+```
+
+### 2. Copy your desired tilesets from pokefirered over to emerald
+
+TODO fill in
+
+### 3. Convert all fire red tilesets to emerald
+
+- If you want to convert all tilesets in your data directory:
+  - Grab this script and place it in your root directory: https://github.com/ghoulslash/tools/blob/master/decomps/convert_tilesets.py
+  - Run it like so: `py convert_tilesets.py` from the root directory
+
+- If you want to rip a tileset from an existing ROM
+    - Grab this script: https://github.com/ghoulslash/tools/blob/master/decomps/tileset_ripper.py
+    - Place your ROM in the same directory
+    - Run it like so: `tileset_ripper.py <path to FireRed ROM> <tileset header offset> <name to dump to> <number of metatiles, optional>`
+
+
+
+- If you want to convert a single tileset:
+   - Grab this script: https://github.com/ghoulslash/tools/blob/master/decomps/convert_metatile_attributes.py
+   - Run it like so: `./convert_metatile_attribytes.py <tileset dir name> <primary vs. secondary>`
+