Skip to content

Cubicake/RaycastedEntityOcclusions

Repository files navigation

Latest stable version: v1.6.5 | Latest beta version: v2.0.0-beta-1

The latest stable version can currently only be found on Modrinth https://modrinth.com/plugin/raycasted-entity-occlusions/

The latest beta version can be found on the discord.

This is an async plugin for PaperMC and its forks that hides/culls entities (and tile entities) from players if they do not have line-of-sight.

The supported versions are 1.21.x PaperMC and Pufferfish. Other server versions and software may work too.

Use cases:

  • Prevent cheating (anti-esp hacks)
    • Block usage of pie-ray to locate underground bases
    • Prevent mods such as mini-maps or cheat clients from displaying the locations of hidden entities
  • Increase client-side performance for low-end devices
    • Massive megabases containing hundreds of armour stands, item frames, banners etc can cause performance issues on low-end devices unable to process so many entities. REO will cull those entities for the client, reducing the number of entities to process.
  • Hide nametags behind walls
    • Yes, this plugin is a bit overkill for doing that, yes you can do it anyways.

Dependencies:

  • Packetevents (soft depend)
    • Only needed if you are using the cull-players option and wish for the players to remain in the tablist

Known issues:

  • Due to the nature of the plugin, there will be a short delay once an entity should be visible before it appears, causing it to appear like it "popped" into view. This issue is partially resolved by turning engine-mode to 2, and is worse for players with higher ping.

Contributions

Contributions via pull requests are welcome. Please join our discord to discuss any contributions beforehand to make sure they will not conflict with or hinder existing plans.

You must hold the rights to any code you contribute, and must agree to licence it under the same licence as the rest of the project in perpetuity, explicitly including any and all changes to the project's licence by project maintainers in the future. The project's licence can always be found at LICENSE.md.

About

A simple entity culling plugin for Minecraft PaperMC

Resources

License

Stars

Watchers

Forks

Sponsor this project

Packages

No packages published

Languages