blessing-skin-server/README_EN.md

134 lines
5.8 KiB
Markdown
Raw Normal View History

- [简体中文](https://github.com/printempw/blessing-skin-server/blob/master/README.md)
- <b>English</b>
<p align="center"><img src="https://img.blessing.studio/images/2017/01/01/bs-logo.png"></p>
<p align="center">
2017-07-29 21:10:14 +08:00
<a href="https://travis-ci.org/printempw/blessing-skin-server"><img src="https://api.travis-ci.org/printempw/blessing-skin-server.svg?branch=master" alt="Travis Building Status"></a>
2017-11-08 19:10:15 +08:00
<a href="https://codecov.io/gh/printempw/blessing-skin-server"><img src="https://codecov.io/gh/printempw/blessing-skin-server/branch/master/graph/badge.svg" alt="Codecov" /></a>
<a href="https://github.com/printempw/blessing-skin-server/releases"><img src="https://poser.pugx.org/printempw/blessing-skin-server/version" alt="Latest Stable Version"></a>
2018-07-14 14:53:41 +08:00
<img src="https://img.shields.io/badge/PHP-7.1.3+-orange.svg" alt="PHP 7.1.3+">
<img src="https://poser.pugx.org/printempw/blessing-skin-server/license" alt="License">
<a href="https://twitter.com/printempw"><img src="https://img.shields.io/twitter/follow/printempw.svg?style=social&label=Follow" alt="Twitter Follow"></a>
</p>
2018-02-09 16:29:51 +08:00
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!
2018-02-09 16:29:51 +08:00
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).
2018-02-09 16:29:51 +08:00
Blessing Skin 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](http://skin.prinzeugen.net/).
Features
-----------
2018-02-09 16:29:51 +08:00
- 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
2018-02-09 16:29:51 +08:00
- Many tweaks for a better UI/UX
2017-06-30 12:13:45 +08:00
- Security
2018-02-09 16:29:51 +08:00
- Support many secure password hash algorithms
- Email verification for registration (available as plugin)
- Score system for preventing evil requests
2018-02-09 16:29:51 +08:00
- Incredibly extensible
2017-06-30 12:13:45 +08:00
- Plenty of plugins available
- Integration with Authme/CrazyLogin/Discuz
2018-02-09 16:29:51 +08:00
- Support custom Yggdrasil API authentication
Requirements
-----------
2018-02-09 16:29:51 +08:00
Blessing Skin has only a few system requirements. _In most cases, these PHP extensions are already enabled._
- Web server with URL rewriting enabled
2018-07-14 14:53:41 +08:00
- **PHP >= 7.1.3** (use v2.x branch if your server doesn't meet the requirements)
- OpenSSL PHP Extension
- PDO PHP Extension
- Mbstring PHP Extension
- Tokenizer PHP Extension
2018-07-20 17:32:27 +08:00
- GD PHP Extension
- XML PHP Extension
- Ctype PHP Extension
- JSON PHP Extension
- fileinfo PHP Extension
2018-02-09 16:29:51 +08:00
Quick Install
-----------
1. Download our [latest release](https://github.com/printempw/blessing-skin-server/releases), 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](#configure-the-web-server) 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.
2017-07-30 15:39:44 +08:00
Plugin System
------------
2018-02-09 16:29:51 +08:00
Blessing Skin provides an elegant and powerful plugin system, and you can attach plenty of functions and customization to your site via installing plugins.
2017-07-30 15:39:44 +08:00
2018-02-09 16:29:51 +08:00
For more information, please refer to [Wiki - Introducing plugin system](https://github.com/printempw/blessing-skin-server/wiki/%E6%8F%92%E4%BB%B6%E7%B3%BB%E7%BB%9F%E4%BB%8B%E7%BB%8D).
2017-07-30 15:39:44 +08:00
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:
2017-11-08 19:10:15 +08:00
```bash
$ git clone https://github.com/printempw/blessing-skin-server.git
$ composer install
2017-06-30 12:13:45 +08:00
$ yarn install
```
2018-02-09 16:29:51 +08:00
Run the tests (optional):
2017-07-29 21:10:14 +08:00
2017-11-08 19:10:15 +08:00
```bash
2018-02-09 16:29:51 +08:00
$ yarn test
$ ./vendor/bin/phpunit
2017-07-29 21:10:14 +08:00
```
Build the things!
2017-11-08 19:10:15 +08:00
```bash
2017-07-29 21:10:14 +08:00
$ yarn run build
```
2018-02-09 16:29:51 +08:00
Congrats! You made it. Next, please refer to No.2 of **Quick Install** section.
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;
}
location ~ /\.env {
deny all;
}
```
Mod Configuration
------------
2018-02-09 16:29:51 +08:00
Please refer to [Wiki - Mod Configuration](https://github.com/printempw/blessing-skin-server/wiki/%E5%A6%82%E4%BD%95%E9%85%8D%E7%BD%AE%E7%9A%AE%E8%82%A4-Mod).
2017-07-29 21:10:14 +08:00
![screenshot](https://img.blessing.studio/images/2017/07/29/2017-06-16_15.54.16.png)
2018-02-09 16:29:51 +08:00
Report Problems
------------
Read [Wiki - FAQ](https://github.com/printempw/blessing-skin-server/wiki/FAQ) and double check if your situation doesn't suit any case mentioned there before reporting.
2018-02-09 16:29:51 +08:00
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](https://github.com/printempw/blessing-skin-server/wiki/%E6%8A%A5%E5%91%8A%E9%97%AE%E9%A2%98%E7%9A%84%E6%AD%A3%E7%A1%AE%E5%A7%BF%E5%8A%BF) before reporting a problem.
Copyright & License
------------
Copyright 2016-2018 [printempw](https://blessing.studio/) and contributors.
2017-11-07 21:20:32 +08:00
Blessing Skin is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License version 3.
**Exception**: Any plugin developed for Blessing Skin, is not required to adopt GPLv3 License nor release its source code, provided no source code from Blessing Skin is contained in the plugin.