原味双拼咸鱼罐头

原味双拼咸鱼罐头

Sal_fish's Attribute Lib (双拼原味咸鱼罐头) – a Forge 1.20.1 library adding configurable attributes and cross-session command memory.

基础库

Sal_fish's Attribute Lib(双拼原味咸鱼罐头)

一个轻量级的属性库,适用于 Minecraft Forge 1.20.1,旨在通过原版属性系统为整合包作者和玩家提供对实体属性的精细控制。它还包含跨会话命令记忆功能,可在游戏会话间持久保存命令历史记录。

📦 共享属性(应用于所有生物实体)

这些属性会自动添加到每个生物实体上。整合包制作者可以全局或按实体类型设置默认值,其他模组也可以动态修改它们。

  • generic.scale – 控制实体的视觉大小和碰撞箱。默认值:1.0
  • generic.step_height – 实体无需跳跃即可走上的最大方块高度。默认值:0.6
  • generic.safe_fall_distance – 实体在受到摔落伤害前可以安全下落的垂直距离。默认值:3.0

👤 玩家专属属性

这些属性仅添加到玩家身上,影响游戏平衡和交互范围。

  • generic.creative_flight – 若值大于0,玩家即可无视游戏模式飞行。默认值:0
  • player.block_interaction_range – 玩家与方块交互(放置、破坏、使用)的最大距离。默认值:4.5
  • player.entity_interaction_range – 玩家与实体交互(攻击、使用)的最大距离。默认值:3.0
  • player.block_break_speed – 应用于玩家方块破坏速度的倍率。默认值:1.0

所有属性均支持任意值(技术上受限于Java整数限制),允许整合包作者精细调整从移动速度到交互距离的一切内容,无需创建数十个独立的修改器。

🧠 命令记忆系统

本模组会自动记住聊天栏中输入的最后50条命令(以/开头的消息),并将其保存到Minecraft游戏目录下的command_history.txt文件中。

  • 历史记录在切换世界甚至完全退出游戏后依然保留。
  • 命令按顺序存储,可通过聊天栏中的上/下箭头键访问,与原版聊天历史功能一致。
  • 无需额外配置——开箱即用。

🔧 使用方法

只需在服务端和客户端同时安装此模组即可。无需配置文件或依赖项。

  • 对于整合包作者:使用提供的属性注册表,通过命令方块、脚本(CraftTweaker、KubeJS)或您自己的模组为玩家和生物分配自定义值。
  • 对于其他开发者:将此库作为依赖项添加,并直接从ModAttributes访问属性注册表对象。

📄 技术说明

  • 属性使用Forge的DeferredRegister注册,并在服务端和客户端之间完全同步。
  • 实体渲染(大小、阴影尺寸)通过Mixin自动调整,确保视觉一致性。
  • 命令历史功能使用本地文件存储命令,绝不会向服务器发送任何数据。

欢迎在整合包中使用、修改和分发。反馈和建议始终欢迎!