Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/senseiwells/chunkdebug
ChunkDebug is a useful tool for debugging chunk loading. It provides you with a live display of all the loaded chunks in any given dimension.
https://github.com/senseiwells/chunkdebug
chunk-debug fabric-mod minecraft minecraft-mod
Last synced: about 1 month ago
JSON representation
ChunkDebug is a useful tool for debugging chunk loading. It provides you with a live display of all the loaded chunks in any given dimension.
- Host: GitHub
- URL: https://github.com/senseiwells/chunkdebug
- Owner: senseiwells
- License: mit
- Created: 2021-12-22T15:35:13.000Z (about 3 years ago)
- Default Branch: 1.21.3
- Last Pushed: 2024-10-24T19:21:47.000Z (2 months ago)
- Last Synced: 2024-10-25T12:30:57.177Z (2 months ago)
- Topics: chunk-debug, fabric-mod, minecraft, minecraft-mod
- Language: Java
- Homepage:
- Size: 16.5 MB
- Stars: 13
- Watchers: 1
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 
ChunkDebug
## What is ChunkDebug?
ChunkDebug is an extremely useful tool for debugging chunk loading.
It provides you with a live display of all the loaded chunks in any given dimension.
It is able to display the chunk's current status, any chunk tickets, as well as
the chunk world generation stage.
ChunkDebug was originally made for [CarpetClient 1.12.2](https://github.com/X-com/CarpetClient).
I have completely re-written the mod to support modern versions of Minecraft.
I only plan on maintaining the mod for the **latest** version of Minecraft.
## How to use ChunkDebug
ChunkDebug is required on both the client and the server.
If you are playing in single player, then you only need to install this mod on the client.
You can download the mod from Modrinth:
[](https://modrinth.com/mod/chunk-debug)
If you are playing on a server, then you will need the correct permissions to use ChunkDebug.
You must be opped, or alternatively you must have the `"chunk-debug"` permission from a
permissions mod, for example [Luck Perms](https://modrinth.com/mod/luckperms).
Once you are in-game, you can hit the ChunkDebug keybind (`F6` by default) which will
open the ChunkDebug map.
You can change this key in the Minecraft controls menu.
### Chunk Map
In the centre is the ChunkDebug map, this is where the live chunk
map is displayed, you can pan and zoom around the map.
### Settings Menu
The menu on the left contains all the options for ChunkDebug.
This can be hidden by pressing `F1` or by toggling the button
in the bottom left corner.
At the top, you can change your minimap mode.
This can be configured to `No Minimap`, `Static Minimap`, where the
minimap will reflect what is currently rendering at the centre of the
chunk map, and `Following Minimap`, where the minimap will follow your player.
Below this are your navigation controls, you can navigate to different
dimensions.
As well as chunk clusters, this will cycle through any loaded groups
of chunks that are neighbouring each other.
This is a great tool for finding loaded chunks in your world.
You can also manually input your coordinates or return to the player's position.
Finally, there are some additional rendering options.
`Render Generation Stages` will colour chunks based on their world
generation stage, this can get quite messy so an option to disable it is provided.
`Render Ticket Types` will colour chunks based on their ticket types.
`Render Minimap` will render the minimap *on top* of the chunk map, this is useful for lining up your minimap view.
And finally `Chunk Retention` is the number of ticks you'd like to
retain unloaded chunks, after a chunk unloads it will fade out for the
number of ticks specified.
This is useful for debugging chunks that unload rapidly.
You can configure the position of the minimap; you first select the corner you want
the minimap to render relative to by changing the `Minimap Corner` configuration,
if you want to further fine-tune the position of the minimap you can enable `Render Minimap`
which will allow you to click and drag the minimap around.
You can also scroll while hovering the minimap to resize it.
### Selection Menu
You can select chunks on the chunk map by right-clicking, this will
highlight the chunk with a red outline, it will also bring up a menu
on the right displaying all the relevant information for that chunk.
This menu can be closed much like the settings menu with `F1` or the button in the bottom right.
The menu displays the location of the chunks, as well as the chunk
status;
you can read more about what this means on the [Minecraft Wiki Page](https://minecraft.wiki/w/Chunk#Level_and_load_type).
The separation of the `Status Level` and `Ticking Status Level` is due to the split of Simulation Distance and Render Distance.
Below, all the tickets for the selected chunk are listed, including
the type of the ticket and the level.
Below that is the `Generation Stage` which is how far the chunk has generated.
And finally, whether the chunk has been scheduled for unloading.
You are also able to select multiple chunks by dragging right-click,
this will highlight a region of chunks with a red outline.
The menu will now display less specific information but displays
data for all the selected chunks.
It shows the location and area of your selection.
The status level range of the chunks, as well as the status distributions of all the chunks.
And finally a count of all the ticket types within the selection.