blessing-skin-server

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

Go to file

printempw fd17d3ac75 bump v3.2.1 🚀		2017-01-15 16:21:34 +08:00
app	add option for sending usage statistics	2017-01-15 16:20:29 +08:00
bootstrap	add detection for vendor existence	2017-01-14 18:42:53 +08:00
config	bump v3.2.1 🚀	2017-01-15 16:21:34 +08:00
database	fix comparing versions contain hyphen	2017-01-02 16:23:31 +08:00
plugins	working on framework of plugins	2016-10-17 12:20:55 +08:00
resources	add option for sending usage statistics	2017-01-15 16:20:29 +08:00
storage	start using laravel-debugbar	2016-12-10 18:55:08 +08:00
.bowerrc	update .bowerrc	2016-09-25 10:42:13 +08:00
.env.example	support hashing passwords with password_hash()	2017-01-08 12:49:32 +08:00
.gitattributes	initialize for laravel	2016-08-28 10:05:21 +08:00
.gitignore	working on extracting of updates	2016-11-25 13:13:26 +08:00
.htaccess	add RewriteBase to .htaccess	2017-01-02 00:21:15 +08:00
artisan	remove constant BASE_DIR	2016-11-21 21:50:24 +08:00
bower.json
composer.json	update composer dependencies	2017-01-14 19:28:45 +08:00
composer.lock	update composer dependencies	2017-01-14 19:28:45 +08:00
gulpfile.js	move translation file from app.js to locale.js	2016-12-31 13:17:13 +08:00
index.php	add detection for mbstring & tokenizer extensions	2016-12-30 20:42:37 +08:00
LICENSE
package.json	bump v3.2.1 🚀	2017-01-15 16:21:34 +08:00
README.md	update README	2017-01-02 10:53:19 +08:00
web.config	fix IIS location path starts with dot	2017-01-02 12:24:33 +08:00

README.md

License

中文文档在这里 @GitHub Wiki。

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 Server!

Blessing Skin Server 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 Server is an open-source project written in PHP, which means you can deploy it freely on your own web server! Here is a live demo.

Features

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
Security
- User passwords will be well encrypted
- Email verification for registration (available as plugin)
- Score system for preventing evil requests
Extensible
- Plenty of plugins available
- Integration with Authme/CrazyLogin/Discuz

Requirements

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

Web server with URL rewriting enabled
PHP >= 5.5.9 (use v2.x branch if your server isn't qualified)
OpenSSL PHP Extension
PDO PHP Extension
Mbstring PHP Extension
Tokenizer PHP Extension
GD PHP Extension (for generating CAPTCHA)

Quick Install

Download our latest release, extract to where you like to installed on.
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)
For Nginx users, add rewrite rules to your Nginx configuration
Navigate to http://your-domain.com/setup in your browser. If 404 is returned, please check whether the rewrite rules works correctly.
Follow the setup wizard and your website is ready-to-go.

Developer Install

If you'd like make some contribution on the project, please deploy it from git first.

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

Clone the code from GitHub and install dependencies:

$ git clone https://github.com/printempw/blessing-skin-server.git
$ composer install
$ npm install
$ 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 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;
}

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

Mod Configuration

See Wiki - Mod Configuration

FAQ

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

Report Bugs

Please attach your log file (located at storage/logs/laravel.log) when reporting a bug. You should also provide the information of your server where the error occured on. Bug will be addressed ASAP.