withfriends 是一款轻量级且完全可配置的生活品质(Quality-of-Life)插件,专为小型和社区导向的 Minecraft 服务器设计。它通过提供实用的社交功能、清晰的角色信息、灵活的就寝系统以及其他众多便捷功能来增强 Minecraft 体验。
每个模块都可以在 config.yml 中独立启用或禁用。
✨ 特性
玩家信息
-
简洁且可自定义的加入和离开消息
-
个人加入摘要显示:
- 当前在线玩家数量
- 当前的游戏内日期和时间
- 你的死亡次数
-
在名称标签上方显示玩家生命值
-
玩家列表中的世界前缀
-
玩家列表、记分板或两者兼有地显示死亡次数
-
持久化追踪游戏时长、死亡次数和玩家活跃度
通信与坐标
- 使用
/msg 发送格式化的私聊消息
- 使用
/playtime 查看自己或其他玩家的游戏时长
- 使用
/seen 检查玩家上次上线时间
- 广播你的坐标或私下发送坐标
- 显示同一维度中与其他玩家的距离
- 可选的世界前缀聊天格式化
- 悬停显示死亡次数和游戏时长信息
- 死亡消息中的坐标可点击并支持复制到剪贴板
AFK(空闲)系统
AFK 玩家会被自动检测,并且可以:
- 在玩家列表中标记
- 排除在就寝投票之外
- 免受伤害保护
- 免受击退影响
灵活的就寝系统
- 基于百分比或固定玩家数量的就寝投票
- 自动排除 AFK 玩家
- 跳过雷暴天气
- 重置幻翼生成计时器
- 跳过夜晚时播放粒子效果和音效
死亡宝箱
- 掉落物品被放入宝箱中,而不是散落在地上
- 可配置的触发条件:始终创建宝箱,或仅在附近有岩浆时创建
- 可配置的持久性:永久宝箱,或带有提前警告的定时过期宝箱
- 可选的仅限所有者访问权限,只有死亡的玩家(和管理员)才能打开
- 当背包物品无法装入单个箱子时,自动创建双箱
- 宝箱清空后自动移除
其他生活品质功能
- 手持空手时可以坐在台阶和楼梯上
- 使用
/enderchest 或 /ec 打开末影箱
- 可将末影箱配置为只读或可编辑
- 使用 MiniMessage 完全自定义文本格式化
? 命令
| 命令 |
描述 |
/withfriends reload |
重新加载插件配置 |
/withfriends status |
显示在线玩家数量和当前就寝模式 |
/playtime [player] |
显示你自己或其他玩家的游戏时长 |
/seen <player> |
显示玩家上次上线的时间 |
/coords [player] |
广播坐标或私下发送坐标 |
/distance <player> |
显示同一维度中与其他玩家的距离 |
/msg <player> <message> |
发送格式化的私聊消息 |
/enderchest |
打开你的末影箱 |
/ec |
/enderchest 的快捷方式 |
/withfriends reload 和 /withfriends status 命令需要 withfriends.admin 权限,该权限默认授予服务器操作员。
⚙️ 配置
所有功能均可独立配置。生成的 config.yml 包含详细的注释和示例。
可用设置包括:
- 启用或禁用各个模块
- 死亡次数的显示位置
- 死亡消息的可见性
- 死亡宝箱触发条件(始终 / 仅岩浆)和持久性(永久 / 定时)
- 所有插件消息的格式化
- 末影箱编辑权限
- 基于百分比或固定的就寝投票
- AFK 保护
- 聊天和玩家列表格式化
修改后,请使用 /withfriends reload 重新加载配置。
? 安装
- 下载最新的 JAR 文件。
- 将其放置在服务器的
plugins 目录中。
- 启动或重启服务器。
- 如有需要,调整
plugins/withfriends/config.yml。
- 运行
/withfriends reload 或再次重启服务器。
✅ 要求
- Minecraft: Java Edition 26.2
- 服务器软件: Paper
- Java: 25
? 玩家数据
死亡次数、游戏时长、上次加入时间和最后看到的时间戳均按 UUID 存储。
数据保存在:
plugins/withfriends/players.json
人类可读的 JSON 格式确保即使玩家更改用户名,其数据也能正确分配。
活跃的死亡宝箱(位置、所有者和过期时间)以相同的方式存储在:
plugins/withfriends/deathchests.json
因此,定时过期和仅限所有者的锁定可以在服务器重启后保留。
⚠️ 兼容性
其他插件可能已经提供了诸如 /msg 或 /ec 之类的命令。如果发生冲突,请使用带命名空间的命令:
/withfriends:msg
/withfriends:ec
? 功能请求
非常欢迎新的想法和功能请求!如果你有改进 withfriends 的建议,请随时提交 Issue 并分享。
? 链接
? 许可证
withfriends 是免费开源软件,根据 GNU 通用公共许可证 v3.0 分发。
withfriends is a lightweight and fully configurable quality-of-life plugin designed for small and community-focused Minecraft servers. It enhances Minecraft with useful social features, clear player information, a flexible sleep system, and many other convenient additions.
Every module can be enabled or disabled independently in the config.yml.
✨ Features
Player Information
-
Clean and customizable join and leave messages
-
Personal join summary showing:
- currently online players
- the current in-game day and time
- your death count
-
Player health displayed above name tags
-
World prefixes in the player list
-
Death counts in the player list, scoreboard, or both
-
Persistent tracking of playtime, deaths, and player activity
Communication and Coordinates
- Formatted private messages using
/msg
- View your own or another player's playtime with
/playtime
- Check when a player was last online with
/seen
- Broadcast your coordinates or send them privately
- Display the distance to another player in the same dimension
- Optional chat formatting with world prefixes
- Hover information for deaths and playtime
- Clickable coordinates in death messages with clipboard support
AFK System
AFK players are automatically detected and can be:
- marked in the player list
- excluded from sleep votes
- protected from damage
- protected from knockback
Flexible Sleep System
- Sleep voting based on a percentage or fixed player count
- Automatic exclusion of AFK players
- Thunderstorm skipping
- Phantom timer reset
- Particle and sound effects when the night is skipped
Death Chests
- Dropped items are placed in a chest instead of scattering on death
- Configurable trigger: always create a chest, or only when lava is nearby
- Configurable persistence: permanent chests, or timed chests that expire with an advance warning
- Optional owner-only access so only the player who died (and admins) can open it
- Automatic double chests when an inventory doesn't fit into a single chest
- Chests are removed automatically once emptied
Additional Quality-of-Life Features
- Sit on slabs and stairs with an empty hand
- Open your Ender Chest with
/enderchest or /ec
- Configure the Ender Chest as read-only or editable
- Fully customizable text formatting using MiniMessage
? Commands
| Command |
Description |
/withfriends reload |
Reloads the plugin configuration |
/withfriends status |
Shows the online player count and active sleep mode |
/playtime [player] |
Shows your own or another player's playtime |
/seen <player> |
Shows when a player was last online |
/coords [player] |
Broadcasts coordinates or sends them privately |
/distance <player> |
Shows the distance to a player in the same dimension |
/msg <player> <message> |
Sends a formatted private message |
/enderchest |
Opens your Ender Chest |
/ec |
Shortcut for /enderchest |
The /withfriends reload and /withfriends status commands require the withfriends.admin permission, which is granted to server operators by default.
⚙️ Configuration
All features can be configured independently. The generated config.yml contains detailed comments and examples.
Available settings include:
- enabling or disabling individual modules
- death count display location
- death message visibility
- death chest trigger (always / lava-only) and persistence (permanent / timed)
- formatting for all plugin messages
- Ender Chest editing permissions
- percentage-based or fixed sleep voting
- AFK protection
- chat and player-list formatting
After making changes, reload the configuration with /withfriends reload.
? Installation
- Download the latest JAR file.
- Place it inside your server's
plugins directory.
- Start or restart the server.
- Adjust
plugins/withfriends/config.yml if needed.
- Run
/withfriends reload or restart the server again.
✅ Requirements
- Minecraft: Java Edition 26.2
- Server software: Paper
- Java: 25
? Player Data
Death counts, playtime, last join times, and last-seen timestamps are stored by UUID.
The data is saved in:
plugins/withfriends/players.json
The human-readable JSON format keeps player data correctly assigned even when a player changes their username.
Active death chests (location, owner, and expiry time) are stored the same way in:
plugins/withfriends/deathchests.json
so timed expiry and owner-only locks survive a server restart.
⚠️ Compatibility
Other plugins may already provide commands such as /msg or /ec. If a conflict occurs, use the namespaced command instead:
/withfriends:msg
/withfriends:ec
? Feature Requests
New ideas and feature requests are always very welcome! If you have a suggestion for improving withfriends, feel free to open an issue and share it.
? Links
? License
withfriends is free and open-source software distributed under the GNU General Public License v3.0.
评论 0
登录后参与评分
还没有评论,来抢沙发吧