> For the complete documentation index, see [llms.txt](https://yourmaps.gitbook.io/yourmaps-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://yourmaps.gitbook.io/yourmaps-docs/faq-and-troubleshooting/technical-troubleshooting.md). # Technical Troubleshooting Most problems are usually related to installation, cache, renamed folders, missing files, wrong configuration, or conflicts with other maps in the same area. ### Before Troubleshooting Before checking specific issues, make sure: * You downloaded the resource from an official YourMAPS source * The resource was fully extracted / unzipped * The folder is inside your server `resources` folder * The resource is added to your `server.cfg` * The folder name was not changed * You read the included `README`, `README.txt`, or `README_FIRST` file * You restarted the server after installation * You checked the server console for errors * You checked your client/F8 console for errors Please do not rename YourMAPS resource folders unless the documentation specifically says it is safe. ### Map Does Not Load If the map does not appear in-game, check: * Is the resource inside your server `resources` folder? * Is the resource added to your `server.cfg`? * Does the `ensure` line match the exact folder name? * Did you rename the resource folder? * Is the resource starting correctly in the server console? * Are there any missing file errors? * Are you using another map in the same area? * Did you clear cache after updating or replacing files? Example: ```cfg ensure yourmaps_resource_name ``` Replace `yourmaps_resource_name` with the real folder name of the resource. ### Missing Textures If textures are missing, black, invisible, or not loading correctly, check: * Did all files upload correctly? * Are all `stream` files present? * Did you rename the resource folder? * Are there any missing `.ytd` files? * Are you using another resource that replaces the same textures? * Did you clear cache after updating? * Are there errors in the server console or F8 console? Texture issues are often caused by incomplete uploads, old cache, renamed folders, or conflicts with other resources. ### Collision Issues If you fall through the floor, hit invisible walls, or collisions feel wrong, check: * Are you using another map in the same area? * Did you install all required files? * Did you read the README file? * Did you clear cache after updating? * Does the issue happen when only this resource is started? * Are there other resources modifying the same building, terrain, or interior? The best test is to start the YourMAPS resource alone without other maps in the same area. If the issue disappears when other maps are disabled, it is probably a conflict. ### Doors Not Working If doors do not lock, unlock, or interact correctly, check: * Are you using the correct door hashes? * Did you copy the hashes correctly? * Is your door script configured properly? * Is another map replacing the same doors? * Are there duplicated doors in the same location? * Did you follow the README instructions? * Are there errors in your door script? Door problems are often related to wrong hashes, duplicated doors, or conflicts with other maps/scripts. When possible, compare the behavior with the YourMAPS test server. ### Props Duplicated / Missing If props are missing, duplicated, or appearing in the wrong place, check: * Did the resource upload correctly? * Are all streamed files present? * Are you using another map in the same location? * Did another resource add props to the same area? * Did you clear cache after replacing files? * Is the correct resource version installed? Duplicated props usually mean another resource is editing the same area. ### Performance / Crashes YourMAPS resources are tested for stability and performance, but every server setup is different. If you experience lag, crashes, or performance issues, check: * Are you using many maps in the same area? * Are there conflicting resources? * Are you using outdated artifacts? * Are there console errors? * Does the issue happen only with this resource enabled? * Does the issue happen on a clean test server? * Are other heavy scripts or maps running nearby? To test properly: 1. Disable other maps in the same area. 2. Start only the YourMAPS resource. 3. Restart the server. 4. Test again in-game. 5. Check server console and F8 console. If the issue only happens when other resources are active, it is probably not caused by the YourMAPS resource alone. ### Clean Server Test A clean server test is one of the best ways to find conflicts. To test: 1. Start a basic RedM server. 2. Add only the YourMAPS resource. 3. Do not start other maps in the same area. 4. Join the server. 5. Test the location. If the resource works correctly on a clean server, the issue is likely caused by another map, script, cache, or configuration on your main server. ### What to Send in a Support Ticket When opening a support ticket, please include: * Product name * Resource folder name * Your framework, if relevant * A short explanation of the issue * A short video showing the problem * Screenshots if useful * Location or coordinates * Server console errors * Client/F8 console errors * List of other maps used in the same area * What you already tried A short video is usually the best way for us to understand the issue quickly. ### Support * Questions or doubts: join the YourMAPS Discord. * For personalized exterior/interior textures, custom buildings, or custom props: open a ticket on Discord. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://yourmaps.gitbook.io/yourmaps-docs/faq-and-troubleshooting/technical-troubleshooting.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.