Commands
All the ImanitySpigot built-in commands.
/imanityspigot
The main command that contains features such as ChunkAnalyzer, Lag Spike Detector, Debug Information, and reload inside
Permission: imanity.command.main
Aliases: /imanity, /ispigot
Usages
reload
Reload ImanitySpigot configurations: config.yml, knockback profiles, and premium.yml
Please note that this command will reload configurations but some options may be fixed, require a reboot to reload.
syncload
The main command for sync loads' catcher data. Sync load catcher is a tool to catch when an attempt to load chunk synchronicity, which is an action being very harmful when you have async chunk enabled.
Using this tool, you can get stacktrace and their used count.
If your server is lagging and have async chunk enabled but your server consumes chunks. Try using this tool to see if there is any sync load happening. We generally want to prevent any sync load from happening.
This tool only being useful when you are a developer, and you understand how to read stacktrace.
In order to enable sync load catcher you will need to have
- Async Chunk enabled
-Dimanity.debug-sync-loads=truein your startup flags
syncload export
The command to export syncload data, It will export as a file inside the debug folder.
syncload clear
The command to clear syncload data
dumpChunks
The tool to dump information for every chunk, useful to search how each chunks got generated.
It will cache chunk coords and chunk creation stacktrace for scheduled chunks and loaded chunks. If you find that your server has loaded an unreasonable amount of chunks, try to use this tool to search.
This tool only being useful when you are a developer, and you understand how to read stacktrace.
In order to enable sync load catcher you will need to have
- Async Chunk enabled
-Dimanity.debug-sync-loads=truein your startup flags
Chunk Analyzer is a Premium only feature.
chunkAnalyzer
The tool to analyze chunk tick time data. It is very useful to see what chunk is causing server lag, you will have to start the analyzer for analyzer to cache tick time data, and stop it to check cached information.
chunkAnalyzer start
Start the chunk analyzer.
chunkAnalyzer stop
Stop the chunk analyzer.
chunkAnalyzer show
Display analyzer information. This command will sort information and highlight chunks that have unusual tick times. Give you the ability to find lags quickly.
chunkAnalyzer export
Export analyzer information. It will export as JSON format, and you can save it or share it to anyone for situations such as discussing with developers.
You can use the flag -u to upload the JSON to code.imanity.dev
Please note that uploading to online site will cap maximum amount of chunks to export at 50.
Display / Export Shared Flags
| Flag | Input Type | Description |
|---|---|---|
| -t | ALLENTITIESTILE_ENTITIESBLOCK_OPERATION | Specify sort targets:ALL sort by every types of target combinedENTITIES sort by Entities Tick TimeTILE_ENTITIES sort by Tile Entities Tick TimeBLOCK_OPERATION sort by Block Tick Time. |
| -m | BY_TOTALBY_AVGBY_MAX | Specify sort methods:BY_TOTAL sort by the total tick spent combined within the analyzer period.BY_AVG sort by the average tick time during the analyzer period.BY_MAX sort by the maxmium tick time during the analyzer period. |
| -w | World Name | Specify the world to show/export with |
| -e | Entity / Tile Entity Type Name | Specify target with type of Entity or Tile Entities |
| -c | Number | Specify maximum count to show/export |
Lag spike detection is a Premium only feature.
lagSpike
The tool to detect lag spike happens during runtime, this is the main command to control on or off for the feature
lagSpike enable
Enable lag spike detector.
lagSpike enable
Disable lag spike detector.
/ping
Check connection ping from the command sender, must be executed by Player.
Permission: imanity.command.ping
/ping <player name>
Check connection ping from a target player, this can be executed in console.
/setMaxSlot <number>
Set current max player limit to the target number.
Permission: imanity.command.setmaxslot
Aliases: /setMaxSlot, /setslot, /setslots
/MobAI
Toggle Mob AI in game.
Permission: imanity.command.mobai
Aliases: /ai, /toggleAI, /toggleMobAI