![\"logo\"](\"https:\/\/imgur.com\/wjxP6Wh.png\")
<\/p>\n# PlayerCulling<\/p>\n
<\/p>\n
\n
\n
\n<\/p>\n
## Description<\/p>\n
PlayerCulling is an anti-cheat plugin and mod for Minecraft servers. It prevents players from seeing other players
\nthrough walls using cheats. It utilizes a unique allocationless asynchronous voxel stepping-faced-ray-casting algorithm.<\/p>\n
## Features<\/p>\n
– Asynchronous, multithreaded culling PlayerCulling uses a custom multi-threaded culling execution system. Using this system, PlayerCulling is able to scale To limit the amount of resources PlayerCulling can use, see the thread limit in the plugin configuration. Here are some examples on how the PlayerCulling scheduler works. One container is able to handle the load of 42 players without many problems.<\/p>\n If the load increases, the scheduler will automatically create a second If a container is no longer used because the load decreased, it gets parked first. The scheduling system is theoretically able to scale to an infinite amount of containers. If the load of multiple containers is too low, they will be Using this view you can keep track of PlayerCulling’s performance.<\/p>\n The first bossbar shows info about the container with the highest load and general – The count of **R**unning containers The second bossbar shows the load of the occlusion world cache, The third bossbar shows info about culled players. The maximum amount In this example, a total of 112 players are together in an area. The server was running in an arch linux desktop ### Supported Software<\/p>\n | Server Version | Paper | Folia | Fabric | #### Dependencies on Fabric:<\/p>\n – Fabric API<\/p>\n ## Usage<\/p>\n PlayerCulling can be installed like any other bukkit plugin. ### Configuration<\/p>\n After the first start, PlayerCulling will automatically create a configuration file. On paper under – `config-version`: Don’t touch this Note: If you’re not sure what a configuration option does, it’s best to leave it at its default value.<\/p>\n ### Locator Bar \/ Waypoints<\/p>\n The locator bar was introduced in Minecraft 1.21.6 and allows players to see the direction of other players. As this Note: Players can still triangulate the real X and Z coordinates of players, use the `hidden` mode to prevent The following modes are available:<\/p>\n | Mode | Description | ### Permissions<\/p>\n | Permission | Description | See the table below for command permissions.<\/p>\n ### Commands<\/p>\n | Command | Description | Permission | Note: `[…]` is an optional argument, `<...>` is a required argument<\/p>\n PlayerCulling uses brigadier for commands which means command blocks and datapacks are also able to use these commands. – `\/execute as Notch run playerculling hidden` will show you the hidden players of the player `Notch`, if online ### API setup<\/p>\n `PlayerCulling` has to be added as a dependency to the `plugin.yml` regardless of the build system used. On Fabric add “`xml<\/p>\n “`xml<\/p>\n “`groovy dependencies { “`kotlin dependencies { ### API usage<\/p>\n Basic paper plugin example:<\/p>\n “`java @Override \/\/ example: disable culling for the player “Notch”, if online Basic fabric mod example:<\/p>\n “`java @Override ## Building<\/p>\n 1. Clone the project (`git clone https:\/\/github.com\/MinceraftMC\/PlayerCulling.git`) The PlayerCulling jars can be found in the `build` \u2192 `libs` directory.<\/p>\n ### Contributing<\/p>\n If you want to contribute to PlayerCulling, feel free to fork the repository and create a pull request. You can test your changes by running `.\/gradlew plugin-paper:runServer` or `.\/gradlew platform-fabric:runServer`. This A culling paper\/folia plugin and fabric mod designed to prevent players from seeing each other through walls using cheats.<\/p>\n","protected":false},"featured_media":122651,"template":"","meta":{"_minecraft_slug":"playerculling","_minecraft_project_id":"CI9dvSKN","_minecraft_author":"booky10","_minecraft_license":"AGPL-3.0-or-later","_minecraft_downloads":17582,"_minecraft_follows":41,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"playerculling.zip","_minecraft_size_bytes":20849311,"_minecraft_version_count":18,"_minecraft_updated_at":"2026-05-16T00:52:25.278578Z","_minecraft_date_created":"2025-06-17T08:15:41.734622Z","_minecraft_date_modified":"2026-02-14T22:42:02.171464Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/playerculling","_minecraft_icon_attachment_id":122651,"_minecraft_imported_at":"2026-06-07T05:04:45+00:00","_minecraft_import_hash":"4b558a16740745c92b0e65ad39bd0e5d","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[97,125,89,126,127,128,92],"mod_loader":[99,131,132,133],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-122650","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-fabric","mod_category-folia","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-utility","mod_loader-fabric","mod_loader-folia","mod_loader-paper","mod_loader-purpur","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n– Allocationsless voxel raycasting algorithm
\n– Advanced scheduler system
\n– Support for nametag visibility, potions, glowing and spectating
\n– 2x2x2-scale voxel occlusion for non-full blocks
\n– Efficient storage of occlusion block data
\n– Nearly instant block updates
\n– Easily enable\/disable culling globally\/per-player<\/p>\n\nScheduler Overview<\/strong><\/summary>\n
\naccording to server load, and can cull both very few players and very many players, as long as enough CPU is available.
\nThe scheduler will dynamically start\/stop threads (“containers”) based on how many threads are needed.<\/p>\n
\nBy default it limits itself to (number of CPU threads \/ 3).<\/p>\n
\nThe following examples were tested on an arch linux desktop environment with an AMD Ryzen 5 3600X CPU:<\/p>\n\n
\nOne Container<\/summary>\n
![\"One](\"https:\/\/imgur.com\/aImcHRU.gif\")
\n<\/details>\n<\/li>\n\nTwo Containers<\/summary>\n
\ncontainer and distribute the players to maintain a buffer. In this example, a total of 55 players are together in an area.<\/p>\n![\"Two](\"https:\/\/imgur.com\/WskzbWA.gif\")
\n<\/details>\n<\/li>\n\nCleanup of Containers<\/summary>\n
\nAfter its time-to-live (TTL) runs out because the load didn’t increase again,
\nit will get cleaned up automatically.<\/p>\n![\"One](\"https:\/\/imgur.com\/ahP2Ynm.gif\")
\n<\/details>\n<\/li>\n\nHeavy Load<\/summary>\n
\nAs long as the load increases (and the limit of containers hasn’t been reached yet), the scheduler
\nwill automatically continue to add more containers. In this example, a total of 112 players are together in an area.<\/p>\n![\"A](\"https:\/\/imgur.com\/Z1Gkxxd.gif\")
\n<\/details>\n<\/li>\n\nMerging of Containers<\/summary>\n
\nmerged together after a few seconds.<\/p>\n![\"A](\"https:\/\/imgur.com\/qqFvxk2.gif\")
\n<\/details>\n<\/li>\n<\/ul>\n<\/details>\n\nPerformance Overview<\/strong><\/summary>\n
\ncontainer scheduling statistics:<\/p>\n
\n– The count of **P**arked containers
\n– The count of total container **T**hreads
\n– The count of total **R**aysteps per cull tick<\/p>\n
\nthe working threads, amount of **C**ompleted tasks,
\namount of **S**tored chunks and the chunk cache size in bytes.<\/p>\n
\nof culled players can be calculated by (playercount) * (playercount – 1).<\/p>\n
\nenvironment with an AMD Ryzen 5 3600X CPU.<\/p>\n![\"Performance](\"https:\/\/imgur.com\/3cFkBec.gif\")
\n<\/details>\n
\n|:————–:|:—–:|:—–:|:——:|
\n| 1.21.11 | \u2705 | \u2705 | \u2705 |
\n| 1.21.10 | \u2705 | \u2705 | \u2705 |
\n| 1.21.9 | \u2705 | \u2705 | \u2705 |
\n| 1.21.8 | \u2705 | \u2705 | \u2705 |
\n| 1.21.7 | \u2705 | \u2705 | \u2705 |
\n| 1.21.6 | \u2705 | \u2705 | \u2705 |
\n| 1.21.5 | \u2705 | \u2705 | \u2705 |
\n| 1.21.4 | \u2705 | \u2705 | \u2705 |
\n| 1.21.3 | \u2705 | \u274c | \u274c |
\n| 1.21.2 | \u2705 | \u274c | \u274c |
\n| 1.21.1 | \u2705 | \u274c | \u274c |
\n| 1.21 | \u2705 | \u274c | \u274c | <\/p>\n
\nPlace the jar file in your `plugins` directory. On Fabric as well, just place the jar file and the dependencies listed
\nabove in your
\n`mods` directory and restart your server.<\/p>\n
\n`plugins\/PlayerCulling\/config.yml` or on Fabric `config\/playerculling.yml`. In there, you are able to configure the
\nfollowing options:<\/p>\n
\n– `scheduler`:
\n – `max-threads`: The maximum amount of threads allowed to use (default: `cpu threads \/ 3`)
\n – `cleanup-interval`: The interval to check for cleanup of threads in seconds (default: `30`)
\n – `container-ttl`: The time-to-live of unused threads (default: `30`)
\n – `max-cull-time`: The maximum time a thread is allowed to have in milliseconds (default: `45`)
\n – `max-transfer-factor`: If the load percentage of a thread is below this factor, it is allowed to accept more tasks
\n from other overloaded threads (default: `0.7`)
\n – `max-merge-factor`: If the combined load percentage of two threads is below this factor, the two threads are
\n allowed to merge together (default: `0.5`)
\n– `culling`:
\n – `nametag-visibility-distance`: The distance in blocks PlayerCulling will check for nametag visibility. Set to `0` to
\n ignore nametags completely (default: `64`, vanilla)
\n – `blacklisted_worlds`: A list of worlds where PlayerCulling should be disabled (default: `[]`)
\n– `updater`:
\n – `enabled`: Enables\/disables the update checker (default: `true`)
\n – `notify-admins`: Whether to notify admins about new PlayerCulling releases (default: `true`)
\n – `interval-hours`: The update check interval in hours (default: `24`)
\n– `waypoint-mode`: The mode for the waypoint system, see the [Locator Bar \/ Waypoints](#locator-bar–waypoints) section
\n for more information. (default: `HIDDEN`)<\/p>\n
\nwould reveal the real location of players and defeat the purpose of PlayerCulling, PlayerCulling will disable all player
\nrelated waypoints by default. If you still want to use the locator bar, you can use the `waypoint-mode` option in the
\nconfiguration file, see below for more info.<\/p>\n
\nthis<\/b>
\n<\/b><\/p>\n
\n|——————|—————————————————————————————————————|
\n| `HIDDEN` | PlayerCulling will disable all player related waypoints (default) |
\n| `AZIMUTH` | PlayerCulling will send the angle between players to the viewer |
\n| `CULLED_AZIMUTH` | PlayerCulling will send the angle between players to the viewer, if the other player is visible to the viewer |
\n| `VANILLA` | The locator bar will not be changed by PlayerCulling, this makes PlayerCulling effectively useless |<\/p>\n
\n|——————————-|————————————————————————————————————————————————————————————————|
\n| `playerculling.update-notify` | If not disabled, players with this permission will receive update notifications |
\n| `playerculling.bypass` | Players with this permission will be ignored by PlayerCulling and therefore be able to always see anyone. Use commands (`\/playerculling toggle`) or API instead of this permission if possible |<\/p>\n
\n|——————————————————————————————————————————————————————————————-|———————————————————————————————————————————————————————————————————————————————–|————————————————————————————————————–|
\n| `\/playerculling blockdebug [raw] [block]`
`\/playerculling blockdebug [block]` | Checks the occluding status of a block in sight of the target entity or specified by the `block` argument. The `raw` argument specifies, if `true` get status from minecraft world, if `false` get status from PlayerCulling occlusion cache. | `playerculling.command.blockdebug` |
\n| `\/playerculling chunkcache` | Gives information about the stored chunks in the PlayerCulling occlusion cache. If the executor is an entity, you will get more information about the entity’s chunk. | `playerculling.command.chunkcache` |
\n| `\/playerculling chunksizes` | Gives the byte size of each chunk in the executors world. You can click on a chunky entry to teleport. | `playerculling.command.chunksizes` |
\n| `\/playerculling cleancontainers [force]` | Triggers the cleanup process manually. The `force` argument decides if you check for the ttl or not. | `playerculling.command.cleancontainers` |
\n| `\/playerculling viewcontainers` | Toggles the view of the container scheduler. It shows the status, load and player count. Please note: The boss bar count is limited by your gui size, minecraft only renders boss bars over one third of the windows size. | `playerculling.command.viewcontainers` |
\n| `\/playerculling hidden` | Shows the hidden list of the executor. | `playerculling.command.hidden` |
\n| `\/playerculling performance` | Toggles the view of the PlayerCulling performance, overall occlusion cache size, and culled players count. Please note: The boss bar count is limited by your gui size, minecraft only renders boss bars over one third of the windows size. | `playerculling.command.performance` |
\n| `\/playerculling raycastdebug
`\/playerculling raycastdebug
`\/playerculling raycastdebug
\n| `\/playerculling reloadconfig` | Reloads the configuration. | `playerculling.command.reloadconfig` |
\n| `\/playerculling toggle global [enabled]`
`\/playerculling toggle player
\nAdditionally, this also means `\/execute` can recognize these commands and you are able to change the executor\/location
\nof the executed command. For example:<\/p>\n
\n– `\/execute as @a run playerculling hidden` will show you the hidden players of everyone online<\/p>\n
\n`playerculling` to the `fabric.mod.json` file.<\/p>\n\nMaven<\/strong><\/summary>\n
\n
\n
\n
\n <\/repository>
\n<\/repositories>
\n“`<\/p>\n
\n
\n
\n
\n
\n
\n <\/dependency>
\n<\/dependencies>
\n“`<\/p>\n<\/details>\n\nGradle (groovy)<\/strong><\/summary>\n
\nrepositories {
\n maven {
\n url = ‘https:\/\/repo.minceraft.dev\/releases\/’
\n name = ‘minceraft’
\n }
\n}<\/p>\n
\n compileOnly ‘de.pianoman911:playerculling-api:2.1.4-SNAPSHOT’
\n}
\n“`<\/p>\n<\/details>\n\nGradle (kotlin)<\/strong><\/summary>\n
\nrepositories {
\n maven(“https:\/\/repo.minceraft.dev\/releases\/”) {
\n name = “minceraft”
\n }
\n}<\/p>\n
\n compileOnly(“de.pianoman911:playerculling-api:2.1.4-SNAPSHOT”)
\n}
\n“`<\/p>\n<\/details>\n
\npublic class ExamplePlugin extends JavaPlugin {<\/p>\n
\n public void onEnable() {
\n \/\/ this loads the player culling api from bukkit’s services manager
\n PlayerCullingApi api = Bukkit.getServicesManager().load(PlayerCullingApi.class);<\/p>\n
\n Player player = Bukkit.getPlayer(“Notch”);
\n if (player != null) {
\n api.setCullingEnabled(player.getUniqueId(), false);
\n }
\n }
\n}
\n“`<\/p>\n
\npublic class ExampleMod implements ModInitializer {<\/p>\n
\n public void onInitialize() {
\n FabricLoader.getInstance().getObjectShare().whenAvailable(“playerculling:api”, (__, obj) -> {
\n if (!(obj instanceof PlayerCullingApi api)) {
\n return;
\n }
\n \/\/ Toggle global culling
\n api.setCullingEnabled(false);
\n });
\n }
\n}
\n“`<\/p>\n
\n2. Go to the cloned directory (`cd PlayerCulling`)
\n3. Build the jar (`.\/gradlew build` on Linux\/MacOS, `gradlew build` on Windows)<\/p>\n
\nPlease make sure to follow the code style and conventions used in the project. If you have any questions or need help,
\nfeel free to ask in our Discord.<\/p>\n
\nwill start a local development server with the compiled plugin or mod automatically installed. This can be combined with
\nthe debugger of your IDE.
\nPlease note that the update checker will be automatically disabled when running in a development environment.<\/p>\n","protected":false},"excerpt":{"rendered":"