# mc-effect-display

**Repository Path**: yanghao_java/mc-effect-display

## Basic Information

- **Project Name**: mc-effect-display
- **Description**: 我的世界药水效果显示模组
- **Primary Language**: Java
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-09-22
- **Last Updated**: 2026-07-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## Effect Display

[![Minecraft](https://img.shields.io/badge/Minecraft-1.21.1-brightgreen)](https://www.minecraft.net/)
[![NeoForge](https://img.shields.io/badge/NeoForge-21.1.172-orange)](https://neoforged.net/)
[![Version](https://img.shields.io/badge/Version-1.1.0-blue)](https://github.com)

> 在实体头顶渲染药水效果图标，灵感源自 Warframe 的异况显示，由我尝试还原 Warframe(不一定实现、发布) 的项目中分离。

---

### ✨ 功能特性

- **药水效果图标渲染** — 在生物头顶实时显示当前活跃的药水效果图标
- **自定义外观** — 可调节图标缩放、位置偏移（X/Y 轴）、实体旋转角度
- **实时预览** — 配置界面内置实体模型预览，所见即所得
- **低时间闪烁** — 药水效果剩余时间 ≤ 10 秒时，图标平滑闪烁提醒
- **距离与视线优化** — 近距离始终渲染(需配置)，中距离需有视线（防止穿墙透视），远距离不渲染
- **热键支持** — 默认c键打开配置
- **显示控制** — 可分别开关自身/其他玩家的药水效果显示


### ⚙️ 可配置项

| 配置项 | 说明 | 默认值  |
|--------|------|------|
| 实体缩放 | 预览实体模型大小 | 1.0  |
| Buff 缩放 | 药水效果图标缩放比例 | 1.0  |
| 位置偏移 X/Y | 图标渲染位置微调 | 0.0  |
| 显示自身药水效果 | 是否在自己头顶渲染 | 关闭   |
| 显示其他玩家药水效果 | 是否在其他玩家头顶渲染 | 开启   |
| 低时间闪烁 | 剩余时间 ≤ 10 秒时图标闪烁 | 开启   |
| 最大渲染距离 | 超出此距离不渲染 | 64 格 |
| 近距离阈值 | 此距离内无视视线检测 | 0 格  |

### 📦 安装

1. 安装 [NeoForge](https://neoforged.net/) 21.1.172+
2. 下载 `effect_display-1.1.0.jar` [从 CurseForge 下载](https://www.curseforge.com/minecraft/mc-mods/effect-display)
3. 放入 `.minecraft/mods/` 文件夹
4. 需要在客户端服务端同时安装
5. 启动游戏

### 🔧 构建

```bash
gradle build