?
Host a serverModrinth App
Sign in
ModsResource PacksData PacksShadersModpacksPluginsServers
Settings
Love Letter

Love Letter

Players can send love letters to specified players via command. Letter content can be randomly picked from a letter library, or custom content from a written book held in hand.

105downloads
1follower
105downloads
1follower

Tags

Creators

Details

Licensed Apache-2.0
Published 8 months ago
Updated 8 months ago
All versions

v1.0

Release
Love Letter v1.08 months ago 105
Download

Compatibility

Minecraft: Java Edition
1.21.x
Platforms
Folia
Paper
Purpur

Changes

English Introduction

Plugin Overview

LoveLetter is a lightweight Minecraft love letter plugin for Paper / Folia 1.21 servers. Players can send love letters to specified players via command. Letter content can be randomly picked from a letter library, or custom content from a written book held in hand. After sending, a broadcast message is sent to all players with a clickable 【Open Letter】 button that anyone (including the recipient) can click to view the content.

Features

Feature Description
Send Letter Use /lletter <player> to send a love letter to a specified player
Random Letter Randomly picks one letter from .txt / .letter files in the letters directory
Custom Book When holding a signed written book, use its content as the letter (requires config)
Broadcast Broadcasts a message to all online players with a clickable 【Open Letter】 button
View Letter Click 【Open Letter】 to receive the letter as a book item or view in chat
Reload Library Use /lletterreload to reload config, language, and letter files without restarting the server
Cooldown Configurable per-player cooldown to prevent spam
Placeholders Letters support %player_reciever%, replaced with the recipient's name
MiniMessage Config supports MiniMessage format for gradients, bold, and more
Letter Expiry Letters expire after 5 minutes in memory to reduce storage

Commands & Permissions

Command Permission Default Description
/lletter <player> lovletter.lletter.use All players Send a love letter to a player
/lletterreload lovletter.lletter.reload OP only Reload config, language, and letter library

Configuration

Config file: plugins/LoveLetter/config.yml

  • language: Language code (e.g. zh_CN, en_US), maps to .yml files in plugins/LoveLetter/language/
  • letter.allow-custom-book: Allow using held written book as custom letter
  • letter.open-as-book: Give letter as book item (true) or show in chat (false)
  • letter.cooldown: Cooldown in seconds; 0 for no cooldown

All UI text (broadcast, errors, book title, etc.) is in the language files under language/.

Letter Library

Letter files go in plugins/LoveLetter/letters/ with .txt or .letter extension. Default letters are extracted on first run.

Example letter (supports %player_reciever% placeholder):

Dear %player_reciever%:

In every sunset of this blocky world, I want to stand beside you.
May our story last as long as the Ender Dragon.

— Someone who admires you

Multi-Language Support

LoveLetter has built-in multi-language support. Language files are in plugins/LoveLetter/language/:

  1. Switch language
    Set language: zh_CN (Simplified Chinese) or language: en_US (English) in config.yml, then run /lletterreload.

  2. Built-in languages

    • zh_CN.yml: Simplified Chinese
    • en_US.yml: English

  3. Add a new language
    Copy zh_CN.yml or en_US.yml, rename to your language code (e.g. ja_JP.yml), translate the fields, and set language: ja_JP in config.yml.

  4. Multi-language letters
    Add letter files per language in letters/ (e.g. default_zh.txt, default_en.txt). All .txt / .letter files are loaded and randomly picked.

  5. MiniMessage format
    Language files support MiniMessage for <red>, <gradient:#ff6b9d:#c44569>, <bold>, etc.