Description

A lightweight server-side mod that spawns heart particles above the player who rapidly crouches near others — a simple gesture of friendliness.

Command

• /kiss <player>: Allowing you to kiss other players with this command (The command can be used once every 10 seconds per player by default. The kissed player will receive a notification and heart particle effects will appear above their head. )

Default Config

kissmod.json

{
  // Maximum number of heart particles that can appear when sneaking (1–20)
  "maxSneakParticles": 6,

  // Vertical position offset for particles (in blocks)
  // 1.6 = Eye level for standing players
  "sneakParticleHeight": 1.6,

  // Message shown when receiving a kiss
  // %s = Automatically replaced by the kisser's username
  "kissMessage": "%s kissed you!",

  // Message shown to the sender after kissing someone
  // %s = Automatically replaced by the receiver's username
  "kissPromptMessage": "you kissed %s",

  // Cooldown between /kiss commands (in seconds)
  // Prevents command spamming (0 = no cooldown)
  "commandCooldown": 10,

  // Enable or disable the /kiss command entirely
  "enableKissCommand": true,

  // Error message shown when trying to kiss yourself
  "selfKissErrorMessage": "You can't kiss yourself!",

  // Error message shown when using /kiss before cooldown ends
  // %d = Automatically replaced by the number of seconds remaining
  "cooldownErrorMessage": "You must wait %d seconds before kissing again!",

  // Maximum view angle (in degrees) to detect nearby players for kiss or sneak particle effects
  // A smaller angle means only players in front are considered visible
  "maxViewAngleDegree": 90.0
}

License

MIT

KissMod

A tiny server-side mod: sneak near another player a few times and hearts pop up overhead — a small, friendly gesture.

Command

• /kiss <player> — send a kiss to another player. Each player can use it once every 10 seconds by default. The kissed player gets a heads-up and a little burst of hearts above their head.

Two permissions are exposed by default, both granted to all players:

• kissmod.command for /kiss
• kissmod.trigger for the sneak-triggered hearts

Override either with your permissions mod if you want to change who can use them.

Configuration

KissMod is server-side — edit the server config and restart to apply changes.

• Fabric: config/kissmod/config.yml
• NeoForge: kissmod-server.toml in the loader's server config location

The config keeps your existing values across upgrades and fills new fields with defaults. Upgrading from KissMod v1? Your old kissmod.json (Fabric) or kissmod-common.toml (NeoForge) is imported the first time, then removed once the new file is written. A current config with custom values is never overwritten.

Hearts for friendly mobs

Hearts trigger the same way as with players: sneak rapidly nearby. By default, this also works for vanilla friendly mobs like villagers, cows, and wolves. The difference is that the hearts appear over the mob's head, not the player's.

You can turn this off, or customize the target list with any entity type IDs or tags you like. Modded mobs are also supported as long as the mod is on the server — no extra integration needed.

Fabric YAML example

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 example

[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

If you'd like to build or release KissMod, see CONTRIBUTING.md.

License

MIT