Skip to content

spinbara/minecraft-cape-generator

Repository files navigation

Pelerynki – kreator peleryn Minecraft

Aplikacja webowa do tworzenia tekstur peleryn i elytra w Minecraft. Wgraj obraz, ustaw kolor (lub auto z obrazu), skalę i opcjonalne tło, a następnie pobierz gotową teksturę w formacie 64×32 (lub w wyższej rozdzielczości). Sluzyla mi jako prywatna gdy tworzylem clienta na zamowienie.

Autor: spinbara


Uruchomienie

npm install
npm run dev

Otwórz w przeglądarce adres wyświetlony w terminalu (zazwyczaj http://localhost:5173).


Budowanie

npm run build

Wynik w katalogu dist/ – gotowa biblioteka do użycia w innych projektach.


Użycie biblioteki

Instancja

import CapeEditor from 'pelerynki' // lub ścieżka do dist

const editor = new CapeEditor()

Generowanie tekstury

Po ustawieniu opcji wywołaj buildCape(). Zwraca Promise z data URL (PNG):

editor.setImage(urlLubBase64)
editor.setScale(2) // 1–6, wyższa = większa rozdzielczość
editor.buildCape().then((dataUrl) => {
  console.log(dataUrl)
  document.querySelector('img').src = dataUrl
})

Opcje

Metoda Opis
setImage(src) Obraz na pelerynę (URL lub base64). Proporcje ~10:16.
setBackground(src) Opcjonalna tekstura tła (peleryna/elytra).
showOnElytra(bool) Czy nanieść obraz także na elytra.
setColor(hex) Kolor obramowania (np. #FF0000).
setAutoColor() Kolor wyliczony z obrazu.
setScale(1–6) Skala: 1 = 64×32, 6 = 2048×1024.

Pobieranie pliku

editor.downloadCape('NazwaPliku')

Technologie

  • Vue 3 – warstwa UI
  • Bootstrap 5 – siatka i formularze
  • Cropper.js – kadrowanie obrazu (proporcje 10:16)
  • minecraft-skin-viewer – podgląd postaci z peleryną
  • Vite – zbieranie i budowanie

Licencja

Zobacz plik LICENSE.

Releases

No releases published

Packages

 
 
 

Contributors