From 5140f75266b824168b9dcd42bf52c6ab7e396d21 Mon Sep 17 00:00:00 2001
From: 0ceanSlim <chriskerr@gmx.com>
Date: Mon, 18 Sep 2023 16:19:42 -0400
Subject: [PATCH] added inventory discription and link to .md

---
 Documents/inventory.md | 46 ++++++++++++++++++++++++++++++++++++++++++
 README.md              |  8 +++++---
 2 files changed, 51 insertions(+), 3 deletions(-)
 create mode 100644 Documents/inventory.md

diff --git a/Documents/inventory.md b/Documents/inventory.md
new file mode 100644
index 00000000..197a32c2
--- /dev/null
+++ b/Documents/inventory.md
@@ -0,0 +1,46 @@
+# Inventory
+
+The tile-based inventory system provides an organized view of the player's equipped gear on the left-hand side of the screen, offering various slots for different types of items.
+
+## Equipped Gear Slots
+
+### Helmet Slot
+- Equip helmets for added protection and character customization.
+
+### Headset Slot
+- Attach headsets to improve communication and audio awareness.
+
+### Rig/Plate Carrier Slot
+- Equipping a rig or plate carrier eallows for attachment of pouches. Pouches attached to the rig further increase storage capacity.
+- Pouches attached to the rig or plate carrier provide additional empty slots for storing various items, making inventory management more flexible and strategic.
+
+### Body Armor Slot
+- Choose between body armor or a plate carrier to enhance protection. The plate carrier includes front and rear plate slots.
+
+### Primary Weapon Slot
+- Keep your primary weapon easily accessible in this slot.
+
+### Secondary Weapon Slot
+- A dedicated space for secondary weapons ensures a quick backup option.
+
+### Pistol Slot
+- Store your sidearm here for swift access.
+
+## Additional Inventory Spaces
+
+### Secure Pocket
+- Items placed in the secure pocket are retained upon death unless the player is `WANTED`. 
+    - More on `WANTED` status in [Combat]()
+
+### Regular Pockets
+- Use regular pockets for smaller items, enhancing realism and immersion.
+
+### Medical Container
+- A dedicated container for medical supplies, retained upon death unless the player is `WANTED`.
+
+### Backpack
+- The backpack offers versatile storage, accommodating a wide range of additional gear and loot.
+
+With this tile-based inventory system, players can strategically equip gear, and manage their resources for a fully immersive gaming experience.
+
+***
\ No newline at end of file
diff --git a/README.md b/README.md
index ff5ba8d7..a1858617 100644
--- a/README.md
+++ b/README.md
@@ -76,16 +76,18 @@ todo: oraganize these into their own sections
 - ##### [Documentation](https://git.happytavern.co/OceanSlim/projectEli/src/branch/master/Documents/health.md)
 
 #### Inventory
+- ##### [Documentation](https://git.happytavern.co/OceanSlim/projectEli/src/branch/master/Documents/inventory.md)
 
-- todo: a description of the inventory system
+- add to git issues
   - right click hold drop one from stack per slot, left click drag to split stack evenly among slots
   - make a dot crosshair when close to an item and pickup item comes up when the crosshair is within the pickup ranges looking at the item
   - right click fill bag on containers like materials bag and tool belt
   - while a stack or item is picked up: right click drops/equips one from the stack. left click drops the whole stack. if no stack is held right click brings up menu
   - when loaading ammo: If you hold a stack of ammo and hover over a mag, right clicking will load one in the mag, - left click will load the whole stack one by one, (instantly in safe city)
   - cells should all be measured in length width hieght LWH
-  - money
-    - Character starts with 5,000,000 Sats
+- money
+  - Character starts with 5,000,000 Sats
+- character starts with 250 storage slots in the stash (10x25)
 
 #### Combat