# Eclipse
**Eclipse** 是一个 Paper 插件,将 SpongePowered/Fabric Mixin 引入到 Paper 服务器环境中。该项目实现了 Ignite Mixin Launcher 的修改版本,修改后在 Minecraft 版本方面更具灵活性和通用性(可以在众多版本上运行且问题较少),并且专为 Eclipse 环境构建。
Eclipse 包含许多功能:
- **访问扩展器**
- **Fabric Mixins**
- **Mixin Extras**
## 快速开始
要使用 Eclipse,请在您的 `paper-plugin.yaml` (或 `.yml`) 中包含以下选项:
```yaml
mixins: [
"example.mixins.json"
]
wideners: [
"eclipse.accesswidener"
]
datapack-entry: true
```
### 配置字段
- **mixins**: 定义您的插件将使用的 Mixin 配置文件
示例:
```json
{
"mixins": [
"ExampleMixin"
],
"package": "me.dueris.example.mixin",
"compatibilityLevel": "JAVA_21"
}
```
- **wideners**: 指定访问扩展器。
- **datapack-entry**: 允许 Eclipse 也将您的插件作为原版 datapack 加载,类似于 fabric mod。
## 安装
1. 从 [modrinth](https://modrinth.com/plugin/eclipse-mixin) 下载 Eclipse。
2. 将 Eclipse 插件 jar 放在服务器的 `plugins` 目录中。
3. 如上所示配置您的插件的 `paper-plugin.yaml`。
## 示例
对于一个名为 `ExamplePlugin` 的插件:
- `paper-plugin.yaml`
```yaml
name: ExamplePlugin
main: me.dueris.example.Main
version: 1.0.0
mixins: [
"eclipse.mixins.json"
]
wideners: [
"eclipse.accesswidener"
]
datapack-entry: true
```
- `eclipse.mixins.json`
```json
{
"mixins": [
"ExampleMixin"
],
"package": "me.dueris.example.mixin",
"compatibilityLevel": "JAVA_21"
}
```
## 许可证
此项目在 GPL-3.0 许可下发布,并包含额外的许可条款:
允许以二进制形式重新分发和使用,但必须获得作者对第三方项目的直接集成的明确许可。
有关更多详细信息,请参阅 [LICENSE](https://github.com/Dueris/Eclipse/blob/master/LICENSE) 文件。
---