本插件与**光影优化模组(Lighting optimization mod)**无任何关联。
请在下载前知悉,以免浪费时间,谢谢。
本项目是 quark-plugin 的延续。
如需更多信息和历史版本下载,请访问该页面。
关于数据升级和迁移,请参阅下文内容。
请加入我们的 QQ 群以便更好地交流:1093970869
描述
这是适用于 Spigot/Paper/Folia/Mohist 服务器的必备插件套件,
包含超过 90 个模块,为各种规模的服务器提供无数功能!
本插件还包含多项性能增强和修复。
从管理到展示、游戏特性到安全防护,
这些内容将从各个方面提升你的服务器体验。
可能用途
- 创建 SMP 服务器。
- 结合 WorldEdit 和 CoreProtect 创建 CMP 服务器。
- 结合 Citizens 和签到插件创建 Lobby 服务器。
所有功能均为独立且可组合的。
你可以通过启用或禁用模块、
添加或移除扩展包,
甚至通过 SDK 包自定义你自己的打包方案。
目标与初衷
我们不太可能专注于那些庞大的内容,或是对单一功能做到极端优化。
我们所做的是创造一种“液体”,以填充服务器中未被修改的细节。
因此,请不要期望我们会像制作模组那样行事——至少在主包中不会如此。
Starlight 仅提供一个基础且可用的实现方案,所以如果你发现有专用的插件可以替换部分提供的功能,请毫不犹豫地直接使用它们——它们的效果绝对更好(100% better)。
核心特性
- 多平台支持:基本支持所有基于 Bukkit 实现的服务器(详见下文)
- 快速:初始化时间少于 600ms,支持命令行热重载。
- 模块化:所有功能均可单独开关。
DISCLAIMER / 免责声明
本项目中的语言代码仅用于标识语言及本地化内容,以兼容 Minecraft 及相关国际化标准。
部分语言代码可能包含地区标识,其用途仅为区分不同语言习惯与翻译分支,不代表任何政治立场或地区主张。
部分外部服务(如 IP 属地、系统 Locale 或第三方 API)返回的信息由其提供方决定,本项目不对相关数据的准确性或地区划分方式作额外定义。
Language codes used in this project are intended solely for localization and compatibility purposes,
following Minecraft and common internationalization conventions where applicable.
Some language tags may include regional identifiers used only to distinguish language variants or localization differences,
and do not imply any political position or territorial claim.
Certain external information (such as IP geolocation, system locale, or third-party API results) is provided by external services.
This project does not define or endorse any regional classification returned by such services.
安装
1. 从页面下载捆绑包。
2. 安装它们。
- 停止服务器或输入
/starlight reload prepare
- 将它们放入你的 jar 包中。
3. 重载。
- 启动服务器或输入
/starlight reload action
- 等待。
4. 卡在库下载?
为了获得更好的性能和更小的 jar 包,Starlight 将使用 OTA 模式
来下载所需的所有库。
如果在 config.yml 中加载库时卡住,你可以更改 Maven 镜像源:
config:
#...
dependency:
maven-repo: ALICLOUD
# accept any maven repo URLS, or:
# - 'ALICLOUD' (AliCloud maven central)
# - 'HUAWEI' (Huawei maven repo)
# - 'TENCENT' (TencentCloud maven repo)
# - 'TSINGHUA' (Tsinghua University maven repository)
# - 'CENTRAL' (Maven Central repo, Capable for non-China users.)
内容
基本概念
- 模块(Module):本工具提供的功能的最小单元。
- 包(Package):模块的最小分组,共享值配置和本地化(i18n)文件。
> 可以通过命令启用或禁用某个包或模块。
> 一个 jar 文件将包含多个模块。
点击各个选项卡并展开以查看包含的内容。
如果不这样做,这个 README 会变得非常非常长。
内容:
starlight-commands:
- Entity Proxy Execute Command(实体代理执行命令):以其他实体或玩家的身份执行命令 文档↗
- Send Message(发送消息):仅向发送者发送格式化消息 文档↗
- Item Command Trigger(物品命令触发器):将命令和操作绑定到物品上 文档↗
- Wear Hat(佩戴帽子):将手持物品装备为可佩戴的头饰 文档↗
- Block Animation(方块动画):使用掉落方块效果为方块添加动画 文档↗
- WorldEdit Command Supplement(WorldEdit 命令补充):提供 WorldEdit 实用画笔和编辑命令 文档↗
- Entity Motion Command(实体运动命令):通过速度命令控制实体运动 文档↗
- Command Tab Completion Fix(命令补全修复):修复服务器命令的标签页补全功能 文档↗
starlight-warps:
- Waypoint(传送点):创建和管理玩家的传送坐标点 文档↗
- Back to Death Point(返回死亡地点):将玩家传送回其死亡位置 文档↗
- Teleport Request(传送请求):处理玩家之间的传送请求与接受 文档↗
- Random teleport(随机传送):将玩家传送到世界中的随机位置 文档↗
starlight-security:
- WorldEdit Operation Monitor(WorldEdit 操作监控):通过确认机制防御未经授权的 WorldEdit 操作 文档↗
- IP Address Detection(IP 地址检测):防御恶意 IP 连接并提供 IP 查询命令 文档↗
- Explosion Defender(爆炸防御):支持白名单,防御方块和实体爆炸 文档↗
- Advanced Permission Control(高级权限控制):控制玩家在聊天、交互和破坏行为方面的高级权限 文档↗
- plugin-backdoor-scanner(插件后门扫描器):扫描插件中是否存在恶意的后门代码模式 文档↗
- Guest Mode(访客模式):限制指定世界中访客玩家的操作 文档↗
- IMG Regulation Sync(IMG 监管同步):从 IMG 监管服务同步玩家封禁记录 文档↗
- end-protect(末地保护):防止在末地维度放置末影水晶 文档↗
- Simple Permission Control(简单权限控制):管理玩家权限,支持 JDBC 存储和命令 文档↗
starlight-oddities:
- Elevator Block(电梯方块):创建类似 OpenBlock 模组的电梯方块。文档↗
starlight-tweaks:
- Sit on players(坐在玩家身上):允许玩家通过右键点击坐在其他玩家身上。文档↗
- Portable Functional Blocks(便携功能方块):允许通过手持物品打开功能方块的 GUI 文档↗
- Stair Seat(楼梯座位):允许玩家坐在楼梯方块上 文档↗
- Realistic Minecart(真实矿车):增强矿车行为,提供更真实的物理效果和操控性 文档↗
- Quick Open Shulker Box(快速开启潜影盒):允许直接从物品栏中打开潜影盒 文档↗
- Crop Click Harvest(点击收获作物):允许通过右键点击来收获作物 文档↗
- Double Door Synchronization(双门同步):同步相邻木门同时开闭 文档↗
- Dispenser Interaction Imporovement(发射器交互改进):通过自定义行为增强发射器的交互体验 文档↗
- Realistic Sleep(真实睡眠):需要大多数玩家入睡才能跳过夜晚 文档↗
- Vein Miner(矿脉矿工):一次挖掘即可开采整个相连的矿石矿脉 文档↗
- Drop Prevention(防掉落保护):防止意外掉落已锁定的物品 文档↗
starlight-proxy:
- 集群聊天同步:在代理服务器实例间同步聊天消息 文档↗
- 集群延迟指标修复:监控并通过代理广播玩家延迟数据 文档↗
- Geyser 皮肤重映射:通过 Geyser 集成重定向基岩版玩家的皮肤 文档↗
- BungeeCord 集群保护:防止未经授权的旧式转发连接 文档↗
- 客户端转移模组支持:支持在代理服务器之间转移玩家 文档↗
starlight-chat:
- 富文本聊天支持:处理聊天组件和告示牌文本格式 文档↗
- 聊天提及:处理聊天中的 @提及和玩家补全功能 文档↗
starlight-sideload:
- inventory-menu:为玩家提供自定义物品栏 GUI 菜单 文档↗
- recipe-loader:从配置文件中加载自定义合成配方 文档↗
- resource-pack-loader:通过 HTTP 服务器向玩家提供资源包 文档↗
starlight-display:
- Player Title:在玩家名称前显示标题头。 文档↗
- Custom Welcome Message:当玩家首次加入服务器时展示欢迎信息。 文档↗
- Dropped Item Highlight Information:在地面掉落物品时显示物品信息 文档↗
- Custom Scoreboard Information:为玩家渲染自定义记分板 文档↗
- TAB Menu Information:提供 TAB 列表显示。 文档↗
- Chat Announcements:向玩家广播周期性公告 文档↗
- Chat Line Formatting:重新格式化你的聊天行。 文档↗
- AFK Detection:当玩家开始挂机时进行广播提示。 文档↗
- Custom MOTD Information:自定义服务器列表中的每日公告 (MOTD) 文档↗
- Custom Death Message Format:重新格式化你的死亡信息。 文档↗
- WorldEdit Selection Renderer:渲染 WorldEdit 选择会话的视觉效果 文档↗
- Player Join Notification:在玩家加入和离开时显示消息。 文档↗
- Custom Kick Message:自定义踢出和封禁消息 文档↗
- Action Bar HUD Information Display:在动作栏标题处创建 HUD 显示。 文档↗
starlight-utilities:
- Hitokoto: 显示来自 hitokoto API 的随机励志名言 doc↗
- tick-manager: 冻结、解冻并步进服务器刻数
- Free Camera: 允许玩家将摄像机与角色分离 doc↗
- Flight Control Commands: 控制玩家飞行速度及开启/关闭 doc↗
- Block Update Locker: 锁定方块更新,如活塞和红石 doc↗
- Particle Text Rendering: 使用粒子效果在世界中渲染文本 doc↗
- Menu Item Trigger: 提供用于快速访问菜单的物品 doc↗
- Client Environment Settings: 允许玩家设置本地天气和时间 doc↗
- Position Lock Command: 防止被锁定的玩家从其位置移动 doc↗
- inventory-profile: 加载并检查玩家的物品栏 NBT 数据 doc↗
- Custom View Distance: 根据玩家数量动态调整服务器视距 doc↗
- Calculator: 通过聊天命令计算数学表达式 doc↗
- Surrounding Block Refresh: 刷新玩家周围的方块和区块 doc↗
- Custom Camera Path: 让玩家摄像机沿预设路径移动 doc↗
- Modern Minecart Movement Compatibility: 为旧版客户端提供新版本协议的信息。 doc↗
- Player Ping Query: 显示玩家延迟/Ping 信息 doc↗
- Position Alignment Command: 将玩家位置对齐到最近的方块中心 doc↗
starlight-management:
- Maintenance Mode: 启用维护模式以限制玩家访问 doc↗
- Chat Report: 处理带有哈希验证的聊天举报 doc↗
- Ban Commands: 管理基于时间长度的玩家封禁 doc↗
- Chat Mute: 管理基于时间长度的玩家禁言 doc↗
- Server Information Commands: 显示服务器信息和性能统计 doc↗
- Auto-Kick on Reload: 在服务器重载时踢出玩家以防止问题 doc↗
- Automatic Garbage Collection: 定期运行垃圾回收以释放内存 doc↗
- Command-Line Plugin Manager: 提供插件管理命令,如列表和切换 doc↗
- Chat Filter: 过滤玩家在聊天和告示牌中的不良用语。 doc↗
- TPS Visual Bar: 通过 Boss 栏叠加层显示 TPS 和 MSPT doc↗
starlight-console:
- [BETA] Custom Log Format: 配置自定义日志格式模式 doc↗
- Stop Confirmation: 在服务器停止前需要确认 doc↗
- Console Proxy Execution: 从服务器控制台执行命令 doc↗
- [BETA] Log Color Patch: 使用 ANSI 颜色修补日志输出 doc↗
- Console Cleaner: 清除控制台屏幕 doc↗
starlight-core:
- [Core] 自定义插件语言加载器:从外部 zip 存档中加载自定义第三方语言资源包。文档↗
- [Core] PlaceHolderAPI 交互支持:提供 papi 支持。文档↗
- [Core] 玩家视角自定义:自定义玩家视角和 UI 设置 文档↗
- [Core] 安装完整性检查:验证插件安装并检测配置问题 文档↗
- [Core] Modrinth 更新服务:在 Modrinth 上检查插件更新 文档↗
- [Core] 平台差异修补器:为特定平台提供修复。文档↗
- [Core] ProtocolLib 平台代理:通过 ProtocolLib 创建兼容性更强的消息发送。文档↗
- [Core] 更新日志查看器:向玩家显示版本更新日志 文档↗
starlight-worldguard:
- wg-region-hud:创建一个显示 WorldGuard 区域信息的 HUD。文档↗
- wg-custom-name:允许为 WorldGuard 区域自定义显示名称 文档↗
- wg-we-check:根据 WorldGuard 区域权限验证 WorldEdit 编辑操作 文档↗
- wg-claim:提供 WorldGuard 区域认领和取消认领的命令 文档↗
starlight-music:
- 音乐播放器:为服务器上的玩家播放自定义音乐曲目 文档↗
兼容性
我们强烈建议您使用基于 Paper 的服务器以启用所有功能。
它也可以在其他平台上运行,但谁知道会发生什么呢?(因为懒散的 GrassBlock2022 从未测试过它们)
版本页面上显示的版本仅用于占位。所有版本均可在 [1.13-1.20] 中使用
| 平台 |
功能 |
交互文本 |
支持 |
描述 |
| Paper |
完整 |
完整 |
完整 |
推荐 |
| Spigot |
大部分 |
完整 |
BugFix |
|
| Bukkit |
少量 |
否 |
测试 |
|
| Folia |
大部分 |
完整 |
BugFix |
不支持热重载 |
| Mohist |
少量 |
否 |
测试 |
UnexpectedBlockChange 不同步 |
使用的第三方库:
| 依赖项 |
范围 |
用途 |
| com.sk89q.worldedit:worldedit-bukkit:7.2.0-SNAPSHOT |
reference |
插件相关扩展 |
| com.sk89q.worldedit:worldedit-core:7.2.0-SNAPSHOT |
reference |
插件相关扩展 |
| me.clip:placeholderapi:2.11.6 |
reference |
占位符支持 |
| org.ahocorasick:ahocorasick:0.6.3 |
downloaded |
聊天过滤算法 |
| net.bytebuddy:byte-buddy:1.17.8 |
downloaded |
字节码扫描 |
| net.kyori:adventure-api:4.17.0 |
auto-complete |
Adventure API |
| net.kyori:adventure-text-serializer-gson:4.17.0 |
auto-complete |
Adventure 序列化器 |
| net.kyori:adventure-text-serializer-legacy:4.17.0 |
auto-complete |
Adventure 序列化器 |
| net.kyori:adventure-text-serializer-plain:4.17.0 |
auto-complete |
Adventure 序列化器 |
| net.kyori:adventure-text-minimessage:4.17.0 |
auto-complete |
MiniMessage 支持 |
| com.h2database:h2:2.3.232 |
reference |
数据库支持 |
| com.baomidou:mybatis-plus:3.5.15 |
reference |
ORM 框架集成 |
| io.netty:netty-codec-http:4.1.128.Final |
reference |
HTTP 服务 |
| adventure-platform-api-4.4.1 |
packaged |
Adventure 平台桥接 |
| adventure-platform-bukkit-4.4.1 |
packaged |
Adventure Bukkit 支持 |
| adventure-platform-facet-4.4.1 |
packaged |
Adventure 平台面 |
| :lib-starlight-shared |
packaged |
共享内部库 |
| me.gb2022.commons:commons-nbt |
packaged |
NBT 工具 |
| me.gb2022.commons:commons-math |
packaged |
数学工具 |
| me.gb2022.commons:commons-container |
packaged |
容器工具 |
| me.gb2022.commons:commons-general |
packaged |
通用工具 |
| me.gb2022.commons:commons-event |
packaged |
事件框架 |
| me.gb2022.commons:commons-reflection |
packaged |
反射工具 |
| me.gb2022.commons:commons-compatibility |
packaged |
兼容层 |
| me.gb2022.apm:apm-remote |
packaged |
APM 远程模块 |
| me.gb2022.apm:apm-plugin |
packaged |
APM 插件模块 |
| org.atcraftmc.qlib:qlib-bukkit |
packaged |
QLib Bukkit 集成 |
| me.gb2022:gluon-main |
packaged |
Gluon 框架运行时 |
| me.gb2022.pluginsX-lib |
packaged |
内部插件库 |
常见问题
它与那个 Starlight 模组有什么关系?
基本上,没关系 :D
Starlight 模组的功能与此项目完全不同。它重写了光照引擎,仅提供优化功能。
为什么安装 starlight-core.jar 后我看不到任何变化?
朋友!我能说什么呢?请看安装部分 :D
为什么要改名?
这个项目最初的名字是 quark-plugin。为了避免与该模组(每个人都喜欢的那个)发生冲突,我决定更改其名称。
但这并非唯一原因。这个项目实际上开始于很久很久很久以前,源自一个小型插件。最糟糕的是,当我启动这个项目时,我实际上对 Java 一无所知。
因此,现在随着该插件获得越来越多的认可,从零开始并重构整个架构以确保可扩展性变得至关重要。
作为延续项目,接下来会发生什么?
不幸的是,为了彻底重构架构,我不得不做出很多牺牲,尤其是兼容性。
从下一个版本开始,该项目将进入 alpha 阶段。插件将使用完全不同的命名空间和 ID。
一旦重构完成,将添加自动迁移代码,允许您从旧插件数据文件夹升级玩家数据和模块数据,新的 starlight 插件可以与旧插件共存。
帮助我们测试
Alpha 阶段伴随着不一致性,所以现在需要您的帮助。请将任何错误或功能请求提交到上面的 GitHub 链接,非常感谢。
与 quark-plugin 配合使用
新的 starlight 内核现在在不同的命名空间中注册内容,但功能冲突仍然存在。您必须手动禁用旧插件中与 starlight 功能重复的模块。
升级与迁移
不幸的是,由于大多数 ID 和值都发生了更改,无法移动或迁移遗留的语言文件或配置文件,因此请在准备好后重新配置它们。
核心版本 25.3.10 之后,我们提供了数据迁移功能。您可以使用命令:
/starlight upgrade-data [category]
来迁移您希望在遗留 quark-plugin 中保留的数据。
目前,我们支持航点数据、音乐文件和静音数据。对于任何其他请求,请在 issue 中留言。
为什么我无法禁用某些模块?
某些模块(主要在 starlight-core 中)提供基本功能或被其他系统依赖。
启用它们不会消耗任何资源。
为什么下载后我看不到某些功能?
有两种可能性。
1. 某些功能未自动启用。
这是手动定义的,因为我们不会期望在安装整个捆绑包后它们会自动加载。
例如,日志颜色补丁模块在某些服务器上运行良好,但在其他服务器上会崩溃。
很难说为什么会出现这种情况,因为它的工作原理类似于注入,并且没有证据指向平台 API 问题。
要解决此问题,在你明确会发生什么之后,筛选正确的模块 ID 并手动启用它。
2. 某些功能需要特定的平台。
基于 Bukkit 的服务器有多个分支,其中大多数在技术上都是不同的。
例如,基于 Folia 的服务器目前没有记分板 API,
而混合服务器(将 Forge/Fabric 与 Bukkit 结合)具有糟糕(并非不好)的类加载设计。
当我们的平台缺少所需 API 时,我们无法期望某些功能能够正常工作。
Starlight -「星辰」
由 GrassBlock2022 发起的开源项目,版权归 @ATCraftMC 所有 2020-2024
This plugin does not have any relation to the Lighting optimization mod.
Please be aware before downloading to not waste your time, Thanks.
This project is a continuation of quark-plugin.
for more information and legacy downloads, please go there, also.
For data upgrade and migration, see content below.
Please join our qq group for better communication:1093970869
Description
This is an essential plugin suite for Spigot/Paper/Folia/Mohist servers,
including more than 90 modules that provides countless features for servers of any scale!
This plugin also includes several performance enhancements and fixes.
From management to display,game features to security,
these contents will improve your server from every aspect.
Possible Usages
- create a SMP server.
- create a CMP server with WorldEdit and CoreProtect.
- create a Lobby server with Citizens and sign-in plugins.
All the features are independently and composable.
you can customize its function by enable or disable modules,
add or remove extension packs,
or even make your own pack through sdk pack.
Goal and reason of this
We are not likely to focus on those massive contents or doing things to extreme on single function.
What we are doing is to create a liquid that fills the unmodified details on the server.
So please do not expect we will do something as a mod——at least not in primary packages.
Starlight only provide a basic and usable implementation, so if you find dedicated plugin to replace part of function
provided, just use them without doubts——They are 100% better.
Core Features
- MultiPlatform support: supports basically every Bukkit-Implemented Server(see below)
- Fast: initialize on less than 600ms, support command-line hot reload.
- Modularized: all features are separately toggleable.
DISCLAIMER / 免责声明
本项目中的语言代码仅用于标识语言及本地化内容,以兼容 Minecraft 及相关国际化标准。
部分语言代码可能包含地区标识,其用途仅为区分不同语言习惯与翻译分支,不代表任何政治立场或地区主张。
部分外部服务(如 IP 属地、系统 Locale 或第三方 API)返回的信息由其提供方决定,本项目不对相关数据的准确性或地区划分方式作额外定义。
Language codes used in this project are intended solely for localization and compatibility purposes,
following Minecraft and common internationalization conventions where applicable.
Some language tags may include regional identifiers used only to distinguish language variants or localization differences,
and do not imply any political position or territorial claim.
Certain external information (such as IP geolocation, system locale, or third-party API results) is provided by external services.
This project does not define or endorse any regional classification returned by such services.
Installation
1. Download the bundler pack from page.
2. install them.
- Stop server or type
/starlight reload prepare
- Throw them into your jar.
3. reload.
- Start your server or type
/starlight reload action
- Wait.
4. Stuck on library download?
For better performance and smaller jars, starlight will use OTA mode
to download all libraries needed.
You can change maven mirror if you got stuck on library loading in config.yml:
config:
#...
dependency:
maven-repo: ALICLOUD
# accept any maven repo URLS, or:
# - 'ALICLOUD' (AliCloud maven central)
# - 'HUAWEI' (Huawei maven repo)
# - 'TENCENT' (TencentCloud maven repo)
# - 'TSINGHUA' (Tsinghua University maven repository)
# - 'CENTRAL' (Maven Central repo, Capable for non-China users.)
Contents
Basic concepts
- Module: The minimum unit of functions this artifact provides.
- Package: The smallest group of modules, share value configurations and i18n files.
> A package or module can be enabled or disable by commands.
> A jar will contain multiple modules.
Click on each tabs and expand them to see what is included.
This readme will become to loooooooooong if I don't do this.
Content:
starlight-commands:
- Entity Proxy Execute Command: Executes commands as other entities or players doc↗
- Send Message: Sends formatted messages to the sender only doc↗
- Item Command Trigger: Binds commands and actions to items doc↗
- Wear Hat: Equips held items as wearable head gear doc↗
- Block Animation: Animates blocks with falling block effects doc↗
- WorldEdit Command Supplement: Provides WorldEdit utility brush and editing commands doc↗
- Entity Motion Command: Controls entity motion with velocity commands doc↗
- Command Tab Completion Fix: Fixes tab completion for server commands doc↗
starlight-warps:
- Waypoint: Creates and manages teleport waypoints for players doc↗
- Back to Death Point: Teleports players back to their death location doc↗
- Teleport Request: Handles teleport request and acceptance between players doc↗
- Random teleport: Teleports players to a random location in the world doc↗
starlight-security:
- WorldEdit Operation Monitor: Defends against unauthorized WorldEdit operations with confirmation doc↗
- IP Address Detection: Defends against malicious IP connections and provides IP query commands doc↗
- Explosion Defender: Defends against block and entity explosions with whitelist support doc↗
- Advanced Permission Control: Controls advanced player permissions for chat, interact, and break actions doc↗
- plugin-backdoor-scanner: Scans plugins for malicious backdoor code patterns doc↗
- Guest Mode: Restricts actions for guest players in specified worlds doc↗
- IMG Regulation Sync: Syncs player ban records from IMG regulation service doc↗
- end-protect: Protects the End dimension from crystal placement doc↗
- Simple Permission Control: Manages player permissions with JDBC-backed storage and commands doc↗
starlight-oddities:
- Elevator Block: Create a OpenBlock mod styled elevator block. doc↗
starlight-tweaks:
- Sit on players: Enable player to sit on others by right-click. doc↗
- Portable Functional Blocks: Opens functional block GUIs from hand-held items doc↗
- Stair Seat: Allows players to sit on stair blocks doc↗
- Realistic Minecart: Enhances minecart behavior for realistic physics and control doc↗
- Quick Open Shulker Box: Opens shulker boxes directly from the inventory doc↗
- Crop Click Harvest: Allows harvesting crops by right-clicking them doc↗
- Double Door Synchronization: Synchronizes adjacent wooden doors to open together doc↗
- Dispenser Interaction Imporovement: Enhances dispenser interaction with custom behavior doc↗
- Realistic Sleep: Requires most players to sleep for night skip doc↗
- Vein Miner: Mines entire connected ore veins with one break doc↗
- Drop Prevention: Prevents accidental dropping of secured items doc↗
starlight-proxy:
- Cluster Chat Sync: Syncs chat messages across proxy server instances doc↗
- Cluster Ping Metrics Fix: Monitors and broadcasts player ping across proxy doc↗
- Geyser Skin Remapping: Redirects Bedrock player skins via Geyser integration doc↗
- BungeeCord Cluster Protection: Protects against unauthorized legacy forwarding connections doc↗
- Client Transfer Mod Support: Supports transferring players between proxy servers doc↗
starlight-chat:
- Rich Text Chat Support: Processes chat components and sign text formatting doc↗
- Chat Mention: Handles @mentions and player completion in chat doc↗
starlight-sideload:
- inventory-menu: Provides custom inventory GUI menus for players doc↗
- recipe-loader: Loads custom crafting recipes from configuration files doc↗
- resource-pack-loader: Serves resource packs to players via HTTP server doc↗
starlight-display:
- Player Title: Provide a Header before player's name. doc↗
- Custom Welcome Message: Present a welcome message when player join a server at first time. doc↗
- Dropped Item Highlight Information: Shows item info when dropped on ground doc↗
- Custom Scoreboard Information: Renders a custom scoreboard for players doc↗
- TAB Menu Information: Provide a tab board display. doc↗
- Chat Announcements: Broadcasts periodic announcements to players doc↗
- Chat Line Formatting: Re-format your chat line. doc↗
- AFK Detection: Announce when player starting AFK. doc↗
- Custom MOTD Information: Customizes server list message of the day doc↗
- Custom Death Message Format: Re-format your death message. doc↗
- WorldEdit Selection Renderer: Renders WorldEdit selection session visuals doc↗
- Player Join Notification: Display message on player join and quit. doc↗
- Custom Kick Message: Customizes kick and ban messages doc↗
- Action Bar HUD Information Display: Create a HUD display on actionbar title. doc↗
starlight-utilities:
- Hitokoto: Displays random inspirational quotes from hitokoto API doc↗
- tick-manager: Freezes, unfreezes, and steps the server tick
- Free Camera: Allows players to detach camera from their body doc↗
- Flight Control Commands: Controls player flight speed and toggling doc↗
- Block Update Locker: Locks block updates such as pistons and redstone doc↗
- Particle Text Rendering: Renders text in the world using particle effects doc↗
- Menu Item Trigger: provides an item for accessing menu quicker doc↗
- Client Environment Settings: Allows players to set local weather and time doc↗
- Position Lock Command: Prevents locked players from moving from their position doc↗
- inventory-profile: Loads and examines player inventory NBT data doc↗
- Custom View Distance: Dynamically adjusts server view distance based on player count doc↗
- Calculator: Evaluates mathematical expressions via chat command doc↗
- Surrounding Block Refresh: Refreshes surrounding blocks and chunks for a player doc↗
- Custom Camera Path: Moves player camera along a predefined path doc↗
- Modern Minecart Movement Compatibility: provide information to legacy clients of newer protocol. doc↗
- Player Ping Query: Shows player latency/ping information doc↗
- Position Alignment Command: Aligns player position to the nearest block center doc↗
starlight-management:
- Maintenance Mode: Enables maintenance mode to restrict player access doc↗
- Chat Report: Handles chat reporting with hash verification doc↗
- Ban Commands: Manages player bans with time-based durations doc↗
- Chat Mute: Manages player muting with time-based durations doc↗
- Server Information Commands: Displays server information and performance statistics doc↗
- Auto-Kick on Reload: Kicks players on server reload to prevent issues doc↗
- Automatic Garbage Collection: Periodically runs garbage collection to free memory doc↗
- Command-Line Plugin Manager: Provides plugin management commands like list and toggle doc↗
- Chat Filter: Filter player's bad words in chat and signs. doc↗
- TPS Visual Bar: Shows TPS and MSPT via a boss bar overlay doc↗
starlight-console:
- [BETA] Custom Log Format: Configures custom log format patterns doc↗
- Stop Confirmation: Requires confirmation before server stop doc↗
- Console Proxy Execution: Executes commands from the server console doc↗
- [BETA] Log Color Patch: Patches log output with ANSI colors doc↗
- Console Cleaner: Clears the console screen doc↗
starlight-core:
- [Core] Custom Plugin Language Loader: Load custom third-party language resource packs from external zip archives. doc↗
- [Core] PlaceHolderAPI Interaction Support: Provide papi support. doc↗
- [Core] Player View Customization : Customizes the player view and UI settings doc↗
- [Core] Installation Integrity Check: Verifies plugin installation and detects configuration issues doc↗
- [Core] Modrinth Update Service: Checks for plugin updates on Modrinth doc↗
- [Core] Platform Difference Patcher: Provide fixes for certain platform. doc↗
- [Core] ProtocolLib Platform Proxy: Create more compatible message sending via ProtocolLib. doc↗
- [Core] Update Log Viewer: Displays version update logs to players doc↗
starlight-worldguard:
- wg-region-hud: Create an HUD displaying WorldGuard region info. doc↗
- wg-custom-name: Allows custom display names for WorldGuard regions doc↗
- wg-we-check: Validates WorldEdit edits against WorldGuard region permissions doc↗
- wg-claim: Provides WorldGuard region claiming and unclaiming commands doc↗
starlight-music:
- Music Player: Plays custom music tracks for players on the server doc↗
Compatibility
We STRONGLY recommend you to use paper based server to enable full features.
it could work on other platform, but who knows what will happen? (since lazy GrassBlock2022 never test them)
Versions showed in versions page are just for placeholder. all versions can work in [1.13-1.20]
| Platform |
Features |
Interactive Text |
Support |
Description |
| Paper |
Full |
Full |
Full |
Recommended |
| Spigot |
Most |
Full |
BugFix |
|
| Bukkit |
Few |
No |
Test |
|
| Folia |
Most |
Full |
BugFix |
No hot reload |
| Mohist |
Few |
No |
Test |
UnexpectedBlockChange not sync |
Used Third-party libraries:
| Dependency |
Scope |
Usage |
| com.sk89q.worldedit:worldedit-bukkit:7.2.0-SNAPSHOT |
reference |
plugin-related-extension |
| com.sk89q.worldedit:worldedit-core:7.2.0-SNAPSHOT |
reference |
plugin-related-extension |
| me.clip:placeholderapi:2.11.6 |
reference |
placeholder support |
| org.ahocorasick:ahocorasick:0.6.3 |
downloaded |
chat-filtering algorithm |
| net.bytebuddy:byte-buddy:1.17.8 |
downloaded |
bytecode scanning |
| net.kyori:adventure-api:4.17.0 |
auto-complete |
Adventure API |
| net.kyori:adventure-text-serializer-gson:4.17.0 |
auto-complete |
Adventure serializer |
| net.kyori:adventure-text-serializer-legacy:4.17.0 |
auto-complete |
Adventure serializer |
| net.kyori:adventure-text-serializer-plain:4.17.0 |
auto-complete |
Adventure serializer |
| net.kyori:adventure-text-minimessage:4.17.0 |
auto-complete |
MiniMessage support |
| com.h2database:h2:2.3.232 |
reference |
Database support |
| com.baomidou:mybatis-plus:3.5.15 |
reference |
ORM framework integration |
| io.netty:netty-codec-http:4.1.128.Final |
reference |
HTTP service |
| adventure-platform-api-4.4.1 |
packaged |
Adventure platform bridge |
| adventure-platform-bukkit-4.4.1 |
packaged |
Adventure Bukkit support |
| adventure-platform-facet-4.4.1 |
packaged |
Adventure platform facet |
| :lib-starlight-shared |
packaged |
Shared internal library |
| me.gb2022.commons:commons-nbt |
packaged |
NBT utilities |
| me.gb2022.commons:commons-math |
packaged |
Math utilities |
| me.gb2022.commons:commons-container |
packaged |
Container utilities |
| me.gb2022.commons:commons-general |
packaged |
General utilities |
| me.gb2022.commons:commons-event |
packaged |
Event framework |
| me.gb2022.commons:commons-reflection |
packaged |
Reflection utilities |
| me.gb2022.commons:commons-compatibility |
packaged |
Compatibility layer |
| me.gb2022.apm:apm-remote |
packaged |
APM remote module |
| me.gb2022.apm:apm-plugin |
packaged |
APM plugin module |
| org.atcraftmc.qlib:qlib-bukkit |
packaged |
QLib Bukkit integration |
| me.gb2022:gluon-main |
packaged |
Gluon framework runtime |
| me.gb2022.pluginsX-lib |
packaged |
Internal plugin library |
FAQ
What relationship does it have to that Starlight mod?
Basically, nope :D
Starlight mod has a totally different function from this artifact.It rewrites light engine and simply provide optimizes.
Why I can't see any changes after installing starlight-core.jar?
Man! What can I say? see Installation section :D
Why it is renamed?
This project is originally name quark-plugin. To avoid being collided with that mod——which everybody loves it, I
decide to change its name.
But the reason is not only for this. This project actully starts from long long long long ago, from a small plugin. The
most bad thing is that when I started this project, I actually have NO
understandings to java.
So now, when this plugin is getting more appreciation, start off from the blank and refactor the WHOLE archtecture to
ensure extandability is important.
What will happen since this project is a continuation?
Unfortunately, to wholly frick the architecture away, I HAVE to sacrifice A lot, especially, compatibility.
from the following version, This project will enter alpha stages.The plugin will use a completely different namespace
and ID.
As soon as the refactor done, the auto-migaration code will be added, to allow you to upgrade Player Data and module
data from old plugin data folder, and the new starlight plugin can work with the old one together.
Help us test
Alpha stage goes with inconsistentcy, so it's now for you to offer help. Please submit any bugs or feature requests to
github link above, thank you sooooo much.
Working with quark-plugin
The new starlight kernal now register things in a different namespace, but feature conflicts still exists. You have to
manually disable modules that has duplicated feature with starlight in your older plugin.
Upgrading and migration
Unfortunately, since most of ids and values are changed, it's not possible to move or migrate legacy language or config
file, so please re-configure them once it's ready.
After core version 25.3.10, we provide data migration. You could use command:
/starlight upgrade-data [category]
to migrate data u would like to in legacy quark-plugin.
Currently, we support waypoint data, music files and mute data. For any other request, leave it in issue.
Why I can't disable some module?
Some modules(mostly in starlight-core) provides basic features or relied by other systems.
Enable them will not cost any resources.
Why I can't see some of the features after downloading this?
There are two possibilities.
1. Some features are not automatically enabled.
This is manually defined, since we won't expect them to load after we install the WHOLE bundler.
For example, the log color patching module work fine on some server, but crash on others.
It's hard to say why since it works like injecting, and there is no evidence points to platform api issue.
To resolve this, after you KNOW what will happen, filter the correct module ID and enable it manually.
2. Some features require certain platform.
Bukkit-based server has multiple branches, and most of them are technically different.
For example, Folia based server does NOT have scoreboard API(currently),
and a MIXED server(combine forge/fabric with bukkit) has a horrible(not bad) class loading design.
We just can't expect some features to work when our platform is missing needed API.
Starlight -「星辰」
A open project by GrassBlock2022, owning by @ATCraftMC 2020-2024
评论 0
登录后参与评分
还没有评论,来抢沙发吧