ServerNews
插件介绍
一款专为 Minecraft 服务器设计的新闻公告系统插件,允许管理员发布和管理服务器新闻,并以精美排版的书籍形式向玩家展示。
该插件支持多语言(根据客户端语言设置自动切换)、交互内容和自动通知功能。
兼容 Folia、Paper、Bukkit、Purpur、Spigot 等服务端核心。
功能特性
- ? 以书籍形式展示新闻内容
- ? 玩家登录时自动通知未读新闻
- ? 默认支持中文和英文;可在
messages.yml 中添加其他语言
- ? 支持 URL 链接和命令交互
- ? 新闻统计数据追踪
- ? 自动清除过期的已读记录
- ? 支持颜色代码和 HEX 颜色
- ? 兼容 PlaceholderAPI 占位符
注意:使用 PlaceholderAPI 功能必须安装 PlaceholderAPI
使用方法
玩家指令
| 指令 |
描述 |
权限 |
默认状态 |
/news |
打开新闻书 |
servernews.use |
✅ 所有玩家可用 |
管理员指令
| 指令 |
描述 |
示例 |
权限 |
/newsadmin |
显示管理员帮助菜单 |
/newsadmin |
servernews.admin |
/newsadmin help |
显示详细帮助信息 |
/newsadmin help |
servernews.admin |
/newsadmin reload |
重新加载配置文件 |
/newsadmin reload |
servernews.admin |
/newsadmin add <title> <content> [options] |
添加新闻及可选功能 |
见下方示例 |
servernews.admin |
/newsadmin remove <id> |
通过索引删除新闻 |
/newsadmin remove 0 |
servernews.admin |
/newsadmin list |
列出所有新闻详情 |
/newsadmin list |
servernews.admin |
/newsadmin stats |
显示综合新闻统计 |
/newsadmin stats |
servernews.admin |
高级添加指令选项
add 指令支持多个可选参数以增强新闻功能:
基本用法:
/newsadmin add "新闻标题" "新闻内容在这里"
包含 URL 链接:
/newsadmin add "更新公告" "查看我们的网站了解详情" -url https://example.com
包含命令执行:
/newsadmin add "服务器活动" "点击参加活动!" -cmd /warp event
包含悬停文本:
/newsadmin add "重要事项" "计划中的服务器维护" -hover "悬停获取更多信息"
组合功能:
/newsadmin add "新功能" "多种交互元素" -url https://example.com -cmd /help -hover "点击访问网站或悬停查看命令"
选项详情:
-url <link>:添加可点击的 URL 链接(必须以 http:// 或 https:// 开头)
-cmd <command>:添加可点击的命令(必须以 / 开头)
-hover <text>:添加悬停提示文本(可包含空格和颜色代码)
提示:
- 选项可以按任意顺序使用
- URL 和命令不能同时使用(命令优先)
- 包含空格的文本请使用引号包裹
- 您也可以直接编辑
news.yml,然后使用 /newsadmin reload
权限列表
| 权限节点 |
描述 |
默认值 |
备注 |
servernews.use |
允许使用 /news 指令 |
true |
所有玩家均可查看新闻 |
servernews.admin |
授予管理员指令访问权限 |
op |
完全管理控制 |
servernews.* |
授予所有新闻相关权限 |
op |
包含所有权限 |
配置文件
config.yml
# 存储的最大新闻数量
max-news: 10
# 自动通知设置
auto-notification:
# 玩家加入后的延迟时间(以刻为单位,20 刻 = 1 秒)
delay-ticks: 60
news.yml
以下列格式存储所有新闻条目:
news:
- title: "新闻标题"
content: "新闻内容(支持颜色代码和占位符)"
date: "2024-01-15 14:30"
url: "https://example.com" # 可选:可点击的 URL
command: "/spawn" # 可选:可点击的命令
hover: "悬停文本与 &a颜色" # 可选:悬停提示
- title: "另一条新闻"
content: "更多新闻内容在这里"
date: "2024-01-14 12:00"
# 可选字段可以省略
messages.yml
包含不同语言的所有可翻译消息。插件会自动检测玩家语言并使用相应的消息。
指令示例
添加带颜色的新闻
# 基础彩色新闻
/newsadmin add "&6&l服务器更新" "&a新增功能!&b快去看看吧。"
# 使用 HEX 颜色
/newsadmin add "&#FF0000重要公告" "�FF00一切正常运行!"
# 使用 PlaceholderAPI
/newsadmin add "欢迎 %player_name%" "您已游玩 %player_time% 小时"
管理示例
# 列出当前所有新闻
/newsadmin list
# 删除第一条新闻(索引 0)
/newsadmin remove 0
# 查看详细统计信息
/newsadmin stats
# 手动编辑后重新加载
/newsadmin reload
常见问题
Q: 如何添加彩色新闻?
A:
使用 & 后跟颜色代码或 HEX 颜色:
&a 表示绿色文本
&#FF0000 表示红色文本(HEX 颜色代码)
&l 表示粗体,&o 表示斜体,&n 表示下划线
Q: 为什么无法打开新闻书?
A:
请检查以下内容:
- 玩家拥有
servernews.use 权限
- 服务器控制台无错误日志
news.yml 中的新闻数据格式正确
- 插件已正确加载并启用
Q: 如何增加新闻上限?
A:
修改 config.yml 中的 max-news 值并重新加载插件。
Q: 我可以使用 PlaceholderAPI 占位符吗?
A:
可以!安装 PlaceholderAPI 并在新闻标题、内容和悬停文本中使用任何占位符。示例:
%player_name% - 玩家名称
%server_name% - 服务器名称
%player_time% - 游戏时长
问:自动通知是如何工作的?
答:
该插件会追踪每位玩家上次查看新闻的时间。当他们加入服务器时,如果有更新的新闻可用,在设定的延迟时间后,他们会收到一条可点击的通知。
ServerNews
Plugin Introduction
A news announcement system plugin designed for Minecraft servers, which allows administrators to publish and manage server news, displaying it to players in beautifully formatted book form.
The plugin supports multiple languages (automatically switching based on client language settings), interactive content, and automatic notification features.
Compatible with Folia, Paper, Bukkit, Purpur, Spigot, and other server cores.
Features
- ? Displays news content in book form
- ? Automatically notifies players of unread news upon login
- ? Supports Chinese and English by default; additional languages can be added in
messages.yml
- ? Supports URL links and command interactions
- ? News statistics tracking
- ? Automatically clears expired read records
- ? Supports color codes and HEX colors
- ? Compatible with PlaceholderAPI placeholders
Note:PlaceholderAPI must be installed to use PlaceholderAPI functionality
Usage
Player Commands
| Command |
Description |
Permission |
Default |
/news |
Opens the news book |
servernews.use |
✅ Available to all players |
Admin Commands
| Command |
Description |
Example |
Permission |
/newsadmin |
Show admin help menu |
/newsadmin |
servernews.admin |
/newsadmin help |
Show detailed help |
/newsadmin help |
servernews.admin |
/newsadmin reload |
Reload configuration files |
/newsadmin reload |
servernews.admin |
/newsadmin add <title> <content> [options] |
Add news with optional features |
See examples below |
servernews.admin |
/newsadmin remove <id> |
Remove news by index |
/newsadmin remove 0 |
servernews.admin |
/newsadmin list |
List all news with details |
/newsadmin list |
servernews.admin |
/newsadmin stats |
Show comprehensive news statistics |
/newsadmin stats |
servernews.admin |
Advanced Add Command Options
The add command supports several optional parameters to enhance news functionality:
Basic Usage:
/newsadmin add "News Title" "News content here"
With URL Link:
/newsadmin add "Update Notice" "Check our website for details" -url https://example.com
With Command Execution:
/newsadmin add "Server Event" "Click to join the event!" -cmd /warp event
With Hover Text:
/newsadmin add "Important" "Server maintenance scheduled" -hover "Hover for more info"
Combined Features:
/newsadmin add "New Features" "Multiple interactive elements" -url https://example.com -cmd /help -hover "Click for website or hover for commands"
Option Details:
-url <link>: Adds a clickable URL link (must start with http:// or https://)
-cmd <command>: Adds a clickable command (must start with /)
-hover <text>: Adds hover tooltip text (can contain spaces and color codes)
Tips:
- Options can be used in any order
- URL and command cannot be used together (command takes priority)
- Use quotes around text containing spaces
- You can directly edit
news.yml and use /newsadmin reload afterward
Permission List
| Permission Node |
Description |
Default |
Notes |
servernews.use |
Allows using /news command |
true |
All players can view news |
servernews.admin |
Grants access to admin commands |
op |
Full administrative control |
servernews.* |
Grants all news-related permissions |
op |
Includes all permissions |
Configuration Files
config.yml
# Maximum number of stored news items
max-news: 10
# Auto-notification settings
auto-notification:
# Delay after player joins (in ticks, 20 ticks = 1 second)
delay-ticks: 60
news.yml
Stores all news entries in the following format:
news:
- title: "News Title"
content: "News content (supports color codes and placeholders)"
date: "2024-01-15 14:30"
url: "https://example.com" # Optional: clickable URL
command: "/spawn" # Optional: clickable command
hover: "Hover text with &acolors" # Optional: hover tooltip
- title: "Another News"
content: "More news content here"
date: "2024-01-14 12:00"
# Optional fields can be omitted
messages.yml
Contains all translatable messages for different languages. The plugin automatically detects player language and uses appropriate messages.
Command Examples
Adding News with Colors
# Basic colored news
/newsadmin add "&6&lServer Update" "&aNew features added! &bCheck them out."
# With HEX colors
/newsadmin add "&#FF0000Important Notice" "�FF00Everything is working fine!"
# With PlaceholderAPI
/newsadmin add "Welcome %player_name%" "You have played for %player_time% hours"
Management Examples
# List all current news
/newsadmin list
# Remove the first news item (index 0)
/newsadmin remove 0
# View detailed statistics
/newsadmin stats
# Reload after manual edits
/newsadmin reload
Frequently Asked Questions
Q: How to add colored news?
A:
Use & followed by color codes or HEX colors:
&a for green text
&#FF0000 for red text (HEX color code)
&l for bold, &o for italic, &n for underline
Q: Why can't the news book be opened?
A:
Check the following:
- Player has the
servernews.use permission
- No error logs in the server console
- News data is properly formatted in
news.yml
- Plugin is properly loaded and enabled
Q: How to increase the news limit?
A:
Modify the max-news value in config.yml and reload the plugin.
Q: Can I use PlaceholderAPI placeholders?
A:
Yes! Install PlaceholderAPI and use any placeholder in news titles, content, and hover text. Examples:
%player_name% - Player's name
%server_name% - Server name
%player_time% - Play time
Q: How does the auto-notification work?
A:
The plugin tracks when each player last viewed news. When they join, if there's newer news available, they'll receive a clickable notification after the configured delay.
评论 0
登录后参与评分
还没有评论,来抢沙发吧