Kiss

Kiss

一个轻量级服务端模组，会在玩家快速蹲伏靠近他人时在其头顶生成爱心粒子——一种简单的友好姿态。

社交

Kiss预览查看大图

KissMod

描述

一款轻量级服务端模组，当玩家在其他玩家附近快速潜行时，会在其头顶生成爱心粒子——这是一种简单的友好表示。

封面

命令

  • /kiss <玩家>：允许你通过此命令亲吻其他玩家（默认情况下，每个玩家每 10 秒可使用一次该命令。被亲吻的玩家将收到通知，并且其头顶会出现爱心粒子效果。）

KissMod 为 /kiss 命令提供了 kissmod.command 权限，为潜行触发的粒子效果提供了 kissmod.trigger 权限。两项权限默认对所有玩家开放，并可由兼容的权限提供者覆盖。

配置

KissMod 为服务端模组。编辑服务端配置并重启服务器以应用更改。

  • Fabric 配置路径：config/kissmod/config.yml
  • NeoForge 服务端配置：位于启动器服务端配置目录下的 kissmod-server.toml

新增配置字段时，现有值会被保留；缺失字段会写入当前默认值。从 KissMod v1 首次升级时，若新的 YAML 文件不存在，Fabric 会导入 config/kissmod.json；若新的服务端配置仍仅包含默认值，NeoForge 会导入 config/kissmod-common.toml。旧文件仅在新配置成功写入后被移除。重命名的设置（如 commandCooldown、sneakTimeWindow、maxViewAngleDegree 和 mobTriggerRadius）会映射到当前等效项。带有自定义值的当前 NeoForge 配置始终优先于旧文件。

友好实体粒子

友好实体粒子默认对生成的配置中列出的原版被动与友好实体启用。你可以禁用该功能，或用精确的实体类型 ID 和实体类型标签替换列表。

KissMod 会将 friendlyEntityTypes 与实体注册表 ID 进行匹配，因此只要相应模组安装在服务器上，模组实体无需 KissMod 侧集成即可正常工作。

Fabric YAML 示例

sneakParticleDecay: 2
sneakTriggerCount: 3
sneakTriggerWindowTicks: 40
sneakPreviewRadius: 6.0
enableEntityParticles: true
entityParticleRadius: 8.0
heartParticleHeightOffset: 0.35
friendlyEntityTypes:
  - minecraft:villager
  - minecraft:cow
  - minecraft:sheep
  - minecraft:pig
  - minecraft:chicken
  - minecraft:horse
  - minecraft:donkey
  - minecraft:mule
  - minecraft:llama
  - minecraft:cat
  - minecraft:wolf
friendlyEntityTags: []

NeoForge TOML 示例

[sneak]
sneakParticleDecay = 2
sneakTriggerCount = 3
sneakTriggerWindowTicks = 40
sneakPreviewRadius = 6.0

[entityParticles]
enableEntityParticles = true
entityParticleRadius = 8.0
heartParticleHeightOffset = 0.35
friendlyEntityTypes = [
  "minecraft:villager",
  "minecraft:cow",
  "minecraft:sheep",
  "minecraft:pig",
  "minecraft:chicken",
  "minecraft:horse",
  "minecraft:donkey",
  "minecraft:mule",
  "minecraft:llama",
  "minecraft:cat",
  "minecraft:wolf"
]
friendlyEntityTags = []

贡献

开发环境搭建、多版本构建说明、测试要求及发布流程均记录在 CONTRIBUTING.md 中。

许可协议

MIT