Go to file
2019-12-24 23:37:57 +08:00
.github Update GitHub Actions config 2019-12-22 23:05:49 +08:00
app Add more events for authentication 2019-12-24 17:09:30 +08:00
bootstrap Preprocess PHP version 2019-09-12 19:31:48 +08:00
config Allow char "§" for player name & Refactor 2019-12-22 11:50:39 +08:00
database Apply php-cs-fixer 2019-12-14 11:10:37 +08:00
plugins
public
resources Optimize invoking skinview3d 2019-12-24 19:33:35 +08:00
routes Add more events for authentication 2019-12-24 17:09:30 +08:00
scripts Add OAuth client 2019-12-15 11:19:10 +08:00
storage Tweak path of options cache file 2019-12-23 23:28:46 +08:00
tests Use native fs functions for bootstrapping tests 2019-12-24 23:37:57 +08:00
.editorconfig
.env.example Refactor retrieving assets 2019-09-15 10:18:49 +08:00
.env.testing
.eslintignore
.gitignore Tweak path of options cache file 2019-12-23 23:28:46 +08:00
.php_cs.dist Apply php-cs-fixer 2019-12-14 11:10:37 +08:00
artisan
azure-pipelines.yml
babel.config.json Apply new ES syntax: Optional Chaining 2019-12-14 00:08:21 +08:00
composer.json Add OAuth client 2019-12-15 11:19:10 +08:00
composer.lock Add OAuth client 2019-12-15 11:19:10 +08:00
crowdin.yml Update Crowdin config [skip ci] 2019-11-02 13:16:09 +08:00
index.html Put an HTML at root for guiding. 2019-09-12 19:17:54 +08:00
LICENSE
package.json Remove codecov from dependencies 2019-12-14 09:39:47 +08:00
phpunit.xml
postcss.config.js Upgrade ESLint-related 2019-11-25 23:30:51 +08:00
README_EN.md Update documentation 2019-12-10 23:29:15 +08:00
README.md Update documentation 2019-12-10 23:29:15 +08:00
server.php
tsconfig.json Simplify TypeScript configuration 2019-12-03 15:41:31 +08:00
webpack.config.js Remove Element UI 2019-12-01 18:08:21 +08:00
yarn.lock Remove codecov from dependencies 2019-12-14 09:39:47 +08:00

Build Status Codecov Latest Stable Version PHP 7.2.0+ License

Are you puzzled by losing your custom skins in Minecraft servers runing in offline mode? Now you can easily get them back with the help of Blessing Skin!

Blessing Skin is a web application where you can upload, manage and share your custom skins & capes! Unlike modifying a resource pack, everyone in the game will see the different skins of each other (of course they should register at the same website too).

Blessing Skin is an open-source project written in PHP, which means you can deploy it freely on your own web server!

Features

  • A fully functional skin hosting service
  • Multiple player names can be owned by one user on the website
  • Share your skins and capes online with skin library!
  • Easy-to-use
    • Visual page for user/player/texture management
    • Detailed option pages
    • Many tweaks for a better UI/UX
  • Security
    • Support many secure password hash algorithms
    • Email verification for registration
    • Score system for preventing evil requests
  • Incredibly extensible
    • Plenty of plugins available
    • Integration with Authme/CrazyLogin/Discuz (available as plugin)
    • Support custom Yggdrasil API authentication (available as plugin)

Requirements

Blessing Skin has only a few system requirements. In most cases, these PHP extensions are already enabled.

  • Web server with URL rewriting enabled (Nginx or Apache)
  • PHP >= 7.2.0 (use v2.x branch if your server doesn't meet the requirements)
  • OpenSSL PHP Extension
  • PDO PHP Extension
  • Mbstring PHP Extension
  • Tokenizer PHP Extension
  • GD PHP Extension
  • XML PHP Extension
  • Ctype PHP Extension
  • JSON PHP Extension
  • fileinfo PHP Extension
  • zip PHP Extension

Quick Install

  1. Download our latest release, extract to where you like to installed on.
  2. Rename .env.example to .env and configure your database information. (For windows users, just rename it to .env., and the last dot will be removed automatically)
  3. For Nginx users, add rewrite rules to your Nginx configuration
  4. Navigate to http://your-domain.com/setup in your browser. If 404 is returned, please check whether the rewrite rules works correctly.
  5. Follow the setup wizard and your website is ready-to-go.

Plugin System

Blessing Skin provides an elegant and powerful plugin system, and you can attach plenty of functions and customization to your site via installing plugins.

Supporting Blessing Skin

Welcome to sponsoring Blessing Skin if this software is useful for you!

Currently you can sponsor us via 爱发电.

Sponsors


hyx5020

dz_paji

ExDragine

Akkariin

星域联盟_晓夜

Backers


爱发电用户_4ft3

pppwaw

Little_Qiu

麻花

Mangocraft

Andy_Chuck

Developer Install

Please refer to here.

Configure the Web Server

For Apache (most of the virtual hosts) users, there is already a pre-configured file for you. What you need is just to enjoy!

For Nginx users, please add the following rules to your Nginx configuration file:

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

location ~ /\.env {
    deny all;
}

Mod Configuration

Please refer to Mod Configuration.

screenshot

Internationalization

Blessing Skin supports multiple languages, while currently supporting English (en) and Simplified Chinese (zh_CN).

Of course, you can add your own language. Please check Add other language [i18n] (Simplified Chinese only).

If you are willing to contribute your translation, welcome to join our Crowdin project.

Report Bugs

Read FAQ and double check if your situation doesn't suit any case mentioned there before reporting.

When reporting a problem, please attach your log file (located at storage/logs/laravel.log) and the information of your server where the error occured on. You should also read this guide before reporting a problem.

MIT License

Copyright (c) 2016-present The Blessing Skin Community