圣经经文 — Paper 服务器插件
将鼓舞人心的经文带给您 Minecraft 服务器上的每位玩家。
Bible Verse 是一款 Paper 服务器插件,在玩家加入后推送圣经经文。每位玩家可以自行选择经文的出现频率、完全禁用,或通过游戏内设置 GUI 进行管理。
只需在 Paper 服务器上安装一次该插件。普通玩家无需安装任何内容。
玩家体验
当玩家的冷却时间就绪时,插件默认等待五秒并显示:
- 作为大标题的经文出处
- 作为副标题的经文精简片段
- 聊天中的完整经文及翻译版本标签
默认频率为每 12 小时一次,但每位玩家都可以自定义自己的时间表。
如果玩家在登录延迟期间断开连接或禁用了经文,待发送的经文将被取消。
功能
- 登录后自动推送圣经经文
- 每位玩家拥有独立的设置和冷却时间
- 五种推送频率选项
- 游戏内箱式风格设置 GUI
- 个人开启/关闭控制
- 管理员和控制台命令支持
- 预览功能不会重置推送冷却时间
- 可配置的登录延迟
- 可配置的大标题颜色、副标题颜色、时间和长度
- 可自定义消息
- 主要和次要在线经文来源
- 可编辑的离线备用经文
- 持久化保存玩家偏好设置
- 异步获取经文
- 通过配套 Fabric 模组实现自动去重
玩家设置 GUI
玩家可以使用 /bibleverse gui 打开设置菜单。
GUI 包含以下选项:
- 每次登录
- 每 6 小时
- 每 12 小时
- 每天一次
- 每周一次
- 圣经经文 开/关
- 关闭
当前选中的频率会以高亮显示。
玩家命令
| 命令 |
描述 |
/bibleverse |
显示可用命令列表。 |
/bibleverse gui |
打开 Bible Verse 设置 GUI。 |
/bibleverse toggle |
切换个人经文的开启或关闭状态。 |
/bibleverse enable |
启用个人经文推送。 |
/bibleverse disable |
禁用个人经文推送。 |
/bibleverse frequency every_login |
每次登录后推送经文。 |
/bibleverse frequency 6h |
设置六小时冷却时间。 |
/bibleverse frequency 12h |
设置十二小时冷却时间。 |
/bibleverse frequency 24h |
设置每日冷却时间。 |
/bibleverse frequency weekly |
设置每周冷却时间。 |
管理员与控制台命令
| 命令 |
描述 |
/bibleverse toggle <player> |
切换在线玩家的经文推送开关。 |
/bibleverse enable <player> |
启用在线玩家的经文推送。 |
/bibleverse disable <player> |
禁用在线玩家的经文推送。 |
/bibleverse frequency <player> <tier> |
更改在线玩家的推送频率。 |
/bibleverse preview [player] |
显示一条经文,但不重置冷却时间。 |
/bibleverse status [player] |
显示启用状态、频率、已用时间和冷却就绪情况。 |
/bibleverse reload |
重新加载配置文件和本地经文。 |
/bibleverse gui <player> |
从控制台运行时,为在线玩家打开 GUI。 |
有效的频率层级:
every_login
6h
12h
24h
weekly
权限
| 权限 |
默认值 |
描述 |
bibleverse.use |
所有人 |
访问基础命令和 GUI。 |
bibleverse.toggle |
所有人 |
更改个人开启/关闭状态。 |
bibleverse.frequency |
所有人 |
更改个人推送频率。 |
bibleverse.admin |
操作员 |
管理玩家、预览经文、查看状态以及重新加载插件。 |
安装
- 停止您的 Paper 服务器。
- 将 Bible Verse JAR 文件放入服务器的
plugins 文件夹中。
- 启动服务器。
- 根据需要编辑
config.yml 或 verses.yml。
- 修改后运行
/bibleverse reload 或重启服务器。
请勿将 Paper 插件放入 Fabric 客户端的 mods 文件夹中。Fabric 版本是单独下载的。
要求
- Minecraft
26.2
- Paper
26.2
- Java
25
- 无需客户端模组
- 配套 Fabric 模组为可选
配置
服务器所有者可以配置:
- 登录延迟
- 玩家默认频率
- 频率冷却时长
- 在线经文来源
- API 超时时间
- 离线备用经文
- 大标题和副标题颜色
- 大标题淡入和显示时间
- 副标题最大长度
- 面向玩家的消息
- 玩家数据文件名
玩家偏好设置以 UUID 存储在 plugins/BibleVersePlugin/playerdata.yml 中。
可编辑的离线经文存储在 plugins/BibleVersePlugin/verses.yml 中。
经文来源
插件按以下顺序尝试经文来源:
- 主要: 来自 bible-api.com 的世界英语圣经(World English Bible)经文
- 次要: 来自 labs.bible.org 的新美国标准版圣经(NET Bible)经文
- 离线备用: 来自
verses.yml 的本地经文
如果在线源失败、超时或返回无效响应,插件会自动尝试下一个来源。
在线请求以异步方式运行,因此经文获取不会阻塞主服务器线程。
配套 Fabric 模组
可选的 Bible Verse Local Fabric 模组可在单人游戏或没有此插件的服务器上提供本地经文:
查看 Bible Verse Local Fabric 模组
请将 PASTE_FABRIC_CURSEFORGE_PROJECT_URL_HERE 替换为您的 Fabric 模组的实际 CurseForge URL。
当安装了兼容 Fabric 模组的玩家加入此 Paper 服务器时:
- Paper 插件发送单向存在信号。
- Fabric 模组暂停其本地推送。
- Paper 控制玩家的经文推送计划。
- 玩家仅收到一条经文,避免重复消息。
Fabric 模组为可选。使用普通 Minecraft 客户端的玩家仍会正常接收由 Paper 推送的经文。
隐私
- 玩家设置保留在服务器的插件文件夹内。
- 在线经文请求不包含玩家名称、UUID、聊天内容、坐标或世界数据。
- 不包含任何分析或遥测服务。
翻译
主要版本和离线版本使用公共领域的世界英语圣经(WEB)。
次要来源使用NET 圣经,并在经文旁显示 NET。NET 圣经的版权和许可信息可在 netbible.com/copyright 获取。
让玩家在保持交付由玩家和服务器双重控制的同时,获得一段宁静的经文时光。
Bible Verse — Paper Server Plugin
Bring encouraging Scripture to everyone on your Minecraft server.
Bible Verse is a Paper server plugin that delivers a Bible verse after players join. Each player can choose how often verses appear, disable them completely, or manage everything through an in-game settings GUI.
Install the plugin once on the Paper server. Regular players do not need to install anything.
What Players Can Expect
When a player's cooldown is ready, the plugin waits five seconds by default and displays:
- The Scripture reference as the large title
- A shortened portion of the verse as the subtitle
- The complete verse and translation label in chat
The default frequency is every 12 hours, but every player can choose their own schedule.
If someone disconnects or disables verses during the login delay, the pending verse is cancelled.
Features
- Automatic Bible verses after login
- Individual settings and cooldowns for every player
- Five delivery-frequency choices
- In-game chest-style settings GUI
- Personal ON/OFF control
- Administrator and console controls
- Previews that do not reset delivery cooldowns
- Configurable login delay
- Configurable title colors, subtitle colors, timing, and length
- Customizable messages
- Primary and secondary online verse sources
- Editable offline fallback verses
- Persistent player preferences
- Asynchronous verse retrieval
- Automatic duplicate prevention with the companion Fabric mod
Player Settings GUI
Players can open the settings menu with /bibleverse gui.
The GUI includes:
- Every Login
- Every 6 Hours
- Every 12 Hours
- Once a Day
- Once a Week
- Bible Verses ON/OFF
- Close
The player's currently selected frequency is highlighted.
Player Commands
| Command |
Description |
/bibleverse |
Shows the available commands. |
/bibleverse gui |
Opens the Bible Verse settings GUI. |
/bibleverse toggle |
Toggles personal verses ON or OFF. |
/bibleverse enable |
Enables personal verse delivery. |
/bibleverse disable |
Disables personal verse delivery. |
/bibleverse frequency every_login |
Delivers a verse after every login. |
/bibleverse frequency 6h |
Sets a six-hour cooldown. |
/bibleverse frequency 12h |
Sets a twelve-hour cooldown. |
/bibleverse frequency 24h |
Sets a daily cooldown. |
/bibleverse frequency weekly |
Sets a weekly cooldown. |
Administrator and Console Commands
| Command |
Description |
/bibleverse toggle <player> |
Toggles verses for an online player. |
/bibleverse enable <player> |
Enables verses for an online player. |
/bibleverse disable <player> |
Disables verses for an online player. |
/bibleverse frequency <player> <tier> |
Changes an online player's frequency. |
/bibleverse preview [player] |
Displays a verse without resetting the cooldown. |
/bibleverse status [player] |
Shows enabled state, frequency, elapsed time, and cooldown readiness. |
/bibleverse reload |
Reloads the configuration and local verses. |
/bibleverse gui <player> |
Opens the GUI for an online player when run from console. |
Valid frequency tiers:
every_login
6h
12h
24h
weekly
Permissions
| Permission |
Default |
Description |
bibleverse.use |
Everyone |
Access to the base command and GUI. |
bibleverse.toggle |
Everyone |
Change personal ON/OFF state. |
bibleverse.frequency |
Everyone |
Change personal frequency. |
bibleverse.admin |
Operators |
Manage players, preview verses, view status, and reload the plugin. |
Installation
- Stop your Paper server.
- Place the Bible Verse JAR in the server's
plugins folder.
- Start the server.
- Edit
config.yml or verses.yml if desired.
- Run
/bibleverse reload or restart after making changes.
Do not place the Paper plugin in a Fabric client's mods folder. The Fabric edition is a separate download.
Requirements
- Minecraft
26.2
- Paper
26.2
- Java
25
- No required client-side mod
- Companion Fabric mod is optional
Configuration
Server owners can configure:
- Login delay
- Default player frequency
- Frequency cooldown lengths
- Online verse sources
- API timeouts
- Offline fallback verses
- Title and subtitle colors
- Title fade and display timing
- Maximum subtitle length
- Player-facing messages
- Player-data filename
Player preferences are stored by UUID in plugins/BibleVersePlugin/playerdata.yml.
Editable offline verses are stored in plugins/BibleVersePlugin/verses.yml.
Verse Sources
The plugin tries verse sources in this order:
- Primary: World English Bible verses from bible-api.com
- Secondary: NET Bible verses from labs.bible.org
- Offline fallback: Local verses from
verses.yml
If an online source fails, times out, or returns an invalid response, the plugin automatically tries the next source.
Online requests run asynchronously so verse retrieval does not block the main server thread.
Companion Fabric Mod
The optional Bible Verse Local Fabric mod provides local verses in singleplayer and on servers without this plugin:
View the Bible Verse Local Fabric mod
Replace PASTE_FABRIC_CURSEFORGE_PROJECT_URL_HERE with the actual CurseForge URL for your Fabric mod.
When a player with the compatible Fabric mod joins this Paper server:
- The Paper plugin sends a one-way presence signal.
- The Fabric mod pauses its local delivery.
- Paper controls the player's verse schedule.
- The player receives one verse instead of duplicate messages.
The Fabric mod is optional. Players using an ordinary Minecraft client still receive Paper-delivered verses normally.
Privacy
- Player settings remain inside the server's plugin folder.
- Online verse requests do not include player names, UUIDs, chat, coordinates, or world data.
- No analytics or telemetry service is included.
Translations
Primary and offline verses use the public-domain World English Bible (WEB).
The secondary source uses the NET Bible and displays NET beside the verse. NET Bible copyright and permissions information is available at netbible.com/copyright.
Give your players a calm moment of Scripture while keeping delivery under both player and server control.
评论 0
登录后参与评分
还没有评论,来抢沙发吧