Minecraft Forge 1.12.2自定义物品右键无法放置水问题求助

阿华AIGC实验室

2026-5-19

解决Minecraft 1.12.2 Forge自定义物品无法放置水的问题

嘿，我在1.12.2 Forge开发自定义物品时碰到过一模一样的问题——消耗动画跑起来了，但水就是出不来。大概率是几个常见的逻辑疏漏，咱们一步步排查修复：

1. 必须在服务器端处理方块放置

Minecraft的客户端和服务器是分离的，如果你在客户端代码里修改世界（比如放水），只会在本地看到临时视觉效果，服务器不会同步这个变化，刷新后就没了。所以一定要先判断当前环境，只在服务器执行方块修改：

@Override
public EnumActionResult onItemUse(EntityPlayer player, World worldIn, BlockPos pos, EnumHand hand, EnumFacing facing, float hitX, float hitY, float hitZ) {
    // 跳过客户端逻辑，只在服务器处理世界修改
    if (worldIn.isRemote) {
        return EnumActionResult.SUCCESS;
    }

    ItemStack stack = player.getHeldItem(hand);
    BlockPos placePos = pos.offset(facing);

    // 检查目标位置是否能放置水
    if (worldIn.isAirBlock(placePos) && Blocks.WATER.canPlaceBlockAt(worldIn, placePos)) {
        // 放置水方块
        worldIn.setBlockState(placePos, Blocks.WATER.getDefaultState());
        
        // 消耗物品（创造模式不消耗）
        if (!player.capabilities.isCreativeMode) {
            stack.shrink(1);
        }

        return EnumActionResult.SUCCESS;
    }

    return EnumActionResult.FAIL;
}

2. 正确处理右键事件的返回值

如果你的物品逻辑是在onItemRightClick（空右键，不点击方块）里实现的，一定要确保返回的ActionResult<ItemStack>标记为成功，不然游戏会认为这次交互没完成，可能导致后续逻辑不触发：

@Override
public ActionResult<ItemStack> onItemRightClick(World worldIn, EntityPlayer playerIn, EnumHand handIn) {
    ItemStack stack = playerIn.getHeldItem(handIn);
    if (!worldIn.isRemote) {
        // 获取玩家前方的放置位置（可根据需求调整距离）
        BlockPos placePos = playerIn.getPosition().offset(playerIn.getHorizontalFacing(), 1);
        if (worldIn.isAirBlock(placePos) && Blocks.WATER.canPlaceBlockAt(worldIn, placePos)) {
            worldIn.setBlockState(placePos, Blocks.WATER.getDefaultState());
            if (!playerIn.capabilities.isCreativeMode) {
                stack.shrink(1);
            }
        }
    }
    // 返回成功，让游戏确认这次交互有效
    return new ActionResult<>(EnumActionResult.SUCCESS, stack);
}