Starlight-Plugin

插件

· 作者 GrassBlock2022

一个包含你所需一切的插件 :D

0 本站下载 0 关注 更新于 3 周前

最新 26.6.4 · 26.2 · Bukkit / Folia

一键开服(送7天)

本插件与**光影优化模组(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

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源