1 files changed, 139 insertions, 0 deletions
diff --git a/docs/map_scripts.md b/docs/map_scripts.md
new file mode 100644
index 000000000..fa8fa308b
--- /dev/null
+++ b/docs/map_scripts.md
@@ -0,0 +1,139 @@
+# Map Scripts
+
+
+## `const_value set 2`
+
+- **`const` *`MAPNAME_OBJECTNAME`***
+
+
+## `MapName_MapScriptHeader:`
+
+
+## `.SceneScripts: db` *N*
+
+- **`scene_script` *script***
+
+
+## `.MapCallbacks: db` *N*
+
+- **`dbw` *type*, *script***
+
+Callback types:
+
+- **`MAPCALLBACK_NEWMAP`**
+
+- **`MAPCALLBACK_TILES`**
+
+- **`MAPCALLBACK_OBJECTS`**
+
+- **`MAPCALLBACK_SPRITES`**
+
+- **`MAPCALLBACK_CMDQUEUE`**
+
+  **`dbw CMDQUEUE_STONETABLE,` *table_pointer***
+  
+  **`stonetable` *warp_id*, *person*, *script***
+  
+  **`db -1 ; end`**
+
+
+## Event scripts
+
+[Event commands](event_commands.md)
+
+
+## Text
+
+[Text commands](text_commands.md)
+
+
+## Movement data
+
+[Movement commands](movement_commands.md)
+
+
+## `MapName_MapEventHeader:`
+
+	; filler
+	db 0, 0
+
+
+## `.Warps: db` *N*
+
+- **`warp_def` *y*, *x*, *warp_id*, *map***
+
+
+## `.CoordEvents: db` *N*
+
+- **`coord_event` *scene id*, *y*, *x*, *script***
+
+
+## `.BGEvents: db` *N*
+
+- **`bg_event` *y*, *x*, *type*, *script***
+
+BG event types:
+
+- **`BGEVENT_READ`**
+
+- **`BGEVENT_UP/DOWN/LEFT/RIGHT`**
+
+- **`BGEVENT_IFSET/IFNOTSET`**
+
+  **`dw` *event_flag*, *script***
+
+- **`BGEVENT_ITEM`**
+
+  **`dwb` *event_flag*, *item_id***
+
+- **`BGEVENT_COPY`**
+
+## `.ObjectEvents: db` *N*
+
+- **`object_event` *sprite*, *y*, *x*, *movement*, *ry*, *rx*, *h1*, *h2*, *palette*, *type*, *range*, *script*, *event_flag***
+
+Movement types:
+
+- **`SPRITEMOVEDATA_ITEM_TREE`**
+
+- **`SPRITEMOVEDATA_WANDER`**
+
+- **`SPRITEMOVEDATA_SPINRANDOM_SLOW`**
+
+- **`SPRITEMOVEDATA_WALK_UP_DOWN`**
+
+- **`SPRITEMOVEDATA_WALK_LEFT_RIGHT`**
+
+- **`SPRITEMOVEDATA_STANDING_UP/DOWN/LEFT/RIGHT`**
+
+- **`SPRITEMOVEDATA_SPINRANDOM_FAST`**
+
+- **`SPRITEMOVEDATA_SNORLAX`**
+
+- **`SPRITEMOVEDATA_POKEMON`**
+
+- **`SPRITEMOVEDATA_SUDOWOODO`**
+
+- **`SPRITEMOVEDATA_SMASHABLE_ROCK`**
+
+- **`SPRITEMOVEDATA_STRENGTH_BOULDER`**
+
+- **`SPRITEMOVEDATA_SPINCOUNTERCLOCKWISE`**
+
+- **`SPRITEMOVEDATA_SPINCLOCKWISE`**
+
+- **`SPRITEMOVEDATA_BIGDOLL`**
+
+- **`SPRITEMOVEDATA_LAPRAS`**
+
+Object types:
+
+- **`OBJECTTYPE_SCRIPT`**
+
+- **`OBJECTTYPE_ITEMBALL`**
+
+  **`itemball` *item_id***
+
+- **`OBJECTTYPE_TRAINER`**
+
+  **`trainer` *event_flag*, *group_id*, *trainer_id*, *seen_text*, *beaten_text*, *loss_text*, *script***