Gravity Gun

插件

· 作者 DL03

一款 Minecraft 插件,用于重现《半条命2》中的重力枪工具。

0 本站下载 0 关注 更新于 1 天前

最新 0.4.0 · 26.3 · Paper / Purpur

一键开服(送7天)

重力枪

一款 Minecraft 插件,重现了《半条命 2》中的重力枪工具。右键可用于拾取生物或方块,也可用于丢弃已拾取的物体。左键可用于推动生物,或在已捕获物体的情况下将其发射出去。

命令 权限 描述
help 显示此帮助信息
reload gravity-gun.reload 重新加载插件配置
give [target] gravity-gun.give 将重力枪给予自己或其他玩家
fix [target] gravity-gun.fix 修复因不幸被抓住而导致重力/碰撞异常的玩家
debug place_all_rotation_blocks gravity-gun.debug 放置那些在旋转 90° 后 BlockData 会发生变化的方块类型的样本

配置

所有设置均位于 config.yml 中。缺失的选项会从内置默认值中补充,而用户文件会保留所有现有值;该文件会在启动时以及执行 /gg reload 时进行更新。

  • version - 配置文件格式版本。
  • debug - 启用关于手持方块显示和还原方块实体的额外日志记录。
  • language - 插件消息和工具提示的语言代码(en_us, en_gb, ru_ru, uk_ua)。
  • item.gravity-gun.name - 重力枪物品的自定义名称;若留空则回退到语言文件中的默认名称。

机制:

  • mechanics.grab.range - 抓取方块或实体的最大距离。
  • mechanics.grab.cooldown - 两次抓取尝试之间的最小延迟。
  • mechanics.pull.range - 拉拽的最大距离。
  • mechanics.pull.force - 拉拽力的强度。
  • mechanics.hold.max-time - 释放前可持握抓取物体的最长时间;设为 0 则禁用此限制。
  • mechanics.hold.display-items.enabled - 将掉落物品作为物品显示来持握,并使弹射物保留其原生实体模型。
  • mechanics.hold.distance.min / mechanics.hold.distance.max / mechanics.hold.distance.step - 持握物体与玩家眼睛之间距离的最小值、最大值和步长。
  • mechanics.launch.power - 当使用左键发射或释放所持有的物体时应用的发射速度。
  • mechanics.release.momentum.enabled - 在释放和发射时继承玩家移动和视角转动的动量。
  • mechanics.release.momentum.multiplier - 继承动量的强度倍数。
  • mechanics.release.momentum.max-speed - 每刻增加的最大动量(以方块为单位)。

效果:

  • effects.enabled - 切换重力枪及方块撞击粒子效果。

限制:

  • limits.entities.allow-grab - 是否允许抓取实体。
  • limits.entities.allow-grab-players - 是否允许抓取玩家。
  • limits.entities.list-mode - 适用于 limits.entities.list 的模式:BLACKLIST(黑名单)、WHITELIST(白名单)或 DISABLED(禁用)。
  • limits.entities.list - 应用于实体抓取列表的实体类型名称。
  • limits.blocks.allow-grab - 是否允许抓取方块。
  • limits.blocks.list-mode - 适用于 limits.blocks.list 的模式:BLACKLIST(黑名单)、WHITELIST(白名单)或 DISABLED(禁用)。
  • limits.blocks.list - 应用于方块抓取列表的方块名称。

效果与释放动量

config.yml 中的 effects.enabled 选项控制重力枪的粒子效果,包括方块撞击粒子。释放动量可通过 mechanics.release.momentum.multiplier 和 mechanics.release.momentum.max-speed 进行调整。

默认启用 mechanics.hold.display-items.enabled 选项。掉落物品作为物品显示被持握,而弹射物则保留并移动其原生实体模型。在持握期间或释放后的半秒内,无法拾取掉落的物品和箭矢;随后会恢复其原始的拾取状态。弹射物沿玩家视角方向瞄准,并在释放时赋予至少配置的发射速度。左键可将捕获的弹射物向前发射;尽管持握的弹射物位于准星下方,但由于使用了手臂摆动事件作为后备方案,因此依然有效。在启动和重载时,插件会填充用户配置中缺失的配置选项,同时保留现有值。

持握的方块显示跟随玩家的准星,并随摄像机平滑旋转;释放时,旋转会 snapped(对齐)到最近的 90°,然后再放置方块。方向性方块和多方块结构会根据从拾取开始以来的玩家水平视角转动进行旋转。门和床会被一起携带和放置。双层箱子故意拆分:被抓取的一半变为单个箱子,地面上剩余的一半也变为单个箱子,但保持其各自的库存不变。床由单个显示表示,栅栏和玻璃板在放置后会更新其连接状态。

方块实体

对于拥有真实 3D 方块模型的方块,方块实体块会使用 BlockDisplay。因此,熔炉、桶、蜂巢、营火、架子、宝库、投掷器、发射器等类似方块在持握时仍保持正常的方块外观。视觉效果仅存在于方块实体渲染器中或其方块模型为空的方块则改用其物品模型显示:箱子(包括铜箱和末影箱)、床、告示牌和悬挂式告示牌、旗帜、头颅、潜影盒、装饰罐、潮涌核心以及铜傀儡雕像。墙上的告示牌、墙上的旗帜、墙上的头颅和墙上悬挂式告示牌则以其站立形态的物品模型显示。

内容和元数据(如箱子库存、告示牌文本、旗帜图案、头颅模型、陶罐碎片、铜傀儡姿势以及自定义名称)会与手持的方块一起存储,并在放置时恢复。仅由方块实体渲染器渲染的细节在手持方块时不可见:例如架子和营火的内容物、保险库动画,以及刷怪笼的动画部分等。由于钟的主体完全由其方块实体渲染器渲染,因此它显示为扁平的物品;如果显示方块模型,则只会显示其挂载部分。

重力枪仅拦截实际的左键和右键点击。物理交互(如在侦测器上行走)会被忽略,因此既不会取消也不会伴随抓取音效。在 config.yml 中设置 debug: true 会记录有关手持方块显示和恢复的方块实体的额外详细信息。

针对资源包

对于资源包,可以通过以下方式将模型和纹理附加到弩上:

{
    "model": {
        "type": "select",
        "property": "custom_model_data",
        "fallback": {
            "type": "model",
            "model": "item/crossbow"
        },
        "cases": [
            {
                "when": "gravity-gun",
                "model": {
                    "type": "model",
                    "model": "item/gravity_gun"
                }
            },
            {
                "when": "gravity-gun-blue",
                "model": {
                    "type": "model",
                    "model": "item/gravity_gun_firework"
                }
            }
        ]
    }
}

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源