Skip to content

Commit cf08800

Browse files
committed
fix: build errors
1 parent 574372b commit cf08800

File tree

1 file changed

+11
-174
lines changed

1 file changed

+11
-174
lines changed

pages/commonissues/otherbugs.mdx

Lines changed: 11 additions & 174 deletions
Original file line numberDiff line numberDiff line change
@@ -10,176 +10,6 @@ import {
1010

1111
Encountering an issue that's not covered in our common problems guide? Don't worry! This page will help you troubleshoot unknown issues and get the support you need to resolve any problems you're experiencing.
1212

13-
## 🔍 Before Reporting a Bug
14-
15-
Before reaching out for help, let's make sure we've exhausted the basic troubleshooting steps and gather the information needed for effective support.
16-
17-
<Callout type="info">
18-
**Community-First Approach**: Many issues are quickly resolved by our helpful
19-
community members who have encountered similar problems. Checking with the
20-
community first often leads to faster solutions!
21-
</Callout>
22-
23-
### Quick Self-Diagnosis
24-
25-
<Steps>
26-
27-
### Check the Obvious
28-
29-
- Is your server actually running?
30-
- Are there any obvious error messages in console?
31-
- Did you recently change anything that might be related?
32-
- Are other resources working normally?
33-
34-
### Review Recent Changes
35-
36-
- New resource installations
37-
- Configuration modifications
38-
- Server updates or migrations
39-
- Framework changes (QBCore/ESX updates)
40-
41-
### Test Isolation
42-
43-
- Does the issue happen with other resources disabled?
44-
- Can you reproduce it consistently?
45-
- Does it affect all players or just specific ones?
46-
- Is it related to specific actions or random?
47-
48-
### Documentation Review
49-
50-
- Have you checked all relevant documentation sections?
51-
- Are you following the correct installation procedures?
52-
- Is your setup matching the stated requirements?
53-
54-
</Steps>
55-
56-
## 🛠️ Advanced Troubleshooting
57-
58-
### Systematic Problem-Solving
59-
60-
<Tabs
61-
items={[
62-
"Resource Issues",
63-
"Server Problems",
64-
"Player-Specific Issues",
65-
"Performance Problems"
66-
]}
67-
>
68-
<Tabs.Tab>
69-
**Resource-Specific Problems:** 1. **Single Resource Testing**: - Disable
70-
all other resources except essentials - Test if the problem persists -
71-
Re-enable resources one by one to identify conflicts 2. **Configuration
72-
Validation**: ```lua -- Check for common config errors Config = Config or {}
73-
-- Verify required settings exist if not Config.Framework then print("ERROR:
74-
Framework not configured!") end ``` 3. **Dependency Verification**: - Ensure
75-
all required resources are installed - Check startup order in server.cfg -
76-
Verify versions are compatible 4. **Fresh Installation Test**: - Download a
77-
clean copy from Keymaster - Install in a separate folder - Test with minimal
78-
configuration
79-
</Tabs.Tab>
80-
<Tabs.Tab>
81-
**Server-Wide Issues:** 1. **Server Artifact Issues**: - Check FiveM server
82-
version - Update to latest recommended artifacts - Review server console for
83-
system-level errors 2. **Database Problems**: ```sql -- Test database
84-
connectivity SHOW TABLES; SHOW PROCESSLIST; -- Check for table corruption
85-
CHECK TABLE your_table_name; ``` 3. **Resource Conflicts**: - Review
86-
server.cfg for duplicate ensures - Check for port conflicts - Look for
87-
overlapping functionality 4. **Performance Diagnostics**: ``` # Monitor
88-
server resources resmon # In-game command # Check memory usage profiler
89-
record 100 profiler view ```
90-
</Tabs.Tab>
91-
<Tabs.Tab>
92-
**Player-Specific Issues:** 1. **Permission Problems**: - Verify user roles
93-
and permissions - Test with admin account - Check framework-specific
94-
permission systems 2. **Client-Side Issues**: - Ask affected players to
95-
clear FiveM cache - Check for client-side script errors - Test with
96-
different players 3. **Database User Data**: ```sql -- Check player data
97-
integrity SELECT * FROM users WHERE identifier = 'player_id'; -- Look for
98-
corrupted or missing data SELECT COUNT(*) FROM characters WHERE citizenid IS
99-
NULL; ``` 4. **Network Issues**: - Check player connection stability -
100-
Verify server-side event handling - Test with players from different
101-
locations
102-
</Tabs.Tab>
103-
<Tabs.Tab>
104-
**Performance-Related Problems:** 1. **Resource Monitor Usage**: ``` # Use
105-
in-game performance tools resmon # Check specific resource performance
106-
profiler record 500 profiler view resource_name ``` 2. **Database
107-
Optimization**: ```sql -- Check for slow queries SHOW PROCESSLIST; --
108-
Analyze table performance ANALYZE TABLE table_name; ``` 3. **Memory
109-
Analysis**: - Monitor server RAM usage - Check for memory leaks - Review
110-
garbage collection patterns 4. **Network Performance**: - Test server
111-
response times - Monitor bandwidth usage - Check for packet loss issues
112-
</Tabs.Tab>
113-
</Tabs>
114-
115-
## 📋 Gathering Information for Support
116-
117-
### Essential Information Checklist
118-
119-
When you're ready to report a bug, gather this information to help us assist you effectively:
120-
121-
#### System Information
122-
123-
- **Resource Name**: Which Zerio-Scripts product is affected
124-
- **Server Framework**: QBCore, ESX, or standalone
125-
- **FiveM Version**: Server artifact version number
126-
- **Operating System**: Windows, Linux distribution and version
127-
- **Hosting Type**: Self-hosted, VPS, dedicated server, or game hosting
128-
129-
#### Error Details
130-
131-
- **Complete Console Output**: Include timestamps and context
132-
- **Reproduction Steps**: Detailed steps to recreate the issue
133-
- **Frequency**: Does it happen always, sometimes, or rarely?
134-
- **Affected Users**: All players, specific roles, or just admins?
135-
136-
#### Configuration Information
137-
138-
```lua
139-
-- Share relevant config sections (remove sensitive data)
140-
Config.Framework = 'qb-core'
141-
Config.Database = 'oxmysql'
142-
Config.Target = 'ox_target'
143-
-- ... other relevant settings
144-
```
145-
146-
#### Recent Changes
147-
148-
- What changed recently on your server?
149-
- Any new resources or updates?
150-
- Configuration modifications?
151-
- Server migrations or updates?
152-
153-
### Sample Bug Report Template
154-
155-
```markdown
156-
**Resource**: zerio-bossmenu
157-
**Framework**: QBCore
158-
**Issue**: Players cannot access boss menu
159-
160-
**Steps to Reproduce**:
161-
162-
1. Player with boss job approaches the interaction point
163-
2. Presses E to interact
164-
3. Nothing happens, no menu appears
165-
166-
**Console Output**:
167-
[2024-01-15 14:30:22] [ERROR] zerio-bossmenu: attempt to index nil value
168-
[2024-01-15 14:30:22] [ERROR] zerio-bossmenu: Error in function checkPermissions
169-
170-
**Configuration**:
171-
172-
- Framework: QBCore latest
173-
- Target: ox_target
174-
- Jobs configured: police, ambulance
175-
176-
**Additional Info**:
177-
178-
- Issue started after updating QBCore yesterday
179-
- Affects all boss-level players
180-
- Other resources working normally
181-
```
182-
18313
## 🤝 Getting Support
18414

18515
### Community Support Channels
@@ -189,10 +19,17 @@ Config.Target = 'ox_target'
18919
icon={<ChatBubbleIcon />}
19020
title="Discord Community"
19121
href="https://discord.zerio-scripts.com"
192-
arrow
19322
/>
194-
<Cards.Card icon={<Pencil1Icon />} title="Bug Reporting" arrow />
195-
<Cards.Card icon={<QuestionMarkCircledIcon />} title="General Help" arrow />
23+
<Cards.Card
24+
icon={<Pencil1Icon />}
25+
title="Bug Reporting"
26+
href="#"
27+
/>
28+
<Cards.Card
29+
icon={<QuestionMarkCircledIcon />}
30+
title="General Help"
31+
href="#"
32+
/>
19633
</Cards>
19734

19835
### Support Process
@@ -202,7 +39,7 @@ Config.Target = 'ox_target'
20239
### Community First
20340

20441
1. **Search Discord**: Check if someone has had the same issue
205-
2. **Ask in General Help**: Post your question in the appropriate channel
42+
2. **Ask in Customer Support**: Post your question in the appropriate channel
20643
3. **Provide Context**: Share relevant details from your information gathering
20744

20845
### Escalate if Needed

0 commit comments

Comments
 (0)