mirror of https://github.com/bs-community/blessing-skin-server.git synced 2024-12-21 06:19:38 +08:00

Go to file

printempw c09700ea57 enhance abstraction of Player model		2016-10-16 18:16:15 +08:00
app	enhance abstraction of Player model	2016-10-16 18:16:15 +08:00
bootstrap	add setting display_errors	2016-09-14 20:02:46 +08:00
config	enhance rendering menus	2016-09-30 17:00:41 +08:00
resources	enhance abstraction of Player model	2016-10-16 18:16:15 +08:00
setup	fix minimal length of password	2016-10-02 20:30:27 +08:00
storage	use YAML for localization	2016-09-11 11:10:02 +08:00
.bowerrc	update .bowerrc	2016-09-25 10:42:13 +08:00
.env.example	update .env.example	2016-09-28 18:08:16 +08:00
.gitattributes	initialize for laravel	2016-08-28 10:05:21 +08:00
.gitignore	move static files to resources/assets	2016-09-25 00:03:07 +08:00
.htaccess	protect dotenv file from being accessed #22	2016-07-28 23:11:05 +08:00
artisan	fix bootstrapers	2016-08-29 14:22:53 +08:00
bower.json	use sweetalert2 to show message in some cases	2016-08-14 13:38:46 +08:00
composer.json	update composer.json	2016-09-27 22:15:23 +08:00
composer.lock	update composer.json	2016-09-27 22:15:23 +08:00
gulpfile.js	update gulp zipping task for packing vendors	2016-09-27 22:47:20 +08:00
index.php	simplify entrance file	2016-09-10 18:09:12 +08:00
LICENSE	change the License to GPL v3	2016-07-23 17:54:52 +08:00
package.json	update to v3.1.1	2016-09-28 22:58:01 +08:00
README.md	update README	2016-09-15 11:21:39 +08:00
web.config	add rules of mime type for IIS	2016-08-16 12:11:49 +08:00

README.md

Blessing Skin Server

Now working on Internationalization. Help wanted~

Blessing Skin Server is a web application for storing and managing skins in Minecraft. You can get your skin back easily even in an offline Minecraft server with Blessing Skin Server.

The framework used by this project is Laravel. Older versions of Blessing Skin Server are available on other branches.

中文版 README 在这里。

Feature

Support UniSkinAPI, CustomSkinLoader API and legacy links
Adapt to Authme, CrazyLogin, Discuz and so on
One user, many players
Skin library and user closets
Score system to provent evil requests
Easy-using user management and option pages
Many color schemes
Avatars generated from skins

Requirements

Blessing Skin Server has a few system requirements.

Web server which supports URL rewriting
PHP version >= 5.5.9
GD PHP Extension
Writeable directory

Quick Start Install

Download the latest release and unzip it to the location you want to install
Rename .env.example to .env and configure your database there.(For windows, just rename it to .env., the last dot will be removed automatically)
For Nginx users, add rewrite rules to your nginx.conf
Access /setup/index.php in your browser
Congratulations! Upload your skins and have fun!

Developer Install

Download and deploy from git only if you want to modify something in Blessing Skin Server.

You'd better have some experience on shell to continue.

Clone the code from GitHub:

$ git clone https://github.com/printempw/blessing-skin-server.git

Install php dependencies using composer:

$ composer install

Install front-end dependencies using bower:

$ bower install

Build the things!

$ gulp

Congrats! You made it. More general install docs here in case you got stuck.

Configure the Web Server

For Apache(most of the virtual hosts) and IIS users, there is already some pre-configured files for you, and what you need to do is just to enjoy!

For Nginx users, please add the below rules to your nginx.conf :

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

# Protect .env file
location ~ /\.env {
    deny all;
}

Mod Configuration

See Wiki - Mod Configuration

BTW, generating configs is available at user center~