Go to file
2020-03-06 10:15:01 +08:00
.github update GitHub Actions 2020-02-29 16:44:36 +08:00
app fix "score cost per closet item" isn't calculated 2020-03-06 10:15:01 +08:00
bootstrap Refactor bootstrap 2019-12-29 17:39:34 +08:00
config disable MySQL strict mode 2020-02-27 18:07:02 +08:00
database Apply php-cs-fixer 2019-12-14 11:10:37 +08:00
plugins Add an empty "plugins" directory 2018-06-28 13:31:43 +08:00
public add bsh 2020-02-17 18:27:56 +08:00
resources fix "score cost per closet item" isn't calculated 2020-03-06 10:15:01 +08:00
routes make user report page be static 2020-01-21 11:07:20 +08:00
scripts add custom background for skin viewer 2020-03-04 19:37:17 +08:00
storage display 3D avatar when applying texture to player 2020-01-12 09:57:55 +08:00
tests fix test 2020-03-05 17:09:30 +08:00
.editorconfig Update release script 2019-08-01 14:38:26 +08:00
.env.example merge upstream configs 2020-02-26 15:09:06 +08:00
.env.testing merge upstream configs 2020-02-26 15:09:06 +08:00
.eslintignore Fix linting errors 2019-07-12 22:41:44 +08:00
.gitignore add custom background for skin viewer 2020-03-04 19:37:17 +08:00
.php_cs.dist Apply php-cs-fixer 2019-12-14 11:10:37 +08:00
artisan Fix artisan 2019-12-29 19:00:52 +08:00
azure-pipelines.yml Tweak CI trigger 2019-08-09 16:29:00 +08:00
babel.config.json update build step 2020-01-16 16:14:49 +08:00
composer.json update dependencies 2020-03-04 10:53:44 +08:00
composer.lock update dependencies 2020-03-05 18:24:23 +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 Relicense to MIT 2019-03-30 13:20:46 +08:00
package.json rewrite texture upload page 2020-03-05 16:16:08 +08:00
phpunit.xml Refactor bootstrap 2019-12-29 17:39:34 +08:00
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 Apply fixes from StyleCI (#16) 2019-03-12 17:21:29 +08:00
tsconfig.json add path alias 2020-02-07 09:59:10 +08:00
webpack.config.js add path alias 2020-02-07 09:59:10 +08:00
yarn.lock rewrite texture upload page 2020-03-05 16:16:08 +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