Troubleshooting

Troubleshooting

Solutions for common issues with the Info Hub.

Installation Issues

Plugin Not Loading

Symptoms:

• No log messages from plugin
• Commands not working

Solutions:

1. Check Java version (requires Java 25+):

   java -version

2. Verify JAR is in correct folder:

   mods/KyuubiSoftInfoHub-X.X.X.jar  ✓
   plugins/InfoHub/KyuubiSoftInfoHub-X.X.X.jar  ✗

3. Check for startup errors in server log

4. Ensure compatible Hytale server version

Configuration Files Not Generated

Symptoms:

• Config folder empty
• Missing files

Solutions:

1. Ensure plugin loaded successfully
2. Check write permissions on plugins folder
3. Restart server (not just reload)
4. Check for disk space issues

---

UI Issues

Info Hub Not Opening

Symptoms:

• /ksinfo command does nothing
• No UI appears

Solutions:

1. Check for JSON syntax errors in configs (the /ksinfo command is public by default — no permission needed)
2. Restart server after config changes
3. Check server logs for errors

Sections Not Showing

Symptoms:

• Main menu is empty
• Some sections missing

Solutions:

1. Check section is enabled:

   "sections": {
     "faq": {
       "enabled": true
     }
   }

2. Check permission requirement:

   "sections": {
     "admin": {
       "permission": "infohub.admin"
     }
   }

3. Verify the section config file exists

Quick Access Buttons Not Working

Symptoms:

• Clicking button does nothing
• Error in chat

Solutions:

1. Verify command exists on server
2. Check player has permission for command
3. Validate JSON syntax in quickaccess.json
4. Check command format (must start with /)

---

Command Issues

Commands Not Listed

Symptoms:

• Command section is empty
• Some commands missing

Solutions:

1. Check settings in commands/categories.json:

   "settings": {
     "showModCommandsOnly": true,
     "showDefaultCommands": false
   }

2. Verify plugin isn’t in blockedPlugins

3. Check if command is in hiddenCommands

4. Try groupBy: "plugin" for automatic detection

Command Execution Not Working

Symptoms:

• Execute button does nothing
• Error message appears

Solutions:

1. Check execution is enabled:

   "execution": {
     "enabled": true
   }

2. Check command isn’t blocked:

   "execution": {
     "blockedCommands": ["op", "stop"]
   }

3. Verify player has permission for the command

---

Localization Issues

Translations Not Loading

Symptoms:

• Shows English instead of selected language
• Shows raw keys like hub.title

Solutions:

1. Check language value in config.json:

   {
     "language": "de-DE"
   }

2. Verify language file exists in localization/ folder

3. Check for JSON syntax errors in language file

4. Reload config with /ksinfoadmin reload

Text Appears Cut Off

Symptoms:

• Buttons show ”…” at end
• Text overlaps

Solutions:

1. Shorten translation text
2. Use abbreviations where appropriate
3. Split into multiple lines if supported

---

Performance Issues

Lag When Opening Info Hub

Symptoms:

• Delay before UI appears
• Server lag spike

Solutions:

1. Reduce itemsPerPage setting:

   "display": {
     "itemsPerPage": 4
   }

2. Limit search results:

   "globalSearch": {
     "maxResults": 10
   }

3. Disable unused sections

---

JSON Validation

Many issues are caused by JSON syntax errors.

Common JSON Errors

Error	Fix
Missing comma	Add , between items
Extra comma	Remove trailing ,
Missing quote	Ensure all strings have "..."
Missing bracket	Match all { with } and [ with ]

Validate JSON Online

Use jsonlint.com to check your files.

---

Reload Configuration

After fixing config files:

/ksinfoadmin reload

---

Getting Help

If issues persist:

1. Check server logs for detailed errors
2. Gather information:
   • Server version
   • Plugin version
   • Config files
   • Error messages
3. Report issue:
   • Discord: KyuubiSoft Discord