CoordinateOffset
\n================
\n**A Minecraft Paper plugin that configurably obfuscates players’ coordinates.**<\/p>\n
<\/p>\n
\n
\n<\/p>\n
\n
\n
\n
\n
\n<\/p>\n
Minecraft offers a useful debug menu (F3) that allows anyone to easily see their coordinates in the world.
\nThis makes it easy to save points of interest and share locations with friends (or enemies).<\/p>\n
However, not all multiplayer servers want coordinates to be so easily accessible. `\/gamerule reducedDebugInfo` can
\nadministratively hide coordinates from the F3 menu, but it is trivial for a player to add a client-side mod that
\nshows them.<\/p>\n
<\/p>\n
**CoordinateOffset** is a plugin for Paper-based Minecraft servers that modifies every coordinate in packets between the
\nserver and client. The player still sees the exact same world they would normally see. But no matter which mods they
\ninstall, they cannot see their real coordinates.<\/p>\n
Why?
\n—-
\nThis plugin isn’t intended for all servers. Here are a few ideas that might make CoordinateOffset useful:
\n* **Prevent metagaming**: If you consider coordinate usage and sharing to be metagaming, this prevents it.
\n* **Amplify in-game items**: Coordinates no longer outclass compasses, lodestones, recovery compasses, and maps
\n when those coordinates are inconsistent.
\n* **Prevent coordinate leaks**: If everyone sees different coordinates, players cannot derive each other’s coordinates
\n from an accidental leak in a screenshot.
\n* **Guard the world seed**: Any unknown offset makes seed-cracking tactics harder.
\n* **Center the origin**: Put the (0, 0) coordinate anywhere you’d like.<\/p>\n
Features
\n——–
\n* Fully-configurable, flexible methods of determining how to apply offsets
\n* Generate offsets randomly for each player, or use fixed offsets for multiple players
\n* Match offsets to the player’s position, so they see themselves near the world’s origin
\n* Optionally regenerate offsets based on various player actions, including death, world change, teleport, and server
\n join
\n* Regenerate and set offsets immediately with commands
\n* Configure different offsets per-player, per-world, and with permissions
\n* Automatic scaling for offsets to ensure coordinates still align when using a nether portal
\n* Extensible API to flexibly get and set offsets
\n* Compatible with Distant Horizons, ViaVersion, and Velocity *(must be installed on Paper, not Velocity itself)*<\/p>\n
Requirements and Installation
\n—————————–
\n* **An understanding of the
\n implications of installing and incompatible plugins
\n \u2014 this plugin WILL break things.**
\n* Paper or a fork for Minecraft 1.21.4\u20131.21.11
\n* PacketEvents (latest release or dev build for Spigot)<\/p>\n
Some known **incompatible** plugins are: Most anticheats, Geyser.<\/p>\n
After ensuring that you meet the requirements, just grab the latest
\nrelease and drop it in your server’s `plugins`
\nfolder. Then follow the steps below to configure how coordinates are shifted for each player.<\/p>\n
Configuration
\n————-
\n*Main article: Configuration Guide*<\/p>\n
The main configuration file is automatically generated after the first run at `plugins\/CoordinateOffset\/config.yml`.<\/p>\n
“`yaml
\ndefaultOffsetProvider: random
\n“`<\/p>\n
The default configuration contains five predefined “offset providers”. An “offset” refers to the amount that the
\nplayer’s coordinates should appear to be shifted from their real location. Get started by picking a strategy that
\nmatches the type of offsetting you’re trying to achieve:
\n* `constant` – Specify the exact offset you want players to have.
\n* `disabled` – Players will see their real coordinates.
\n* `random` – Individually randomize each player’s offset. Optionally re-roll offsets upon player actions.
\n* `zeroAtLocation` – Use an offset based on the player’s starting location, so they see themselves near (0, 0).
\n Optionally re-center offsets upon player actions.
\n* `permission` – Assign permissions to players, like `coordinateoffset.offset.160.-240`, to control their offset.<\/p>\n
You can customize these providers further, use different providers for different players\/worlds\/groups, and define your
\nown providers. See the complete
\n**Configuration Guide**.<\/p>\n
Commands and Permissions
\n————————<\/p>\n
See the Commands and Permissions Guide
\nfor details.<\/p>\n
API
\n—
\nYou can use or extend CoordinateOffset in your own plugin by using the API. Please see the
\nAPI Guide.<\/p>\n
Support
\n——-
\n* Open an issue on GitHub to report a bug or request a feature.
\n* Join the Chips’s Mods Discord for help.<\/p>\n
Credits
\n——-
\nSpecial thanks to Cavallium for developing
\n**CoordinatesObfuscator**, which CoordinateOffset is a fork of.
\nCoordinateOffset’s packet translation logic was heavily modeled after the work done by CoordinatesObfuscator.<\/p>\n
Libraries used:
\n* PacketEvents
\n* ConfigLib
\n* bStats (Statistics for this plugin)
\n* MorePersistentDataTypes<\/p>\n","protected":false},"excerpt":{"rendered":"
Configurably obfuscate players’ coordinates.<\/p>\n","protected":false},"featured_media":45873,"template":"","meta":{"_minecraft_slug":"coordinateoffset","_minecraft_project_id":"OdYCYqTX","_minecraft_author":"Chips","_minecraft_license":"AGPL-3.0-only","_minecraft_downloads":3543,"_minecraft_follows":21,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"coordinateoffset.zip","_minecraft_size_bytes":68086649,"_minecraft_version_count":37,"_minecraft_updated_at":"2026-05-16T04:42:59.569129Z","_minecraft_date_created":"2023-07-18T06:00:16.312627Z","_minecraft_date_modified":"2026-04-07T05:51:26.839886Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/coordinateoffset","_minecraft_icon_attachment_id":45873,"_minecraft_imported_at":"2026-06-02T07:21:19+00:00","_minecraft_import_hash":"ef5a0b4c33fececd776d1dda8005341a","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,89,126,127,128,129,92],"mod_loader":[130,132,133,134],"minecraft_version":[49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-45872","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","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","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n