CoordinateOffset
一款 Minecraft Paper 插件,可按配置混淆玩家的坐标。
Minecraft 提供了一个有用的调试菜单(F3),允许任何人轻松查看他们在世界中的坐标。 这使得保存兴趣点和与朋友(或敌人)共享位置变得很容易。
然而,并非所有多人服务器都希望坐标如此容易获取。/gamerule reducedDebugInfo 可以
在管理层面隐藏 F3 菜单中的坐标,但玩家只需添加一个客户端模组即可轻易显示它们。

CoordinateOffset 是一款用于基于 Paper 的 Minecraft 服务器的插件,它修改服务器和客户端之间数据包中的每一个坐标。玩家仍然会看到他们通常看到的完全相同的世界。但是无论他们安装哪些模组,都无法看到他们的真实坐标。
为什么?
本插件并非适用于所有服务器。以下是一些可能使 CoordinateOffset 有用的想法:
- 防止超游戏行为(Metagaming):如果你认为坐标的使用和分享属于超游戏行为,这可以阻止它。
- 增强游戏内物品价值:当坐标不一致时,坐标不再压倒指南针、锚点、死亡回归指南针和地图的优势。
- 防止坐标泄露:如果每个人看到的坐标都不同,玩家就无法从截图中的意外泄露中推导出彼此的坐标。
- 保护世界种子:任何未知的偏移量都会使破解种子的策略变得更加困难。
- 居中原点:将 (0, 0) 坐标放置在你想要的任何地方。
功能
- 完全可配置、灵活的方法来确定如何应用偏移量
- 为每个玩家随机生成偏移量,或为多个玩家使用固定偏移量
- 将偏移量与玩家的位置匹配,使他们看到自己靠近世界原点
- 可选地根据各种玩家操作重新生成偏移量,包括死亡、世界切换、传送和加入服务器
- 通过命令立即重新生成和设置偏移量
- 配置针对不同玩家、不同世界以及权限的不同偏移量
- 自动缩放偏移量以确保在使用下界传送门时坐标仍然对齐
- 可扩展 API 以灵活获取和设置偏移量
- 兼容 Distant Horizons、ViaVersion 和 Velocity (必须安装在 Paper 上,而不是 Velocity 本身)
要求和安装
- 了解 安装不兼容插件的影响 — 此插件 WILL break things.(会导致问题。)
- Paper 或其分支
- PacketEvents(最新发行版或 Spigot 的 开发构建)
一些已知的不兼容插件包括:大多数反作弊插件、Geyser。
在确保满足要求后,只需下载最新的
发行版并将其放入服务器的 plugins
文件夹中。然后按照以下步骤配置如何为每个玩家偏移坐标。
配置
主文章:配置指南
主配置文件会在首次运行后自动生成,位于 plugins/CoordinateOffset/config.yml。
defaultOffsetProvider: random
默认配置包含五个预定义的“偏移提供程序”。“偏移”指的是玩家的坐标应相对于其实际位置显示的位移量。首先选择一种与你想要实现的偏移类型相匹配的策略:
constant- 指定你希望玩家拥有的确切偏移量。disabled- 玩家将看到他们的真实坐标。random- 为每个玩家单独随机化其偏移量。可选地在玩家执行操作时重新掷骰子生成偏移量。zeroAtLocation- 基于玩家的起始位置使用偏移量,使他们看到自己位于 (0, 0) 附近。可选地在玩家执行操作时重新居中偏移量。permission- 为玩家分配权限(例如coordinateoffset.offset.160.-240),以控制其偏移量。
你可以进一步自定义这些提供程序,为不同的玩家/世界/组使用不同的提供程序,并定义你自己的提供程序。请参阅完整的 配置指南。
命令与权限
有关详细信息,请参阅 命令与权限指南。
API
你可以使用 API 在自有插件中使用或扩展 CoordinateOffset。请参阅 API 指南。
支持
- 在 GitHub 上提交 issue 以报告错误或请求新功能。
- 加入 Chips's Mods Discord 服务器寻求帮助。
致谢
特别感谢 Cavallium 开发了 CoordinatesObfuscator,CoordinateOffset 即为其分支。 CoordinateOffset 的数据包翻译逻辑大量借鉴了 CoordinatesObfuscator 所做的工作。
使用的库:
CoordinateOffset
A Minecraft Paper plugin that configurably obfuscates players' coordinates.
Minecraft offers a useful debug menu (F3) that allows anyone to easily see their coordinates in the world. This makes it easy to save points of interest and share locations with friends (or enemies).
However, not all multiplayer servers want coordinates to be so easily accessible. /gamerule reducedDebugInfo can
administratively hide coordinates from the F3 menu, but it is trivial for a player to add a client-side mod that
shows them.

CoordinateOffset is a plugin for Paper-based Minecraft servers that modifies every coordinate in packets between the server and client. The player still sees the exact same world they would normally see. But no matter which mods they install, they cannot see their real coordinates.
Why?
This plugin isn't intended for all servers. Here are a few ideas that might make CoordinateOffset useful:
- Prevent metagaming: If you consider coordinate usage and sharing to be metagaming, this prevents it.
- Amplify in-game items: Coordinates no longer outclass compasses, lodestones, recovery compasses, and maps when those coordinates are inconsistent.
- Prevent coordinate leaks: If everyone sees different coordinates, players cannot derive each other's coordinates from an accidental leak in a screenshot.
- Guard the world seed: Any unknown offset makes seed-cracking tactics harder.
- Center the origin: Put the (0, 0) coordinate anywhere you'd like.
Features
- Fully-configurable, flexible methods of determining how to apply offsets
- Generate offsets randomly for each player, or use fixed offsets for multiple players
- Match offsets to the player's position, so they see themselves near the world's origin
- Optionally regenerate offsets based on various player actions, including death, world change, teleport, and server join
- Regenerate and set offsets immediately with commands
- Configure different offsets per-player, per-world, and with permissions
- Automatic scaling for offsets to ensure coordinates still align when using a nether portal
- Extensible API to flexibly get and set offsets
- Compatible with Distant Horizons, ViaVersion, and Velocity (must be installed on Paper, not Velocity itself)
Requirements and Installation
- An understanding of the implications of installing and incompatible plugins — this plugin WILL break things.
- Paper or a fork
- PacketEvents (latest release or dev build for Spigot)
Some known incompatible plugins are: Most anticheats, Geyser.
After ensuring that you meet the requirements, just grab the latest
release and drop it in your server's plugins
folder. Then follow the steps below to configure how coordinates are shifted for each player.
Configuration
Main article: Configuration Guide
The main configuration file is automatically generated after the first run at plugins/CoordinateOffset/config.yml.
defaultOffsetProvider: random
The default configuration contains five predefined "offset providers". An "offset" refers to the amount that the player's coordinates should appear to be shifted from their real location. Get started by picking a strategy that matches the type of offsetting you're trying to achieve:
constant- Specify the exact offset you want players to have.disabled- Players will see their real coordinates.random- Individually randomize each player's offset. Optionally re-roll offsets upon player actions.zeroAtLocation- Use an offset based on the player's starting location, so they see themselves near (0, 0). Optionally re-center offsets upon player actions.permission- Assign permissions to players, likecoordinateoffset.offset.160.-240, to control their offset.
You can customize these providers further, use different providers for different players/worlds/groups, and define your own providers. See the complete Configuration Guide.
Commands and Permissions
See the Commands and Permissions Guide for details.
API
You can use or extend CoordinateOffset in your own plugin by using the API. Please see the API Guide.
Support
- Open an issue on GitHub to report a bug or request a feature.
- Join the Chips's Mods Discord for help.
Credits
Special thanks to Cavallium for developing CoordinatesObfuscator, which CoordinateOffset is a fork of. CoordinateOffset's packet translation logic was heavily modeled after the work done by CoordinatesObfuscator.
Libraries used:
下载 CoordinateOffset
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CoordinateOffset
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CoordinateOffset
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CoordinateOffset
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CoordinateOffset
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CoordinateOffset
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CoordinateOffset
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CoordinateOffset
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CoordinateOffset
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 CoordinateOffset
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
支持的 Minecraft 服务器:Paper 26.1.2-26.3
- 支持 26.3
- 将最低 Minecraft 版本要求提升至 26.1.2
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
使床在所有维度中爆炸的模组
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
评论 0
登录后参与评分
还没有评论,来抢沙发吧