stunnable

模组

· 作者 Frqme

一个在敌人周围显示方框/轮廓的模组,让你知道何时开始尝试晕眩猛击

0 本站下载 0 关注 更新于 6 个月前

需要前置:Cloth Config API

最新 1.0 · 1.21.11 · Fabric

一键开服(送7天)

? Stunnable 模组

一款极简、高性能的客户端 Fabric 模组,在目标玩家的可触及范围内添加高度可定制、响应式的视觉渲染框和轮廓。

非常适合通过流畅的动画、彩虹效果和呼吸式过渡来保持空间感知并监控眩晕/交互范围。?


? 目录


⚡ 快速开始

  1. 确保你已拥有:

    • Fabric Loader
    • Fabric API
    • Cloth Config
    • AutoConfig
  2. 将 stunnable.jar 文件放入你的:

.minecraft/mods
  1. 启动游戏。

  2. 直接通过 ModMenu 打开配置界面。?️

自定义:

  • 颜色 ?
  • 彩虹渲染 ?
  • 呼吸式透明度过渡 ?
  • 轮廓宽度 ?
  • 填充透明度 ?

完美调整 HUD 风格以符合你的喜好。


? 工作原理 — 核心架构

该模组完全在客户端运行,直接挂钩到 Minecraft 的渲染生命周期,以在附近目标周围绘制平滑的叠加层。?️


? 核心初始化

模组使用标准的 Fabric 入口点进行初始化和配置设置。

StunnableClient

实现:

ClientModInitializer

负责:

  • 客户端初始化
  • 次要配置处理

Stunnable

实现:

ClientModInitializer

负责:

  • 注册 AutoConfig 模式
  • 挂钩到 Fabric 渲染生命周期事件

? 渲染生命周期挂钩

在 Stunnable.java 内部,模组订阅了:

WorldRenderEvents.END_MAIN.register(context -> {
    ...
});

这确保了:

  • 每帧更新渲染
  • 无游戏刻延迟
  • 无方块更新依赖
  • 极其流畅的视觉追踪

? 定位与计算管道

? 触及限制

模组动态提取玩家交互范围,使用实体属性:

double reach = mc.player.getAttributeValue(Attributes.ENTITY_INTERACTION_RANGE);

? 相对增量渲染

边界框被转换为相对于摄像机的局部坐标,以消除渲染抖动:

AABB box = player.getBoundingBox().move(-camPos.x, -camPos.y, -camPos.z);

? 目标排除

渲染器遍历加载的玩家,同时排除本地玩家:

if (player != mc.player && playerPos.distanceTo(player.position()) <= reach)

⚙️ 配置选项

模组包含一个完整的可配置渲染系统,可通过以下方式访问:

  • ModMenu
  • Cloth Config UI
  • AutoConfig 配置文件

?️ 渲染类别

控制:

  • 盒子视觉效果
  • 轮廓宽度
  • 透明度
  • 基础颜色
选项 类型 默认值 用途
fillColor 颜色选择器(十六进制) 0x00FF00 盒子面内部颜色
outlineColor 颜色选择器(十六进制) 0x00FF00 边界边缘颜色
onlyOutline 布尔值 false 禁用填充渲染
fillOpacity 有界离散值 (0-100) 50 填充透明度
outlineWidth 有界离散值 (1-5) 2 线条粗细

? 效果类别

处理:

  • 动态颜色
  • 动画透明度
  • 程序化视觉效果
选项 类型 默认值 用途
rainbowMode 布尔值 false 启用 HSV 彩虹循环
rainbowSpeed 有界离散值 (1-20) 5 色相过渡速度
rainbowFillOnly 布尔值 true 彩虹仅影响填充
breathingEnabled 布尔值 false 启用透明度呼吸效果
breathingSpeed 有界离散值 (1-20) 5 呼吸周期速度
breathingStrength 有界离散值 (0-100) 50 呼吸强度

✨ 视觉效果系统


? 颜色数学 (HSV → RGB)

当启用彩虹模式时,颜色使用时间同步的 HSV 计算动态生成。

这创造了:

  • 平滑的渐变
  • 无卡顿
  • 连续的光谱过渡
private int hsvToRgb(float hue, float saturation, float value) {
    int h = (int) (hue * 6);
    float f = hue * 6 - h;
    float p = value * (1 - saturation);
    float q = value * (1 - f * saturation);
    float t = value * (1 - (1 - f) * saturation);

    float r, g, b;

    switch (h % 6) {
        case 0 -> {
            r = value;
            g = t;
            b = p;
        }
        case 1 -> {
            r = q;
            g = value;
            b = p;
        }
        case 2 -> {
            r = p;
            g = value;
            b = t;
        }
        case 3 -> {
            r = p;
            g = q;
            b = value;
        }
        case 4 -> {
            r = t;
            g = p;
            b = value;
        }
        case 5 -> {
            r = value;
            g = p;
            b = q;
        }
        default -> {
            r = 0;
            g = 0;
            b = 0;
        }
    }

    return ((int) (r * 255) << 16)
        | ((int) (g * 255) << 8)
        | (int) (b * 255);
}

? 呼吸数学

呼吸系统使用平滑的三角正弦波周期修改透明度:

float cycle = (float) (
    Math.sin(time * config.breathingSpeed * 0.003)
    * 0.5 + 0.5
);

float strength = config.breathingStrength / 100f;

breathMod = 1f - (
    1f - (0.3f + 0.7f * cycle)
) * strength;

这产生了:

  • 平滑的脉冲过渡
  • 非线性淡入淡出行为
  • 可调节的动画强度

? 低级顶点缓冲区

渲染通过 Minecraft 内部的顶点管道原生处理,使用 VertexConsumer。


? 填充盒子

使用:

RenderTypes.debugFilledBox()

手动构建所有六个面:

  • 底部
  • 顶部
  • 北面
  • 南面
  • 东面
  • 西面

示例:

buffer.addVertex(pose, minX, minY, minZ)
    .setColor(r, g, b, a);

buffer.addVertex(pose, maxX, minY, minZ)
    .setColor(r, g, b, a);

buffer.addVertex(pose, maxX, minY, maxZ)
    .setColor(r, g, b, a);

buffer.addVertex(pose, minX, minY, maxZ)
    .setColor(r, g, b, a);

? 轮廓框

用途:

RenderTypes.LINES

在边界坐标之间映射显式的线段,并包含法线和宽度参数。

private void vertex(
    Matrix4f pose,
    VertexConsumer buffer,
    float x,
    float y,
    float z,
    float r,
    float g,
    float b,
    float a,
    float nx,
    float ny,
    float nz,
    float w
) {
    buffer.addVertex(pose, x, y, z)
        .setColor(r, g, b, a)
        .setNormal(nx, ny, nz)
        .setLineWidth(w);
}

? 集成与 ModMenu

该模组直接集成 ModMenu,以便即时访问 GUI 配置界面。


? ModMenuIntegration.java

package frqme.isa.dev.stunnable.config;

import com.terraformersmc.modmenu.api.ConfigScreenFactory;
import com.terraformersmc.modmenu.api.ModMenuApi;
import me.shedaniel.autoconfig.AutoConfig;

public class ModMenuIntegration implements ModMenuApi {

    @Override
    @SuppressWarnings("removal")
    public ConfigScreenFactory<?> getModConfigScreenFactory() {
        return parent ->
            AutoConfig
                .getConfigScreen(ModConfig.class, parent)
                .get();
    }
}

这自动桥接了以下组件:

  • Cloth Config
  • AutoConfig
  • ModMenu

无需依赖以下内容:

  • 命令
  • 手动 GUI 处理
  • 自定义屏幕注册

?️

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源