110 lines
3.6 KiB
Markdown
110 lines
3.6 KiB
Markdown
# Blessing Skin Server
|
|
|
|
Just a simple open-source Minecraft skin server write in PHP. [Live demo](https://work.prinzeugen.net/blessing-skin-server/)
|
|
|
|
|
|
|
|
Features:
|
|
-----------
|
|
|
|
- Support latest [UniSkinAPI](https://github.com/RecursiveG/UniSkinServer/blob/master/doc/UniSkinAPI_zh-CN.md)
|
|
- Support CustomSkinLoader API
|
|
- Also support legacy link to access image directly
|
|
- Nothing else...
|
|
|
|
Installation:
|
|
-----------
|
|
|
|
1. Configure your database information in config.php
|
|
2. Run `./admin/install.php`
|
|
3. Configure your rewrite rules in your `nginx.conf`
|
|
3. Register or login with `admin/123456`
|
|
4. Upload your skin/cape
|
|
5. Configure your url in `UniSkinMod.cfg` of Minecraft client
|
|
6. Enjoy~
|
|
|
|
Server configure:
|
|
------------
|
|
|
|
Add rewrite rules to your nginx.conf:
|
|
|
|
```
|
|
rewrite ^/([^/]*).json$ /get.php?type=json&uname=$1 last;
|
|
rewrite ^/(skin|cape)/([^/-]*)(|-)(|alex|steve).png$ /get.php?type=$1&model=$4&uname=$2 last;
|
|
# Optional
|
|
rewrite ^/(usm|csl)/([^/]*).json$ /get.php?type=json&uname=$2&api=$1 last;
|
|
rewrite ^/(usm|csl)/textures/(.*)$ /textures/$2 last;
|
|
```
|
|
You can also use optional rewrite rules to support both CustomSkinLoader API & UniSkinAPI.
|
|
|
|
If you installed the skin server to subdirectory, you should configure the rules as this:
|
|
|
|
```
|
|
rewrite ^/subdir/([^/]*).json$ /subdir/get.php?type=json&uname=$1 last;
|
|
```
|
|
|
|
Now you can access `http://example.com/username.json` to get your json profile of your preferred API. Another API is also available `http://example.com/(usm|csl)/username.json`.
|
|
|
|
After uploading skins, you can also access `http://example.com/skin/username.png` for prefered model's skin image or `http://example.com/cape/username.png` for cape. Secondary model's texture is available on `http://example.com/skin/username-(alex|steve).png`.
|
|
|
|
Client configure:
|
|
------------
|
|
|
|
#### For UniSkinMod version >= 1.3
|
|
|
|
Put your root directory of skin server( like `/path/to/root` above ) into your `/config/UniSkinMod.cfg` of Minecraft client
|
|
|
|
Sample:
|
|
|
|
```
|
|
# Line starts with '#' is a commit line
|
|
# Line starts with 'Root: ' indicates a server
|
|
# All servers will be queried in that order.
|
|
# Server in front has higher priority
|
|
# Official server has the lowest priority
|
|
# No more legacy style link support!
|
|
|
|
# SkinMe Default
|
|
Root: http://www.skinme.cc/uniskin
|
|
# Your Server
|
|
Root: http://example.com
|
|
```
|
|
|
|
#### For UniSkinMod version < 1.3 or other
|
|
|
|
Also put your url into `/config/UniSkinMod.cfg`, but you need to fill 2 urls for skin and cape
|
|
|
|
Sample:
|
|
|
|
```
|
|
Version: 1
|
|
# Do not edit the line above
|
|
|
|
Skin: http://skins.minecraft.net/MinecraftSkins/%s.png
|
|
Cape: http://skins.minecraft.net/MinecraftCloaks/%s.png
|
|
# Your Server
|
|
Skin: http://example.com/skin/%s.png
|
|
Cape: http://example.com/cape/%s.png
|
|
```
|
|
|
|
FAQ
|
|
------------
|
|
|
|
If everything works well, you will get an awesome skin in game:
|
|
|
|
|
|
|
|
And the log will be like this:
|
|
|
|
```
|
|
[16:23:56] [launcher/INFO] [UniSkinMod]: Loading configuration ... @D:\Minecraft\1.8\.minecraft\config\UniSkinMod.cfg
|
|
[16:23:56] [launcher/INFO] [UniSkinMod]: Root Url Added: http://127.0.0.1/blessing-skin-server
|
|
|
|
[16:24:23] [Client thread/INFO] [UniSkinMod]: Filling profile for player: 621sama
|
|
[16:24:23] [Client thread/INFO] [UniSkinMod]: Fetching URL: http://127.0.0.1/blessing-skin-server/621sama.json
|
|
[16:24:23] [Client thread/INFO] [UniSkinMod]: Player Skin Selected: 621sama default 3f14a21723023642b9e8d2bc008b443780698aaedbb7d4e29960e8a2c754a771
|
|
[16:24:23] [Client thread/INFO] [UniSkinMod]: Player Cape Selected: 621sama aed8c3fc67aae4906b72fa74c27e15866c89752f0838f6b2a1c44bb4d59cec1e
|
|
```
|
|
|
|
If not, please check your log to locate where error occured.
|