Skip to main content

Troubleshooting Vexor Core Plugins

Common issues and solutions across all Vexor Core plugins.

General Issues​

Plugin Not Loading​

Symptoms:

  • Plugin appears RED in /plugins
  • Console shows load errors
  • Commands not available

Solutions:

  1. Check Server Software

    # Verify you're using Paper (not Spigot/Bukkit)
    /version
    • ❌ Spigot/Bukkit are NOT supported
    • ✅ Use Paper, Purpur, or another Paper fork

  2. Verify Java Version

    java -version
    # Must be Java 21 or higher

  3. Check Console for Errors

    • Look for stack traces during startup
    • Missing dependencies listed?
    • File permission errors?

  4. Verify File Integrity

    • Re-download the plugin JAR
    • Ensure file isn't corrupted
    • Check file size matches official release

Commands Not Working​

Symptoms:

  • /command not recognized
  • "Unknown command" message

Solutions:

  1. Verify Plugin Loaded

    /plugins
    # Plugin should be GREEN

  2. Check Permissions

    /lp user <your_name>permission check pluginname.admin

  3. Try Reload

    /reload confirm
    # or restart server

Configuration Not Applying​

Symptoms:

  • Changes to config.yml not taking effect
  • Settings reverting to default

Solutions:

  1. Stop Server Before Editing

    • Never edit configs while server is running
    • Changes may be overwritten

  2. Validate YAML Syntax

    • Use YAML Lint to check syntax
    • Common issues: tabs instead of spaces, missing colons

  3. Check File Permissions

    # On Linux/Mac
    chmod 644 plugins/PluginName/config.yml

  4. Use Reload Command (if available)

    /pluginname reload

Plugin-Specific Issues​

PivotPoly​

Wand Not Working​

  • Ensure you got wand from /pp wand (not random blaze rod)
  • Check for WorldEdit conflicts
  • Verify no console errors when clicking

Door Not Animating​

  • Check all 3 positions set (Pos1, Pos2, Pivot)
  • Verify BlockDisplays exist: /minecraft:entity list
  • Check console for animation errors

Doors Missing After Restart​

  • Verify doors.yml exists in plugins/PivotPoly/
  • Check file isn't corrupted (validate YAML)
  • Restore from backup if needed

ItemLimiter / EnchantLimits​

Limits Not Enforcing​

  • Check player doesn't have bypass permission
  • Verify limits configured in GUI
  • Reload plugin after config changes

GUI Not Opening​

  • Verify permission: limitless.admin or enchantlimit.admin
  • Check console for errors
  • Ensure not in creative mode glitches

CoreTeams​

Team Commands Not Working​

  • Check permissions: coreteams.use (players), coreteams.admin (admins)
  • Verify team exists: /team list
  • Check if feature toggled off in config

Team Chat Not Working​

  • Verify permission: coreteams.chat
  • Check player is in a team: /team info
  • Ensure not muted/deafened

SupplyCrates​

Crates Not Dropping​

  • Check /supplycrates drop permission
  • Verify loot tables configured
  • Check console for spawn errors

Loot Not Generating​

  • Verify fillloot dependency installed (if required)
  • Check loot table configuration
  • Ensure world allows entity spawns

Performance Issues​

Server Lag/TPS Drops​

Symptoms:

  • Server TPS below 20
  • Lag during plugin operations
  • High CPU/RAM usage

Solutions:

  1. Check Entity Count

    /minecraft:entity list
    • Too many BlockDisplays from PivotPoly?
    • Clean up unused doors/entities

  2. Optimize Configurations

    • Reduce animation complexity
    • Limit concurrent operations
    • Adjust update intervals

  3. Monitor with Timings

    /timings on
    # Let run for a while
    /timings paste

Memory Issues​

Symptoms:

  • OutOfMemoryError in console
  • Server crashes
  • Extreme lag

Solutions:

  1. Increase RAM Allocation

    java -Xms4G -Xmx4G -jar server.jar

  2. Clean Up Data

    • Delete unused doors/teams/crates
    • Clear old logs
    • Optimize database

Database/Storage Issues​

Data Not Saving​

Symptoms:

  • Configuration resets
  • Doors/teams disappear
  • Progress lost

Solutions:

  1. Check File Permissions

    ls -l plugins/PluginName/
    # Ensure server can write

  2. Verify Disk Space

    df -h
    # Ensure sufficient space

  3. Check for Crashes

    • Review logs for errors during save
    • Look for corrupted YAML files

Corrupted Configuration Files​

Symptoms:

  • Plugin fails to load
  • YAML parse errors in console

Solutions:

  1. Restore from Backup

    cp plugins/Plugin/config.yml.backup plugins/Plugin/config.yml

  2. Validate and Fix YAML

    • Use online YAML validator
    • Fix syntax errors (tabs, colons, indentation)

  3. Delete and Regenerate

    # Backup first!
    mv plugins/Plugin/config.yml plugins/Plugin/config.yml.broken
    # Restart server to regenerate defaults

Known Conflicts​

WorldEdit​

  • Issue: Wand conflicts with PivotPoly
  • Solution: Use different wand items or disable WorldEdit wand

Other Selection Plugins​

  • May interfere with region selection tools
  • Temporarily disable for setup

Heavy Redstone Systems​

  • Can trigger too many animations
  • Add delays or limit redstone triggers

Getting Help​

If you can't resolve your issue:

  1. Gather Information:

    • Server version: /version
    • Plugin version: /plugins
    • Console errors (full stack trace)
    • Configuration files
    • Steps to reproduce

  2. Check Resources:

    • Plugin-specific documentation
    • CHANGELOG.md for known issues
    • GitHub issues page

  3. Ask for Support:

    • Discord - Fastest response
    • GitHub Issues - For bug reports
    • Include all gathered information

Reporting Bugs​

When reporting bugs, include:

  1. Server Information:

    Server version: Paper 1.21.3 build 123
    Java version: OpenJDK 21.0.1
    Plugin version: PluginName 1.0

  2. Steps to Reproduce:

    • Clear, numbered steps
    • Expected vs actual behavior

  3. Error Messages:

    • Full console output
    • Stack traces
    • Relevant logs

  4. Configuration:

    • Attach relevant config files
    • Note any customizations

Still need help? Join our Discord for community support!