Go to file
2020-01-13 10:59:32 +08:00
.github Update GitHub Actions config 2019-12-22 23:05:49 +08:00
app remove unused code 2020-01-13 09:32:44 +08:00
bootstrap Refactor bootstrap 2019-12-29 17:39:34 +08:00
config remove responding 204 for unexisted players 2020-01-13 08:41:35 +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 Refactor bootstrap 2019-12-29 17:39:34 +08:00
resources New Crowdin translations (#124) 2020-01-13 08:58:56 +08:00
routes tweak middlewares 2020-01-13 09:25:07 +08:00
scripts Add OAuth client 2019-12-15 11:19:10 +08:00
storage display 3D avatar when applying texture to player 2020-01-12 09:57:55 +08:00
tests tweak middlewares 2020-01-13 09:25:07 +08:00
.editorconfig Update release script 2019-08-01 14:38:26 +08:00
.env.example New password algorithm: Argon2i 2019-12-25 16:28:24 +08:00
.env.testing Clean up .env files 2019-09-12 19:06:18 +08:00
.eslintignore Fix linting errors 2019-07-12 22:41:44 +08:00
.gitignore update .gitignore 2019-12-31 10:38:58 +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 upgrade deps 2020-01-13 10:59:32 +08:00
composer.json switch server-side texture renderer 2020-01-12 09:27:39 +08:00
composer.lock switch server-side texture renderer 2020-01-12 09:27:39 +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 upgrade deps 2020-01-13 10:59:32 +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 Simplify TypeScript configuration 2019-12-03 15:41:31 +08:00
webpack.config.js remove auto update check 2020-01-05 17:37:56 +08:00
yarn.lock upgrade deps 2020-01-13 10:59:32 +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