https://github.com/archmc-development/archoss-skinbridge

Services to bridge Eaglercraft & Minecraft Java skins through MineSkin.
https://github.com/archmc-development/archoss-skinbridge

Last synced: 9 months ago
JSON representation

Services to bridge Eaglercraft & Minecraft Java skins through MineSkin.

• Host: GitHub
• URL: https://github.com/archmc-development/archoss-skinbridge
• Owner: ArchMC-Development
• Created: 2025-08-07T02:50:07.000Z (10 months ago)
• Default Branch: main
• Last Pushed: 2025-08-07T03:19:34.000Z (10 months ago)
• Last Synced: 2025-09-01T15:04:24.555Z (9 months ago)
• Language: Kotlin
• Homepage:
• Size: 76.2 KB
• Stars: 2
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# SkinBridge

Services to bridge Eaglercraft & Minecraft Java skins through MineSkin.

## Why?

- Eaglercraft uses its protocol for client skins. Eagler players are not online players, so they cannot create signed skins.

- On networks where the majority of the player base is playing on Eaglercraft, Java players may have an unauthentic experience looking at steve skins.



## How?

- Using the MineSkin API, SkinBridge queues **Conversion Jobs** (respecting the max concurrent job limit as described by the MineSkin API limits).

- These conversion jobs are processed by MineSkin, and a response is sent back to the SkinBridge agent, notifying it of a job completion.

- A **Conversion Job** consists of:

  - Converting the Eaglercraft-formatted skin (ABGR8) into a standard PNG skin that MineSkin can process.

  - Sending the job through MineSkin, which uses an online Minecraft account in its pool to generate a valid skin value and signature.

  - Receiving the MineSkin response with the skin value and signature.

  - Sending a one-way RPC network-wide with the valid skin value and signature, forcing an update on the Eagler player's client if online.

  - Caching the response for up to 1w so that the player with the skin (and any other player with that skin) can reuse the generated skin value/signature when they log in again. The caching layer that ArchMC uses is Redis.

- SkinBridge exposes metrics to VictoriaMetrics for monitoring purposes: