GreenName

GREENNAME – 绿色聊天名称插件

English | 中文

---

简介 | Introduction

GreenName 是一款轻量级的 Paper 插件，允许管理员为玩家设置带有到期时间的绿色聊天名称。玩家可以自行使用 /greenname on/off 开关这一效果，所有数据基于玩家名存储，完美支持离线服务器。插件内置 12 种语言支持，并允许管理员自定义聊天格式。

GreenName is a lightweight Paper plugin that allows admins to give players a green chat name with an expiration date. Players can toggle the effect on/off using /greenname on/off. All data is stored by player name, making it perfect for offline-mode servers. The plugin comes with 12 built-in languages and allows admins to customize the chat format.

---

功能特性 | Features

• 为玩家设置绿色聊天名称（支持自定义颜色，默认绿色）

• 可配置到期时间（以天为单位），到期后自动失效

• 玩家可用 /greenname on/off 自行开关效果

• 数据基于玩家名（小写）存储，适合离线服务器

• 12 种语言支持（简体中文、繁体中文、英语、俄语、德语、法语、西班牙语、葡萄牙语、日语、韩语、印尼语、阿拉伯语）

• 管理员可自定义聊天格式（支持颜色代码 &）

• 所有消息可通过语言文件自由修改

• 轻量、高效，无额外依赖

• 兼容 Paper 1.13 ~ 1.21+（Java 17+）

• Set a green chat name for players (color customizable, default green)

• Configurable expiration time (in days), auto-expires after expiry

• Players can toggle the effect on/off using /greenname on/off

• Data stored by player name (lowercase) – ideal for offline-mode servers

• 12 languages supported (Chinese Simplified/Traditional, English, Russian, German, French, Spanish, Portuguese, Japanese, Korean, Indonesian, Arabic)

• Admins can customize chat format (supports color code &)

• All messages can be freely edited via language files

• Lightweight, no extra dependencies

• Compatible with Paper 1.13 ~ 1.21+ (Java 17+)

---

命令与权限 | Commands & Permissions

命令 /setgreen <玩家名> <天数> - 设置玩家的绿色名称时长（天）; Set a player's green name duration (days) 权限: greennames.admin 默认: OP

命令 /greenname on - 开启自己的绿色名称; Enable your own green name 权限: greennames.use 默认: 所有人 (true)

命令 /greenname off - 关闭自己的绿色名称; Disable your own green name 权限: greennames.use 默认: 所有人 (true)

---

配置文件 | Configuration

config.yml 内容:

language: zh chat-format: "&a<%s>&d %s"

语言文件 | Language Files

语言文件位于 plugins/Greenname/language/ 目录，命名格式为 messages_.yml，支持的颜色代码为 &0-9 &a-f &k-o &r。管理员可以自由编辑所有提示消息。

Language files are stored in plugins/Greenname/language/ with naming messages_.yml. Supports color codes &0-9 &a-f &k-o &r. Admins can freely edit all messages.

支持的语言列表 | Supported Languages

语言代码: zh 语言名称: 简体中文 语言代码: zh_tw 语言名称: 繁體中文 语言代码: en 语言名称: English 语言代码: ru 语言名称: Русский 语言代码: de 语言名称: Deutsch 语言代码: fr 语言名称: Français 语言代码: es 语言名称: Español 语言代码: pt 语言名称: Português 语言代码: ja 语言名称: 日本語 语言代码: ko 语言名称: 한국어 语言代码: id 语言名称: Bahasa Indonesia 语言代码: ar 语言名称: العربية

---

数据存储 | Data Storage

所有玩家数据保存在 plugins/Greenname/data.yml 中，结构如下：

expiry: player1: 1735689600000 player2: 1735776000000 toggle: player1: true player2: false

---

安装 | Installation

1. 下载 Greenname.jar

2. 将文件放入服务器的 plugins/ 文件夹

3. 重启服务器（或使用 /reload）

4. 编辑 config.yml 和语言文件（可选）

5. 使用 /setgreen <玩家名> <天数> 给玩家设置绿色名称

6. Download Greenname.jar

7. Place it in your server's plugins/ folder

8. Restart the server (or use /reload)

9. Edit config.yml and language files (optional)

10. Use /setgreen to give a player a green name

---

兼容性 | Compatibility

服务端 | Server: Paper 1.13 ~ 1.21+ Java: 17 或更高 (建议 21) 依赖 | Dependencies: 无 (None)

---

许可 | License

本项目采用 MIT 许可证，你可以自由使用、修改和分发。

This project is licensed under the MIT License. You are free to use, modify, and distribute it.

---

支持 | Support

如有问题或建议，请在 GitHub 提交 Issue 或联系作者。

If you have any issues or suggestions, please submit an Issue on GitHub or contact the author.

---

感谢使用 GreenName！ | Thanks for using GreenName! 😊