Eclipse

Важно: Eclipse официально устарел и заменён проектом Horizon от CanvasMC. Обновлений больше не будет.

Eclipse - это плагин для Paper серверов, который привносит в среду Paper поддержку SpongePowered/Fabric Mixin. По сути, это адаптированная версия Ignite Mixin Launcher, переработанная под разные версии Minecraft (работает почти без проблем на многих версиях) и заточенная под окружение Eclipse.

Зачем это вообще нужно? В ванильном Paper нет встроенной поддержки миксинов - тех самых штук, которые позволяют модам на Fabric менять код игры на лету. Eclipse решает эту проблему: теперь плагины могут использовать миксины, аксесс-вайденеры и другие фишки, которые раньше были доступны только в Fabric-модах. Для серверных разработчиков это открывает кучу возможностей - от тонкой настройки производительности до добавления новых механик без костылей.

Что умеет Eclipse

• Access Wideners - расширение доступа к приватным полям и методам игры
• Fabric Mixins - полноценная поддержка миксинов, как в Fabric
• Mixin Extras - дополнительные утилиты для работы с миксинами

Как начать использовать

Чтобы подключить Eclipse к своему плагину, пропиши в paper-plugin.yaml (или .yml) следующие настройки:

mixins: [
  "example.mixins.json"
]
wideners: [
  "eclipse.accesswidener"
]
datapack-entry: true

Поля конфигурации

• mixins - указывает на файлы конфигурации миксинов, которые будет использовать твой плагин.

  Пример содержимого example.mixins.json:

  {
    "mixins": [
      "ExampleMixin"
    ],
    "package": "me.dueris.example.mixin",
    "compatibilityLevel": "JAVA_21"
  }
  

• wideners - задаёт файлы аксесс-вайденеров.

• datapack-entry - если true, Eclipse будет загружать твой плагин ещё и как ванильный датапак (прямо как Fabric мод). Удобно, если хочешь совместить плагин с датапаком.

Установка Eclipse на сервер

1. Скачай Eclipse с Modrinth.
2. Положи jar-файл плагина в папку plugins твоего сервера.
3. Настрой paper-plugin.yaml для своих плагинов, как показано выше.

Пример для плагина ExamplePlugin

Допустим, у тебя есть плагин с названием ExamplePlugin. Вот как будет выглядеть его конфиг:

• paper-plugin.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:

  {
    "mixins": [
      "ExampleMixin"
    ],
    "package": "me.dueris.example.mixin",
    "compatibilityLevel": "JAVA_21"
  }
  

Лицензия и важные моменты

Проект распространяется под лицензией GPL-3.0 с дополнительным условием: если хочешь встроить Eclipse напрямую в свой проект (не как зависимость, а прям в код), нужно получить явное разрешение от автора. В бинарном виде распространять можно без проблем.

Если ты разрабатываешь плагины для Paper и тебе не хватает гибкости ванильного API - Eclipse был неплохим вариантом. Но учти, что проект больше не поддерживается, так что лучше смотреть в сторону Horizon.