Orebfuscator 是一款用于对抗 X 射线客户端模组、材质包、箱子雷达等作弊行为的 Minecraft 插件。它通过修改发送给客户端的数据来隐藏指定的方块，例如矿石、箱子和地牢等，但不会修改世界文件中的方块，使用安全。ProximityHider 功能可以隐藏远离玩家的箱子。

⛏️ Orebfuscator - 反 X 射线插件

版本

• 原生 Minecraft 版本: 1.13
• 测试 Minecraft 版本: 1.9, 1.10, 1.11, 1.12, 1.13
• 当前版本: 4.4.3 (CraftBukkit 1.9, 1.9.1, 1.9.2, 1.9.4, 1.10, 1.11, 1.12, 1.13, 1.13.1, 1.13.2)

🔗 链接

• 源代码: GitHub
• 配置指南: 配置指南
• 配置文件: 配置文件
• 常见问题解答: FAQ
• 下载最新版本: GitHub Releases

✨ 主要功能

• 高级算法隐藏矿石、箱子以及任何你在配置中指定的方块。
• Spout 兼容（可选）。
• 无需修改 CraftBukkit.jar。
• 自定义需要隐藏的方块。
• 隐藏地牢和其他黑暗中的方块。
• 不同的隐藏模式或扰乱模式。
• 丰富的配置选项，可以根据带宽和处理速度调整更新方法。
• 隐藏箱子和熔炉，直到玩家靠近或看到它们。
• 视线检测的 Proximity Hider。

⚙️ 使用方法

安装

1. 将 "orebfuscator-4.4.3.jar" 或最新版本复制到你的 plugins 文件夹。
2. 如果你是从早期版本升级，请将 "Orebfuscator3" 文件夹的内容移动到 "Orebfuscator4" 文件夹。
3. 重启你的服务器。
4. 请同时下载 ProtocolLib 并安装到 plugins 文件夹。需要 4.0.0 或更高版本。

配置

请参考 Wiki

命令

请参考 Wiki

权限

请参考 Wiki

💻 源代码

托管在 GitHub 上，请在此提交问题和请求。

📊 指标

本插件使用 Hidendra 的插件指标系统，会匿名收集你的操作系统和设置信息并发送到 mcstats.org。你可以通过编辑 plugins/Plugin Metrics/config.yml 并将 opt-out 设置为 true 来退出此服务。

🐛 Bug 修复

• 4.1.14 版本有重大改进，请立即更新并报告任何问题。PaperSpigot 用户必须更新。
• 1.11 支持请使用 4.2.1 或更高版本。
• 1.12 支持请使用 4.3.0 或更高版本。
• 1.13.x 支持请使用 4.4.1 或更高版本。
• 1.13.2 支持请使用 4.4.3 或更高版本。

📝 更新日志

版本 4.4.3

• 支持 Minecraft 1.13.2 最新版本 (CraftBukkit/Spigot/etc)。

版本 4.4.2

• 修复了使用过程中报告的问题，请更新。

版本 4.4.1

• 支持 Minecraft 1.13 和 1.13.x (CraftBukkit/Spigot/etc)。
• 一些底层增强，包括对 tile entity 隐藏和状态管理的更好支持。

版本 4.3.3

• 包含 #164 部分问题的修复。
• 新特性：基于视线的 Proximity Hiding。如果由于方块阻挡而无法看到，它会保持 proximity hid 状态，无论你的物理距离如何！
• 新的示例配置！请在此处查找：示例配置

版本 4.3.0

• 支持 Minecraft 1.12 (CraftBukkit/Spigot/etc)。

版本 4.2.1

• #135：解决了必须删除配置并强制重新加载和清除启动后缓存插件才能工作的问题。

版本 4.2.0

• 支持 Minecraft 1.11 (CraftBukkit/Spigot/etc)。

版本 4.1.14

• 由于大规模的性能问题，移除了 ChunkReloader。
• 解决了 #66。添加了限制缓存保留配置选项。
• 如果 Proximity Hider 和 orebfuscated 都处于活动状态，则 Proximity Hider 方块默认会被 orebfuscated。
• 实现了 #62。每个世界的配置——每个世界都有唯一的配置。
• 解决了 DevotedMC#8。允许每个隐藏材料都有唯一的 proximity Y 高度。

⚙️ 配置文件示例

#
# Configuration file for Orebfuscator
#

# engine-mode:
# 1 - Slower, less intensive.  Recommended on lower-end machines.
# 2 - Recommended for fast servers, but may cause a little more CPU usage.

engine-mode: 2

# How often, in ticks, should chunks be updated? (20 ticks = 1 second)
# Setting this too low can cause lag.
# Setting this too high can cause blocks to appear as normal for a short time.
# Recommended value is 20.
update-ticks: 20

# Should chunks be reloaded when a player moves between worlds?
# If false, a player moving between worlds will still see obfuscated blocks from the previous world.
# Requires Engine Mode 2 to function
world-change-reloads: false

# Should we attempt to fix chunk caching issues with Spigot/PaperSpigot?
# When this is enabled, blocks will remain hidden after being exposed by block break.
# Recommended value is true for Spigot/PaperSpigot servers.
chunk-caching-fix: true

# Set this to false to disable ore obfuscation entirely.
enabled: true

# Default obfuscation block is stone.  It is recommended that this not be visible to players.
# If it is, the effect is for ore to appear and disappear as players walk around.
# You can use either numerical IDs or block names (as of version 4.1.1).

default-block: STONE

# Define a list of blocks that should never be obfuscated.  Default includes bedrock, command block, etc.
# You can use either numerical IDs or block names (as of version 4.1.1).
# This CANNOT be an empty list.  If you don't want anything on it, specify one block.
# Example:
#never-obfuscate:
# - BEDROCK
# - END_PORTAL
# - COMMAND
# - COMMAND_MINECART
# - STRUCTURE_BLOCK
# - BARRIER
# - END_GATEWAY
# - REPEATING_COMMAND_MINECART
# - CHAIN_COMMAND_MINECART

never-obfuscate:
 - BEDROCK
 - END_PORTAL
 - COMMAND
 - COMMAND_MINECART
 - STRUCTURE_BLOCK
 - BARRIER
 - END_GATEWAY
 - REPEATING_COMMAND_MINECART
 - CHAIN_COMMAND_MINECART


# In engine-mode 2, should we attempt to "lighten" the load by only checking blocks that
# are near to transparent blocks?  This is generally desirable, but is automatically disabled
# if you have manually defined transparent-blocks or non-transparent-blocks
# in order to force compatibility in the event of configuration problems.
# If you don't define transparent-blocks or non-transparent-blocks, leave this on.

auto-detect-transparent-blocks: true

# In engine-mode 1 and 2, define a list of blocks that are transparent (e.g., glass, water, etc.)
# These blocks will NOT be obfuscated, and blocks next to them will not be obfuscated.
# If you have a very large number of blocks to specify, it will slow things down, so specify wisely.
# This is an empty list by default.  If this is empty and auto-detect-transparent-blocks is true, it will
# auto-generate the list.  If you have problems, try copying the "transparent-blocks" section from the
# "example-configuration.yml" file on Github.
# You can use either numerical IDs or block names (as of version 4.1.1).
#
#transparent-blocks:
# - AIR
# - LAVA
# - WATER
# - OAK_LEAVES
# - ACACIA_LEAVES
# - BIRCH_LEAVES
# - DARK_OAK_LEAVES
# - JUNGLE_LEAVES
# - SPRUCE_LEAVES
# - GLASS
# - COBWEB

transparent-blocks:
 - AIR
 - LAVA
 - WATER
 - OAK_LEAVES
 - ACACIA_LEAVES
 - BIRCH_LEAVES
 - DARK_OAK_LEAVES
 - JUNGLE_LEAVES
 - SPRUCE_LEAVES
 - GLASS
 - COBWEB

# In engine-mode 1, define a list of blocks that are NOT transparent.
# This is an empty list by default.  If this is empty and auto-detect-transparent-blocks is true, it will
# auto-generate the list.  If you have problems, try copying the "non-transparent-blocks" section from the
# "example-configuration.yml" file on Github.
# You can use either numerical IDs or block names (as of version 4.1.1).

#non-transparent-blocks:
# - STONE

non-transparent-blocks:
 - STONE

# In engine-mode 2, should we attempt to reload chunks when a player is teleported?
# This is only needed if you have a buggy teleport plugin, but enable it if you suspect you need it.
# Generally not recommended unless you are having problems.

teleport-reloads: false

#
# Blocks to obfuscate -- customize this to your liking!  See example-configuration.yml on Github
#

blocks:
  16:  # Coal Ore
    obfuscate: true
    default-block: STONE
  15:  # Iron Ore
    obfuscate: true
    default-block: STONE
  14: # Gold Ore
    obfuscate: true
    default-block: STONE
  56: # Diamond Ore
    obfuscate: true
    default-block: STONE
  73: # Redstone Ore
    obfuscate: true
    default-block: STONE
  129: # Emerald Ore
    obfuscate: true
    default-block: STONE
  48: # Moss Stone
    obfuscate: true
    default-block: STONE
  52: # Monster Spawner
    obfuscate: true
    default-block: STONE

#
# Proximity Hider -- This is what hides chests, etc.
#

proximity-hider:
  enabled: false
  # Maximum number of blocks away a player can be to see the hidden thing.
  range: 20
  # Should we also confirm that the player can SEE the block before deobfuscating it?
  gaze-hider: true
  # Blocks that are subject to proximity hiding.  Customize to your heart's content.
  blocks:
    54:  # Chest
      obfuscate: true
      default-block: STONE
      # Unique Y-height for this material (optional).  If not specified, global default is used.
      y-height: 60
    61:  # Furnace
      obfuscate: true
      default-block: STONE
      # Unique Y-height for this material (optional).  If not specified, global default is used.
      y-height: 60
    62:  # Burning Furnace
      obfuscate: true
      default-block: STONE
      # Unique Y-height for this material (optional).  If not specified, global default is used.
      y-height: 60

#
# Advanced features below!  Read the documentation before using.  Misconfiguration can cause problems.
#

# Orebfuscator now supports multiple configurations, one per world.
# If world-specific configuration is not defined, then the default is used (above).
#
#worlds:
#  world: # Default world name, change this to your world's name.
#    engine-mode: 1 # overrides the default engine-mode setting.
#    blocks:
#      16:  # Coal Ore
#        obfuscate: false # overrides the default block setting to NOT obfuscate in this world.
#      15:  # Iron Ore
#        obfuscate: true
#        default-block: DIRT # Overrides the default block to DIRT, for this world.
#  world_nether: # Default nether name, change this to your nether's name.
#    engine-mode: 2 # overrides the default engine-mode setting.
#    blocks:
#      16:  # Coal Ore
#        obfuscate: true # overrides the default block setting to obfuscate, even if default is turned off.
#        default-block: NETHERRACK # Overrides the default block to NETHERRACK, for this world.
#      15:  # Iron Ore
#        obfuscate: true
#        default-block: NETHERRACK # Overrides the default block to NETHERRACK, for this world.

#Limit Cache Retention
#Orebfuscator stores last known location of a obfuscated block inside cache
#Block location is removed from cache after specified amount of time
#This is used to fix issues when obfuscated block is destroyed by an explosion, or is moved by a piston
#Valid Values:
#  -1 - disable cache retention at all. Cache will grow over time and will never be cleared. Not Recommended
#   0 - block location will be removed from cache as soon as it is deobfuscated (was exposed to the player). Recommended for slow servers
#  >0 - amount of time in seconds the location will be stored in cache.
#       Recommended values 1-10 for fast servers (if you want to decrease server load set to 0)

cache-retention: 0