Commit:

"Add complete documentation system"

docs/Troubleshooting.md

@@ -1,107 +1,265 @@
 # Troubleshooting
 
-This guide covers common issues and their solutions.
+This guide covers the most common issues encountered when using RS-MobStand and provides steps to resolve them.
 
 ---
 
-# Machine Not Collecting Items
+# Mob Stand Will Not Convert
 
-## Target Container Missing
+### Symptoms
 
-The assigned container no longer exists.
+* Sneak-right-clicking an Armor Stand does nothing.
+* The conversion does not occur.
 
-Symptoms:
+### Check
 
-* Machine shows a warning state.
-* Items remain on the ground.
+Verify that:
 
-Solution:
+* You are holding a Stick.
+* You are sneaking.
+* You have the required permission.
+* The target is a normal Armor Stand.
 
-* Replace the container.
-* Reassign the target container if necessary.
+### Solution
+
+Ensure you are:
+
+```text id="6rj03f"
+Sneaking
++
+Holding a Stick
++
+Right-Clicking an Armor Stand
+```
 
 ---
 
-## Container Full
+# Cannot Open Mob Stand Menu
 
-The target container has no available space.
+### Symptoms
 
-Symptoms:
+* Right-clicking a Mob Stand does nothing.
+* The menu does not appear.
 
-* Items remain on the ground.
-* Machine appears operational.
+### Check
 
-Solution:
+Verify that:
 
-* Remove items from the container.
-* Expand storage capacity.
+* The stand is already converted.
+* You own the Mob Stand.
+* You have permission to use Mob Stands.
 
-RS-ItemMagnet automatically resumes collection when space becomes available.
+### Solution
+
+Try interacting with a Mob Stand that you own.
+
+Administrators can bypass ownership restrictions using:
+
+```text id="jhy0k0"
+rsmobstand.admin
+```
 
 ---
 
-## Filter Blocking Items
+# "You Do Not Own This Mob Stand"
 
-The item is not allowed by the machine's filter configuration.
+### Symptoms
 
-Solution:
+You receive an ownership error message.
 
-* Review filter settings.
-* Add the desired item to the filter.
+### Cause
+
+The Mob Stand belongs to another player.
+
+### Solution
+
+* Use your own Mob Stand.
+* Ask the owner for assistance.
+* Have an administrator assist you.
+
+Administrators with:
+
+```text id="3u4r6l"
+rsmobstand.admin
+```
+
+may bypass ownership restrictions.
 
 ---
 
-## Item Outside Radius
+# Mob Stand Is Not Processing Mobs
 
-The item is located outside the configured collection area.
+### Check Pause Status
 
-Solution:
+Verify the Mob Stand is not paused.
 
-* Increase radius.
-* Move the machine closer to the collection area.
+Open:
+
+```text id="50s1d7"
+Main Menu
+    ↓
+Pause / Resume
+```
+
+and ensure processing is enabled.
 
 ---
 
-# Machine Lost After Restart
+### Check Radius
 
-RS-ItemMagnet stores machine data in SQLite.
+Verify the configured radius is large enough to reach the intended mobs.
 
-Machine data should automatically persist across:
+Open:
 
-* Server restarts
-* Chunk unloads
-* Player relogs
+```text id="kce0j6"
+Main Menu
+    ↓
+Radius
+```
 
-If data is missing, contact the server administrator.
+and review the current value.
 
 ---
 
-# Ownership Problems
+### Check Filters
 
-Only the machine owner may modify settings.
+Verify the mob type is enabled in the appropriate filter menu.
 
-Administrators with appropriate permissions may bypass ownership restrictions.
+Review:
+
+* Adult Filters
+* Baby Filters
+
+If a mob is disabled in filters, it will be ignored.
+
+---
+
+### Check Leave Alive
+
+Verify the Leave Alive setting is not preventing additional processing.
+
+Example:
+
+```text id="j11jv0"
+Leave Alive: 10
+```
+
+If only ten matching mobs exist, no additional processing will occur.
+
+---
+
+# Mobs Are Being Ignored
+
+### Cause
+
+The mob type may be disabled in filters.
+
+### Solution
+
+Open:
+
+```text id="yzr39t"
+Adult Filters
+```
+
+or
+
+```text id="jq4z32"
+Baby Filters
+```
+
+and verify the desired mob type is enabled.
+
+---
+
+# Gravity Is Not Working As Expected
+
+### Cause
+
+Gravity may be disabled.
+
+### Solution
+
+Open:
+
+```text id="r5g7t1"
+Main Menu
+    ↓
+Gravity
+```
+
+and verify the current setting.
+
+---
+
+# Configuration Changes Are Not Taking Effect
+
+### Cause
+
+The configuration may not have been reloaded.
+
+### Solution
+
+Administrators can use:
+
+```text id="db0vtg"
+Admin Menu
+    ↓
+Reload Config
+```
+
+after making configuration changes.
+
+---
+
+# Version Status Shows "Unable To Check"
+
+### Cause
+
+The plugin could not contact the update source.
+
+Possible reasons:
+
+* No internet access
+* GitHub unavailable
+* Repository is private
+
+### Solution
+
+This does not affect plugin operation.
+
+RS-MobStand will continue functioning normally.
+
+---
+
+# Server Performance Concerns
+
+### Recommendations
+
+* Avoid excessively large radius values.
+* Use filters to limit processing.
+* Only create Mob Stands where needed.
+* Review server performance regularly.
 
 ---
 
 # Still Need Help?
 
-If the problem persists:
+Before requesting support, gather:
 
-1. Verify plugin version.
-2. Review server logs.
-3. Open an issue on the GitHub repository.
+* Minecraft Version
+* Paper Version
+* RS-MobStand Version
+* Screenshots (if applicable)
+* Console Errors (if applicable)
+
+Providing this information helps resolve issues more quickly.
 
 ---
 
-# Known Behavior
+# Related Pages
 
-## Full Containers
-
-When a container becomes full:
-
-* Items remain on the ground.
-* No items are lost.
-* Collection automatically resumes when storage space becomes available.
-
-This behavior is intentional.
+* Installation
+* Permissions
+* Admin Guide
+* Main Menu